Sun Cluster Entwicklerhandbuch Datendienste für Solaris OS

Anhang A Standardeigenschaften

Dieser Anhang beschreibt die standardmäßigen Ressourcentypen, Ressourcengruppen und Ressourceneigenschaften. Daneben beschreibt er die Ressourceneigenschaftsattribute, die für das Ändern systemdefinierter Eigenschaften und das Erstellen von Erweiterungseigenschaften zur Verfügung stehen.

Der Anhang enthält die folgenden Hauptabschnitte:


Hinweis –

Die Eigenschaftswerte, wie True und False, unterscheiden nicht nach Groß- und Kleinschreibung.


Ressourcentypeigenschaften

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

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.  

N  

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.  

J  

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.

J  

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.  

N  

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.  

N  

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.

N  

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.

N  

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. 

N  

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.

N  

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.  

N  

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 

Ressourceneigenschaften

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

Tabelle A–2 listet auch auf, ob und wann Ressourceneigenschaften aktualisiert werden können (in der Spalte “Aktualisierung möglich?”), und zwar wie folgt:

None oder False

Nie 

True oder Anytime

Jederzeit 

At_creation

Beim Hinzufügen der Ressource zu einem Cluster 

When_disabled

Wenn die Ressource deaktiviert ist 

Tabelle A–2 Ressourceneigenschaften

Eigenschaftsname 

Beschreibung 

Aktualisierung möglich?  

Kategorie 

Affinity_timeout (Ganzzahl)

Länge der Zeit in Sekunden, während der Verbindungen von einer bestimmten Client-IP-Adresse für jeden Dienst in der Ressource an denselben Serverknoten gesendet werden.  

Diese Eigenschaft ist nur dann relevant, wenn Load_balancing_policy entweder Lb_sticky oder Lb_sticky_wild ist. Zudem muss Weak_affinity auf "false" eingestellt sein (Standardwert).

Diese Eigenschaft wird nur für Scalable-Dienste verwendet.  

Jederzeit 

Optional 

Cheap_probe_interval (Ganzzahl)

Die Anzahl Sekunden zwischen den Aufrufen eines schnellen Fehlertests der Ressource. Diese Eigenschaft wird nur durch RGM erstellt und steht dem Verwalter zur Verfügung, wenn sie in der RTR-Datei deklariert wird. 

Diese Eigenschaft ist optional, wenn in der RTR-Datei ein Standardwert angegeben ist. Wenn das Tunable-Attribut nicht in der Ressourcentypdatei angegeben ist, lautet der Tunable-Wert für die Eigenschaft When_disabled.

Diese Eigenschaft ist erforderlich, wenn das Default-Attribut nicht in der Eigenschaftsdeklaration in der RTR-Datei angegeben ist.

Wenn deaktiviert  

Bedingt 

Erweiterungseigenschaften 

Erweiterungseigenschaften, wie sie in der RTR-Datei des Ressourcentyps deklariert sind. Die Implementierung des Ressourcentyps definiert diese Eigenschaften. Weitere Informationen zu den einzelnen Attribute, die für Erweiterungseigenschaften eingestellt werden können, finden Sie in der Tabelle A–4.

Abhängig von der spezifischen Eigenschaft. 

Bedingt 

Failover_mode (Aufzählung)

Mögliche Einstellungen sind NONE, SOFT und HARD. Steuert, ob RGM eine Ressourcengruppe verschiebt oder einen Knoten beendet, wenn ein Start-, Stop- oder Monitor_stop-Methodenaufruf für die Ressource fehlgeschlagen ist. NONE gibt an, dass RGM den Ressourcenzustand lediglich auf Methodenfehler einstellt und auf den Bedienereingriff wartet. SOFT gibt an, dass RGM nach Fehlschlagen einer Start-Methode die Ressourcengruppe auf einen anderen Knoten verschiebt. Bei Fehlschlagen einer Stop- oder Monitor_stop-Methode versetzt RGM die Ressource in den STOP_FAILED-Zustand und die Ressourcengruppe in den ERROR_STOP_FAILED-Zustand. Dann wird auf den Bedienereingriff gewartet. Für Fehlschläge von Stop oder Monitor_stop gelten die NONE- und SOFT-Einstellungen entsprechend. HARD gibt an, dass der Fehlschlag einer Start-Methode zum Verschieben der Gruppe führt, während der Fehlschlag einer Stop- oder Monitor_stop-Methode den Cluster-Knoten beendet und so das Stoppen der Ressource erzwingt.

