[AIX Solaris HP-UX Linux Windows][z/OS]

Intelligent Management : tâches administratives de la stratégie de santé

Vous pouvez utiliser les tâches d'administration ci-dessous pour créer, supprimer et gérer des stratégies de santé.

Commande createHealthPolicy

La commande createHealthPolicy crée une règle de santé.
Tableau 1. Arguments de la commande createHealthPolicy
Argument Description
name (requis) Indique le nom de la stratégie de santé existante qui est unique dans la cellule.
description Indique une description de la stratégie de santé.
reactionMode Indique si les tâches d'exécution sont créées avant d'appliquer des actions à la stratégie de santé, ou si les actions sont automatiques. La valeur est SUPERVISE ou AUTOMATIC.
Tableau 2. Arguments de l'étape addCondition
Argument Description
type (requis) Indique le type de condition. La valeur peut être CUSTOM, AGE, WORKLOAD, MEMORY_LEAK, EXCESSIVE_MEMORY, EXCESSIVE_RESPONSE_TIME, EXCESSIVE_REQUEST_TIMEOUT, STORM_DRAIN ou GC_PERCENTAGE. Chaque valeur comporte différents paramètres que vous devez indiquer.
expression Si vous utilisez une condition personnalisée, indiquez une sous-expression à évaluer.
params
  • AGE
    • maxAge : spécifie l'âge maximal.
    • ageUnits : spécifie le type d'unité du paramètre d'âge. La valeur est HOURS ou MINUTES. La valeur par défaut est HOURS.
  • WORKLOAD
    • totalRequests : spécifie le nombre total de demandes à traiter avant de redémarrer les membres. Ce nombre doit être supérieur ou égal à 1000.
  • MEMORY_LEAK
    • level : indique le niveau de détection pour la fuite de mémoire. La valeur est FAST, NORMAL ou CONSERVATIVE. La valeur par défaut est FAST.
  • EXCESSIVE_MEMORY
    • timeOverThreshold : spécifie la période d'infraction pour la condition de dépassement de mémoire. La valeur par défaut est 1 MINUTE.
    • timeUnits : spécifie les unités de la valeur timeOverThreshold. La valeur est MINUTES ou SECONDS. La valeur par défaut est MINUTES.
    • memoryUsed : spécifie un pourcentage qui représente la taille du segment de mémoire JVM (Java™ virtual machine) maximale à utiliser pour les processus JVM. La valeur est comprise entre 1 et 99.
  • EXCESSIVE_RESPONSE_TIME
    • responseTime : spécifie le temps de réponse moyen considéré comme excessif. Lorsque cette valeur est atteinte, les membres sont redémarrés.
    • responseTimeUnits : spécifie l'unité des temps de réponse. La valeur est MINUTES, SECONDS ou MILLISECONDS.
  • EXCESSIVE_REQUEST_TIMEOUT
    • timeoutPercent : spécifie la valeur de seuil pour le pourcentage de demandes arrivées à expiration entraînant une violation de condition. Cette valeur est comprise entre 1 et 99.
  • STORM_DRAIN
    • level : spécifies le niveau de détection. La valeur est NORMAL ou CONSERVATIVE. La valeur NORMAL offre moins de précision mais permet de détecter rapidement une condition de drainage incorrect. CONSERVATIVE offre plus de précision, mais la détection d'une condition de drainage incorrect est moins rapide.
  • GC_PERCENTAGE
    • garbageCollectionPercent : valeur de seuil pour le pourcentage de temps associé à la récupération de place. Cette valeur peut être comprise entre 1 et 99. La valeur par défaut est 10.
    • samplingPeriod : période d'échantillonnage pour les données de récupération de place. La durée totale de la récupération de place pendant la période d'échantillonnage doit être supérieure à la valeur de seuil avant une action corrective. Cette valeur peut être comprise entre 1 minute et 24 heures. La valeur par défaut est 2 minutes.
    • samplingUnits : spécifie l'unité du paramètre samplingPeriod. La valeur peut être MINUTES ou HOURS. La valeur par défaut est MINUTES.
    • Eviter les incidents Eviter les incidents: Les paramètres garbageCollectionPercent et samplingPeriod sont requis et doivent être spécifiés pour l'exécution de la commande.gotcha
