WebSphere Virtual Enterprise, Version 6.1.1
             Sistemas Operacionais: AIX,, HP-UX, Linux, Solaris, Windows ,


Tarefas Administrativas da Política de Funcionamento

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

Exemplo

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:




Conceitos relacionados
Gerenciamento de funcionamento
Tarefas relacionadas
Configurando o Gerenciamento de Funcionamento
Criando Políticas de Funcionamento
Criando Ações Customizadas de Política de Funcionamento
Configurando o Modo de Manutenção
Referências relacionadas
Tarefas Administrativas de Modo de Manutenção
Tópico de Referência    

Termos de Uso | Feedback

Última atualização: 24/09/2009 14h19min03s EDT
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r1m1/index.jsp?topic=/com.ibm.websphere.ops.doc/info/reference/radtaskhealth.html