Der Standardwert ist NONE.

Jederzeit  

Optional 

Load_balancing_policy (Zeichenkette)

Eine Zeichenkette, welche das verwendete Lastausgleichsverfahren definiert. Diese Eigenschaft wird nur für Scalable-Dienste verwendet. RGM erstellt diese Eigenschaft automatisch, wenn die Scalable-Eigenschaft in der RTR-Datei deklariert ist. Load_balancing_policy kann folgende Werte haben:

Lb_weighted (Standardwert). Die Last wird auf mehrere Knoten verteilt, entsprechend den in der Eigenschaft Load_balancing_weights eingestellten Gewichtungen. Lb_sticky. Ein bestimmter Client (identifiziert durch die Client-IP-Adresse) des Scalable-Dienstes wird immer an denselben Cluster-Knoten gesendet. Lb_sticky_wild. Ein bestimmter Client (identifiziert durch die Client-IP-Adresse), der eine Verbindung mit einer IP-Adresse eines Sticky-Dienstes mit Platzhalter herstellt, wird immer zu demselben Cluster-Knoten gesendet, unabhängig von der Port-Nummer, an die er gelangt.

Der Standardwert ist Lb_weighted.

Bei Erstellung  

Bedingt/ Optional 

Load_balancing_weights (Zeichenketten-Array)

Nur für Scalable-Ressourcen. RGM erstellt diese Eigenschaft automatisch, wenn die Scalable-Eigenschaft in der RTR-Datei deklariert ist. Das Format ist Gewichtung@Knoten, Gewichtung@Knoten, wobei Gewichtung eine Ganzzahl ist, die den relativen Anteil der Last angibt, die auf den angegebenen Knoten verteilt wird. Der an einen Knoten verteilte Lastanteil ist die Gewichtung dieses Knotens, geteilt durch die Summe aller Gewichtungen. So gibt zum Beispiel 1@1,3@2 an, dass Knoten 1 1/4 der Last erhält, und Knoten 2 3/4. Die leere Zeichenkette (“”) ist der Standardwert und stellt eine gleichmäßige Verteilung ein. Jeder Knoten, dem keine ausdrückliche Gewichtung zugewiesen wurde, erhält eine Standardgewichtung von 1.

Wenn das Tunable-Attribut nicht in der Ressourcentypdatei angegeben ist, lautet der Tunable-Wert für die Eigenschaft Anytime. Eine Änderung dieser Eigenschaft ändert die Verteilung nur für neue Verbindungen.

Der Standardwert ist die leere Zeichenkette (“”). 

Jederzeit  

Bedingt/ Optional 

Methoden-_timeout für jede Rückmeldemethode in dem Typ (Ganzzahl).

Der Zeitraum in Sekunden, nach dem RGM entscheidet, dass der Aufruf einer Methode fehlgeschlagen ist.  

Der Standardwert ist 3.600 (eine Stunde), wenn die Methode selbst in der RTR-Datei deklariert ist. 

Jederzeit 

Bedingt/ 

Optional 

Monitored_switch (Aufzählung)

Wird von RGM auf Enabled oder Disabled eingestellt, wenn der Cluster-Verwalter den Monitor mit einem Verwaltungsdienstprogramm aktiviert oder deaktiviert. Im Fall von Disabled wird die Start-Methode des Monitors nicht mehr aufgerufen, bis er wieder aktiviert ist. Wenn die Ressource keine Monitor-Rückmeldemethode hat, ist diese Eigenschaft nicht vorhanden.

