Sun Cluster Entwicklerhandbuch Datendienste für Solaris OS

Ressourcentyp-Registrierungsdatei

Ressourcentypname

Die drei Komponenten des Resssourcentypnamens sind Eigenschaften, die in der RTR-Datei als Vendor_id, Resource_type und RT_version angegeben werden. Der scrgadm-Befehl fügt den Punkt und das Semikolon als Trennzeichen ein, um den Namen des Ressourcentyps zu erstellen:


vendor_id.resource_type:rt_version

Das Präfix Vendor_id dient zur Unterscheidung zwischen zwei Registrierungsdateien des gleichen Namens, die von verschiedenen Herstellern geliefert werden. RT_version unterscheidet zwischen mehreren registrierten Versionen (Aufrüstungen) des gleichen Basisressourcentyps. Um sicherzustellen, dass Vendor_id einmalig ist, wird empfohlen, das Börsensymbol für das Unternehmen, das den Ressourcentyp erstellt, zu verwenden.

Die Registrierung des Ressourcentyps schlägt fehl, wenn die RT_version Zeichenkette ein Leerzeichen, Tabulator, Schrägstrich (/), umgekehrten Schrägstrich (\), Asterisk (*), Fragezeichen (?), Komma (,), Semicolon (;), linke eckige Klammer ([) oder rechte eckige Klammer (]) als Zeichen enthält.

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

Der vollständig qualifizierte Name ist der Name, der von folgendem Befehl zurückgegeben wird:


scha_resource_get -O Type -R Ressourcenname -G Ressourcengruppenname

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


vendor_id.resource_type

Anweisungen

RTR-Dateien für aufrüstfähige Ressourcentypen müssen eine #$upgrade-Anweisung enthalten, gefolgt von Null oder mehr Anweisungen der Form:


#$upgrade_from Version Einstellbarkeit

Die upgrade_from-Anweisung besteht aus der Zeichenkette #$upgrade_from, gefolgt von der Einstellbarkeitseinschränkung RT_Version für die Ressource. Wenn der aufzurüstende Ressourcentyp keine Version hat, wird RT_Version als leere Zeichenkette angegeben, wie im letzten Beispiel unten gezeigt.


#$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

RGM erzwingt diese Einschränkungen bei einer Ressource, wenn der Systemverwalter versucht, Type_version der Ressource zu ändern. Wenn die aktuelle Version des Ressourcentyps nicht in der Liste angezeigt wird, erzwingt RGM die Einstellbarkeit von When_unmanaged.

Diese Anweisungen müssen zwischen dem Abschnitt der Ressourcentyp-Eigenschaftsdeklarationen in der RTR-Datei und dem Abschnitt der Ressourcendeklarationen in der RTR-Datei stehen. Siehe rt_reg( 4).

Ändern von RT_Version in einer RTR-Datei

Die RT_Version-Zeichenkette in einer RTR-Datei ist immer dann zu ändern, wenn sich der Inhalt der RTR-Datei ändert. Der Wert dieser Eigenschaft muss deutlich machen, , welche die neuere und welche die ältere Version des Ressourcentyps ist. Eine Änderung der RT_Version-Zeichenkette ist nicht erforderlich, solange keine Änderungen in der RTR-Datei vorgenommen werden.

Ressourcentypnamen in früheren Versionen von Sun Cluster

Ressourcentypnamen in Sun Cluster 3.0 enthielten kein Versionssuffix:


vendor_id.resource_name

Ein Ressourcentyp, der ursprünglich unter Sun Cluster 3.0 registriert wurde, behält diese Form bei, auch wenn die Cluster-Software auf Sun Cluster 3.1 oder höhere Versionen aufgerüstet wird. 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 mit Sun Cluster 3.1-Software bzw. einer höheren Version läuft.

Sie können RTR-Dateien mit der #$upgrade- oder #$upgrade_from -Anweisung in Sun Cluster 3.0 registrieren. Das Migrieren vorhandener Ressourcen zu neuen Ressourcentypen in Sun Cluster 3.0 wird jedoch nicht unterstützt.