Tableau 3. Arguments de l'étape addAction.

Utilisez les arguments de l'étape addAction en format de tableau. Le format de tableau permet de spécifier les paramètres dans l'ordre sans indication du nom.

Argument Description
type (requis) Indique le type d'action. La valeur est CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK ou MAINT_MODE_STOP.
stepNum (requis) Indique l'ordre d'application des actions. L'étape 1 est effectuée la première, et ainsi de suite.
action Indique le nom d'une action personnalisée. Utilisez la commande createHealthAction pour créer une action personnalisée. Ce paramètre est uniquement requis pour les actions personnalisées.
node Indique le noeud sur lequel appliquer l'action. Ce paramètre est uniquement requis pour les actions personnalisées. Les options valides sont un nom de noeud ou une chaîne vide "".

server Indique le serveur sur lequel appliquer l'action.

Ce paramètre est uniquement requis pour les actions personnalisées. Les options valides sont un nom de serveur ou l'une des chaînes suivantes : "Sick server" ou "Node agent of the sick server". Si l'une de ces chaînes est utilisée, la valeur de noeud valide est la chaîne vide, "".

Tableau 4. Arguments de l'étape addMember.

Utilisez les arguments de l'étape addMember en format de tableau. Le format de tableau permet de spécifier les paramètres dans l'ordre sans indication du nom.

Argument Description
type (requis) Indique le type de membre. La valeur est CELL, CLUSTER, DYNAMIC_CLUSTER, SERVER ou ODR.
name (requis) Indique le nom du membre.
node Indique le nom du noeud. Le nom du noeud est requis si vous sélectionnez le type SERVER.

Exemples de commande createHealthPolicy

Exemple d'utilisation en mode interactif :

  • A l'aide de Jacl :
    $AdminTask createHealthPolicy {-interactive}
  • Avec Jython :
    AdminTask.createHealthPolicy ('[-interactive]')

Syntaxe d'un exemple de mode différé :

La commande suivante crée une règle de santé avec une des conditions de santé prédéfinies.

$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 myServer1 myNode1}{SERVER myServer2 mynode2}}

La commande suivante crée une stratégie de santé avec une condition personnalisée.

$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 myServer1 myNode1}{SERVER myServer2 mynode2}} 
Placez l'expression correspondant à votre condition personnalisée entre guillemets.

Commande modifyHealthPolicy