Der Standardwert ist Enabled.

Nie 

Nur-Abfrage 

Network_resources_used (Zeichenketten-Array)

Eine Liste logischer Hostnamen- bzw. gemeinsam genutzter Netzwerkadressressourcen, die von der Ressource verwendet werden. Für Scalable-Dienste muss sich diese Eigenschaft auf gemeinsam genutzte Adressressourcen beziehen, die in einer eigenen Ressourcengruppe vorhanden sind. Für Failover-Dienste bezieht sich diese Eigenschaft auf logische Hostnamen- oder gemeinsam genutzte Adressressourcen, die in derselben Ressourcengruppe vorhanden sind. RGM erstellt diese Eigenschaft automatisch, wenn die Scalable-Eigenschaft in der RTR-Datei deklariert ist. Wenn Scalable nicht in der RTR-Datei deklariert ist, steht Network_resources_used nicht zur Verfügung, es sei denn, sie wird explizit in der RTR-Datei deklariert.

Wenn das Tunable-Attribut nicht in der Ressourcentypdatei angegeben wird, lautet der Tunable-Wert für die Eigenschaft At_creation.

Bei Erstellung  

Bedingt/ Erforderlich 

On_off_switch (Aufzählung)

Wird von RGM auf Enabled oder Disabled eingestellt, wenn der Cluster-Verwalter die Ressource mit einem Verwaltungsdienstprogramm aktiviert oder deaktiviert. Wenn eine Ressource deaktiviert ist, werden so lange keine Rückmeldungen aufgerufen, bis sie wieder aktiviert wird.

Der Standardwert ist Disabled.

Nie  

Nur-Abfrage 

Port_list (Zeichenketten-Array)

Eine Liste mit Port-Nummern, die der Server abhört. An jede Port-Nummer ist das Protokoll angehängt, das von diesem Port verwendet wird, zum Beispiel Port_list=80/tcp. Wenn die Scalable-Eigenschaft in der RTR-Datei deklariert ist, erstellt RGM Port_list automatisch. Andernfalls steht diese Eigenschaft nicht zur Verfügung, es sei denn, sie wird explizit in der RTR-Datei deklariert.

Das Konfigurieren dieser Eigenschaft für Apache wird im Sun Cluster Data Service for Apache Guide for Solaris OS beschrieben.

Bei Erstellung  

Bedingt/ 

Erforderlich 

R_description (Zeichenkette)

Eine kurze Beschreibung der Ressource. 

Der Standardwert ist eine leere Zeichenkette. 

Jederzeit 

Optional 

Resource_name (Zeichenkette)

Der Name der Ressourceninstanz. Dieser Name muss in der Cluster-Konfiguration einmalig sein und kann nach Erstellen einer Ressource nicht mehr geändert werden.  

Nie  

Erforderlich 

Resource_project_name (Zeichenkette)

Der Solaris-Projektname, der dieser Ressource zugeordnet ist. Diese Eigenschaft wird verwendet, um Solaris-Ressourcenverwaltungsfunktionen wie CPU-Anteile und Ressourcen-Pools auf Cluster-Datendienste anzuwenden. Wenn RGM Ressourcen online bringt, werden die entsprechende Prozesse unter diesem Projektnamen gestartet. Wenn diese Eigenschaft nicht angegeben ist, wird der Projektname von der Eigenschaft RG_project_name der Ressourcengruppe mit der Ressource übernommen (siehe rg_properties (5)). Wenn keine der Eigenschaften angegeben ist, verwendet RGM den vordefinierten Projektnamen default. Der angegebene Projektname muss in der Projektdatenbank vorhanden sein, und der Benutzer root muss als Mitglied des benannten Projekts konfiguriert sein. Diese Eigenschaft wird nur beim Starten unter Solaris 9 unterstützt.


