Sun Cluster Entwicklerhandbuch Datendienste für Solaris OS

Ressourcentypeigenschaften

Die folgende Tabelle beschreibt die von Sun Cluster definierten Ressourcentypeigenschaften. Die Eigenschaftswerte werden in der Spalte “Kategorie” in folgende Kategorien unterteilt:

Erforderlich — Die Eigenschaft erfordert einen expliziten Wert in der Ressourcentyp-Registrierungsdatei (RTR-Datei). Andernfalls kann das Objekt, zu dem sie gehört, nicht erstellt werden. Ein Leerzeichen bzw. eine leere Zeichenkette sind als Wert nicht zulässig.
Bedingt — Um vorhanden sein zu können, muss die Eigenschaft in der RTR-Datei deklariert werden. Andernfalls wird sie von RGM nicht erstellt und steht den Verwaltungsdienstprogrammen nicht zur Verfügung. Ein Leerzeichen bzw. eine leere Zeichenkette sind zulässig. Wenn die Eigenschaft in der RTR-Datei deklariert, jedoch kein Wert angegeben ist, stellt RGM einen Standardwert bereit.
Bedingt/Explizit — Um vorhanden sein zu können, muss die Eigenschaft in der RTR-Datei mit einem expliziten Wert deklariert werden. Andernfalls wird sie von RGM nicht erstellt und steht den Verwaltungsdienstprogrammen nicht zur Verfügung. Ein Leerzeichen bzw. eine leere Zeichenkette sind nicht zulässig.
Optional — Die Eigenschaft kann in der RTR-Datei deklariert werden. Wenn sie nicht deklariert ist, erstellt sie RGM und stellt einen Standardwert bereit. Wenn die Eigenschaft in der RTR-Datei deklariert, jedoch kein Wert angegeben ist, stellt RGM denselben Standardwert bereit, als wäre die Eigenschaft nicht in der RTR-Datei deklariert.

Ressourcentypeigenschaften können nicht mit Verwaltungsdienstprogrammen aktualisiert werden, mit Ausnahme von Installed_nodes. Diese Eigenschaft kann nicht in der RTR-Datei deklariert werden und muss vom Verwalter eingerichtet werden.

Tabelle A–1 Ressourcentypeigenschaften

Eigenschaftsname

Beschreibung

Aktualisierung möglich?

Kategorie

Allow_hosts (Zeichenketten-Array)

Steuert den Satz der Clients, die sich beim cl_apid-Dämon registrieren dürfen, um Cluster-Rekonfigurationsereignisse zu erhalten. Die allgemeine Form dieser Eigenschaft ist ipaddress/masklength, was ein Teilnetz definiert, von dem aus sich die Clients registrieren können. Zum Beispiel ermöglicht es die Einstellung 129.99.77.0/24 den Clients im Teilnetz 129.99.77, sich für Ereignisse zu registrieren. Dagegen ermöglicht zum Beispiel 192.9.84.231/32 nur dem Client 192.9.84.231, sich für Ereignisse zu registrieren. Diese Eigenschaft verleiht dem CRNP Sicherheit. Der cl_apid-Dämon ist in SUNW.Event(5) beschrieben.

Daneben werden die folgenden besonderen Schlüsselwörter erkannt. LOCAL bezieht sich auf alle Clients, die sich in direkt verbundenen Teilnetzen des Clusters befinden. ALL ermöglicht allen Clients die Registrierung. Beachten Sie, dass einem Client, für den ein Eintrag sowohl in der Eigenschaft Allow_hosts als auch in Deny_hosts gefunden wird, die Registrierung bei der Implementierung verweigert wird.

Der Standardwert ist LOCAL.

Optional

API_version (Ganzzahl)

Die Version der Ressourcenverwaltungs-API, die von dieser Ressourcentypimplementierung verwendet wird.

Der Standardwert für Sun Cluster 3.1 4/04 ist 2.

Optional

Boot (Zeichenkette)