La commande modifyHealthPolicy modifie une règle de santé existante.
Tableau 5. Arguments initiaux
Argument Description
name (requis) Indique le nom unique de la stratégie de santé que vous voulez modifier.
reactionMode Indique si les tâches d'exécution sont créées avant d'appliquer des actions à la stratégie de santé, ou si les actions sont automatiques. La valeur est SUPERVISE ou AUTOMATIC.
Tableau 6. Arguments de l'étape modifyCondition
Argument Description
type Indique le type de condition. La valeur peut être CUSTOM, AGE, WORKLOAD, MEMORY_LEAK, EXCESSIVE_MEMORY, EXCESSIVE_RESPONSE_TIME, EXCESSIVE_REQUEST_TIMEOUT, STORM_DRAIN ou GC_PERCENTAGE. Chaque valeur comporte différents paramètres que vous devez indiquer.
expression Si vous utilisez une condition personnalisée, indiquez une sous-expression à évaluer.
params
  • AGE
    • maxAge : spécifie l'âge maximal.
    • ageUnits : spécifie le type d'unité du paramètre d'âge. La valeur est HOURS ou MINUTES. La valeur par défaut est HOURS.
  • WORKLOAD
    • totalRequests : spécifie le nombre total de demandes à traiter avant de redémarrer les membres. Ce nombre doit être supérieur ou égal à 1000.
  • MEMORY_LEAK
    • level : indique le niveau de détection pour la fuite de mémoire. La valeur est FAST, NORMAL ou CONSERVATIVE. La valeur par défaut est FAST.
  • EXCESSIVE_MEMORY
    • timeOverThreshold : spécifie la période d'infraction pour la condition de dépassement de mémoire. La valeur par défaut est 1 MINUTE.
    • timeUnits : spécifie les unités de la valeur timeOverThreshold. La valeur est MINUTES ou SECONDS. La valeur par défaut est MINUTES.
    • memoryUsed : spécifie un pourcentage qui représente la taille du segment de mémoire JVM (Java virtual machine) maximale à utiliser pour les processus JVM. La valeur est comprise entre 1 et 99.
  • EXCESSIVE_RESPONSE_TIME
    • responseTime : spécifie le temps de réponse moyen considéré comme excessif. Lorsque cette valeur est atteinte, les membres sont redémarrés.
    • responseTimeUnits : spécifie l'unité des temps de réponse. La valeur est MINUTES, SECONDS ou MILLISECONDS.
  • EXCESSIVE_REQUEST_TIMEOUT
    • timeoutPercent : spécifie la valeur de seuil pour le pourcentage de demandes arrivées à expiration entraînant une violation de condition. Cette valeur est comprise entre 1 et 99.
  • STORM_DRAIN
    • level : spécifies le niveau de détection. La valeur est NORMAL ou CONSERVATIVE. La valeur NORMAL offre moins de précision mais permet de détecter rapidement une condition de drainage incorrect. CONSERVATIVE offre plus de précision, mais la détection d'une condition de drainage incorrect est moins rapide.
  • GC_PERCENTAGE
    • garbageCollectionPercent : valeur de seuil pour le pourcentage de temps associé à la récupération de place. Cette valeur peut être comprise entre 1 et 99. La valeur par défaut est 10.
    • samplingPeriod : période d'échantillonnage pour les données de récupération de place. La durée totale de la récupération de place pendant la période d'échantillonnage doit être supérieure à la valeur de seuil avant une action corrective. Cette valeur peut être comprise entre 1 minute et 24 heures. La valeur par défaut est 2 minutes.
    • samplingUnits : spécifie l'unité du paramètre samplingPeriod. La valeur peut être MINUTES ou HOURS. La valeur par défaut est MINUTES.
    • Eviter les incidents Eviter les incidents: Les paramètres garbageCollectionPercent et samplingPeriod sont requis et doivent être spécifiés pour l'exécution de la commande.gotcha
Tableau 7. Arguments de l'étape removeAction
Argument Description
name Indique le nom de l'action de santé à supprimer. Le paramètre de nom est uniquement utilisé pour les actions personnalisées.
type (requis) Indique le type d'action. La valeur est CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK ou MAINT_MODE_STOP.
Tableau 8. Arguments de l'étape addAction
Argument Description
type (requis) Indique le type d'action. La valeur est CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK ou MAINT_MODE_STOP.
action Indique le nom de l'action de santé. Utilisez la commande createHealthAction pour créer une action personnalisée. Ce paramètre est uniquement requis pour les actions personnalisées.
node Indique le noeud sur lequel appliquer l'action. Ce paramètre est uniquement requis pour les actions personnalisées. Les options valides sont un nom de noeud ou une chaîne vide "".
server Indique le serveur sur lequel appliquer l'action.

Ce paramètre est uniquement requis pour les actions personnalisées. Les options valides sont un nom de serveur ou l'une des chaînes suivantes : "Sick server" ou "Node agent of the sick server". Si l'une de ces chaînes est utilisée, la valeur de noeud valide est la chaîne vide, "".

stepNum (requis) Indique l'ordre d'application des actions. L'étape 1 est effectuée la première, et ainsi de suite.
Tableau 9. Arguments de l'étape orderAction
Argument Description
name Indique le nom de l'action de santé. Le paramètre de nom est uniquement utilisé pour les actions personnalisées.
type Indique le type d'action. La valeur est CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK ou MAINT_MODE_STOP.
stepNum (requis) Indique l'ordre d'application des actions. L'étape 1 est effectuée la première, et ainsi de suite.
Tableau 10. Arguments de l'étape addMember
Argument Description
type (requis) Indique le type de membre. La valeur est CELL, CLUSTER, DYNAMIC_CLUSTER, SERVER ou ODR.
name (requis) Indique le nom du membre.
node Indique le nom du noeud. Le nom du noeud est requis si vous sélectionnez le type SERVER.

Exemples de commande modifyHealthPolicy

Exemple d'utilisation en mode interactif :

  • A l'aide de Jacl :
    $AdminTask modifyHealthPolicy {-interactive}
  • Avec Jython :
    AdminTask.modifyHealthPolicy ('[-interactive]')

Syntaxe d'un exemple de mode différé :