Hinweis –

Änderungen an dieser Eigenschaft werden nach einem Neustart der Ressource wirksam.


Der Standardwert ist Null. 

Jederzeit  

Optional 

Resource_state auf jedem Cluster-Knoten (Aufzählung)

Der von RGM festgelegte Zustand der Ressource auf jedem Cluster-Knoten. Mögliche Zustände sind Online, Offline, Stop_failed, Start_failed, Monitor_failed und Online_not_monitored.

Diese Eigenschaft kann nicht vom Benutzer konfiguriert werden. 

Nie 

Nur-Abfrage 

Retry_count (Ganzzahl)

Anzahl der Male, die ein Monitor im Fehlerfall versucht, eine Ressource neu zu starten. Diese Eigenschaft wird nur durch RGM erstellt und steht dem Verwalter zur Verfügung, wenn sie in der RTR-Datei deklariert wird. Sie ist optional, wenn in der RTR-Datei ein Standardwert angegeben ist. 

Wenn das Tunable-Attribut nicht in der Ressourcentypdatei angegeben wurde, dann ist der Tunable-Wert für die Eigenschaft When_disabled.

Diese Eigenschaft ist erforderlich, wenn das Default-Attribut nicht in der Eigenschaftsdeklaration in der RTR-Datei angegeben ist.

Wenn deaktiviert 

Bedingt  

Retry_interval (Ganzzahl)

Die Anzahl Sekunden, während der die Versuche, eine fehlgeschlagene Ressource neu zu starten, gezählt werden. Der Ressourcen-Monitor verwendet diese Eigenschaft zusammen mit Retry_count. Diese Eigenschaft wird nur durch RGM erstellt und steht dem Verwalter zur Verfügung, wenn sie in der RTR-Datei deklariert wird. Sie ist optional, wenn in der RTR-Datei ein Standardwert angegeben ist.

Wenn das Tunable-Attribut nicht in der Ressourcentypdatei angegeben wurde, dann ist der Tunable-Wert für die Eigenschaft When_disabled.

Diese Eigenschaft ist erforderlich, wenn das Default-Attribut nicht in der Eigenschaftsdeklaration in der RTR-Datei angegeben ist.

Wenn deaktiviert  

Bedingt 

Scalable (Boolescher Wert)

Gibt an, ob es sich um eine Scalable-Ressource handelt. Wenn diese Eigenschaft in der RTR-Datei deklariert ist, erstellt RGM automatisch die folgenden Scalable-Diensteigenschaften für Ressourcen dieses Typs: Network_resources_used, Port_list, Load_balancing_policy und Load_balancing_weights. Diese Eigenschaften haben Standardwerte, wenn sie nicht explizit in der RTR-Datei deklariert werden. Der Standardwert für Scalable— wenn die Eigenschaft in der RTR-Datei deklariert ist — ist True.

Wenn diese Eigenschaft in der RTR-Datei deklariert wurde, muss das Tunable-Attribut auf At_creation eingestellt sein. Andernfalls schlägt die Ressourcenerstellung fehl.

Wenn diese Eigenschaft nicht in der RTR-Datei deklariert wurde, ist die Ressource nicht Scalable, der Cluster-Verwalter kann die Eigenschaft nicht einstellen, und keine Scalable-Diensteigenschaften werden von RGM eingestellt. Sie können die Eigenschaften Network_resources_used und Port_list jedoch auf Wunsch explizit in der RTR-Datei deklarieren, da sie in einem Nicht-Scalable-Dienst ebenso nützlich wie in einem Scalable-Dienst sein können.

Bei Erstellung  

Optional 

Status auf jedem Cluster-Knoten (Aufzählung)

Wird vom Ressourcen-Monitor eingestellt. Mögliche Werte sind: OK, degraded, faulted, unknown und offline. RGM stellt die Werte auf unknown ein, wenn die Ressource online gebracht wird, und auf Offline, wenn sie offline gebracht wird.

