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:
Die Eigenschaftswerte, wie True und False, unterscheiden nicht nach Groß- und Kleinschreibung.
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. |
N |
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. |
N |
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. |
J |
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. |
J |
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. |
N |
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. |
N |
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. |
N |
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. |
N |
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. |
J |
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. |
J |
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. |
N |
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. |
N |
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. |
N |
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:
|
N |
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. |
N |
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. |
N |
Optional |
|||
Start (Zeichenkette) |
Eine Rückmeldemethode: der Pfad zu dem Programm, das von RGM zum Starten einer Ressource dieses Typs aufgerufen wird. |
N |
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. |
N |
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. |
N |
Bedingt/Explizit |
|||
Vendor_ID (Zeichenkette) |
Siehe die Resource_type-Eigenschaft. |
N |
Bedingt |
Tabelle A–2 beschreibt die von Sun Cluster definierten Ressourceneigenschaften. Die Eigenschaftswerte werden in der Spalte “Kategorie” in folgende Kategorien unterteilt:
Erforderlich — Der Verwalter muss einen Wert angeben, wenn er eine Ressource mit einem Verwaltungsdienstprogramm erstellt.
Optional — Wenn der Verwalter beim Erstellen einer Ressourcengruppe keinen Wert angibt, so stellt das System einen Standardwert bereit.
Bedingt — RGM erstellt die Eigenschaft nur dann, wenn sie in der RTR-Datei deklariert wurde. Andernfalls ist die Eigenschaft nicht vorhanden, und sie steht den Systemverwaltern nicht zur Verfügung. Eine bedingte Eigenschaft, die in der RTR-Datei deklariert wurde, ist optional oder erforderlich, je nachdem, ob in der RTR-Datei ein Standardwert angegeben ist. Weitere Details sind in der Beschreibung für jede bedingte Eigenschaft enthalten.
Nur-Abfrage — Kann nicht direkt durch ein Verwaltungstool eingestellt werden.
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:
|
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:
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 |
Die folgende Tabelle beschreibt die von Sun Cluster definierten Ressourcengruppeneigenschaften. Die Eigenschaftswerte werden in folgende Kategorien unterteilt (in der Spalte “Kategorie”):
Erforderlich — Der Verwalter muss einen Wert angeben, wenn er eine Ressourcengruppe mit einem Verwaltungsdienstprogramm erstellt.
Optional — Wenn der Verwalter beim Erstellen einer Ressourcengruppe keinen Wert angibt, so stellt das System einen Standardwert bereit.
Nur-Abfrage — Kann nicht direkt durch ein Verwaltungstool eingestellt werden.
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. |
J |
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. |
J |
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. |
J |
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. |
J |
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. |
J |
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). |
J |
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. |
N |
Nur-Abfrage |
RG_description (Zeichenkette) |
Eine kurze Beschreibung der Ressourcengruppe. Der Standardwert ist eine leere Zeichenkette. |
J |
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. |
N |
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. |
N |
Nur-Abfrage |
Die folgende Tabelle beschreibt die Ressourceneigenschaftsattribute, die für das Ändern systemdefinierter Eigenschaften bzw. das Erstellen von Erweiterungseigenschaften verwendet werden können.
NULL oder die leere Zeichenkette (“”) können nicht als Standardwert für boolean-, enum- oder int-Typen angegeben werden.
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. |