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.
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: