É possível usar as seguintes tarefas administrativas para criar, excluir e gerenciar políticas de funcionamento.
Comando createHealthPolicy
O comando createHealthPolicy
cria uma nova política de funcionamento.
Tabela 1. Argumentos do Comando createHealthPolicy
Argumento |
Descrição |
name (necessário) |
Especifica um nome para a política de funcionamento
que é exclusiva na célula. |
descrição |
Especifica uma descrição para a política de funcionamento. |
reactionMode |
Especifica se as tarefas de tempo de
execução são criadas antes de desempenhar ações em uma política de funcionamento ou se as ações são automáticas.
O valor pode ser SUPERVISE ou AUTOMATIC. |
Tabela 2. Argumentos de Etapa addCondition
Argumento |
Descrição |
type (necessário) |
Especifica o tipo de condição. O valor
pode ser CUSTOM, AGE, WORKLOAD, MEMORY_LEAK, EXCESSIVE_MEMORY, EXCESSIVE_RESPONSE_TIME,
EXCESSIVE_REQUEST_TIMEOUT ou STORM_DRAIN. Cada valor possui parâmetros diferentes
que devem ser especificados. |
expression |
Se você estiver utilizando uma condição customizada,
especifique uma sub-expressão a ser avaliada. |
params |
- AGE
- maxAge: Especifica a idade máxima.
- ageUnits: Especifica o tipo de unidades para o parâmetro de idade. O valor
pode ser HOURS ou MINUTES. O padrão é HOURS.
- WORKLOAD
- totalRequests: Especifica o total de pedidos para serviço antes de reiniciar
os membros. O número deve ser maior ou igual a 1000.
- MEMORY_LEAK
- level: Especifica o nível de detecção para fuga de memória. O valor pode
ser FAST, NORMAL ou CONSERVATIVE. O padrão é FAST.
- EXCESSIVE_MEMORY
- timeOverThreshold: Especifica o período de tempo de transgressão
para a condição de memória excessiva.
- timeUnits: Especifica as unidades para o valor de timeOverThreshold. O valor
pode ser MINUTES ou SECONDS. O padrão é MINUTES.
- memoryUsed: especifica a porcentagem que representa o tamanho máximo de heap de Java Virtual
Machine (JVM) a ser usado para o processo do JVM. O valor varia de 1 a 99.
- EXCESSIVE_RESPONSE_TIME
- responseTime: Especifica o tempo médio de resposta que é considerado
excessivo. Quando a média atinge esse valor, os membros reiniciam.
- responseTimeUnits: Especifica as unidades de tempo para o tempo de resposta. O
valor pode ser MINUTES, SECONDS ou MILLISECONDS.
- EXCESSIVE_REQUEST_TIMEOUT
- timeoutPercent: Especifica o valor do limite para a porcentagem dos
pedidos que atinjiram o tempo limite para causar uma violação de condição. Esse valor varia de 1 a 99.
- STORM_DRAIN
- level: Especifica o nível de detecção. O valor pode ser NORMAL ou CONSERVATIVE. NORMAL é
menos preciso, mas pode detectar uma condição de dreno em excesso rapidamente. CONSERVATIVE é
mais preciso, mas demora mais para detectar uma condição de dreno em excesso.
|
Tabela 3. Argumentos de Etapa addAction.
Utilize os argumentos de etapa addAction
em um formato de tabela. Com o formato de tabela, é possível especificar os parâmetros
na ordem sem o nome do parâmetro.
Argumento |
Descrição |
type (necessário) |
Especifica o tipo de ação. O valor
pode ser CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK ou MAINT_MODE_STOP. |
stepNum (necessário) |
Especifica a ordem em que desempenhar
as ações. A etapa 1 é concluída primeiramente, e assim por diante. |
ação |
Especifica o nome
de uma ação customizada. Utilize o comando createHealthAction para criar uma ação
customizada. |
Nó |
Especifica o nó em que desempenhar
a ação. |
Servidor |
Especifica o servidor em que desempenhar
a ação. |
Tabela 4. Argumentos de Etapa addMember.
Utilize os argumentos de etapa addMember
em um formato de tabela. Com o formato de tabela, é possível especificar os parâmetros
na ordem sem o nome do parâmetro.
Argumento |
Descrição |
type (necessário) |
Especifica o tipo de membro. O
valor pode ser CELL, CLUSTER, DYNAMIC_CLUSTER, SERVER ou ODR. |
name (necessário) |
Especifica o nome do membro. |
Nó |
Especifica o nome do nó.
O nome do nó é necessário se você selecionar o tipo SERVER. |
Exemplo
Exemplo de uso do modo interativo:
Exemplo de uso do modo de lote:
O comando a seguir cria uma política de funcionamento com uma das seguintes condições de funcionamento predefinidas:
$AdminTask createHealthPolicy { -name myHealthPolicy -description "Minha Política de Funcionamento" -reactionMode SUPERVISE
-addCondition { -type AGE -params {{maxAge 12} {ageUnits HOURS}} } -addAction {{HEAPDUMP 1}{CUSTOM 2 myAction
myNode myServer} } -addMember {SERVER myServer myNode} }
O comando
a seguir cria uma política de funcionamento com uma condição customizada:
$AdminTask createHealthPolicy { -name myHealthPolicy -description "Minha Política de Funcionamento" -reactionMode SUPERVISE
-addCondition { -type CUSTOM -expression "ODRServerMetric_FromServerStart$errors > 100L" }
-addAction {{HEAPDUMP 1}{CUSTOM 2 myAction myNode myServer} } -addMember {SERVER myServer myNode} }
Delimite com aspas
a expressão para a condição customizada.
Comando modifyHealthPolicy
O comando modifyHealthPolicy
altera uma política de funcionamento existente.
Tabela 5. Argumentos Iniciais
Argumento |
Descrição |
name (necessário) |
Especifica o nome da política de funcionamento que você deseja
alterar. |
reactionMode |
Especifica se as tarefas de tempo de
execução são criadas antes de desempenhar ações em uma política de funcionamento ou se as ações são automáticas.
O valor pode ser SUPERVISE ou AUTOMATIC. |
Tabela 6. Argumentos de Etapa modifyCondition
Argumento |
Descrição |
tipo |
Especifica o tipo de condição. O valor
pode ser CUSTOM, AGE, WORKLOAD, MEMORY_LEAK, EXCESSIVE_MEMORY, EXCESSIVE_RESPONSE_TIME,
EXCESSIVE_REQUEST_TIMEOUT ou STORM_DRAIN. Cada valor possui parâmetros diferentes
que devem ser especificados. |
expression |
Se você estiver utilizando uma condição customizada,
especifique uma sub-expressão a ser avaliada. |
params |
- AGE
- maxAge: Especifica a idade máxima.
- ageUnits: Especifica o tipo de unidades para o parâmetro de idade. O valor
pode ser HOURS ou MINUTES. O padrão é HOURS.
- WORKLOAD
- totalRequests: Especifica o total de pedidos para serviço antes de reiniciar
os membros. O número deve ser maior ou igual a 1000.
- MEMORY_LEAK
- level: Especifica o nível de detecção para fuga de memória. O valor pode
ser FAST, NORMAL ou CONSERVATIVE. O padrão é FAST.
- EXCESSIVE_MEMORY
- timeOverThreshold: Especifica o período de tempo de transgressão
para a condição de memória excessiva.
- timeUnits: Especifica as unidades para o valor de timeOverThreshold. O valor
pode ser MINUTES ou SECONDS. O padrão é MINUTES.
- memoryUsed: especifica a porcentagem que representa o tamanho máximo de heap de Java Virtual
Machine (JVM) a ser usado para o processo do JVM. O valor varia de 1 a 99.
- EXCESSIVE_RESPONSE_TIME
- responseTime: Especifica o tempo médio de resposta que é considerado
excessivo. Quando a média atinge esse valor, os membros reiniciam.
- responseTimeUnits: Especifica as unidades de tempo para o tempo de resposta. O
valor pode ser MINUTES, SECONDS ou MILLISECONDS.
- EXCESSIVE_REQUEST_TIMEOUT
- timeoutPercent: Especifica o valor do limite para a porcentagem dos
pedidos que atinjiram o tempo limite para causar uma violação de condição. Esse valor varia de 1 a 99.
- STORM_DRAIN
- level: Especifica o nível de detecção. O valor pode ser NORMAL ou CONSERVATIVE. NORMAL é
menos preciso, mas pode detectar uma condição de dreno em excesso rapidamente. CONSERVATIVE é
mais preciso, mas demora mais para detectar uma condição de dreno em excesso.
|
Tabela 7. Argumentos de Etapa removeAction
Argumento |
Descrição |
name |
Especifica o nome da ação de funcionamento a ser removida. O parâmetro
de nome só é utilizado para ações customizadas. |
type (necessário) |
Especifica o tipo de ação. O valor
pode ser CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK ou MAINT_MODE_STOP. |
Tabela 8. Argumentos de Etapa addAction
Argumento |
Descrição |
type (necessário) |
Especifica o tipo de ação. O valor
pode ser CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK ou MAINT_MODE_STOP. |
nome
|
Especifica o nome da ação de funcionamento. O parâmetro
de nome só é utilizado para ações customizadas. |
Nó |
Especifica o nó em que desempenhar
a ação. |
Servidor |
Especifica o servidor em que desempenhar
a ação. |
stepNum (necessário) |
Especifica a ordem em que desempenhar
as ações. A etapa 1 é concluída primeiramente, e assim por diante. |
Tabela 9. Argumentos de Etapa orderAction
Argumento |
Descrição |
nome
|
Especifica o nome da ação de funcionamento. O parâmetro
de nome só é utilizado para ações customizadas. |
tipo |
Especifica o tipo de ação. O valor
pode ser CUSTOM, HEAPDUMP, THREADDUMP, RESTART_SERVER, SET_MAINT_MODE, MAINT_MODE_BREAK ou MAINT_MODE_STOP. |
stepNum (necessário) |
Especifica a ordem em que desempenhar
as ações. A etapa 1 é concluída primeiramente, e assim por diante. |
Tabela 10. Argumentos de Etapa addMember
Argumento |
Descrição |
type (necessário) |
Especifica o tipo de membro. O
valor pode ser CELL, CLUSTER, DYNAMIC_CLUSTER, SERVER ou ODR. |
name (necessário) |
Especifica o nome do membro. |
Nó |
Especifica o nome do nó.
O nome do nó é necessário se você selecionar o tipo SERVER. |
Exemplo
Exemplo de uso do modo interativo:
Exemplo de uso do modo de lote:$AdminTask modifyHealthPolicy { -name myHealthPolicy -removeAction { -type HEAPDUMP } }
Comando deleteHealthPolicy
O comando deleteHealthPolicy
remove a política de funcionamento denominada.
Tabela 11. Argumentos do Comando deleteHealthPolicy
Argumento |
Descrição |
name (necessário) |
Especifica o nome da política de funcionamento a ser excluída. |
Exemplo
Exemplo de uso do modo de lote:
Exemplo de uso do modo interativo:
Comando listHealthPolicies
O comando listHealthPolicies lista
cada política de funcionamento configurada na célula.
Comando createHealthAction
O comando createHealthAction
cria uma nova ação de funcionamento que pode ser utilizada ao definir políticas de funcionamento.
Tabela 12. Argumentos do Comando createHealthAction
Argumento |
Descrição |
name (necessário) |
Especifica um nome para a ação de funcionamento. |
É possível criar uma ação do Java ou uma ação que seja de outro tipo de arquivo executável.
Tabela 13. Argumentos de Etapa não-Java
Argumento |
Descrição |
executable |
Especifica o caminho do arquivo executável. Esse argumento é necessário se você especificar um argumento de etapa não-Java. |
executableArgs |
Especifica uma matriz de cadeia de
argumentos a serem transmitidos para o arquivo executável. |
osNames |
Especifica uma lista delimitada por vírgula de
sistemas operacionais. Especifique null para que a ação seja aplicada ao
sistema operacional. Os nomes de sistema operacional válidos são: windows, unix
e zos. |
workingDir |
Especifica o local no sistema de
arquivo de onde o comando é chamado. Esse argumento é necessário se você especificar um argumento de etapa não-Java. |
usernameVar |
Especifica uma variável para o nome
de usuário. |
userNameVal |
Especifica o valor para a
variável do nome de usuário. |
passwordVar |
Especifica uma variável para a senha. |
passwordVal |
Especifica o valor da variável da
senha. |
Tabela 14. Argumentos de Etapa Java
Argumento |
Descrição |
javaDir |
Especifica o local do arquivo executável Java, por exemplo, ${JAVA_HOME}. É possível especificar uma variável
ou um caminho. |
executableTargetType |
Especifica o tipo de arquivo que você está usando para o arquivo executável Java. O valor pode ser EXECUTABLE_JAR ou JAVA_CLASS. |
executable |
Especifica o caminho do arquivo executável. Este argumento será necessário, se você especificar um argumento de etapa Java. |
exectuableArgs |
Especifica uma matriz de cadeia de
argumentos a serem transmitidos para o arquivo executável. |
osNames |
Especifica uma lista delimitada por vírgula de
sistemas operacionais. Especifique null para que a ação seja aplicada ao
sistema operacional. Os nomes de sistema operacional válidos são: windows, unix
e zos. |
pidVarName |
Especifica o nome da variável de ID do processo Java. |
workingDir |
Especifica o local no sistema de
arquivo de onde o comando é chamado.Este argumento será necessário, se você especificar um argumento de etapa Java. |
usernameVar |
Especifica uma variável para o nome
de usuário. |
usernameVal |
Especifica o valor para a
variável do nome de usuário. |
passwordVar |
Especifica uma variável para a senha. |
passwordVal |
Especifica o valor da variável da
senha. |
Exemplo
Exemplo de uso do modo de batch:
Exemplo de uso do modo interativo:
Comando modifyHealthAction
Utilize o comando modifyHealthAction
para modificar uma ação de funcionamento existente.
Tabela 15. Argumentos do Comando
modifyHealthAction
Argumento |
Descrição |
name (necessário) |
Especifica um nome para a ação de funcionamento que você deseja
modificar. |
Tabela 16. Argumentos de Etapa não-Java
Argumento |
Descrição |
executable |
Especifica o caminho do arquivo executável. |
executableArgs |
Especifica uma matriz de cadeia de
argumentos a serem transmitidos para o arquivo executável. |
workingDir |
Especifica o local no sistema de
arquivo de onde o comando é chamado. |
usernameVar |
Especifica uma variável para o nome
de usuário. |
usernameVal |
Especifica o valor para a
variável do nome de usuário. |
passwordVar |
Especifica uma variável para a senha. |
passwordVal |
Especifica o valor da variável da
senha. |
Tabela 17. Argumentos de Etapa Java
Argumento |
Descrição |
javaDir |
Especifica o local do arquivo executável Java, por exemplo, ${JAVA_HOME}. É possível especificar uma variável
ou um caminho. |
executableTargetType |
Especifica o tipo de arquivo que você está usando para o arquivo executável Java. O valor pode ser EXECUTABLE_JAR ou JAVA_CLASS. |
executable |
Especifica o caminho do arquivo executável. |
executableArgs |
Especifica uma matriz de cadeia de
argumentos a serem transmitidos para o arquivo executável. |
pidVarName |
Especifica o nome da variável de ID do processo Java. |
usernameVar |
Especifica uma variável para o nome
de usuário. |
usernameVal |
Especifica o valor para a
variável do nome de usuário. |
passwordVar |
Especifica uma variável para a senha. |
passwordVal |
Especifica o valor da variável da
senha. |
workingDir |
Especifica o local no sistema de
arquivo de onde o comando é chamado. |
Exemplo
Exemplo de uso do modo de lote:
$AdminTask modifyHealthAction { -name myAction -java { -javaDir c:\java\bin -executableTargetType EXECUTABLE_JAR
-executable test.jar -executableArgs "{arg1}{arg2a arg2b}" -pidVarName pvn -workingDir c:\workingDir } }
Exemplo de uso do modo interativo:
Comando deleteHealthAction
O comando deleteHealthAction
remove uma ação de funcionamento.
Tabela 18. Argumentos do Comando deleteHealthAction
Argumento |
Descrição |
name (necessário) |
Especifica um nome para a ação de funcionamento. |
Exemplo
Exemplo de uso do modo de lote:
Comando listHealthActions
O comando listHealthActions lista
cada uma das ações de funcionamento definidas na célula.
Exemplo
Exemplo de uso do modo de lote:
Comando executeHealthAction
O comando executeHealthAction
executa a ação de funcionamento especificada.
Tabela 19. Argumentos do Comando
executeHealthAction
Argumento |
Descrição |
name (necessário) |
Especifica o nome da ação de funcionamento que você deseja
desempenhar. |
node (necessário) |
Especifica o nó em que desempenhar
a ação. |
server (necessário) |
Especifica o servidor em que desempenhar
a ação. |
cell
|
Especifica a célula em que desempenhar a ação de funcionamento. |
timeout |
Especifica um valor de tempo limite para execução da ação de funcionamento. |
|
Especifica valores de variáveis java.util.Properties. |
Exemplo
Exemplo de uso do modo de lote:
Exemplo de uso do modo interativo: