WebSphere Virtual Enterprise, Version 6.1.1
             Betriebssysteme: AIX, HP-UX, Linux, Solaris, Windows,


Verwaltungs-Tasks für Vitalitätsrichtlinien

Verwenden Sie die folgenden Verwaltungs-Tasks, um Vitalitätsrichtlinien zu erstellen, zu löschen und zu verwalten.

Befehl "createHealthPolicy"

Der Befehl "createHealthPolicy" erstellt eine neue Vitalitätsrichtlinie.
Tabelle 1. Argumente für den Befehl "createHealthPolicy"
Argument Beschreibung
name (erforderlich) Gibt einen in der Zelle eindeutigen Namen für die Vitalitätsrichtlinie an.
description Gibt eine Beschreibung für die Vitalitätsrichtlinie an.
reactionMode Gibt an, ob Laufzeit-Tasks erstellt werden, bevor Aktionen für eine Vitalitätsrichtlinie ausgeführt werden, oder ob die Aktionen automatisch ausgeführt werden. Die gültigen Werte sind SUPERVISE und AUTOMATIC.
Tabelle 2. Argumente für den Schritt addCondition
Argument Beschreibung
type (erforderlich) Gibt den Bedingungstyp an. Die gültigen Werte sind CUSTOM, AGE, WORKLOAD, MEMORY_LEAK, EXCESSIVE_MEMORY, EXCESSIVE_RESPONSE_TIME, EXCESSIVE_REQUEST_TIMEOUT und STORM_DRAIN. Jeder Wert hat andere Parameter, die Sie angeben müssen.
Ausdruck Wenn Sie eine angepasste Bedingung verwenden, müssen Sie einen auszuwertenden Unterausdruck angeben.
Parameter
  • AGE
    • maxAge: Gibt das maximale Alter an.
    • ageUnits: Gibt den Einheitentyp für den Parameter "age" an. Die gültigen Werte sind HOURS und MINUTES. Der Standardwert ist HOURS.
  • WORKLOAD
    • totalRequests: Gibt die Gesamtanzahl zu bearbeitender Anforderungen vor dem Neustart der Member an. Die Zahl muss größer-gleich 1000 sein.
  • MEMORY_LEAK
    • level: Gibt die Erkennungsstufe für den Speicherverlust an. Die gültigen Werte sind FAST, NORMAL und CONSERVATIVE. Der Standardwert ist FAST.
  • EXCESSIVE_MEMORY
    • timeOverThreshold: Gibt den Nichteinhaltungszeitraum für die Bedingung für überhöhte Speicherbelegung an.
    • timeUnits: Gibt die Einheiten für den timeOverThreshold-Wert an. Die gültigen Werte sind MINUTES und SECONDS. Der Standardwert ist MINUTES.
    • memoryUsed: Gibt einen Prozentsatz an, der die maximale Größe des JVM-Heap-Speichers (Java Virtual Machine) für den JVM-Prozess darstellt. Die gültigen Werte sind 1 bis 99.
  • EXCESSIVE_RESPONSE_TIME
    • responseTime: Gibt die durchschnittliche Antwortzeit an, die als unangemessen eingestuft wird. Wenn der Durchschnittswert diesen Grenzwert erreicht, werden die Member erneut gestartet.
    • responseTimeUnits: Gibt die Zeiteinheiten für die Antwortzeit an. Die gültigen Wert sind MINUTES, SECONDS und MILLISECONDS.
  • EXCESSIVE_REQUEST_TIMEOUT
    • Gibt den Schwellenwert für den Prozentsatz der Zeitlimitüberschreitungen an, der zu einem Verstoß gegen eine Bedingung verursacht hat. Die gültigen Werte sind 1 bis 99.
  • STORM_DRAIN
    • level: Gibt die Erkennungsstufe an. Die gültigen Werte sind NORMAL und CONSERVATIVE. Bei der Erkennungsstufe NORMAL sind die Werte zwar weniger genau, aber Eskalationsbedingungen werden schnell erkannt. Die Erkennungsstufe CONSERVATIVE liefert die genauesten Werte, aber es dauert länger, bis Eskalationsbedingungen erkannt werden.
Tabelle 3. Argumente für den Schritt addAction.