Eine optionale Rückmeldemethode: der Pfad zu dem Programm, das RGM auf einem Knoten aufruft, der dem Cluster beitritt bzw. erneut beitritt, wenn eine Ressource dieses Typs bereits verwaltet wird. Diese Methode hat die Aufgabe, Initialisierungsaktionen für Ressourcen dieses Typs, vergleichbar mit denen der Init-Methode, auszuführen.

Bedingt/Explizit

Client_retry_count (Ganzzahl)

Steuert die Anzahl der Versuche, die vom cl_apid-Dämon unternommen werden, während er mit den externen Clients kommuniziert. Wenn ein Client nicht innerhalb von Client_retry_count Versuchen antwortet, hat der Client die Zeit überschritten. Daraufhin wird er aus der Liste der registrierten Clients entfernt, die Cluster-Rekonfigurationsereignisse erhalten können. Der Client muss sich erneut registrieren, um wieder Ereignisse zu erhalten. Weitere Informationen darüber, wie oft diese Wiederholungen von der Implementierung durchgeführt werden, finden Sie in der Beschreibung der Eigenschaft Client_retry_interval. Der cl_apid-Dämon wird in SUNW.Event(5) beschrieben.

Der Standardwert ist 3.

Optional

Client_retry_interval (Ganzzahl)

Definiert den Zeitraum in Sekunden, den der cl_apid-Dämon bei der Kommunikation mit nicht antwortenden externen Clients verwendet. Bis zu Client_retry_count Versuche zur Verbindung mit dem Client werden während dieses Zeitintervalls unternommen. Der cl_apid-Dämon ist in SUNW.Event(5) beschrieben.

Der Standardwert ist 1800.

Optional

Client_timeout (Ganzzahl)

Der Zeitüberschreitungswert in Sekunden, der vom cl_apid-Dämon bei der Kommunikation mit externen Clients verwendet wird. Der cl_apid -Dämon wiederholt die Verbindungsversuche mit dem Client jedoch für eine einstellbare Anzahl von Malen erneut. In der Beschreibung der Eigenschaften Client_retry_count und Client_retry_interval erfahren Sie weitere Einzelheiten zu den Mitteln, die Sie zum Einstellen dieser Eigenschaft einsetzen können. Der cl_apid-Dämon ist in SUNW.Event(5) beschrieben.

Der Standardwert ist 60.

Optional

Deny_hosts (Zeichenketten-Array)

Steuert den Satz der Clients, deren Registrierung für das Erhalten von Cluster-Rekonfigurationsereignissen zurückgewiesen wird. Um den Zugriff festzulegen, haben die Einstellungen dieser Eigenschaft Vorrang vor denen der Allow_hosts-Liste. Das Format dieser Eigenschaft entspricht dem in der Allow_hosts-Eigenschaft definierten Format. Diese Eigenschaft verleiht dem CRNP Sicherheit.

Der Standardwert ist NULL.

Optional

Failover (Boolescher Wert)

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

Optional

Fini (Zeichenkette)

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

Bedingt/Explizit

Init (Zeichenkette)

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

Bedingt/Explizit

Init_nodes (Aufzählung)

Die Werte können RG_primaries (nur diejenigen Knoten, die Master der Ressourcen sein können) oder RT_installed_nodes (alle Knoten, auf denen der Ressourcentyp installiert ist) sein. Gibt die Knoten an, auf denen RGM die Methoden Init, Fini, Boot und Validate aufruft.

Der Standardwert ist RG_primaries.

Optional

Installed_nodes (Zeichenketten-Array)

Eine Liste der Cluster-Knotennamen, 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.

Der Standardwert ist alle Cluster-Knoten.

Kann vom Cluster-Verwalter konfiguriert werden.

Max_clients (Ganzzahl)

Steuert die maximale Anzahl der Clients, die sich beim cl_apid-Dämon für den Erhalt von Cluster-Ereignisbenachrichtigungen registrieren können. Versuche weiterer Clients, sich für Ereignisse zu registrieren, werden von der Anwendung zurückgewiesen. Da jede Client-Registrierung Cluster-Ressourcen beansprucht, kann durch Einstellen dieser Eigenschaft die Ressourcennutzung durch externe Clients auf dem Cluster gesteuert werden. Der cl_apid-Dämon ist in SUNW.Event(5) beschrieben.