Nie 

Nur-Abfrage 

Status_msg auf jedem Cluster-Knoten (Zeichenkette)

Wird vom Ressourcen-Monitor zur gleichen Zeit wie die Status-Eigenschaft eingestellt. Diese Eigenschaft kann pro Ressource und pro Knoten eingestellt werden. RGM stellt sie auf leere Zeichenkette ein, wenn die Ressource offline gebracht wird.

Nie 

Nur-Abfrage 

Thorough_probe_interval (Ganzzahl)

Die Anzahl Sekunden zwischen den Aufrufen eines Überlauftests der Ressource. Diese Eigenschaft wird nur durch RGM erstellt und steht dem Verwalter zur Verfügung, wenn sie in der RTR-Datei deklariert wird. Sie ist optional, wenn in der RTR-Datei ein Standardwert angegeben ist. 

Wenn das Tunable-Attribut nicht in der Ressourcentypdatei angegeben ist, lautet der Tunable-Wert für die Eigenschaft When_disabled.

Diese Eigenschaft ist erforderlich, wenn das Default-Attribut nicht in der Eigenschaftsdeklaration in der RTR-Datei angegeben ist.

Wenn deaktiviert  

Bedingt 

Type (Zeichenkette)

Der Ressourcentyp, von dem die Ressource eine Instanz darstellt. 

Nie 

Erforderlich 

Type_version (Zeichenkette)

Gibt an, welche Version des Ressourcentyps der Ressource aktuell zugeordnet ist. RGM erstellt diese Eigenschaft automatisch. Sie kann nicht in der RTR-Datei deklariert werden. Der Wert dieser Eigenschaft entspricht der RT_version-Eigenschaft des Ressourcentyps. Bei Erstellung einer Ressource wird die Type_version-Eigenschaft nicht ausdrücklich angegeben. Sie kann jedoch als Suffix des Ressourcentypnamens angezeigt werden. Wenn eine Ressource bearbeitet wird, kann Type_version einen neuen Wert erhalten.

Die Einstellbarkeit leitet sich von Folgendem ab:

  • Der aktuellen Version des Ressourcentyps,

  • Der #$upgrade_from-Anweisung in der RTR-Datei.

Siehe Beschreibung 

Siehe Beschreibung  

UDP_affinity (Boolescher Wert)

Wenn der Wert "true" ist, wird der ganze UDP-Verkehr eines bestimmten Clients an denselben Serverknoten gesendet, der aktuell den ganzen TCP-Verkehr für den Client bearbeitet. 

Diese Eigenschaft ist nur relevant, wenn Load_balancing_policy entweder Lb_sticky oder Lb_sticky_wild ist. Außerdem muss Weak_affinity auf "False" (Standardwert) eingestellt sein.

Diese Eigenschaft wird nur für Scalable-Dienste verwendet. 

Wenn deaktiviert 

Optional 

Weak_affinity (Boolescher Wert)

Wenn "true" eingestellt ist, wird die schwache Form der Client-Affinität aktiviert. Dadurch können Verbindungen eines bestimmten Clients zu demselben Serverknoten gesendet werden, es sei denn: 

  • Ein Server-Listener startet, zum Beispiel aufgrund von Fehler-Monitor-Neustarts, Ressourcen-Failover oder -Switchover, oder weil ein Knoten dem Cluster nach einem Fehler erneut beitritt.

  • Load_balancing_weights für die Scalable-Ressource wird aufgrund einer Verwaltungsaktion geändert.

Eine schwache Affinität sorgt für eine niedrige Überlaufalternative zur Standardform, und zwar sowohl bezüglich des Speicherverbrauchs als auch der Prozessorzyklen.  

Diese Eigenschaft ist nur dann relevant, wenn Load_balancing_policy entweder Lb_sticky oder Lb_sticky_wild ist.

