Befehl "mkresponse"

Zweck

Erstellt eine neue Antwortdefinition.

Syntax

eine Antwort ohne Aktionen erstellen:

mkresponse [ -b ] <-p Knotenname] [-h] [-TV] Antwort

Antwort mit einer Aktion erstellen:

mkresponse -n Aktion [ -d Wochentage[,Wochentage… ] ] [ -t. Tageszeit[,Tageszeit… ] ] -s Aktionsscript [ -r Rückkehrcode ] [ -b | [ -e a | A | B | E | R ] ] [ -o ] [ -E env_var (Umgebungsvariable)=Wert[,env_var (Umgebungsvariable)=Wert... ] ] [-u] [ -p Knotenname ] [-h] [-TV] Antwort

Antwort kopieren:

mkresponse -c existing_response[:Knotenname] [-p Knotenname] [-h] [-TV] Antwort

Beschreibung

Der Befehl mkresponse erstellt eine neue Antwortdefinition mit dem mit dem Parameter Antwort angegebenen Namen. Eine Aktion kann auch angegeben werden, wenn die Antwort definiert ist. Aktionen definieren Befehle, die ausgeführt werden sollen, wenn die Antwort mit einer Bedingung verwendet wird und die Bedingung eintritt. Die Aktion definiert die Wochentage, an denen die Aktion verwendet werden kann, die Uhrzeit an diesen Wochentagen, zu der das Script oder der Befehl ausgeführt werden soll, den Ereignistyp, bei dem der Befehl ausgeführt werden soll, den erwarteten Rückgabecode des Scripts oder Befehls und die Einstellung für die Beibehaltung der Standardausgabe. Die Tage und Zeiten werden paarweise angegeben, sodass unterschiedliche Zeiten für verschiedene Tage angegeben werden können. Eine Antwort ohne Aktionen protokolliert nur die Ereignisse.

Verwenden Sie das Flag -b, um anzugeben, dass die Antwort und alle Aktionen, die in dieser Antwort definiert werden sollen, Ereignisstapel unterstützen. Bei Ereignisstapel können mehrere mehrere Ereignisse zusammengefasst oder gruppiert und so an eine Antwort übergeben werden. Die Aktionen der Antwort werden an eine Datei weitergeleitet, die die Details zu den Stapelereignissen enthält. Eine Antwort, die Ereignisstapel unterstützt, kann nur für Bedingungen verwendet werden, die angeben, dass die Ereignisse in Stapeln zusammengefasst werden sollen. Das Flag -b kann nicht zusammen mit dem Flag -e angegeben werden.

Verwenden Sie in einer Clusterumgebung das Flag -p , um den Knoten in der Domäne anzugeben, der die Antwortdefinition enthalten soll. Wenn Sie mkresponse auf dem Management-Server verwenden und die Antwort auf dem Management-Server definiert werden soll, geben Sie das Flag -p nicht an. Wenn das Flag -p nicht angegeben ist, wird die Antwort auf dem lokalen Knoten definiert.

Mit dem Befehl chresponse können Sie einer Antwort Aktionen hinzufügen oder Aktionen aus einer Antwort entfernen. Verwenden Sie den Befehl startcondresp, um die Überwachung zu starten. Der Befehl startcondresp verlinkt eine Antwort mit einer Bedingung, sofern sie nicht bereits verlinkt ist.

Um eine Antwort zu sperren, sodass sie nicht geändert oder entfernt werden kann, verwenden Sie den Befehl chresponse mit dem Flag -L .

Flags

-b

Gibt an, dass die Antwort und alle Aktionen, die in dieser Antwort definiert werden sollen, Ereignisstapel unterstützen. Bei Ereignisstapel können mehrere mehrere Ereignisse zusammengefasst oder gruppiert und so an eine Antwort übergeben werden. Die Aktionen der Antwort werden an eine Datei weitergeleitet, die die Details zu den Stapelereignissen enthält. Eine Antwort, die Ereignisstapel unterstützt, kann nur für Bedingungen verwendet werden, die angeben, dass die Ereignisse in Stapeln zusammengefasst werden sollen.

Eine Ereignisantwort kann für gestapelte Ereignisbedingungen ohne Aktionsscript erstellt werden.

Das Flag -b kann nicht zusammen mit dem Flag -e angegeben werden.

