Angeben der #$upgrade- und #$upgrade_from-Anweisungen

Um sicherzustellen, dass der Ressourcentyp, den Sie ändern, Upgrade-Unterstützung bietet, fügen Sie die #$upgrade-Anweisung in die RTR-Datei des Ressourcentyps ein. Fügen Sie nach der #$upgrade-Anweisung null oder mehrere #$upgrade_from-Anweisungen für jede frühere Version des Ressourcentyps ein, den Sie unterstützen möchten.

Die #$upgrade- und #$upgrade_from-Anweisungen müssen zwischen den Ressourcentyp-Eigenschaftsdeklarationen und den Ressourcendeklarationsabschnitten in der RTR-Datei stehen. Weitere Informationen finden Sie in der Online-Dokumentation zu rt_reg(4).

Beispiel 4–1 #$upgrade_from-Anweisung in einer RTR-Datei

#$upgrade_from   "1.1"   WHEN_OFFLINE
#$upgrade_from   "1.2"   WHEN_OFFLINE
#$upgrade_from   "1.3"   WHEN_OFFLINE
#$upgrade_from   "2.0"   WHEN_UNMONITORED
#$upgrade_from   "2.1"   ANYTIME
#$upgrade_from   ""      WHEN_UNMANAGED

Das Format der #$upgrade_from-Anweisung lautet wie folgt:

#$upgrade_from Version Optimierbarkeit

Version

Die RT_version. Geben Sie eine leere Zeichenkette an (“”), wenn ein Ressourcentyp keine Version aufweist, oder für andere Versionen als zuvor in der RTR-Datei definiert.

Optimierbarkeit

Die Bedingungen, unter denen der Cluster-Administrator die angegebene RT_version aktualisieren kann.

Verwenden Sie die folgenden Optimierbarkeitswerte in den #$upgrade_from-Anweisungen:

ANYTIME

Verwenden Sie diese Anweisung, wenn es keine Beschränkungen gibt, wann der Cluster-Administrator die Ressource aktualisieren kann. Die Ressource kann während des Upgrades vollständig online sein.

WHEN_UNMONITORED

Verwenden Sie diese Anweisung, wenn die Methoden der neuen Ressourcentypversion wie folgt lauten:

• Die Update-, Stop-, Monitor_check- und Postnet_stop-Methoden sind mit den älteren Startmethoden (Prenet_stop und Start) der Ressourcentypversion kompatibel

• Die Fini-Methode ist mit der Init-Methode älterer Versionen kompatibel

Der Cluster-Administrator muss lediglich das Ressourcen-Monitor-Programm vor dem Upgrade stoppen.

WHEN_OFFLINE

Verwenden Sie diese Anweisung, wenn die Update-, Stop-, Monitor_check- oder Postnet_stop-Methode Folgendes ist:

• Kompatibel mit der Init-Methode einer älteren Version

• Inkompatibel mit den Startmethoden (Prenet_stop und Start) einer älteren Ressourcentypversion

Der Cluster-Administrator muss die Ressource vor dem Upgrade offline nehmen.

WHEN_DISABLED

Ähnlich wie WHEN_OFFLINE. Der Cluster-Administrator muss die Ressource jedoch vor dem Upgrade deaktivieren.

WHEN_UNMANAGED

Verwenden Sie diese Anweisung, wenn die Fini-Methode der neuen Ressourcentypversion mit der Init-Methode einer älteren Version inkompatibel ist . Der Cluster-Administrator muss die vorhandene Ressourcengruppe vor dem Upgrade in den nicht verwalteten Zustand bringen.

Wenn in der Liste der #$upgrade_from-Anweisungen keine Version des Ressourcentyps erscheint, stellt RGM die Optimierbarkeit von WHEN_UNMANAGED standardmäßig auf diese Version ein.

AT_CREATION

Verwenden Sie diese Anweisung, um zu verhindern, dass vorhandene Ressourcen auf die neue Version des Ressourcentyps aktualisiert werden. Der Cluster-Administrator muss eine Ressource löschen und neu erstellen.