Diese Eigenschaft wird nur für Scalable-Dienste verwendet.  

Wenn deaktiviert  

Optional 

Ressourcengruppeneigenschaften

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

Die Spalte “Aktualisierung möglich?” zeigt, ob die Eigenschaft aktualisiert werden kann ((J) oder nicht (N)), nachdem sie eingestellt wurde.

Tabelle A–3 Ressourcengruppeneigenschaften

Eigenschaftsname 

Beschreibung 

Aktualisierung möglich? 

Kategorie 

Auto_start_on_new_ cluster (Boolescher Wert)

Diese Eigenschaft lässt kein automatisches Starten der Ressourcengruppe zu, wenn ein neuer Cluster gebildet wird. 

 

Der Standardwert ist TRUE. Wenn TRUE eingestellt ist, versucht Ressourcengruppen-Manager, die Ressourcengruppe automatisch zu starten, um Desired_primaries zu erzielen, wenn der Cluster neu gestartet wird. Wenn FALSE eingestellt ist, startet die Ressourcengruppe bei einem Neustart des Clusters nicht automatisch.

Optional 

Desired_primaries (Ganzzahl)

Die Anzahl der Knoten, auf denen die Gruppe gleichzeitig online gebracht werden soll.  

Der Standardwert ist 1. Wenn die RG_mode-Eigenschaft Failover ist, dann darf der Wert dieser Eigenschaft nicht größer als 1 sein. Wenn die RG_mode-Eigenschaft Scalable ist, dann ist ein Wert größer 1 zulässig.

Optional 

Failback (Boolescher Wert)

Ein boolescher Wert, der angibt, ob der Satz der Knoten, auf denen die Gruppe online ist, neu berechnet wird, wenn sich die Cluster-Mitgliedschaft ändert. Eine Neuberechnung kann dazu führen, dass RGM die Gruppe auf weniger bevorzugten Knoten offline und auf stärker bevorzugten Knoten online bringt. 

Der Standardwert ist False.

J  

Optional 

Global_resources_used (Zeichenketten-Array)

Gibt an, ob Cluster-Dateisysteme von einer Ressource in dieser Ressourcengruppe verwendet werden. Zulässige Werte, die der Verwalter angeben kann, sind ein Asterisk (*) für alle globalen Ressourcen und die leere Zeichenkette (“”) für keine globalen Ressourcen. 

Der Standardwert ist alle globalen Ressourcen.  

J  

Optional 

Implicit_network_ dependencies (Boolescher Wert)

Ein boolescher Wert, der bei Einstellung auf True angibt, dass RGM starke Abhängigkeiten von Nicht-Netzwerkadressressourcen von Netzwerkadressressourcen innerhalb der Gruppe erzwingen soll. Netzwerkadressressourcen umfassen die logische Hostnamen- und gemeinsam genutzten Adressressourcentypen.

In einer Scalable-Ressourcengruppe hat diese Eigenschaft keine Wirkung, da eine solche Gruppe keine Netzwerkadressressourcen enthält. 

Der Standardwert ist True.

Optional 

Maximum_primaries (Ganzzahl)

Die maximale Anzahl der Knoten, auf denen die Gruppe gleichzeitig online sein kann.  

Der Standardwert ist 1. Wenn die RG_mode-Eigenschaft Failover ist, dann darf der Wert dieser Eigenschaft nicht größer als 1 sein. Wenn die RG_mode-Eigenschhaft Scalable ist, dann ist ein Wert größer 1 zulässig.

Optional 

Nodelist (Zeichenketten-Array)

Eine Liste der Cluster-Knoten, auf denen die Gruppe in der Reihenfolge ihres Vorrangs online gebracht werden kann. Diese Knoten werden als potenzielle Primärknoten bzw. Master der Ressourcengruppe bezeichnet. 

Der Standardwert ist die Liste aller Cluster-Knoten.  

J  

Optional 

Pathprefix (Zeichenkette)