--c vorhandene_Antwort[:node_name]

Kopiert eine vorhandene Antwort. Links mit Bedingungen werden nicht kopiert. Die vorhandene Antwort wird auf dem Knoten definiert, der als Knotennamein einem Cluster. Wenn Sie Knotenname nicht angeben, wird der lokale Knoten verwendet. Knotenname steht für einen Knoten in dem mit der Umgebungsvariablen CT_MANAGEMENT_SCOPE festgelegten Geltungsbereich. Wenn andere Flags angegeben sind, aktualisieren Sie die neue Antwort entsprechend den Flags.

--d tage_der_woche

Gibt die Wochentage an, an denen die zu definierende Aktion ausgeführt werden kann. Wochentage und Uhrzeit definieren zusammen das Intervall, in dem die Aktion ausgeführt werden kann.

Geben Sie die Anzahl der Tage getrennt durch ein Pluszeichen (+) oder einen Bereich von Tagen getrennt durch einen Bindestrich (-) ein. Es können mehrere Parameter Wochentage angegeben werden, die Parameter müssen jedoch durch Kommata (,) voneinander getrennt werden. Die Anzahl der angegebenen Wochentage-Parameter muss mit der Anzahl der angegebenen Tageszeit-Parameter übereinstimmen. Standardmäßig werden alle Tage angegeben. Wenn Sie keinen Wert, sondern ein Komma eingeben, wird der Standardwert verwendet. Im Folgenden sind die Werte für die einzelnen Tage aufgelistet:

1

Sonntag

2

Montag

3

Dienstag

4

Mittwoch

5

Donnerstag

6

Freitag

7

Samstag

-e a | A | b | e | r

Gibt den Ereignistyp an, bei dem die zu definierende Aktion ausgeführt werden soll:

a

Gibt ein Ereignis an. Dies ist die Standardeinstellung.

A

Gibt einen beliebigen Ereignistyp an (Ereignis, Fehlerereignis oder Reaktivierungsereignis).

b

Gibt ein Ereignis und ein Reaktivierungsereignis an.

e

Gibt ein Fehlerereignis an.

r

Gibt ein Reaktivierungsereignis an.

Sie können mehrere Ereignistypen angeben, z. B. -e ae. Das Flag -e kann nicht zusammen mit dem Flag -b angegeben werden.

-E umgebungsvariable=wert[,umgebungsvariable=wert...]

Gibt alle Umgebungsvariablen an, die vor der Ausführung der Aktion festgelegt werden sollen. Wenn mehrere Variablen env_var=wert angegeben werden, müssen sie durch Kommas getrennt werden.

--n Aktion

Gibt den Namen der definierten Aktion an. Beim Erstellen der Antwort kann nur eine Aktion definiert werden. Mit dem Befehl chresponse können Sie weitere Aktionen zur Antwort hinzufügen.

-o

Leitet alle Standardausgaben von Aktionsscript an das Prüfprotokoll weiter. Standardmäßig wird die Standardausgabe nicht beibehalten. Die Standardfehlerausgabe wird immer an das Prüfprotokoll gesendet.

--p knoten_name

Gibt den Namen des Knotens an, auf dem die Antwort definiert ist. Dieses Flag wird in einer Clusterumgebung verwendet und der Knotenname ist der Name, unter dem der Knoten in der Domäne bekannt ist. Standardmäßig wird als Knotenname der lokale Knoten verwendet, auf dem der Befehl ausgeführt wird. Knotenname steht für einen Knoten in dem mit der Umgebungsvariablen CT_MANAGEMENT_SCOPE festgelegten Geltungsbereich.

Wenn Sie mkresponse auf dem Management-Server verwenden und die Antwort auf dem Management-Server definiert werden soll, geben Sie nicht das Flag -p an.

--r return_code

Gibt den erwarteten Rückgabecode für Aktionsscripts an. Wenn der erwartete Rückkehrcode angegeben ist, wird der tatsächliche Rückkehrcode von action_scriptwird mit dem erwarteten Rückkehrcode verglichen. Es wird eine Nachricht in das Prüfprotokoll geschrieben, in der angezeigt wird, ob die Codes übereinstimmen. Wenn das Flag -r nicht angegeben ist, wird der tatsächliche Rückkehrcode in das Prüfprotokoll geschrieben und es wird kein Vergleich durchgeführt.

