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

Intelligent Management: tareas administrativas de política de salud

Puede utilizar las tareas administrativas siguientes para crear, suprimir y gestionar las políticas de salud.

Mandato createHealthPolicy

El mandato createHealthPolicy crea una nueva política de salud.
Tabla 1. Argumentos del mandato createHealthPolicy
Argumento Descripción
name (necesario) Especifica un nombre para la política de salud que es exclusivo en la célula.
description Especifica una descripción de la política de salud.
reactionMode Especifica si se crean tareas en tiempo de ejecución antes de actuar según una política de salud o si las acciones son automáticas. El valor puede ser SUPERVISE o AUTOMATIC.
Tabla 2. Argumentos del paso addCondition
Argumento Descripción
type (necesario) Especifica el tipo de condición. El valor puede ser CUSTOM, AGE, WORKLOAD, MEMORY_LEAK, EXCESSIVE_MEMORY, EXCESSIVE_RESPONSE_TIME, EXCESSIVE_REQUEST_TIMEOUT, STORM_DRAIN o GC_PERCENTAGE. Cada valor tiene parámetros distintos que debe especificar.
expresión Si utiliza una condición personalizada, especifique una subexpresión que se va a evaluar.
params
  • AGE
    • maxAge: especifica la máxima antigüedad.
    • ageUnits: especifica el tipo de unidades del parámetro age. El valor puede ser HOURS o MINUTES. Toma por omisión HOURS.
  • WORKLOAD
    • totalRequests: especifica el número total de solicitudes al servicio antes de reiniciar los miembros. El número debe ser mayor o igual que 1000.
  • MEMORY_LEAK
    • level: especifica el nivel de detección de la fuga de memoria. El valor puede ser FAST, NORMAL o CONSERVATIVE. Toma por omisión FAST.
  • EXCESSIVE_MEMORY
    • timeOverThreshold: especifica el periodo de tiempo causante de la condición de memoria excesiva. El valor predeterminado es 1 MINUTE.
    • timeUnits: especifica las unidades del valor timeOverThreshold. El valor puede ser MINUTES o SECONDS. Toma por omisión MINUTES.
    • memoryUsed: especifica un porcentaje que representa el tamaño máximo de almacenamiento dinámico de Java™ Virtual Machine (JVM) que se va a utilizar para el proceso de la JVM. El valor varía entre 1 y 99.
  • EXCESSIVE_RESPONSE_TIME
    • responseTime: especifica el promedio de tiempo de respuesta que se considera como excesivo. Cuando el promedio alcanza este valor, se reinician los miembros.
    • responseTimeUnits: especifica las unidades de tiempo para el tiempo de respuesta. El valor puede ser MINUTES, SECONDS, o MILLISECONDS.
  • EXCESSIVE_REQUEST_TIMEOUT
    • timeoutPercent: especifica el valor de umbral del porcentaje de las solicitudes que han superado el tiempo de espera para que se provoque el incumplimiento de una condición. Este valor varía entre 1 y 99.
  • STORM_DRAIN
    • level: especifica el nivel de detección. El valor puede ser NORMAL o CONSERVATIVE. NORMAL es menos preciso, pero puede detectar rápidamente una condición de reducción de saturación. CONSERVATIVE es la opción de mayor precisión, pero lleva más tiempo detectar una condición de reducción de saturación.
  • GC_PERCENTAGE
    • garbageCollectionPercent: valor de umbral del porcentaje de tiempo empleado en la recogida de basura. Este valor puede estar entre 1 y 99. El valor predeterminado es 10.
    • samplingPeriod: periodo de prueba para la recopilación de datos de recogida de basura. La cantidad total del tiempo empleado en la recogida de basura durante el periodo de tiempo de prueba debe ser superior al valor del umbral antes de una acción correctiva. Este valor puede oscilar entre 1 minuto y 24 horas. El valor predeterminado es de 2 minutos.
    • samplingUnits: especifica las unidades de tiempo para el parámetro samplingPeriod. El valor puede ser MINUTES o HOURS. El valor predeterminado es MINUTES.
    • Avoid trouble Avoid trouble: Los parámetros garbageCollectionPercent y samplingPeriod son necesarios y se deben especificar para poder ejecutar el mandato. gotcha
Tabla 3. Argumentos de paso de addAction.

