Commandes PowerShell utiles pour un cluster de basculement Windows et SQL Server
Aide-mémoire des commandes PowerShell et cluster.exe pour gérer groupes, ressources, disques et journaux d'un cluster de basculement Windows hébergeant SQL Server.
Aide-mémoire des commandes utiles pour administrer un cluster de basculement Windows (Failover Cluster) hébergeant SQL Server : installation des fonctionnalités, déplacement des groupes, ressources, espace disque et journaux du cluster.
Installer les fonctionnalités Windows
Install-WindowsFeature Net-Framework-Core -Source C:\install\sxs\
Install-WindowsFeature Application-Server,Failover-Clustering,RSAT-Clustering-MGMT -IncludeManagementTools
Add-WindowsFeature AS-Dist-Transaction,AS-Incoming-Trans,AS-Outgoing-Trans
Installer une instance SQL Server en cluster
Sur le premier nœud, lancer le programme d'installation avec l'action InstallFailoverCluster, puis sur chaque nœud passif avec l'action AddNode :
Setup /SkipRules=Cluster_VerifyForErrors /Action=InstallFailoverCluster
Setup /SkipRules=Cluster_VerifyForErrors /Action=AddNode
Si SQL Server Configuration Manager ne parvient pas à se connecter au fournisseur WMI (erreur 0x80041010, classe invalide), recompiler le fichier MOF du fournisseur :
mofcomp "C:\Program Files (x86)\Microsoft SQL Server\100\Shared\sqlmgmproviderxpsp2up.mof"
Le chemin dépend de la version de SQL Server installée (ici 100 correspond à SQL Server 2008 / 2008 R2).
Déplacer des groupes de cluster
Avec l'ancien utilitaire cluster.exe :
cluster group "cluster group" /properties
cluster group "cluster group" /move:nodename
Avec le module PowerShell FailoverClusters :
Import-Module FailoverClusters
Get-Command -Module FailoverClusters
Get-ClusterGroup
Déplacer tous les groupes actifs d'un nœud vers un autre :
Get-ClusterNode node01 | Get-ClusterGroup | Move-ClusterGroup -Node node02
# Variante : filtrer sur le propriétaire et attendre indéfiniment la fin du déplacement
Get-ClusterGroup | Where-Object { $_.OwnerNode -eq "node01" } | Move-ClusterGroup -Node "node02" -Wait 0
Déplacer un groupe nommé (par exemple un groupe de disponibilité) :
Move-ClusterGroup -Name 'ag_app_001' -Node 'node01'
Move-ClusterGroup -Name 'Cluster Group' -Node 'node01'
Get-ClusterGroup affiche le nœud propriétaire et l'état de chaque groupe :
Name OwnerNode State
---- --------- -----
ag_app_001 node01 Online
ag_app_002 node01 Online
Available Storage node01 Offline
Cluster Group node01 Online
Ressources du cluster
# Lister les ressources et lire leurs paramètres
Get-ClusterResource
Get-ClusterResource "Cluster IP Address" | Get-ClusterParameter
# Nœuds propriétaires possibles d'une ressource
Get-ClusterResource "SQL Server Agent" | Get-ClusterOwnerNode
# Arrêter la ressource SQL Server
Stop-ClusterResource "SQL Server"
# Modifier le TTL de l'enregistrement DNS d'une ressource nom réseau
Get-ClusterResource cluster1FS | Set-ClusterParameter HostRecordTTL 300
Modifier plusieurs paramètres d'une ressource adresse IP en une seule fois :
$res = Get-ClusterResource "IP Address"
$param1 = New-Object Microsoft.FailoverClusters.PowerShell.ClusterParameter $res,Address,192.0.2.10
$param2 = New-Object Microsoft.FailoverClusters.PowerShell.ClusterParameter $res,SubnetMask,255.255.255.0
$params = $param1,$param2
$params | Set-ClusterParameter
Quelques équivalents avec cluster.exe :
cluster /List
cluster.exe "clustername" group "SQL Server (MSSQLSERVER)" /status
cluster /cluster:%cluster% res /prop
cluster /cluster:%cluster% network "%PublicNetwork%" /priv
cluster restype "%resource_name%" /delete /type
Espace disque des volumes du cluster
Taille et espace libre des volumes NTFS (hors C: et D:) sur plusieurs nœuds, au format CSV :
wmic /node:"node01","node02" path Win32_LogicalDisk WHERE "FileSystem='NTFS' AND Name != 'C:' AND Name != 'D:'" GET SystemName,Name,Size,FreeSpace,VolumeName /format:csv
Pour une liste plus longue de nœuds, la placer dans un fichier :
echo node01 > clusternodes.txt & echo node02 >> clusternodes.txt & wmic /node:@clusternodes.txt path Win32_LogicalDisk WHERE "FileSystem='NTFS' AND Name != 'C:' AND Name != 'D:'" GET SystemName,Name,Size,FreeSpace,VolumeName
Équivalent PowerShell local :
Get-WmiObject Win32_LogicalDisk
Taille d'un répertoire en PowerShell
function directory-summary($dir=".") {
Get-ChildItem $dir |
ForEach-Object { $f = $_ ;
Get-ChildItem -Recurse $_.FullName |
Measure-Object -Property Length -Sum |
Select-Object @{Name="Name"; Expression={$f}},Sum }
}
Taille en Mo des éléments du répertoire courant :
Get-ChildItem | Select-Object Name, @{Name="MegaBytes";Expression={$_.Length / 1MB}}
Filtrer les fichiers modifiés durant les 7 derniers jours :
Get-ChildItem -Recurse | Where-Object { (-not $_.PSIsContainer) -and ($_.LastWriteTime -ge [DateTime]::Today.AddDays(-7)) }
Débogage de scripts
Set-PSDebug -Trace 2 -Step
Set-PSDebug -Trace 0
Journal de débogage du cluster
Depuis Windows Server 2008, le fichier texte CLUSTER.LOG de Windows Server 2003 n'existe plus : le journal du cluster repose sur Event Tracing for Windows (ETW) et doit être généré au format texte à la demande. Cette génération se fait avec cluster.exe ou, à partir de Windows Server 2008 R2, avec les applets de commande PowerShell.
cluster.exe |
PowerShell | Effet |
|---|---|---|
cluster log /gen |
Get-ClusterLog |
Génère le journal |
/COPY:"directory" |
-Destination |
Copie les journaux de tous les nœuds dans un seul répertoire |
/SPAN:min |
-TimeSpan |
Ne conserve que les X dernières minutes |
/NODE:"node-name" |
-Node |
Cible un nœud précis, utile quand le service de cluster est arrêté |
Référence : Understanding the Cluster Debug Log in 2008 (blog Microsoft Ask the Core Team).
Remarques
cluster.exeest un outil historique ; sur les versions récentes de Windows Server, préférer les applets de commande du moduleFailoverClusters.- Les noms de nœuds, de groupes et de ressources ci-dessus sont des exemples génériques, à adapter.