Befehl "runact"

Online bearbeiten

Zweck

Führt eine Aktion für eine Ressourcenklasse aus.

Syntax

runact -s "Auswahlzeichenfolge" [ -N { Knotendatei │ "-" } ] [-f Eingabedatei für Ressourcendaten] [-l │ -t │ -d │ -D Begrenzer] [-x] [-h] [-TV] resource_class (Aktion) [in_Element=Wert…] [rsp_element...]

runact -r [-f Eingabedatei für Ressourcendaten] [-l | -t | -d | -D Begrenzer] [-x] [-h] [-TV] resource_handle action [in_element=wert...] [rsp_element...]

runact -c [-f Eingabedatei für Ressourcendaten] [-n Knotenname] [-l | -t | -d | -D Begrenzer] [-x] [-h] [-TV] resource_class action [in_element=wert...] [rsp_element...]

runact -C Domänenname... [-f Eingabedatei für Ressourcendaten] [-l │ -t │ -d │ -D Begrenzer] [-x] [-h] [-TV] resource_class (Aktion) [in_Element=Wert…] [rsp_element...]

Beschreibung

Der Befehl runact fordert an, dass das RMC-Subsystem die angegebene Aktion für die angegebene Ressourcenklasse ausführt.

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.

Bevor Sie diesen Befehl ausführen, verwenden Sie den Befehl lsactdef , um die Ressourcenklassenaktionen aufzulisten, die von dieser Ressourcenklasse unterstützt werden. Verwenden Sie außerdem den Befehl lsactdef , um die erforderlichen Eingabeaktionselemente aufzulisten, die beim Aufruf einer Aktion angegeben werden müssen. Der Befehl lsactdef gibt auch den Datentyp für jedes Eingabeelement an. Der für jedes Eingabeelement angegebene Wert muss mit diesem Datentyp übereinstimmen.

Flags

-c
Ruft die Aktion für die Ressourcenklasse auf.

Wenn Sie die Klassenaktion für eine globalisierte Ressourcenklasse in allen auf dem Management-Server definierten Peerdomänen aufzurufen, setzen Sie die Umgebungsvariable CT_MANAGEMENT_SCOPE=3 und verwenden Sie das Flag -c.

--C domain_name..
Ruft eine Klassenaktion für eine globalisierte Ressourcenklasse in einer oder mehreren RSCT-Peerdomänen auf, die auf dem Management-Server definiert sind. Globalisierte Klassen werden in Peerdomänen und Managementdomänen für Ressourcenklassen verwendet, die Informationen über die Domäne enthalten.
--f ressourcen_daten_eingabe_datei
Gibt den Namen der Datei an, die Eingabeelemente und Werte für Ressourcenaktionen enthält. Verwenden Sie den Befehl lsactdef mit dem Flag -i , um eine Vorlage für diese Eingabedatei zu erstellen.
-d
Gibt eine Ausgabe mit Begrenzern an. Der Standardbegrenzer ist ein Doppelpunkt (:). Verwenden Sie das Flag -D , um den Standardbegrenzer zu ändern.
--D Begrenzer
Gibt eine formatierte Ausgabe mit dem angegebenen Begrenzer an. Verwenden Sie dieses Flag, um einen anderen Begrenzer als den Standarddoppelpunkt (:) anzugeben, z. B., wenn die angezeigten Daten Doppelpunkte enthalten. Verwenden Sie dieses Flag, um einen aus einem oder mehreren Zeichen bestehenden Begrenzer anzugeben.
-l
Gibt das Langformat an, in dem ein Eintrag pro Zeile angezeigt wird. Dies ist das Standardanzeigeformat.
-n Knotenname
Gibt den Namen des Knotens an, auf dem die Klassenaktion ausgeführt werden soll. Sie können dieses Flag nur zusammen mit dem Flag -c verwenden.
--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 "Ressourcenhandle"
Gibt ein Ressourcenhandle an. Das Ressourcenhandle muss im folgenden Format angegeben werden:
"0xnnnn 0xnnnn 0xnnnnnnnn 0xnnnnnnnn 0xnnnnnnnn 0xnnnnnnnn"
Das "n" steht für ein Hexadezimalzeichen. Verwenden Sie dieses Flag, um die Aktion für die mit Ressourcenhandle übereinstimmende Ressource aufzurufen.
-s "Auswahlzeichenfolge"
Gibt eine 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. Informationen zur Angabe von Auswahlzeichenfolgen finden Sie in der Veröffentlichung Administering RSCT.
-t
Gibt das Tabellenformat an. Jedes Attribut wird in einer separaten Spalte mit einer Ressource pro Zeile angezeigt.
-x
Unterdrückt die Ausgabe von Überschriften.
-h
Schreibt den Verwendungshinweis für den Befehl in die Standardausgabe.
-T
Schreibt die Tracenachrichten des Befehls in die Standardfehlerausgabe. Dieses Flag ist ausschließlich für die Verwendung durch die Software-Service-Organisation bestimmt.
-V
Schreibt die ausführlichen Nachrichten des Befehls in die Standardausgabe.

