Sun Cluster Entwicklerhandbuch Datendienste für Solaris OS

Ressourcentypeigenschaften

In den folgenden Informationen werden die Ressourcentypeigenschaften beschrieben, die von der Sun Cluster-Software definiert werden. Die Eigenschaftswerte werden wie folgt in Kategorien unterteilt:

Ressourcentypeigenschaften können von den Verwaltungsdienstprogrammen nicht aktualisiert werden, mit Ausnahme von Installed_nodes und RT_system, die in der RTR-Datei nicht deklariert werden können und vom Cluster-Administrator festgelegt werden müssen.

Die Eigenschaftsnamen werden zuerst angezeigt, gefolgt von einer Beschreibung.


Hinweis –

Ressourcentypeigenschaftsnamen, z.B. API_version und Boot unterliegen nicht der Groß-/Kleinschreibung. Bei der Eingabe von Eigenschaftsnamen können Sie jede beliebige Kombination aus Groß- und Kleinbuchstaben verwenden.


API_version (integer)

Die niedrigste Version der Ressourcenverwaltungs-API, die zur Unterstützung dieser Ressourcentypimplementierung benötigt wird.

Die folgenden Informationen stellen eine Zusammenfassung der höchsten API_version dar, die von jedem Sun Cluster-Release unterstützt wird.

Bis Version 3.1

2

Version 3.1 10/03

3

Version 3.1 4/04

4

3.1 9/04

5

3.1 8/05

6

Die Deklaration eines Wertes für die API_version, die höher ist als 2, in der RTR-Datei verhindert, dass der Ressourcentyp auf einer Version von Sun Cluster installiert wird, die eine niedrigere Maximalversion unterstützt. Wenn Sie für einen Ressourcentyp beispielsweise API_version=5 deklarieren, kann dieser Ressourcentyp nicht auf einer Version von Sun Cluster installiert werden, die vor 3.1 9/04 herausgegeben wurde.


Hinweis –

Wenn Sie diese Eigenschaft nicht deklarieren oder sie auf den Standardwert (2) setzen, kann der Datendienst auf jeder beliebigen Version von Sun Cluster installiert werden, beginnend bei Sun Cluster 3.0.


Kategorie:

Optional

Standard:

2

Einstellbar:

NONE

Boot (string)

Eine optionale Rückmeldemethode: der Pfad zu dem Programm, das RGM auf einem Knoten ausführt, der dem Cluster beitritt bzw. erneut beitritt, wenn eine Ressource dieses Typs bereits verwaltet wird. Diese Methode initialisiert Ressourcen dieses Typs wie die Init -Methode.

Kategorie:

Bedingt oder Explizit

Standard:

Kein Standard

Einstellbar:

NONE

Failover (boolean)

True gibt an, dass Ressourcen dieses Typs nicht in einer Gruppe konfiguriert werden können, die auf mehreren Knoten gleichzeitig online sein kann.

In der folgenden Tabelle wird dargestellt, wie diese Ressourcentypeigenschaft in Kombination mit der Scalable-Ressourceneigenschaft verwendet wird.

Wert des Failover-Ressourcentyps

Wert der Scalable-Ressource

Beschreibung 

TRUE

TRUE

Geben Sie diese unlogische Kombination nicht an. 

TRUE

FALSE

Geben Sie diese Kombination für einen Failover-Dienst an. 

FALSE

TRUE

Geben Sie diese Kombination für einen Scalable-Dienst an, der eine SharedAddress -Ressource für den Netzwerklastausgleich verwendet.

Im Sun Cluster Konzepthandbuch für Solaris OS wird SharedAddress detailliert beschrieben.

FALSE

FALSE

Obwohl es sich um eine ungewöhnliche Kombination handelt, können Sie diese Kombination auch zur Auswahl eines Mehrfach-Master-Dienstes verwenden, der keinen Netzwerklastausgleich verwendet. 

Die Beschreibung von Scalable in der Online-Dokumentation unter r_properties(5) und Kapitel 3, Schlüsselkonzepte für Systemverwalter und Anwendungsentwickler in Sun Cluster Konzepthandbuch für Solaris OS enthalten weitere Informationen.

Kategorie:

Optional

Standard:

FALSE

Einstellbar:

NONE

Fini (string)

Eine optionale Rückmeldemethode: der Pfad zu dem Programm, das RGM ausführt, wenn eine Ressource dieses Typs aus der RGM-Verwaltung entfernt wird.

Kategorie:

Bedingt oder Explizit

Standard:

Kein Standard

Einstellbar:

NONE

Init (string)

Eine optionale Rückmeldemethode: der Pfad zu dem Programm, das RGM ausführt, wenn eine Ressource dieses Typs unter die Verwaltung durch RGM gestellt wird.

Kategorie:

Bedingt oder Explizit

