LLI Wiki — My Digital Knowledge Base

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

Mastodon LLIMastodon SocialFosstodon