$AdminTask modifyHealthPolicy { -name myHealthPolicy -removeAction { -type HEAPDUMP } }

Commande deleteHealthPolicy

La commande deleteHealthPolicy supprime la règle de santé nomméee.
Tableau 11. Arguments de la commande deleteHealthPolicy
Argument Description
name (requis) Indique le nom de la stratégie de santé à supprimer.

Exemples de commande deleteHealthPolicy

Syntaxe d'un exemple de mode différé :

  • A l'aide de Jacl :
    $AdminTask deleteHealthPolicy {-name MyHealthPolicy}
  • Avec Jython :
    AdminTask.deleteHealthPolicy('MyHealthPolicy')

Exemple d'utilisation en mode interactif :

  • A l'aide de Jacl :
    $AdminTask deleteHealthPolicy {-interactive}
  • Avec Jython :
    AdminTask.deleteHealthPolicy ('[-interactive]')

Commande listHealthPolicies

La commande listHealthPolicies affiche chaque règle de santé configurée dans la cellule.

Exemples de commande listHealthPolicies

  • A l'aide de Jacl :
    $AdminTask listHealthPolicies
  • Avec Jython :
    AdminTask.listHealthPolicies

Commande createHealthAction

La commande createHealthAction crée une action de santé que vous pouvez utiliser en vue de définir vos règles de santé.
Tableau 12. Arguments de la commande createHealthAction
Argument Description
name (requis) Indique un nom pour l'action de santé.
Vous pouvez créer une action Java ou une action sous forme de tout autre type de fichier exécutable.
Tableau 13. Arguments de l'étape non Java
Argument Description
executable Indiquez le chemin d'accès au fichier exécutable. Cet argument est requis si vous indiquez un argument d'étape non Java.
executableArgs Indique un groupe d'arguments sous forme de chaîne à transmettre au fichier exécutable.
osNames Indique une liste de systèmes d'exploitation, séparés par une virgule. Indiquez null pour que l'action s'applique à chaque système d'exploitation. Les noms de système d'exploitation valides sont : windows, unix et zos.
workingDir Indique l'emplacement du système de fichiers à partir duquel la commande est appelée. Cet argument est requis si vous indiquez un argument d'étape non Java.
usernameVar Indique une variable de nom d'utilisateur.
userNameVal Indique la valeur de la variable de nom d'utilisateur.
passwordVar Indique une variable de mot de passe.
passwordVal Indique la valeur de la variable de mot de passe.
Tableau 14. Arguments de l'étape Java
Argument Description
javaDir Indique l'emplacement de votre fichier exécutable Java, par exemple ${JAVA_HOME}. Vous pouvez indiquer une variable ou un chemin.
executableTargetType Indique le type de fichier utilisé pour votre fichier exécutable Java. La valeur est EXECUTABLE_JAR ou JAVA_CLASS.
executable Indiquez le chemin d'accès au fichier exécutable.Cet argument est requis si vous indiquez un argument d'étape Java.
exectuableArgs Indique un groupe d'arguments sous forme de chaîne à transmettre au fichier exécutable.
osNames Indique une liste de systèmes d'exploitation, séparés par une virgule. Indiquez null pour que l'action s'applique à chaque système d'exploitation. Les noms de système d'exploitation valides sont : windows, unix et zos.
pidVarName Indique le nom de variable d'ID processus Java.
workingDir Indique l'emplacement du système de fichiers à partir duquel la commande est appelée.Cet argument est requis si vous indiquez un argument d'étape Java.
usernameVar Indique une variable de nom d'utilisateur.
usernameVal Indique la valeur de la variable de nom d'utilisateur.
passwordVar Indique une variable de mot de passe.
passwordVal Indique la valeur de la variable de mot de passe.

Exemples de commande createHealthAction

Syntaxe d'un exemple de mode différé :

  • A l'aide de Jacl :
    $AdminTask createHealthAction { -name myAction -java { -javaDir c:\java\bin -executableTargetType EXECUTABLE_JAR
     -executable test.jar -executableArgs "{arg1}{arg2a arg2b}" -osNames "windows, unix" -pidVarName pvn 
    -workingDir c:\workingDir } }