Standard:

Kein Standard

Einstellbar:

NONE

Init_nodes (enum)

Gibt die Knoten an, auf denen RGM die Methoden Init , Fini, Boot und Validate aufruft. Die Werte können RG_PRIMARIES (nur die Knoten, die die Ressourcen verarbeiten können) oder RT_INSTALLED_NODES (alle Knoten, auf dem der Ressourcentyp installiert wird) lauten.

Kategorie:

Optional

Standard:

RG_PRIMARIES

Einstellbar:

NONE

Installed_nodes (string_array)

Eine Liste der Namen von Cluster-Knoten, auf denen der Ressourcentyp ausgeführt werden kann. RGM erstellt diese Eigenschaft automatisch. Der Cluster-Verwalter kann den Wert einstellen. Diese Eigenschaft kann nicht in der RTR-Datei deklariert werden.

Kategorie:

Kann vom Cluster-Verwalter konfiguriert werden.

Standard:

Alle Cluster-Knoten

Einstellbar:

ANYTIME

Is_logical_hostname (boolean

TRUE gibt an, dass dieser Ressourcentyp eine Version des Ressourcentyps LogicalHostname ist, der Failover-IP-Adressen verwaltet.

Kategorie:

Nur-Abfrage

Standard:

Kein Standard

Einstellbar:

NONE

Is_shared_address (boolean)

TRUE gibt an, dass dieser Ressourcentyp eine Version des Ressourcentyps SharedAddress ist, der Failover-IP-Adressen verwaltet.

Kategorie:

Nur-Abfrage

Standard:

Kein Standard

Einstellbar:

NONE

Monitor_check (string)

Eine optionale Rückmeldemethode: der Pfad zu dem Programm, das RGM ausführt, bevor ein vom Monitor angefordertes Failover einer Ressource dieses Typs ausgeführt wird.

Kategorie:

Bedingt oder Explizit

Standard:

Kein Standard

Einstellbar:

NONE

Monitor_start (string)

Eine optionale Rückmeldemethode: Der Pfad zu dem Programm, das von RGM zum Starten eines Fehler-Monitors für eine Ressource dieses Typs ausgeführt wird.

Kategorie:

Bedingt oder Explizit

Standard:

Kein Standard

Einstellbar:

NONE

Monitor_stop (string)

Eine Rückmeldemethode, die erforderlich ist, wenn Monitor_start eingestellt ist: der Pfad zu dem Programm, das von RGM ausgeführt wird, um den Fehler-Monitor für eine Ressource dieses Typs zu stoppen.

Kategorie:

Bedingt oder Explizit

Standard:

Kein Standard

Einstellbar:

NONE

Pkglist (string_array)

Eine optionale Liste der Pakete, die in der Ressourcentypinstallation inbegriffen sind.

Kategorie:

Bedingt oder Explizit

Standard:

Kein Standard

Einstellbar:

NONE

Postnet_stop (string)

Eine optionale Rückmeldemethode: der Pfad zu dem Programm, das von RGM nach Aufruf der Stop-Methode einer beliebigen Netzwerkadressressource ausgeführt wird, von der eine Ressource dieses Typs abhängig ist. Nachdem die Netzwerkschnittstellen herunterkonfiguriert wurden, muss diese Methode Stop-Aktionen ausführen.

Kategorie:

Bedingt oder Explizit

Standard:

Kein Standard

Einstellbar:

NONE

Prenet_start (string)

Eine optionale Rückmeldemethode: der Pfad zu dem Programm, das von RGM ausgeführt wird, bevor die Start-Methode beliebiger Netzwerkadressressourcen aufgerufen wird, von denen eine Ressource dieses Typs abhängig ist. Diese Methode führt Start-Aktionen aus, die vor der Konfiguration von Netzwerkschnittstellen durchgeführt werden müssen.

Kategorie:

Bedingt oder Explizit

Standard:

Kein Standard

Einstellbar:

NONE

Resource_list (string_array)

Die Liste aller Ressourcen des Ressourcentyps. Der Cluster-Administrator stellt diese Eigenschaft nicht direkt ein. Stattdessen aktualisiert der RGM diese Eigenschaft, wenn der Cluster-Administrator Ressourcen der Ressourcengruppe hinzufügt oder daraus entfernt.

Kategorie:

Nur-Abfrage

Standard:

Leere Liste

Einstellbar:

NONE

Resource_type (string)

Der Name des Ressourcentyps. Geben Sie Folgendes ein, um die Namen der aktuell registrierten Ressourcentypen anzuzeigen:

scrgadm -p

In Sun Cluster 3.1 und höheren Versionen muss ein Ressourcentypname auch die Version enthalten:

Hersteller-ID.Ressourcentyp:RT-Version

Die drei Komponenten des Ressourcentypnamens sind Eigenschaften, die in der RTR-Datei als Hersteller-ID, Ressourcentyp und RT-Version angegeben sind. Der Befehl scrgadm für einen Punkt (.) und einen Doppelpunkt (:) als Trennzeichen ein. Das RT-Version-Suffix des Ressourcentypnamens hat den gleichen Wert wie die RT_version-Eigenschaft. Um sicherzustellen, dass die Hersteller-ID eindeutig ist, müssen Sie das Börsensymbol des Unternehmens verwenden, das den Ressourcentyp erstellt. Ressourcentypnamen, die vor Sun Cluster 3.1 erstellt wurden, verwenden weiterhin folgende Syntax:

Hersteller-ID.Ressourcentyp

Kategorie:

Erforderlich

Standard:

Leerzeichenkette

Einstellbar:

NONE

RT_basedir (string)

Der Verzeichnispfad, der zum Vervollständigen von relativen Pfaden für Rückmeldemethoden verwendet wird. Dieser Pfad muss auf das Verzeichnis eingestellt sein, in dem die Ressourcentyppakete installiert sind. Dabei muss es sich um einen vollständigen, mit einem Schrägstrich (/) beginnenden Pfad handeln.

Kategorie:

Erforderlich, falls nicht alle Methodenpfadnamen absolut sind.

Standard:

Kein Standard

Einstellbar:

NONE

RT_description (string)

Eine kurze Beschreibung des Ressourcentyps.

Kategorie:

Bedingt

Standard:

Leerzeichenkette

Einstellbar:

NONE

RT_system (boolean)

Wenn die RT_system-Eigenschaft für einen Ressourcentyp auf TRUE eingestellt ist, können Sie den Ressourcentyp nicht löschen (scrgadm -r -t Ressourcentypname). Diese Eigenschaft verhindert die versehentliche Löschung der Ressourcentypen, z.B. LogicalHostname, die zur Unterstützung der Cluster-Infrastruktur verwendet werden. Sie können die RT_system -Eigenschaft jedoch auf jeden beliebigen Ressourcentyp anwenden.

Um einen Ressourcentyp zu löschen, dessen RT_system-Eigenschaft auf TRUE eingestellt ist, müssen Sie die Eigenschaft zunächst auf FALSE setzen. Gehen Sie beim Löschen eines Ressourcentyps, dessen Ressourcen Cluster-Dienste unterstützen, vorsichtig vor.

Kategorie:

Optional

Standard:

FALSE

Einstellbar:

ANYTIME

RT_version (string)

Ab Sun Cluster 3.1 eine erforderliche Versionszeichenkette für diese Ressourcentypimplementierung. RT_version ist die Suffixkomponente des vollständigen Ressourcentypnamens. Die RT_version-Eigenschaft, die in Sun Cluster 3.0 optional war, ist in Sun Cluster 3.1 und höheren Versionen zwingend erforderlich.

Kategorie:

Bedingt/Explizit oder Erforderlich

Standard:

Kein Standard

Einstellbar:

NONE

Single_instance (boolean)

TRUE gibt an, dass nur eine Ressource dieses Typs im Cluster vorhanden sein darf. RGM lässt Cluster-weit jeweils nur die Ausführung einer Ressource dieses Typs zu.

Kategorie:

Optional

Standard:

FALSE

Einstellbar:

NONE

Start (string)

Eine Rückmeldemethode: der Pfad zu dem Programm, das RGM ausführt, um eine Ressource dieses Typs zu starten.

Kategorie:

Erforderlich, es sei denn, in der RTR-Datei wird eine Prenet_start -Methode deklariert.

Standard:

Kein Standard

Einstellbar:

NONE

Stop (string)

Eine Rückmeldemethode: der Pfad zu dem Programm, das von RGM zum Stoppen einer Ressource dieses Typs ausgeführt wird.

Kategorie:

Erforderlich, falls die RTR-Datei keine Postnet_stop-Methode deklariert.

Standard:

Kein Standard

Einstellbar:

NONE

Update (string)

Eine optionale Rückmeldemethode: der Pfad zu dem Programm, das RGM ausführt, wenn Eigenschaften einer laufenden Ressource dieses Typs geändert werden.

Kategorie:

Bedingt oder Explizit

Standard:

Kein Standard

Einstellbar:

NONE

Validate (string)

Eine optionale Rückmeldemethode: der Pfad zu dem Programm, das von RGM ausgeführt wird, um die Werte der Eigenschaften von Ressourcen dieses Typs zu prüfen.

Kategorie:

Bedingt oder Explizit

Standard:

Kein Standard

Einstellbar:

NONE

Vendor_ID (string)

Siehe die Resource_type-Eigenschaft.

Kategorie:

Bedingt

Standard:

Kein Standard

Einstellbar:

NONE