Utilice los argumentos de paso de addAction en formato de tabla. Con el formato de tabla, puede especificar los parámetros por orden sin el nombre de parámetro.

Argumento Descripción
type (necesario) Especifica el tipo de acción. El valor puede ser CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK o MAINT_MODE_STOP.
stepNum (necesario) Especifica el orden en que se realizan las acciones. El paso 1 se termina el primero y así sucesivamente.
action Especifica el nombre de una acción personalizada. Utilice el mandato createHealthAction para crear una acción personalizada. Este parámetro sólo es necesario para las acciones personalizadas.
node Especifica el nodo en el que se va a realizar la acción. Este parámetro sólo es necesario para las acciones personalizadas. Las opciones válidas son un nombre de nodo o la serie vacía "".

server Especifica el servidor en el que se va a realizar la acción.

Este parámetro es necesario sólo para las acciones personalizadas. Las opciones válidas son un nombre de servidor o una de las series siguientes: "Servidor anómalo" o "Agente del nodo del servidor anómalo". Si se utiliza cualquiera de estas series, el valor de nodo válido es la serie vacía, "".

Tabla 4. Argumentos de paso de addMember.

Utilice los argumentos de paso de addMember en formato de tabla. Con el formato de tabla, puede especificar los parámetros por orden sin el nombre de parámetro.

Argumento Descripción
type (necesario) Especifica el tipo de miembro. El valor puede ser CELL, CLUSTER, DYNAMIC_CLUSTER, SERVER o ODR.
name (necesario) Especifica el nombre del miembro.
node Especifica el nombre del nodo. Es necesario el nombre de nodo si se selecciona el tipo SERVER.

Ejemplos del mandato createHealthPolicy

Ejemplo de utilización de la modalidad interactiva:

  • Utilizando Jacl:
    $AdminTask createHealthPolicy {-interactive}
  • Utilizando Jython:
    AdminTask.createHealthPolicy ('[-interactive]')

Ejemplo de utilización de la modalidad por lotes:

El mandato siguiente crea una política de salud con una de las condiciones de salud predefinidas:

$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}}

El mandato siguiente crea una política de salud con una condición personalizada:

$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}} 
Ponga la expresión de la condición personalizada entre comillas.

Mandato modifyHealthPolicy

El mandato modifyHealthPolicy cambia una política de salud existente.
Tabla 5. Argumentos iniciales
Argumento Descripción
name (necesario) Especifica el nombre de la política de salud que desea cambiar.
reactionMode Especifica si se crean tareas en tiempo de ejecución antes de actuar según una política de salud o si las acciones son automáticas. El valor puede ser SUPERVISE o AUTOMATIC.
Tabla 6. Argumentos de paso de modifyCondition
Argumento Descripción
type Especifica el tipo de condición. El valor puede ser CUSTOM, AGE, WORKLOAD, MEMORY_LEAK, EXCESSIVE_MEMORY, EXCESSIVE_RESPONSE_TIME, EXCESSIVE_REQUEST_TIMEOUT, STORM_DRAIN o GC_PERCENTAGE. Cada valor tiene parámetros distintos que debe especificar.
expresión Si utiliza una condición personalizada, especifique una subexpresión que se va a evaluar.
params
  • AGE
    • maxAge: especifica la máxima antigüedad.
    • ageUnits: especifica el tipo de unidades del parámetro age. El valor puede ser HOURS o MINUTES. Toma por omisión HOURS.
  • WORKLOAD
    • totalRequests: especifica el número total de solicitudes al servicio antes de reiniciar los miembros. El número debe ser mayor o igual que 1000.
  • MEMORY_LEAK
    • level: especifica el nivel de detección de la fuga de memoria. El valor puede ser FAST, NORMAL o CONSERVATIVE. Toma por omisión FAST.
  • EXCESSIVE_MEMORY
    • timeOverThreshold: especifica el periodo de tiempo causante de la condición de memoria excesiva. El valor predeterminado es 1 MINUTE.
    • timeUnits: especifica las unidades del valor timeOverThreshold. El valor puede ser MINUTES o SECONDS. Toma por omisión MINUTES.
    • memoryUsed: especifica un porcentaje que representa el tamaño máximo de almacenamiento dinámico de Java Virtual Machine (JVM) que se va a utilizar para el proceso de la JVM. El valor varía entre 1 y 99.
  • EXCESSIVE_RESPONSE_TIME
    • responseTime: especifica el promedio de tiempo de respuesta que se considera como excesivo. Cuando el promedio alcanza este valor, se reinician los miembros.
    • responseTimeUnits: especifica las unidades de tiempo para el tiempo de respuesta. El valor puede ser MINUTES, SECONDS, o MILLISECONDS.
  • EXCESSIVE_REQUEST_TIMEOUT
    • timeoutPercent: especifica el valor de umbral del porcentaje de las solicitudes que han superado el tiempo de espera para que se provoque el incumplimiento de una condición. Este valor varía entre 1 y 99.
  • STORM_DRAIN
    • level: especifica el nivel de detección. El valor puede ser NORMAL o CONSERVATIVE. NORMAL es menos preciso, pero puede detectar rápidamente una condición de reducción de saturación. CONSERVATIVE es la opción de mayor precisión, pero lleva más tiempo detectar una condición de reducción de saturación.
  • GC_PERCENTAGE
    • garbageCollectionPercent: valor de umbral del porcentaje de tiempo empleado en la recogida de basura. Este valor puede estar entre 1 y 99. El valor predeterminado es 10.
    • samplingPeriod: periodo de prueba para la recopilación de datos de recogida de basura. La cantidad total del tiempo empleado en la recogida de basura durante el periodo de tiempo de prueba debe ser superior al valor del umbral antes de una acción correctiva. Este valor puede oscilar entre 1 minuto y 24 horas. El valor predeterminado es de 2 minutos.
    • samplingUnits: especifica las unidades de tiempo para el parámetro samplingPeriod. El valor puede ser MINUTES o HOURS. El valor predeterminado es MINUTES.
    • Avoid trouble Avoid trouble: Los parámetros garbageCollectionPercent y samplingPeriod son necesarios y se deben especificar para poder ejecutar el mandato. gotcha
