LLI Wiki — My Digital Knowledge Base

SQL Server : failover manuel d'un groupe de disponibilité avec Set-AGClusterFailover

Fonctionnement et usage de la fonction PowerShell Set-AGClusterFailover (failover synchrone, forcé et DR d'un groupe Always On).

Mémo sur la fonction PowerShell Set-AGClusterFailover, écrite par Martin Pugh (2014), qui déclenche un failover manuel d'un groupe de disponibilité Always On vers un nœud donné. Le code n'est pas reproduit ici ; voici son fonctionnement et son usage. Elle s'appuie sur le module SQL Server (provider SQLSERVER:\), sur le module FailoverClusters et sur une fonction d'aide New-AGSession (non fournie dans la note) qui ouvre une session PowerShell distante vers le nœud.

Syntaxe

Import-Module \\fileserver\scripts\functions\SQL.Automation.psm1 -Force

# failover vers un nœud synchrone (sans effet si ce nœud est déjà primaire)
Set-AGClusterFailover -ComputerName sqlnode01

# failover vers un nœud asynchrone (perte de données possible)
Set-AGClusterFailover -ComputerName sqlnode02 -Force

# DR : quorum perdu, forcer le quorum sur le nœud asynchrone
Set-AGClusterFailover -ComputerName sqlnode02 -Force -ForceDR
Paramètre Rôle
-ComputerName Nœud du cluster vers lequel basculer
-Force Obligatoire pour un nœud asynchrone ou un nœud synchrone non synchronisé ; confirme que la perte de données est acceptée
-ForceDR Avec -Force, uniquement en reprise après sinistre avec perte du quorum

Fonctionnement

  1. Ouvre une session distante sur le nœud cible et liste ses groupes de disponibilité.
  2. Si le nœud est déjà primaire pour un groupe, rien n'est fait pour ce groupe.
  3. Si le nœud est en SynchronousCommit et Synchronized, appelle Switch-SqlAvailabilityGroup sans perte de données.
  4. Si le nœud est synchrone mais pas synchronisé, ou asynchrone, la bascule n'a lieu qu'avec -Force et après confirmation interactive (Read-Host) ; elle utilise Switch-SqlAvailabilityGroup -AllowDataLoss -Force.
  5. Avec -Force -ForceDR (nœud asynchrone) : après confirmation, arrête le nœud dans le cluster (Stop-ClusterNode), le redémarre avec Start-ClusterNode -FixQuorum, donne un poids de vote de 1 à ce nœud et 0 aux autres, puis bascule avec perte de données autorisée.
  6. Après chaque bascule, reprend la réplication sur les autres réplicas avec Resume-SqlAvailabilityDatabase pour chaque base du groupe.

Remarques

Mastodon LLIMastodon SocialFosstodon