Der Standardwert ist 1000.

Optional

Monitor_check (Zeichenkette)

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

Bedingt/Explizit

Monitor_start (Zeichenkette)

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

Bedingt/Explizit

Monitor_stop (Zeichenkette)

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

Bedingt/Explizit

Num_resource_restarts auf jedem Cluster-Knoten (Ganzzahl)

Diese Eigenschaft wird von RGM auf die Anzahl der Aufrufe von scha_control RESTART eingestellt, die für diese Ressource auf diesem Knoten während der letzten n Sekunden erfolgt sind, wobei n der Wert der Retry_interval-Eigenschaft der Ressource ist. Wenn für einen Ressourcentyp die Retry_interval-Eigenschaft nicht deklariert wurde, dann steht die Eigenschaft Num_resource_restarts den Ressourcen dieses Typs nicht zur Verfügung.

Nur-Abfrage

Pkglist (Zeichenketten-Array)

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

Bedingt/Explizit

Postnet_stop (Zeichenkette)

Eine optionale Rückmeldemethode: der Pfad zu dem Programm, das von RGM nach Aufruf der Stop-Methode einer beliebigen Netzwerkadressressource aufruft (Network_resources_used), von der eine Ressource dieses Typs abhängt. Diese Methode ist für STOP-Aktionen vorgesehen, die ausgeführt werden müssen, nachdem die Netzwerkschnittstellen als inaktiv konfiguriert wurden.

Bedingt/Explizit

Prenet_start (Zeichenkette)

Eine optionale Rückmeldemethode: der Pfad zu dem Programm, das von RGM vor Aufruf der Start-Methode für eine beliebige Netzwerkadressressource aufgerufen wird (Network_resources_used), von der eine Ressource dieses Typs abhängt. Diese Methode ist für START-Aktionen vorgesehen, die ausgeführt werden müssen, bevor die Netzwerkschnittstellen als aktiv konfiguriert werden.

Bedingt/Explizit

Resource_type (Zeichenkette)

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:

vendor_id.resource_type:version

Die drei Bestandteile des Ressourcentypnamens sind Eigenschaften, die in der RTR-Datei als Vendor_id, Resource_type und RT_version angegeben sind. Der scrgadm-Befehl fügt die Punkte und Semikolons als Trennzeichen ein. Das RT_version-Suffix des Ressourcentypnamens hat den gleichen Wert wie die RT_version-Eigenschaft. Um sicherzustellen, dass Vendor_id einmalig ist, wird empfohlen, das Börsensymbol für das Unternehmen, das den Ressourcentyp erstellt, zu verwenden. Ressourcentypnamen, die vor Sun Cluster 3.1 erstellt wurden, verwenden weiterhin folgende Form:

vendor_id.resource_type

Der Standardwert ist eine leere Zeichenkette.

Erforderlich

RT_basedir (Zeichenkette)

Der Verzeichnispfad, der zum Vervollständigen von relativen Pfaden für Rückmeldemethoden verwendet wird. Dieser Pfad muss auf den Installationsspeicherort für die Ressourcentyppakete eingestellt sein. Dabei muss es sich um einen vollständigen, mit einem Schrägstrich (/) beginnenden Pfad handeln. Diese Eigenschaft ist nicht erforderlich, wenn alle Methodenpfadnamen absolut sind.

Erforderlich, falls nicht alle Methodenpfad- namen absolut sind.

RT_description (Zeichenkette)

Eine kurze Beschreibung des Ressourcentyps.

Der Standardwert ist eine leere Zeichenkette.

Bedingt

RT_version (Zeichenkette)

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 ab Sun Cluster 3.1 verbindlich.

Bedingt/Explizit

Single_instance (Boolescher Wert)

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

Der Standardwert ist False.

Optional

Start (Zeichenkette)

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

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

Stop (Zeichenkette)

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

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

Update (Zeichenkette)

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

Bedingt/Explizit

Validate (Zeichenkette)

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

Bedingt/Explizit

Vendor_ID (Zeichenkette)

Siehe die Resource_type-Eigenschaft.

Bedingt