Parameter

Aktion
Gibt den Namen der aufzurufenden Aktion an.
in_element=wert...
Gibt die Namen und Werte der Namen der Aktionseingabeelemente an. Wenn Sie das Flag -f verwenden, geben Sie keine in_element=Wert -Paare in der Befehlszeile ein.

Eingabeelement steht für einen der Namen der eingegebenen strukturierten Datenelemente. Es sollte ein Paar in_element_n=Wert für jedes der definierten Eingabeelemente für strukturierte Daten (SD) für die angegebene Aktion geben. Verwenden Sie lsactdef mit dem Flag -s i , um die Eingabeelemente für eine bestimmte Ressourcenklasse und Aktion aufzulisten. Verwenden Sie lsactdef -i , um eine Eingabedateivorlage zu generieren, die nach entsprechender Bearbeitung als Eingabedatei verwendet werden kann.

Wert muss der geeignete Datentyp für das angegebene Element sein. Wenn NodeNumber beispielsweise als Datentyp uint32 definiert ist, geben Sie einen positiven numerischen Wert ein.

Ressourcenklasse
Gibt den Namen der Ressourcenklasse mit den Aktionen an, die Sie aufrufen möchten.
Ressourcenkennung
Gibt das Ressourcenhandle für die Ressource und die Klasse mit den Aktionen an, die Sie aufrufen möchten.
rsp_element
Gibt einen oder mehrere Namen von strukturierten Datenelementen für die Aktionsantwort an. Wenn Sie einen oder mehrere Elementnamen angeben, werden nur diese Elemente in der angegebenen Reihenfolge angezeigt. Wenn Sie keine Elementnamen angeben, werden alle Elemente der Antwort angezeigt.

Sicherheit

Für diesen Befehl ist die Berechtigung root erforderlich.

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.

Umgebungsvariablen

CT_CONTACT
Wenn die Umgebungsvariable CT_CONTACT auf einen Hostnamen oder eine IP-Adresse gesetzt ist, kontaktiert der Befehl den RMC-Dämon (Resource Monitoring and Control) auf dem angegebenen Host. 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, zu dem die Verbindung aufgebaut 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. Die Umgebungsvariable CT_IP_AUTHENT hat nur Bedeutung, wenn CT_CONTACT auf eine IP-Adresse gesetzt ist. Sie stützt sich nicht auf den DNS-Service (Domain Name System, Domänennamensservice).
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.

Implementierungsspezifikationen

Dieser Befehl ist Teil des RSCT-Dateisets (Reliable Scalable Cluster Technology ) für AIX®.

Standardausgabe

Wenn das Flag -h angegeben ist, wird der Verwendungshinweis für diesen Befehl in die Standardausgabe geschrieben.

Die Befehlsausgabe und alle ausführlichen Nachrichten werden in die Standardausgabe geschrieben.

Standardfehlerausgabe

Alle Tracenachrichten werden in die Standardfehlerausgabe geschrieben.

Beispiele

  1. Um die Ressourcenklassenaktion TestClassAction für die Ressourcenklasse " IBM.Example aufzurufen, geben Sie ein:
    runact -c IBM.Example TestClassAction Int32=99
    Die Ausgabe gleicht der folgenden:
    Resource Class Action Response for: TestClassAction
sd_element 1:
   Int32 = 99

Position

/opt/rsct/bin/runact
Enthält den Befehl runact