Verwenden Sie die Argumente für den Schritt addAction im Tabellenformat. Beim Tabellenformat geben Sie die Parameter nacheinander ohne den Parameternamen an.

Argument Beschreibung
type (erforderlich) Gibt den Aktionstyp an. Die gültigen Werte sind CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK und MAINT_MODE_STOP.
stepNum (erforderlich) Gibt die Reihenfolge an, in der die Aktionen ausgeführt werden sollen. Schritt 1 wird zuerst ausgeführt usw.
action Gibt den Namen einer angepassten Aktion an. Verwenden Sie den Befehl "createHealthAction", um eine angepasste Aktion zu erstellen.
node Gibt den Knoten an, auf dem die Aktion ausgeführt werden soll.
server Gibt den Server an, auf dem die Aktion ausgeführt werden soll.
Tabelle 4. Argumente für den Schritt addMember.

Verwenden Sie die Argumente für den Schritt addMember im Tabellenformat. Beim Tabellenformat geben Sie die Parameter nacheinander ohne den Parameternamen an.

Argument Beschreibung
type (erforderlich) Gibt den Member-Typ an. Die gültigen Werte sind CELL, CLUSTER, DYNAMIC_CLUSTER, SERVER und ODR.
name (erforderlich) Gibt den Namen des Members an.
node Gibt den Namen des Knotens an. Der Knotenname ist erforderlich, wenn Sie den Typ SERVER auswählen.

Beispiel

Verwendungsbeispiel für Dialogmodus:

Verwendungsbeispiel für Stapelbetrieb:

Der folgende Befehl erstellt eine Vitalitätsrichtlinie mit einer der vordefinierten Vitalitätsbedingungen:

$AdminTask createHealthPolicy { -name myHealthPolicy -description "My Health Policy" -reactionMode SUPERVISE 
-addCondition { -type AGE -params {{maxAge 12} {ageUnits HOURS}} } -addAction {{HEAPDUMP 1}{CUSTOM 2 myAction 
myNode myServer} } -addMember {SERVER myServer myNode} }

Der folgende Befehl erstellt eine Vitalitätsrichtlinie mit einer angepassten Bedingung:

$AdminTask createHealthPolicy { -name myHealthPolicy -description "My Health Policy" -reactionMode SUPERVISE 
-addCondition { -type CUSTOM -expression "ODRServerMetric_FromServerStart$errors  > 100L"  } 
-addAction {{HEAPDUMP 1}{CUSTOM 2 myAction myNode myServer} } -addMember {SERVER myServer myNode} }
Setzen Sie den Ausdruck für Ihre angepasste Bedingung in Anführungszeichen.

Befehl "modifyHealthPolicy"