Tabla 7. Argumentos de paso de removeAction
Argumento Descripción
name Especifica el nombre de la acción de salud que se va a eliminar. El parámetro name sólo se utiliza para las acciones personalizadas.
type (necesario) Especifica el tipo de acción. El valor puede ser CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK o MAINT_MODE_STOP.
Tabla 8. Argumentos de paso de addAction
Argumento Descripción
type (necesario) Especifica el tipo de acción. El valor puede ser CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK o MAINT_MODE_STOP.
action Especifica el nombre de la acción de salud. Utilice el mandato createHealthAction para crear una acción personalizada. Este parámetro sólo es necesario para las acciones personalizadas.
node Especifica el nodo en el que se va a realizar la acción. Este parámetro sólo es necesario para las acciones personalizadas. Las opciones válidas son un nombre de nodo o la serie vacía "".
server Especifica el servidor en el que se va a realizar la acción.

Este parámetro es necesario sólo para las acciones personalizadas. Las opciones válidas son un nombre de servidor o una de las series siguientes: "Servidor anómalo" o "Agente del nodo del servidor anómalo". Si se utiliza cualquiera de estas series, el valor de nodo válido es la serie vacía, "".

stepNum (necesario) Especifica el orden en que se realizan las acciones. El paso 1 se termina el primero y así sucesivamente.
Tabla 9. Argumentos de paso de orderAction
Argumento Descripción
name Especifica el nombre de la acción de salud. El parámetro name sólo se utiliza para las acciones personalizadas.
type Especifica el tipo de acción. El valor puede ser CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK o MAINT_MODE_STOP.
stepNum (necesario) Especifica el orden en que se realizan las acciones. El paso 1 se termina el primero y así sucesivamente.
Tabla 10. Argumentos de paso de addMember
Argumento Descripción
type (necesario) Especifica el tipo de miembro. El valor puede ser CELL, CLUSTER, DYNAMIC_CLUSTER, SERVER o ODR.
name (necesario) Especifica el nombre del miembro.
node Especifica el nombre del nodo. Es necesario el nombre de nodo si se selecciona el tipo SERVER.

Ejemplos del mandato modifyHealthPolicy

Ejemplo de utilización de la modalidad interactiva:

  • Utilizando Jacl:
    $AdminTask modifyHealthPolicy {-interactive}
  • Utilizando Jython:
    AdminTask.modifyHealthPolicy ('[-interactive]')