Exemple d'utilisation en mode interactif :

  • A l'aide de Jacl :
    $AdminTask createHealthAction {-interactive}
  • Avec Jython :
    AdminTask.createHealthAction('[-interactive]')

Commande modifyHealthAction

Utilisez la commande modifyHealthAction pour modifier une action de santé existante.
Tableau 15. Arguments de la commande modifyHealthAction
Argument Description
name (requis) Indique le nom de l'action de santé à modifier.
Tableau 16. Arguments de l'étape non Java
Argument Description
executable Indiquez le chemin d'accès au fichier exécutable.
executableArgs Indique un groupe d'arguments sous forme de chaîne à transmettre au fichier exécutable.
workingDir Indique l'emplacement du système de fichiers à partir duquel la commande est appelée.
usernameVar Indique une variable de nom d'utilisateur.
usernameVal Indique la valeur de la variable de nom d'utilisateur.
passwordVar Indique une variable de mot de passe.
passwordVal Indique la valeur de la variable de mot de passe.
Tableau 17. Arguments de l'étape Java
Argument Description
javaDir Indique l'emplacement de votre fichier exécutable Java, par exemple ${JAVA_HOME}. Vous pouvez indiquer une variable ou un chemin.
executableTargetType Indique le type de fichier utilisé pour votre fichier exécutable Java. La valeur est EXECUTABLE_JAR ou JAVA_CLASS.
executable Indiquez le chemin d'accès au fichier exécutable.
executableArgs Indique un groupe d'arguments sous forme de chaîne à transmettre au fichier exécutable.
pidVarName Indique le nom de variable d'ID processus Java.
usernameVar Indique une variable de nom d'utilisateur.
usernameVal Indique la valeur de la variable de nom d'utilisateur.
passwordVar Indique une variable de mot de passe.
passwordVal Indique la valeur de la variable de mot de passe.
workingDir Indique l'emplacement du système de fichiers à partir duquel la commande est appelée.

Exemples de commande modifyHealthAction

Syntaxe d'un exemple de mode différé :

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

Exemple d'utilisation en mode interactif :

  • A l'aide de Jacl :
    $AdminTask modifyHealthAction {-interactive}
  • Avec Jython :
    AdminTask.modifyHealthAction('[-interactive]')

Commande deleteHealthAction

La commande deleteHealthAction supprime une action de santé.
Tableau 18. Arguments de la commande deleteHealthAction
Argument Description
name (requis) Indique un nom pour l'action de santé.

Exemples de commande deleteHealthAction

Syntaxe d'un exemple de mode différé :

  • A l'aide de Jacl :
    $Admintask deleteHealthAction {-name myHealthAction}
  • Avec Jython :
    AdminTask.deleteHealthAction('-name myHealthAction')

Commande listHealthActions

La commande listHealthActions affiche chacune des actions de santé définies dans la cellule.

Exemples de commande listHealthActions

Syntaxe d'un exemple de mode différé :

  • A l'aide de Jacl :
    $Admintask listHealthActions
  • Avec Jython :
    AdminTask.listHealthActions

Commande executeHealthAction

La commande executeHealthAction exécute l'action de santé indiquée.
Tableau 19. Arguments de la commande executeHealthAction
Argument Description
name (requis) Indique le nom de la stratégie de santé à exécuter.
node (requis) Indique le noeud sur lequel appliquer l'action. Ce paramètre est uniquement requis pour les actions personnalisées. Les options valides sont un nom de noeud ou une chaîne vide "".
server (requis) Indique le serveur sur lequel appliquer l'action.
cell Indique la cellule dans laquelle est exécutée l'action de santé.
timeout Indique une valeur de délai d'exécution de l'action de santé.
variables Indique les valeurs de variables java.util.Properties.

Exemples de commande executeHealthAction

Syntaxe d'un exemple de mode différé :

  • A l'aide de Jacl :
    $AdminTask executeHealthAction {-name myHealthAction -node myNode -server myServer}
  • Avec Jython :
    AdminTask.executeHealthAction ('[-name myHealthAction -node myNode -server myServer]')

Exemple d'utilisation en mode interactif :

  • A l'aide de Jacl :
    $AdminTask executeHealthAction {-interactive}
  • Avec Jython :
    AdminTask.executeHealthAction ('[-interactive]')

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwve_adtaskhealth
Nom du fichier : rwve_adtaskhealth.html