Befehl "resetrsrc"

Zweck

Setzt eine Ressource zurück, d. h., erzwingt, dass die Ressource in den Offlinestatus versetzt wird.

Syntax

Eine oder mehrere Ressourcen unter Verwendung der in der Befehlszeile eingegebenen Daten zurücksetzen:

resetrsrc -s "Auswahlzeichenfolge" [ -N { Knotendatei │ "-" } ] [-h] [-TV] Ressourcenklasse [Argument=Wert...]

resetrsrc -r [-h] [-TV] Ressourcenkennung [arg=wert ...

Eine oder mehrere Ressourcen unter Verwendung der in einer Eingabedatei vordefinierten Befehlsargumente zurücksetzen:

resetrsrc -f Eingabedatei für Ressourcendaten -s "Auswahlzeichenfolge" [ -N { Knotendatei | "-" }] [-h] [-TV] Ressourcenklasse

resetrsrc -f Eingabedatei für Ressourcendaten -r [-h] [-TV] Ressourcenkennung

Namen und Datentypen der Befehlsargumente anzeigen:

resetrsrc -l [-h] Ressourcenklasse

Beschreibung

Der Befehl resetrsrc fordert an, dass das RMC-Subsystem (Resource Monitoring and Control) eine oder mehrere Ressourcen offline setzt. Die Anforderung wird vom entsprechenden Ressourcenmanager ausgeführt.

Wenn Sie eine oder mehrere Ressourcen zurücksetzen möchten, verwenden Sie das Flag -s , um alle Ressourcen, die mit der angegebenen Auswahlzeichenfolge übereinstimmen, offline zu setzen. Zum Zurücksetzen einer bestimmten Ressource verwenden Sie das Flag -r , um das Ressourcenhandle anzugeben, das diese bestimmte Ressource darstellt.

Anstatt mehrere Knotennamen in Auswahlzeichenfolgeanzugeben, können Sie das Flag -N Knotendatei verwenden, um anzugeben, dass sich die Knotennamen in einer Datei befinden. Verwenden Sie -N "-" , um die Knotennamen aus der Standardeingabe zu lesen.

Verwenden Sie das Flag -l , um festzustellen, ob die angegebene Ressourcenklasse zusätzliche Befehlsargumente akzeptiert.

Die erfolgreiche Ausführung dieses Befehls garantiert nicht, dass die Ressource offline ist, sondern nur, dass der Ressourcenmanager die Anforderung zum Stoppen dieser Ressource erfolgreich empfangen hat. Überwachen Sie das dynamische Ressourcenattribut OpState , um zu ermitteln, wann das Stoppen der Ressource erzwungen wird. Registrieren Sie ein Ereignis für die Ressource und geben Sie das Attribut OpState an, um zu ermitteln, wann die Ressource offline ist. Oder führen Sie den Befehl lsrsrc sporadisch aus, bis Sie feststellen, dass die Ressource offline ist (der Wert von OpState ist 2). Beispiel:

      
lsrsrc -s 'Name == "/filesys1"' -t IBM.FileSystem Name OpState

Wenn Cluster Systems Management (CSM) auf Ihrem System installiert ist, können Sie CSM-definierte Knotengruppen als Knotennamenswerte verwenden, um auf mehrere Knoten zu verweisen. Informationen zum Arbeiten mit CSM-Knotengruppen und zur Verwendung des CSM-Befehls nodegrp finden Sie im Handbuch CSM: Administration Guide und im Handbuch CSM: Command and Technical Reference.

Parameter

Ressourcenklasse

Gibt den Namen der Ressourcenklasse an, die die Ressourcen enthält, die Sie stoppen möchten.

Ressourcenkennung

Gibt das Ressourcenhandle an, das der Ressource entspricht, die Sie stoppen möchten. Verwenden Sie den Befehl lsrsrc , um eine Liste gültiger Ressourcenkennungen abzurufen. Das Ressourcenhandle muss in doppelte Anführungszeichen eingeschlossen werden, z. B.:

"0x4017 0x0001 0x00000000 0x0069684c 0x0d4715b0 0xe9635f69"

arg=wert

Gibt ein oder mehrere Paare von Befehlsargumentnamen und -werten an.

Argument: Gibt den Argumentnamen an.
Wert: Gibt den Wert für dieses Argument an. Der Datentyp des Werts muss mit der Definition des Argumentdatentyps übereinstimmen.

Befehlsargumente sind optional. Wenn arg=value -Paare eingegeben werden, muss für jedes Befehlsargument, das für die Offlinefunktion für die angegebene Ressourcenklasse definiert ist, ein Paar arg=value vorhanden sein.

Verwenden Sie resetrsrc -l , um eine Liste der Befehlsargumentnamen und Datentypen für die spezifische Ressourcenklasse abzurufen.

Flags

--f ressourcen_daten_eingabe_datei

Gibt den Namen der Datei an, die Ressourceninformationen für Argumente enthält. Der folgende Inhalt der Datei wird angezeigt:

PersistentResourceArguments::                            
argument1 = value1                                    
argument2 = value2

-l

Listet die Befehlsargumente und Datentypen auf. Einige Ressourcenmanager akzeptieren zusätzliche Argumente, die an die Offlineanforderung übergeben werden. Verwenden Sie dieses Flag, um alle definierten Befehlsargumente und die Datentypen der Befehlsargumentwerte aufzulisten.

--N { node_file │ "-" }

Gibt an, dass die Knotennamen aus einer Datei oder aus der Standardeingabe gelesen werden. Verwenden Sie -N Knotendatei , um anzugeben, dass sich die Knotennamen in einer Datei befinden.

In der Knotendatei wird ein Knotenname pro Zeile aufgelistet.
Ein Nummernzeichen (#) in Spalte 1 gibt an, dass die Zeile ein Kommentar ist.
Alle Leerzeichen vor einem Knotennamen werden ignoriert
Alle Zeichen nach einem Knotennamen werden ignoriert.

Verwenden Sie -N "-" , um die Knotennamen aus der Standardeingabe zu lesen.

Die Umgebungsvariable CT_MANAGEMENT_SCOPE legt den Bereich des Clusters fest. Wenn CT_MANAGEMENT_SCOPE nicht definiert ist, wird zuerst der Managementdomänenbereich ausgewählt (sofern eine Managementdomäne vorhanden ist), dann der Peerdomänenbereich ausgewählt (sofern eine Peerdomäne vorhanden ist) und dann der lokale Bereich ausgewählt, bis der Bereich für den Befehl gültig ist. Der Befehl wird einmal für den ersten gültigen Bereich ausgeführt, der gefunden wird. Wenn eine Managementdomäne und eine Peerdomäne vorhanden sind und CT_MANAGEMENT_SCOPE nicht definiert ist, gilt dieser Befehl für die Managementdomäne. Wenn dieser Befehl auf die Peerdomäne angewendet werden soll, setzen Sie CT_MANAGEMENT_SCOPE auf 2.

-r

Erzwingt, dass die Ressource, die dem angegebenen Ressourcenhandle entspricht, gestoppt wird.

--s"auswahl_string"

Gibt die Auswahlzeichenfolge an. Alle Auswahlzeichenfolgen müssen in doppelte oder einfache Anführungszeichen eingeschlossen werden. Wenn die Auswahlzeichenfolge doppelte Anführungszeichen enthält, schließen Sie die gesamte Auswahlzeichenfolge in einfache Anführungszeichen ein. Beispiel:

           
-s 'Name == "testing"'                                   
           
-s 'Name ?= "test"'

In einer Auswahlzeichenfolge können nur persistente Attribute aufgelistet werden.

-h

Schreibt den Verwendungshinweis für diesen Befehl in die Standardausgabe.

-T

Schreibt die Tracenachrichten des Befehls in die Standardfehlerausgabe. Diese Option ist nur für Ihre Software-Service-Organisation bestimmt.

-V

Schreibt die ausführlichen Nachrichten des Befehls (sofern vorhanden) in die Standardausgabe.

Umgebungsvariablen

CT_CONTACT

Wenn die Umgebungsvariable CT_CONTACT auf einen Hostnamen oder eine IP-Adresse gesetzt wird, stellt der Befehl eine Verbindung zum RMC-Dämon (Resource Monitoring and Control, Ressourcenüberwachung und -steuerung) auf dem angegebenen Host her. Wenn die Umgebungsvariable nicht gesetzt wird, stellt der Befehl eine Verbindung zum RMC-Dämon auf dem lokalen System her, auf dem der Befehl ausgeführt wird. Die Ressourcenklasse oder Ressourcen, die vom Befehl angezeigt oder geändert werden, befinden sich auf dem System, auf dem die Verbindung hergestellt wird.

CT_IP_AUTHENT

Wenn die Umgebungsvariable CT_IP_AUTHENT vorhanden ist, verwendet der RMC-Dämon die IP-basierte Netzauthentifizierung, um die Verbindung zum RMC-Dämon auf dem System herzustellen, das mit der IP-Adresse angegeben ist, auf die die Umgebungsvariable CT_CONTACT gesetzt ist. CT_IP_AUTHENT ist nur von Bedeutung, wenn CT_CONTACT auf eine IP-Adresse gesetzt ist. Diese Umgebungsvariable stützt sich nicht auf den DNS-Service (Domain Name System).

CT_MANAGEMENT_SCOPE

Bestimmt den Managementbereich, der für die Sitzung mit dem RMC-Dämon verwendet wird, um die Ressourcen und Ressourcenklassen zu überwachen und zu steuern. Der Managementbereich bestimmt die Gruppe möglicher Zielknoten, auf denen die Ressourcen und Ressourcenklassen überwacht und gesteuert werden können. Die gültigen Werte sind im Folgenden beschrieben:

0: Gibt den lokalen Bereich an.
1: Gibt den lokalen Bereich an.
2: Gibt den Peerdomänenbereich an.
3: Gibt den Managementdomänenbereich an.

Wenn diese Umgebungsvariable nicht gesetzt ist, wird der lokale Bereich verwendet.

Standardausgabe

Wenn das Flag -h angegeben ist, wird dieser Verwendungshinweis für den Befehl in die Standardausgabe geschrieben. Wenn das Flag -V angegeben ist, werden ausführliche Nachrichten zu diesem Befehl (sofern verfügbar) in die Standardausgabe geschrieben.

Standardfehler

Alle Tracenachrichten werden in die Standardfehlerausgabe geschrieben.

Exitstatus

0: Der Befehl wurde erfolgreich ausgeführt.
1: Es ist ein Fehler in RMC aufgetreten.
2: Bei der Ausführung des CLI-Scripts (Command-Line Interface, Befehlszeilenschnittstelle) ist ein Fehler aufgetreten.
3: In der Befehlszeile wurde ein falsches Flag angegeben.
4: In der Befehlszeile wurde ein falscher Parameter angegeben.
5: Es ist ein Fehler in RMC aufgetreten, der auf eine falsche Eingabe in der Befehlszeile zurückzuführen ist.
6: Es wurden keine Ressourcen gefunden, die mit der angegebenen Auswahlzeichenfolge übereinstimmen.

Sicherheit

Sie benötigen Schreibberechtigung für die Ressourcenklasse , die in resetrsrc angegeben ist, um resetrsrcauszuführen. Berechtigungen werden in der ACL-Datei (Access Control List) auf dem kontaktierten System angegeben. Informationen zur ACL-Datei und zu deren Änderung finden Sie in der Veröffentlichung Administering RSCT.

Implementierungsspezifikationen

Dieser Befehl ist Teil der Dateigruppe rsct.core.rmc für AIX® und rsct.core-3.1.0.0-0.-Plattform.rpm -Paket für Linux®, Solaris und Windows, wobei -Plattform i386, ppc, ppc64, s390oder x86_64ist.

Position

/opt/rsct/bin/resetrsrc

Beispiele

Angenommen, Sie haben eine Peerdomäne mit dem Namen foo und drei definierten Knoten: nodeA, nodeBund nodeC. nodeA verfügt über zwei Ethernet-Karten: ent0 und ent1.

Angenommen, nodeA ist online und ent0 (unter nodeA) ist ebenfalls online. Um ent0 offline unter nodeAzu erzwingen, führen Sie den folgenden Befehl unter nodeAaus:
```
resetrsrc -s 'Name == "ent0"' IBM.EthernetDevice
```
Angenommen, nodeA und nodeB sind online, ent0 (unter nodeA) ist ebenfalls online und Sie sind momentan bei nodeBangemeldet. Um ent0 offline unter nodeAzu erzwingen, führen Sie den folgenden Befehl unter nodeBaus:
```
resetrsrc -s 'NodeName == "nodeA" AND Name == "ent0"' IBM.EthernetDevice
```
Angenommen, nodeA und nodeB sind online und das Dateisystem /filesys1 ist definiert und an nodeBangehängt. Um /filesys1 offline unter nodeBzu erzwingen, führen Sie den folgenden Befehl unter nodeAaus:
```
resetrsrc -s 'NodeName == "nodeB" AND Name == "/filesys1"' IBM.FileSystem
```
Angenommen, das Ressourcenhandle für ent0 unter nodeA lautet wie folgt:
```
0x406b 0x0001 0x00000000 0x0069564c 0x0dc1f272 0xb9de145e   
```
Um ent0 offline unter nodeAzu erzwingen, führen Sie den folgenden Befehl unter nodeAaus:
```
resetrsrc -r "0x406b 0x0001 0x00000000 0x0069564c 0x0dc1f272 0xb9de145e"
```
Gehen Sie wie folgt vor, um ent0 unter nodeA und nodeBmithilfe der Datei /tmp/common/node_file zurückzusetzen:
```
# common node file
#
nodeA
nodeB
#
```
als Eingabe zu ändern:
```
resetrsrc -s 'Name == "ent0"' -N /tmp/common/node_file \
IBM.EthernetDevice
```