Ein Verzeichnis im Cluster-Dateisystem, in dem Ressourcen in der Gruppe wesentliche Verwaltungsdateien schreiben können. Für einige Ressourcen kann diese Eigenschaft erforderlich sein. Pathprefix muss für jede Ressourcengruppe einmalig sein.

Der Standardwert ist eine leere Zeichenkette. 

Optional 

Pingpong_interval (Ganzzahl)

Ein nicht negativer Ganzzahlwert in Sekunden, mit dem RGM festlegt, wo die Ressourcengruppe im Fall einer Rekonfiguration oder bei einem scha_control -O GIVEOVER-Befehl bzw. einer scha_control()-Funktion mit Ausführung des SCHA_GIVEOVER-Arguments online gebracht werden kann.

Im Fall einer Rekonfiguration, wenn die Ressourcengruppe mehr als einmal innerhalb der verstrichenen, im Pingpong_interval eingestellten Sekundenzahl auf einem bestimmten Knoten nicht online gebracht werden konnte (weil die Start- oder Prenet_start-Methode nicht mit Null beendet wurde oder die Zeitüberschreitung abgelaufen war), gilt dieser Knoten für das Hosten der Ressourcengruppe als nicht wählbar, und RGM sucht einen anderen Master.

Wenn ein Aufruf des scha_control-Befehls bzw. der scha_control()-Funktion der Ressource die Ressourcengruppe auf einem bestimmten Knoten innerhalb der letzten Pingpong_interval-Sekunden offline bringt, kommt dieser Knoten für das Hosten der Ressourcengruppe infolge eines späteren Aufrufs von scha_control() durch einen anderen Knoten nicht in Frage.

Der Standardwert ist 3,600 (eine Stunde). 

Optional 

Resource_list (Zeichenketten-Array)

Die Liste der in dieser Gruppe enthaltenen Ressourcen. Der Verwalter stellt diese Eigenschaft nicht direkt ein. RGM aktualisiert sie immer dann, wenn der Verwalter der Ressourcengruppe Ressourcen hinzufügt bzw. sie daraus entfernt.  

Der Standardwert ist die leere Liste. 

Nur-Abfrage 

RG_description (Zeichenkette)

Eine kurze Beschreibung der Ressourcengruppe. 

Der Standardwert ist eine leere Zeichenkette. 

Optional 

RG_mode (Aufzählung)

Gibt an, ob die Ressourcengruppe eine Failover- oder Scalable-Gruppe ist. Wenn der Wert Failover ist, stellt RGM die Maximum_primaries-Eigenschaft der Gruppe auf 1 und beschränkt die Ressourcengruppe, so dass sie nur von einem einzigen Knoten unterstützt wird.

Wenn der Wert dieser Eigenschaft Scalable ist, lässt RGM für die Maximum_primaries-Eigenschaft einen Wert größer als 1 zu. Das bedeutet, dass die Gruppe mehrere Knoten gleichzeitig als Master haben kann. RGM lässt nicht zu, dass eine Ressource, deren Failover-Eigenschaft True ist, einer Ressourcengruppe hinzugefügt wird, deren RG_mode auf Scalable eingestellt ist.

Der Standardwert ist Failover, wenn Maximum_primaries 1 ist, und Scalable, wenn Maximum_primaries größer als 1 ist.

Optional 

RG_name (Zeichenkette)

Der Name der Ressourcengruppe. Dieser Name muss im Cluster einmalig sein.  

N  

Erforderlich 

RG_project_name (Zeichenkette)

Der Solaris-Projektname, der dieser Ressourcengruppe zugeordnet ist. Diese Eigenschaft wird verwendet, um Solaris-Ressourcenverwaltungsfunktionen wie CPU-Anteile und Ressourcen-Pools auf Cluster-Datendienste anzuwenden. Wenn RGM Ressourcengruppen online bringt, wird der entsprechende Prozess für Ressourcen, bei denen die Resource_project_name-Eigenschaft nicht eingestellt ist, unter diesem Projektnamen gestartet. Der angegebene Projektname muss in der Projektdatenbank vorhanden sein, und der Benutzer root muss als Mitglied des benannten Projekts konfiguriert sein.