Der Befehl "modifyHealthPolicy" ändert eine vorhandene Vitalitätsrichtlinie.
Tabelle 5. Anfangsargumente
Argument Beschreibung
name (erforderlich) Gibt den Namen der zu ändernden Vitalitätsrichtlinie an.
reactionMode Gibt an, ob Laufzeit-Tasks erstellt werden, bevor Aktionen für eine Vitalitätsrichtlinie ausgeführt werden, oder ob die Aktionen automatisch ausgeführt werden. Die gültigen Werte sind SUPERVISE und AUTOMATIC.
Tabelle 6. Argumente für den Schritt modifyCondition
Argument Beschreibung
type Gibt den Bedingungstyp an. Die gültigen Werte sind CUSTOM, AGE, WORKLOAD, MEMORY_LEAK, EXCESSIVE_MEMORY, EXCESSIVE_RESPONSE_TIME, EXCESSIVE_REQUEST_TIMEOUT und STORM_DRAIN. Jeder Wert hat andere Parameter, die Sie angeben müssen.
Ausdruck Wenn Sie eine angepasste Bedingung verwenden, müssen Sie einen auszuwertenden Unterausdruck angeben.
Parameter
  • AGE
    • maxAge: Gibt das maximale Alter an.
    • ageUnits: Gibt den Einheitentyp für den Parameter "age" an. Die gültigen Werte sind HOURS und MINUTES. Der Standardwert ist HOURS.
  • WORKLOAD
    • totalRequests: Gibt die Gesamtanzahl zu bearbeitender Anforderungen vor dem Neustart der Member an. Die Zahl muss größer-gleich 1000 sein.
  • MEMORY_LEAK
    • level: Gibt die Erkennungsstufe für den Speicherverlust an. Die gültigen Werte sind FAST, NORMAL und CONSERVATIVE. Der Standardwert ist FAST.
  • EXCESSIVE_MEMORY
    • timeOverThreshold: Gibt den Nichteinhaltungszeitraum für die Bedingung für überhöhte Speicherbelegung an.
    • timeUnits: Gibt die Einheiten für den timeOverThreshold-Wert an. Die gültigen Werte sind MINUTES und SECONDS. Der Standardwert ist MINUTES.
    • memoryUsed: Gibt einen Prozentsatz an, der die maximale Größe des JVM-Heap-Speichers (Java Virtual Machine) für den JVM-Prozess darstellt. Die gültigen Werte sind 1 bis 99.
  • EXCESSIVE_RESPONSE_TIME
    • responseTime: Gibt die durchschnittliche Antwortzeit an, die als unangemessen eingestuft wird. Wenn der Durchschnittswert diesen Grenzwert erreicht, werden die Member erneut gestartet.
    • responseTimeUnits: Gibt die Zeiteinheiten für die Antwortzeit an. Die gültigen Wert sind MINUTES, SECONDS und MILLISECONDS.
  • EXCESSIVE_REQUEST_TIMEOUT
    • Gibt den Schwellenwert für den Prozentsatz der Zeitlimitüberschreitungen an, der zu einem Verstoß gegen eine Bedingung verursacht hat. Die gültigen Werte sind 1 bis 99.
  • STORM_DRAIN
    • level: Gibt die Erkennungsstufe an. Die gültigen Werte sind NORMAL und CONSERVATIVE. Bei der Erkennungsstufe NORMAL sind die Werte zwar weniger genau, aber Eskalationsbedingungen werden schnell erkannt. Die Erkennungsstufe CONSERVATIVE liefert die genauesten Werte, aber es dauert länger, bis Eskalationsbedingungen erkannt werden.
Tabelle 7. Argumente für den Schritt removeAction
Argument Beschreibung
name Gibt den Namen der zu entfernenden Vitalitätsaktion an. Der Parameter "name" wird nur für angepasste Aktionen verwendet.
type (erforderlich) Gibt den Aktionstyp an. Die gültigen Werte sind CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK und MAINT_MODE_STOP.
Tabelle 8. Argumente für den Schritt addAction
Argument Beschreibung
type (erforderlich) Gibt den Aktionstyp an. Die gültigen Werte sind CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK und MAINT_MODE_STOP.
name Gibt den Namen der Vitalitätsaktion an. Der Parameter "name" wird nur für angepasste Aktionen verwendet.
node Gibt den Knoten an, auf dem die Aktion ausgeführt werden soll.
server Gibt den Server an, auf dem die Aktion ausgeführt werden soll.
stepNum (erforderlich) Gibt die Reihenfolge an, in der die Aktionen ausgeführt werden sollen. Schritt 1 wird zuerst ausgeführt usw.
Tabelle 9. Argumente für den Schritt orderAction
Argument Beschreibung
name Gibt den Namen der Vitalitätsaktion an. Der Parameter "name" wird nur für angepasste Aktionen verwendet.
type Gibt den Aktionstyp an. Die gültigen Werte sind CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK und MAINT_MODE_STOP.
stepNum (erforderlich) Gibt die Reihenfolge an, in der die Aktionen ausgeführt werden sollen. Schritt 1 wird zuerst ausgeführt usw.
Tabelle 10. Argumente für den Schritt addMember
Argument Beschreibung
type (erforderlich) Gibt den Member-Typ an. Die gültigen Werte sind CELL, CLUSTER, DYNAMIC_CLUSTER, SERVER und ODR.
name (erforderlich) Gibt den Namen des Members an.
node Gibt den Namen des Knotens an. Der Knotenname ist erforderlich, wenn Sie den Typ SERVER auswählen.

Beispiel

Verwendungsbeispiel für Dialogmodus: Verwendungsbeispiel für Stapelbetrieb:
$AdminTask modifyHealthPolicy { -name myHealthPolicy -removeAction { -type HEAPDUMP } }

Befehl "deleteHealthPolicy"