--s action_script

Gibt den vollständig qualifizierten Pfad für das Script oder den Befehl an, das bzw. der für die zu definierende Aktion ausgeführt werden soll. Beschreibungen der vordefinierten Antwortscripts, die mit der Anwendung bereitgestellt werden, finden Sie in den Abschnitten logevent, notifyeventund wallevent .

--t tageszeit

Gibt den Zeitraum an, in dem Aktion ausgeführt werden kann. Zur Angabe eines Zeitraums müssen die Startzeit und die Endzeit mit einem Minuszeichen dazwischen angegeben werden. Wochentage und Uhrzeit definieren zusammen das Intervall, in dem die Aktion ausgeführt werden kann.

Die Uhrzeit ist im 24-Stunden-Format (HHMM) angegeben, wobei die ersten beiden Ziffern die Stunde und die letzten zwei Ziffern die Minuten darstellen. Der Wert für die Startzeit muss kleiner als Wert für die Endzeit sein, da diese Werte pro angegebenem Wochentag gelten. Es können mehrere Parameter Tageszeit angegeben werden, die Parameter müssen jedoch durch Kommata (,) voneinander getrennt werden. Die Anzahl der angegebenen Wochentage-Parameter muss mit der Anzahl der angegebenen Tageszeit-Parameter übereinstimmen. Der Standardwert ist 0000-2400. Wenn Sie keinen Wert, sondern ein Komma eingeben, wird der Standardwert verwendet.

-u

Gibt an, dass die Aktion ausgeführt werden soll, wenn die Definition einer überwachten Ressource aufgehoben wird.

-h

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

-T

Schreibt die Tracenachrichten des Befehls in die Standardfehlerausgabe. Dieses Flag ist nur für die Verwendung durch Ihre Software-Service-Organisation bestimmt.

-V

Schreibt die ausführlichen Nachrichten des Befehls in die Standardausgabe.

Parameter

Sicherheit

Der Benutzer benötigt Schreibberechtigung für die IBM.EventResponse -Ressourcenklasse, um mkresponseausführen zu können. Berechtigungen werden in der ACL-Datei (Access Control List) auf dem kontaktierten System angegeben. Einzelheiten zur ACL-Datei und deren Änderung finden Sie in der Veröffentlichung Administering RSCT.

Exitstatus

0

Der Befehl wurde erfolgreich ausgeführt.

1

Es ist ein Fehler in RMC aufgetreten.

2

Es ist ein Fehler in einem Befehlszeilenschnittstellenscript aufgetreten.

3

In der Befehlszeile wurde ein ungültiges Flag eingegeben.

4

In der Befehlszeile wurde ein falscher Parameter eingegeben.

5

Es ist ein Fehler aufgetreten, der auf eine ungültige Eingabe in der Befehlszeile zurückzuführen ist.

Umgebungsvariablen

CT_CONTACT

Bestimmt das System, auf dem die Sitzung mit dem RMC-Dämon (Resource Monitoring and Control) ausgeführt wird. Wenn CT_CONTACT auf einen Hostnamen oder eine IP-Adresse gesetzt ist, stellt der Befehl eine Verbindung zum RMC-Dämon auf dem angegebenen Host her. Wenn CT_CONTACT nicht gesetzt ist, stellt der Befehl eine Verbindung zum RMC-Dämon auf dem lokalen System, auf dem der Befehl ausgeführt wird, her. Das Ziel der RMC-Dämonsitzung und der Managementbereich bestimmen die Ressourcenklassen bzw. die Ressourcen, die verarbeitet werden.

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

Legt den Managementbereich fest, der für die Sitzung mit dem RMC-Dämon bei der Verarbeitung der Ressourcen des ERRM (Event-Response Resource Manager, Ressourcenmanager für Ereignisse und Antworten) verwendet wird. Der Managementbereich bestimmt die Gruppe der möglichen Zielknoten, auf denen die Ressourcen verarbeitet 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. Alle ausführlichen Nachrichten werden in die Standardausgabe geschrieben.

Standardfehlerausgabe

Alle Tracenachrichten werden in die Standardfehlerausgabe geschrieben.

Beispiele

Position

/opt/rsct/bin/mkresponse