test

Sun Cluster Entwicklerhandbuch Datendienste für Solaris OS

Erstellen des Inhalts der RTR-Datei

Ressourcentypname

Die drei Komponenten eines Ressourcentypnamens sind Eigenschaften, die in der RTR-Datei als Hersteller-ID, Ressourcentyp und RT-Version angegeben sind. Der Befehl scrgadm fügt beim Erstellen eines Ressourcentyps den Punkt und Doppelpunkt ein: 

Hersteller-ID.Ressourcentyp:RT-Version

Das Hersteller-ID-Präfix dient dazu, zwischen zwei Registrierungsdateien mit demselben Namen verschiedener Unternehmen zu unterscheiden. Um sicherzustellen, dass die Hersteller-ID einmalig ist, verwenden Sie beim Erstellen des Ressourcentyps das Börsensymbol des Unternehmens. Die RT-Version unterscheidet zwischen mehreren registrierten Versionen (Upgrades) desselben Basisressourcentyps.

Sie können den vollständig qualifizierten Ressourcentypnamen durch Eingabe des folgenden Befehls abrufen: 


# scha_resource_get -O Type -R Ressourcenname -G Ressourcengruppenname

Ressourcentypnamen, die vor Sun Cluster 3.1 registriert wurden, verwenden weiterhin folgende Form: 

Hersteller-ID.Ressourcentyp

Das Format von Ressourcentypnamen wird im Abschnitt Format von Ressourcentypnamen beschrieben.

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.

Ändern der RT_version in einer RTR-Datei

Sie müssen die RT_version -Eigenschaft in einer RTR-Datei nur dann ändern, wenn sich der Inhalt der RTR-Datei ändert. Wählen Sie für diese Eigenschaft einen Wert, der genau angibt, ob diese Version des Ressourcentyps die aktuellste ist.

Verwenden Sie in der Zeichenkette RT_version der RTR-Datei keines der folgenden Zeichen, da die Registrierung des Ressourcentyps sonst fehlschlägt:

Die RT_version-Eigenschaft, die in Sun Cluster 3.0 optional war, ist ab Sun Cluster 3.1 verbindlich.

Ressourcentypnamen in früheren Versionen von Sun Cluster

Die Ressourcentypnamen in Sun Cluster 3.0 enthalten kein Versionssuffix, wie hier abgebildet: 

Hersteller-ID.Ressourcentyp

Ein Ressourcentyp, der ursprünglich unter Sun Cluster 3.0 registriert war, hat weiterhin einen Namen, der dieser Syntax folgt, selbst nachdem der Cluster-Administrator die Cluster-Software auf Sun Cluster 3.1 oder höher aktualisiert. Ebenso erhält ein Ressourcentyp, in dessen RTR-Datei die #$upgrade-Anweisung fehlt, einen Namen im Sun Cluster 3.0-Format ohne Versionssuffix, wenn die RTR-Datei auf einem Cluster registriert ist, der mindestens mit Sun Cluster 3.1-Software läuft.

Der Cluster-Administrator kann RTR-Dateien mithilfe der #$upgrade-Anweisung oder der #$upgrade_from-Anweisung in Sun Cluster 3.0 registrieren. Ein Upgrade vorhandener Ressourcen auf neue Ressourcentypen in Sun Cluster 3.0 wird jedoch nicht unterstützt.