Der Befehl "deleteHealthPolicy" entfernt die angegebene Vitalitätsrichtlinie.
Tabelle 11. Argumente für den Befehl "deleteHealthPolicy"
Argument Beschreibung
name (erforderlich) Gibt den Namen der zu löschenden Vitalitätsrichtlinie an.

Beispiel

Verwendungsbeispiel für Stapelbetrieb: Verwendungsbeispiel für Dialogmodus:

Befehl "listHealthPolicies"

Der Befehl "listHealthPolicies" listet die konfigurierten Vitalitätsrichtlinien in der Zelle auf.

Beispiel

Befehl "createHealthAction"

Der Befehl "createHealthAction" erstellt eine neue Vitalitätsaktion, die Sie beim Definieren Ihrer Vitalitätsrichtlinien verwenden können.
Tabelle 12. Argumente für den Befehl "createHealthAction"
Argument Beschreibung
name (erforderlich) Gibt einen Namen für die Vitalitätsaktion an.
Sie können eine Java-Aktion oder eine Aktion mit jedem anderen Typ von ausführbarer Datei erstellen.
Tabelle 13. Argumente für einen Schritt ohne Java-Aktion
Argument Beschreibung
executable Gibt den Pfad der ausführbaren Datei an. Dieses Argument ist erforderlich, wenn Sie ein Argument für einen Schritt angeben, der kein Java-Schritt ist.
executableArgs Gibt einen Zeichenfolgebereich mit Argumenten an, die an die ausführbare Datei übergeben werden sollen.
osNames Gibt eine durch Kommas getrennte Liste mit Betriebssystemen an. Geben Sie null an, wenn die Aktion für jedes Betriebssystem ausgeführt werden soll. Die gültigen Betriebssystemnamen sind windows, unix und zos.
workingDir Gibt die Position der Datei im Dateisystem an, über die der Befehl aufgerufen wird. Dieses Argument ist erforderlich, wenn Sie ein Argument für einen Schritt angeben, der kein Java-Schritt ist.
usernameVar Gibt eine Variable für den Benutzernamen an.
userNameVal Gibt den Wert für die Benutzernamensvariable an.
passwordVar Gibt eine Variable für das Kennwort an.
passwordVal Gibt den Wert der Kennwortvariablen an.
Tabelle 14. Argumente für einen Java-Schritt
Argument Beschreibung
javaDir Gibt die Position der ausführbaren Java-Datei an, z. B. ${JAVA_HOME}. Sie können eine Variable oder einen Pfad angeben.
executableTargetType Gibt den Dateityp an, den Sie für Ihre ausführbare Java-Datei verwenden. Die gültigen Werte sind EXECUTABLE_JAR und JAVA_CLASS.
executable Gibt den Pfad der ausführbaren Datei an. Dieses Argument ist erforderlich, wenn Sie ein Argument für einen Java-Schritt angeben.
exectuableArgs Gibt einen Zeichenfolgebereich mit Argumenten an, die an die ausführbare Datei übergeben werden sollen.
osNames Gibt eine durch Kommas getrennte Liste mit Betriebssystemen an. Geben Sie null an, wenn die Aktion für jedes Betriebssystem ausgeführt werden soll. Die gültigen Betriebssystemnamen sind windows, unix und zos.
pidVarName Gibt den Namen der Variablen für die Java-Prozess-ID an.
workingDir Gibt die Position der Datei im Dateisystem an, über die der Befehl aufgerufen wird. Dieses Argument ist erforderlich, wenn Sie ein Argument für einen Java-Schritt angeben.
usernameVar Gibt eine Variable für den Benutzernamen an.
usernameVal Gibt den Wert für die Benutzernamensvariable an.
passwordVar Gibt eine Variable für das Kennwort an.
passwordVal Gibt den Wert der Kennwortvariablen an.

Beispiel

Verwendungsbeispiel für Stapelbetrieb:

Verwendungsbeispiel für Dialogmodus:

Befehl "modifyHealthAction"