Ejemplo de utilización de la modalidad por lotes:

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

Mandato deleteHealthPolicy

El mandato deleteHealthPolicy elimina la política de salud indicada.
Tabla 11. Argumentos del mandato deleteHealthPolicy
Argumento Descripción
name (necesario) Especifica el nombre de la política de salud que se va a suprimir.

Ejemplos del mandato deleteHealthPolicy

Ejemplo de utilización de la modalidad por lotes:

  • Utilizando Jacl:
    $AdminTask deleteHealthPolicy {-name MyHealthPolicy}
  • Utilizando Jython:
    AdminTask.deleteHealthPolicy('MyHealthPolicy')

Ejemplo de utilización de la modalidad interactiva:

  • Utilizando Jacl:
    $AdminTask deleteHealthPolicy {-interactive}
  • Utilizando Jython:
    AdminTask.deleteHealthPolicy ('[-interactive]')

Mandato listHealthPolicies

El mandato listHealthPolicies enumera todas las políticas de salud configuradas de la célula.

Ejemplos del mandato listHealthPolicies

  • Utilizando Jacl:
    $AdminTask listHealthPolicies
  • Utilizando Jython:
    AdminTask.listHealthPolicies

Mandato createHealthAction

El mandato createHealthAction crea una nueva acción de salud que puede utilizar al definir sus políticas de salud.
Tabla 12. Argumentos del mandato createHealthAction
Argumento Descripción
name (necesario) Especifica el nombre de la acción de salud.
Puede crear una acción Java o una acción que sea de cualquier otro tipo de archivo ejecutable.
Tabla 13. Argumentos de paso que no es Java
Argumento Descripción
executable Especifica la vía de acceso al archivo ejecutable.Este argumento es necesario si especifica un argumento de paso que no es Java.
executableArgs Especifica una matriz de argumentos de tipo serie que se van a pasar al archivo ejecutable.
osNames Especifica una lista de sistemas operativos delimitados por coma. Especifique null para que se aplique la acción para todos los sistemas operativos. Entre los nombres de sistema operativo válidos se incluyen: windows, unix y zos.
workingDir Especifica la ubicación del sistema de archivos desde donde se ha invocado el mandato. Este argumento es necesario si especifica un argumento de paso que no es Java.
usernameVar Especifica una variable para el nombre de usuario.
userNameVal Especifica el valor de la variable de nombre de usuario.
passwordVar Especifica una variable para la contraseña.
passwordVal Especifica el valor de la variable de contraseña.
Tabla 14. Argumentos de pasos Java
Argumento Descripción
javaDir Especifica la ubicación del archivo ejecutable Java, por ejemplo, ${JAVA_HOME}. Puede especificar una variable o una vía de acceso.
executableTargetType Especifica el tipo de archivo que se utiliza para el archivo ejecutable Java. El valor puede ser EXECUTABLE_JAR o JAVA_CLASS.
executable Especifica la vía de acceso al archivo ejecutable.Este argumento es necesario si especifica un argumento de paso Java.
exectuableArgs Especifica una matriz de argumentos de tipo serie que se van a pasar al archivo ejecutable.
osNames Especifica una lista de sistemas operativos delimitados por coma. Especifique null para que se aplique la acción para todos los sistemas operativos. Entre los nombres de sistema operativo válidos se incluyen: windows, unix y zos.
pidVarName Especifica el nombre de la variable de ID de proceso Java.
workingDir Especifica la ubicación del sistema de archivos desde donde se ha invocado el mandato.Este argumento es necesario si especifica un argumento de paso Java.
usernameVar Especifica una variable para el nombre de usuario.
usernameVal Especifica el valor de la variable de nombre de usuario.
passwordVar Especifica una variable para la contraseña.
passwordVal Especifica el valor de la variable de contraseña.

Ejemplos del mandato createHealthAction

Ejemplo de utilización de la modalidad por lotes:

  • Utilizando 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 } }

Ejemplo de utilización de la modalidad interactiva:

  • Utilizando Jacl:
    $AdminTask createHealthAction {-interactive}
  • Utilizando Jython
    AdminTask.createHealthAction('[-interactive]')

Mandato modifyHealthAction