Diese Eigenschaft wird nur beim Starten unter Solaris 9 unterstützt.  


Hinweis –

Änderungen an dieser Eigenschaft werden nach einem Neustart der Ressource wirksam.


Jederzeit 

Erforderlich 

RG_state auf jedem Cluster-Knoten (Aufzählung)

Wird von RGM auf Online, Offline, Pending_online, Pending_offline, Pending_online_blocked, Error_stop_failed oder Online_faulted eingestellt und beschreibt den Zustand der Gruppe auf jedem Cluster-Knoten.

Diese Eigenschaft kann nicht vom Benutzer konfiguriert werden. Sie kann jedoch indirekt durch das Aufrufen von scswitch(1M) eingestellt werden, bzw. durch die Verwendung des äquivalenten scsetup( 1M) oder SunPlex Manager-Befehle.

Nur-Abfrage 

Ressourceneigenschaftsattribute

Die folgende Tabelle beschreibt die Ressourceneigenschaftsattribute, die für das Ändern systemdefinierter Eigenschaften bzw. das Erstellen von Erweiterungseigenschaften verwendet werden können.


Achtung – Achtung –

NULL oder die leere Zeichenkette (“”) können nicht als Standardwert für boolean-, enum- oder int-Typen angegeben werden.


Tabelle A–4 Ressourceneigenschaftsattribute

Eigenschaft 

Beschreibung 

Property

Der Name der Ressourceneigenschaft. 

Extension

Die Verwendung gibt an, dass der RTR-Dateieintrag eine Erweiterungseigenschaft deklariert, die durch die Ressourcentypimplementierung definiert wurde. Andernfalls ist der Eintrag eine systemdefinierte Eigenschaft.  

Description

Eine Zeichenkettenanmerkung, die eine kurze Beschreibung der Eigenschaft gibt. Das description-Attribut kann in der RTR-Datei nicht für systemdefinierte Eigenschaften eingestellt werden. 

Typ der Eigenschaft 

Zulässige Typen sind: string, boolean, int, enum und stringarray. Das type-Attribut kann in der RTR-Datei nicht für systemdefinierte Eigenschaften eingestellt werden. Der Typ legt akzeptable Eigenschaftswerte und die typspezifischen Attribute fest, die in dem RTR-Dateieintrag zulässig sind. Ein enum-Typ ist ein Satz von Zeichenkettenwerten.

Default

Gibt einen Standardwert für die Eigenschaft an. 

Tunable

Gibt an, ob der Cluster-Verwalter den Wert dieser Eigenschaft einer Ressource einstellen kann. Kann auf None oder False eingestellt werden, damit der Verwalter die Eigenschaft nicht einstellen kann. Folgende Werte können vom Verwalter eingestellt werden: True oder Anytime (jederzeit), At_creation (nur zum Erstellungszeitpunkt der Ressource) oder When_disabled (wenn die Ressource offline ist).

Der Standardwert ist True (Anytime).

Enumlist

Für einen enum-Typ ist ein Satz von Zeichenkettenwerten für die Eigenschaft zulässig.

Min

Für einen int-Typ der zulässige Mindestwert für die Eigenschaft.

Max

Für einen int-Typ der zulässige Höchstwert für die Eigenschaft.

Minlength

Für string- und stringarray-Typen die zulässige Mindestlänge der Zeichenkette.

Maxlength

Für string- und stringarray-Typen die zulässige Höchstlänge der Zeichenkette.

Array_minsize

Für den stringarray-Typ die zulässige Mindestanzahl von Array-Elementen.

Array_maxsize

Für den stringarray-Typ die zulässige Höchstzahl von Array-Elementen.