IPS_PromoteToReplicationMaster

 bool IPS_PromoteToReplicationMaster ()

Rückgabewert

Konnte die Funktion erfolgreich ausgeführt werden, liefert sie als Ergebnis TRUE, andernfalls FALSE.

Beschreibung

Diese Funktion ist nur für den internen Gebrauch vorgesehen und kann sich jederzeit ohne Ankündigung ändern oder entfallen.

Die Funktion befördert den Slave zum Master, sodass er die Aufgaben des Masters übernimmt (Failover). Der Abgleich mit dem Master wird angehalten, der Zeitpunkt für IPS_GetReplicationFailoverTime gesetzt und alle Instanzen im Status Standby (106) werden aktiviert. Das Ergebnis der Aktivierung wird je Instanz in der Meldungsanzeige protokolliert.

Dasselbe geschieht automatisch, wenn das automatische Failover konfiguriert ist und der Abgleich mit dem Master wiederholt fehlschlägt. Mit IPS_DemoteToReplicationSlave kann der Slave wieder zurückgestuft werden.

Ist die Replikation nicht aktiv, schlägt die Funktion mit "Replication is not active!" fehl. Ist die Replikation nicht im Modus Standby (IPS_GetReplicationMode), schlägt die Funktion mit "Replication must be in Standby-Mode!" fehl.

Beispiel

// Slave manuell zum Master befördern, z.B. bei einer geplanten Wartung des Masters
if (IPS_IsReplicationActive() && !IPS_IsReplicationFailoverActive()) {
    IPS_PromoteToReplicationMaster();
}