Utilice el mandato modifyHealthAction para modificar una acción de salud existente.
Tabla 15. Argumentos del mandato modifyHealthAction
Argumento Descripción
name (necesario) Especifica un nombre para la acción de salud que desea modificar.
Tabla 16. Argumentos de paso que no es Java
Argumento Descripción
executable Especifica la vía de acceso al archivo ejecutable.
executableArgs Especifica una matriz de argumentos de tipo serie que se van a pasar al archivo ejecutable.
workingDir Especifica la ubicación del sistema de archivos desde donde se ha invocado el mandato.
usernameVar Especifica una variable para el nombre de usuario.
usernameVal Especifica el valor de la variable de nombre de usuario.
passwordVar Especifica una variable para la contraseña.
passwordVal Especifica el valor de la variable de contraseña.
Tabla 17. Argumentos de pasos Java
Argumento Descripción
javaDir Especifica la ubicación del archivo ejecutable Java, por ejemplo, ${JAVA_HOME}. Puede especificar una variable o una vía de acceso.
executableTargetType Especifica el tipo de archivo que se utiliza para el archivo ejecutable Java. El valor puede ser EXECUTABLE_JAR o JAVA_CLASS.
executable Especifica la vía de acceso al archivo ejecutable.
executableArgs Especifica una matriz de argumentos de tipo serie que se van a pasar al archivo ejecutable.
pidVarName Especifica el nombre de la variable de ID de proceso Java.
usernameVar Especifica una variable para el nombre de usuario.
usernameVal Especifica el valor de la variable de nombre de usuario.
passwordVar Especifica una variable para la contraseña.
passwordVal Especifica el valor de la variable de contraseña.
workingDir Especifica la ubicación del sistema de archivos desde donde se ha invocado el mandato.

Ejemplos del mandato modifyHealthAction

Ejemplo de utilización de la modalidad por lotes:

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

Ejemplo de utilización de la modalidad interactiva:

  • Utilizando Jacl:
    $AdminTask modifyHealthAction {-interactive}
  • Utilizando Jython
    AdminTask.modifyHealthAction('[-interactive]')

Mandato deleteHealthAction

El mandato deleteHealthAction elimina una acción de salud.
Tabla 18. Argumentos del mandato deleteHealthAction
Argumento Descripción
name (necesario) Especifica el nombre de la acción de salud.

Ejemplos del mandato deleteHealthAction

Ejemplo de utilización de la modalidad por lotes:

  • Utilizando Jacl:
    $Admintask deleteHealthAction {-name myHealthAction}
  • Utilizando Jython:
    AdminTask.deleteHealthAction('-name myHealthAction')

Mandato listHealthActions

El mandato listHealthActions enumera todas las acciones de salud definidas en la célula.

Ejemplos del mandato listHealthActions

Ejemplo de utilización de la modalidad por lotes:

  • Utilizando Jacl:
    $Admintask listHealthActions
  • Utilizando Jython:
    AdminTask.listHealthActions

Mandato executeHealthAction

El mandato executeHealthAction ejecuta la acción de salud especificada.
Tabla 19. Argumentos del mandato executeHealthAction
Argumento Descripción
name (necesario) Especifica el nombre de la acción de salud que desea ejecutar.
node (necesario) Especifica el nodo en el que se va a realizar la acción. Este parámetro sólo es necesario para las acciones personalizadas. Las opciones válidas son un nombre de nodo o la serie vacía "".
server (necesario) Especifica el servidor en el que se va a realizar la acción.
célula Especifica la célula en la que se va a ejecutar la acción de salud.
timeout Especifica un valor de tiempo de espera excedido para ejecutar la acción de salud.
variables Especifica valores de java.util.Properties de variables.

Ejemplos del mandato executeHealthAction

Ejemplo de utilización de la modalidad por lotes:

  • Utilizando Jacl:
    $AdminTask executeHealthAction {-name myHealthAction -node myNode -server myServer}
  • Utilizando Jython:
    AdminTask.executeHealthAction ('[-name myHealthAction -node myNode -server myServer]')

Ejemplo de utilización de la modalidad interactiva:

  • Utilizando Jacl:
    $AdminTask executeHealthAction {-interactive}
  • Utilizando Jython:
    AdminTask.executeHealthAction ('[-interactive]')

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwve_adtaskhealth
File name: rwve_adtaskhealth.html