Verwenden Sie den Befehl "modifyHealthAction", um eine vorhandene Vitalitätsaktion zu ändern.
Tabelle 15. Argumente für den Befehl "modifyHealthAction"
Argument Beschreibung
name (erforderlich) Gibt einen Namen für die Vitalitätsaktion an, die Sie ändern möchten.
Tabelle 16. Argumente für einen Schritt ohne Java-Aktion
Argument Beschreibung
executable Gibt den Pfad der ausführbaren Datei an.
executableArgs Gibt einen Zeichenfolgebereich mit Argumenten an, die an die ausführbare Datei übergeben werden sollen.
workingDir Gibt die Position der Datei im Dateisystem an, über die der Befehl aufgerufen wird.
usernameVar Gibt eine Variable für den Benutzernamen an.
usernameVal Gibt den Wert für die Benutzernamensvariable an.
passwordVar Gibt eine Variable für das Kennwort an.
passwordVal Gibt den Wert der Kennwortvariablen an.
Tabelle 17. Argumente für einen Java-Schritt
Argument Beschreibung
javaDir Gibt die Position der ausführbaren Java-Datei an, z. B. ${JAVA_HOME}. Sie können eine Variable oder einen Pfad angeben.
executableTargetType Gibt den Dateityp an, den Sie für Ihre ausführbare Java-Datei verwenden. Die gültigen Werte sind EXECUTABLE_JAR und JAVA_CLASS.
executable Gibt den Pfad der ausführbaren Datei an.
executableArgs Gibt einen Zeichenfolgebereich mit Argumenten an, die an die ausführbare Datei übergeben werden sollen.
pidVarName Gibt den Namen der Variablen für die Java-Prozess-ID an.
usernameVar Gibt eine Variable für den Benutzernamen an.
usernameVal Gibt den Wert für die Benutzernamensvariable an.
passwordVar Gibt eine Variable für das Kennwort an.
passwordVal Gibt den Wert der Kennwortvariablen an.
workingDir Gibt die Position der Datei im Dateisystem an, über die der Befehl aufgerufen wird.

Beispiel

Verwendungsbeispiel für Stapelbetrieb:

$AdminTask modifyHealthAction { -name myAction -java { -javaDir c:\java\bin -executableTargetType EXECUTABLE_JAR
 -executable test.jar -executableArgs "{arg1}{arg2a arg2b}" -pidVarName pvn -workingDir c:\workingDir } }

Verwendungsbeispiel für Dialogmodus:

Befehl "deleteHealthAction"

Der Befehl "deleteHealthAction" entfernt eine Vitalitätsaktion.
Tabelle 18. Argumente für den Befehl "deleteHealthAction"
Argument Beschreibung
name (erforderlich) Gibt einen Namen für die Vitalitätsaktion an.

Beispiel

Verwendungsbeispiel für Stapelbetrieb:

Befehl "listHealthActions"

Der Befehl "listHealthActions" listet die definierten Vitalitätsaktionen in der Zelle auf.

Beispiel

Verwendungsbeispiel für Stapelbetrieb:

Befehl "executeHealthAction"

Der Befehl "executeHealthAction" führt die angegebene Vitalitätsaktion aus.
Tabelle 19. Argumente für den Befehl "executeHealthAction"
Argument Beschreibung
name (erforderlich) Gibt den Namen der auszuführenden Vitalitätsaktion an.
node (erforderlich) Gibt den Knoten an, auf dem die Aktion ausgeführt werden soll.
server (erforderlich) Gibt den Server an, auf dem die Aktion ausgeführt werden soll.
cell Gibt die Zelle an, in der die Vitalitätsaktion ausgeführt werden soll.
timeout Gibt ein Zeitlimit für die Ausführung der Vitalitätsaktion an.
variables Gibt java.util.Properties-Werte von Variablen an.

Beispiel

Verwendungsbeispiel für Stapelbetrieb:

Verwendungsbeispiel für Dialogmodus:




Zugehörige Konzepte
Vitalitätsüberwachung
Zugehörige Tasks
Vitalitätsüberwachung konfigurieren
Vitalitätsrichtlinien erstellen
Angepasste Aktionen für Vitalitätsrichtlinien erstellen
Wartungsmodus festlegen
Zugehörige Verweise
Verwaltungs-Tasks für den Wartungsmodus
Referenzartikel    

Nutzungsbedingungen | Feedback

Letzte Aktualisierung: 24.09.2009 16.40 Uhr EDT
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r1m1/index.jsp?topic=/com.ibm.websphere.ops.doc/info/reference/radtaskhealth.html