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 o STORM_DRAIN. 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. El valor predeterminado es 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. El valor predeterminado es FAST.
- EXCESSIVE_MEMORY
- timeOverThreshold: especifica el periodo de tiempo causante de la condición
de memoria excesiva
- timeUnits: especifica las unidades del valor de timeOverThreshold. El valor
puede ser MINUTES o SECONDS. El valor predeterminado es 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.
|
Tabla 3. Argumentos del paso addAction.
Utilice los argumentos del paso 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. |
nodo |
Especifica el nodo en el que se va a realizar
la acción. |
servidor |
Especifica el servidor en el que se va a realizar
la acción. |
Tabla 4. Argumentos del paso addMember.
Utilice los argumentos del paso 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. |
nodo |
Especifica el nombre del nodo.
Es necesario el nombre de nodo si se selecciona el tipo SERVER. |
Ejemplo
Ejemplo de utilización de la modalidad interactiva:
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 "Mi política de salud" -reactionMode SUPERVISE
-addCondition { -type AGE -params {{maxAge 12} {ageUnits HOURS}} } -addAction {{HEAPDUMP 1}{CUSTOM 2 myAction
myNode myServer} } -addMember {SERVER myServer myNode} }
El mandato siguiente crea una política de salud
con una condición personalizada:
$AdminTask createHealthPolicy { -name myHealthPolicy -description "Mi política de salud" -reactionMode SUPERVISE
-addCondition { -type CUSTOM -expression "ODRServerMetric_FromServerStart$errors > 100L" }
-addAction {{HEAPDUMP 1}{CUSTOM 2 myAction myNode myServer} } -addMember {SERVER myServer myNode} }
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 del paso modifyCondition
Argumento |
Descripción |
tipo |
Especifica el tipo de condición. El valor
puede ser CUSTOM, AGE, WORKLOAD, MEMORY_LEAK, EXCESSIVE_MEMORY, EXCESSIVE_RESPONSE_TIME,
EXCESSIVE_REQUEST_TIMEOUT o STORM_DRAIN. 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. El valor predeterminado es 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. El valor predeterminado es FAST.
- EXCESSIVE_MEMORY
- timeOverThreshold: especifica el periodo de tiempo causante de la condición
de memoria excesiva
- timeUnits: especifica las unidades del valor de timeOverThreshold. El valor
puede ser MINUTES o SECONDS. El valor predeterminado es 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.
|
Tabla 7. Argumentos del paso removeAction
Argumento |
Descripción |
name |
Especifica el nombre de la acción de salud que se a 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 del paso 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. |
name |
Especifica el nombre de la acción de salud. El
parámetro name sólo se utiliza para las acciones personalizadas. |
nodo |
Especifica el nodo en el que se va a realizar
la acción. |
servidor |
Especifica el servidor en el que se va a realizar
la acción. |
stepNum (necesario) |
Especifica el orden en que se realizan
las acciones. El paso 1 se termina el primero y así sucesivamente. |
Tabla 9. Argumentos del paso 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. |
tipo |
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 del paso 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. |
nodo |
Especifica el nombre del nodo.
Es necesario el nombre de nodo si se selecciona el tipo SERVER. |
Ejemplo
Ejemplo de utilización de la modalidad interactiva:
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. |
Ejemplo
Ejemplo de utilización de la modalidad por
lotes:
Ejemplo de utilización de la modalidad interactiva:
Mandato listHealthPolicies
El mandato listHealthPolicies enumera
todas las políticas de salud configuradas de la célula.
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 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. |
Ejemplo
Ejemplo de utilización de la modalidad por lotes:
Ejemplo de utilización de la modalidad interactiva:
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 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. |
Ejemplo
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:
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. |
Ejemplo
Ejemplo de utilización de la modalidad por
lotes:
Mandato listHealthActions
El mandato listHealthActions enumera
todas las acciones de salud definidas en la célula.
Ejemplo
Ejemplo de utilización de la modalidad por
lotes:
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. |
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. |
Ejemplo
Ejemplo de utilización de la modalidad por
lotes:
Ejemplo de utilización de la modalidad interactiva: