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

Intelligent Management: 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, STORM_DRAIN ou GC_PERCENTAGE. 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 solicitações 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 a 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 ofensivo para a condição de memória excessiva. O padrão é 1 MINUTO.
    • 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 de heap máximo da Java™ virtual machine (JVM) a ser usado para o processo da 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 das solicitações que atingiram 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.
  • GC_PERCENTAGE
    • garbageCollectionPercent: O valor do limite para a porcentagem de tempo gasta na coleta de lixo. Esse valor pode estar entre 1 e 99. O valor padrão é 10.
    • samplingPeriod: O período de amostragem para reunir dados de coleta de lixo. A quantia de tempo total gasta na coleta de lixo durante o período de tempo de amostragem deve ser maior que o valor do limite antes de uma ação corretiva. Esse valor pode variar de 1 minuto a 24 horas. O valor padrão é 2 minutos.
    • samplingUnits: Especifica as unidades de tempo para o parâmetro samplingPeriod. O valor pode ser MINUTES ou HOURS. O valor padrão é MINUTES.
    • Evitar Problemas Evitar Problemas: Os parâmetros garbageCollectionPercent e samplingPeriod são necessários e devem ser especificados para executar o comando.gotcha
Tabela 3. Argumentos de Etapa addAction.

Use os argumentos de etapa addAction em 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.
action Especifica o nome de uma ação customizada. Use o comando createHealthAction para criar uma ação customizada. Esse parâmetro é necessário somente para ações customizadas.
node Especifica o nó no qual a ação deve ser tomada. Esse parâmetro é necessário somente para ações customizadas. Opções válidas são um nome de nó ou uma sequência de caracteres vazia "".

server Especifica o servidor em que desempenhar a ação.

Esse parâmetro é necessário somente para ações customizadas. Opções válidas são um nome de servidor ou uma das sequências a seguir: "Servidor inconforme" ou "Agente do nó do servidor inconforme". Se uma dessas duas sequências for usada, o valor de nó válido é a sequência de caracteres vazia, "".

Tabela 4. Argumentos de Etapa addMember.

Use os argumentos de etapa addMember em 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.
node Especifica o nome do nó. O nome do nó é necessário se você selecionar o tipo SERVER.

Exemplos do Comando createHealthPolicy

Exemplo de uso no modo interativo:

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

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

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 myServer1 myNode1}{SERVER myServer2 mynode2}} 
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
type Especifica o tipo de condição. O valor pode ser CUSTOM, AGE, WORKLOAD, MEMORY_LEAK, EXCESSIVE_MEMORY, EXCESSIVE_RESPONSE_TIME, EXCESSIVE_REQUEST_TIMEOUT, STORM_DRAIN ou GC_PERCENTAGE. 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 solicitações 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 a 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 ofensivo para a condição de memória excessiva. O padrão é 1 MINUTO.
    • 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 de heap máximo da Java virtual machine (JVM) a ser usado para o processo da 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 das solicitações que atingiram 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.
  • GC_PERCENTAGE
    • garbageCollectionPercent: O valor do limite para a porcentagem de tempo gasta na coleta de lixo. Esse valor pode estar entre 1 e 99. O valor padrão é 10.
    • samplingPeriod: O período de amostragem para reunir dados de coleta de lixo. A quantia de tempo total gasta na coleta de lixo durante o período de tempo de amostragem deve ser maior que o valor do limite antes de uma ação corretiva. Esse valor pode variar de 1 minuto a 24 horas. O valor padrão é 2 minutos.
    • samplingUnits: Especifica as unidades de tempo para o parâmetro samplingPeriod. O valor pode ser MINUTES ou HOURS. O valor padrão é MINUTES.
    • Evitar Problemas Evitar Problemas: Os parâmetros garbageCollectionPercent e samplingPeriod são necessários e devem ser especificados para executar o comando.gotcha
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.
action Especifica o nome da ação de funcionamento. Use o comando createHealthAction para criar uma ação customizada. Esse parâmetro é necessário somente para ações customizadas.
node Especifica o nó no qual a ação deve ser tomada. Esse parâmetro é necessário somente para ações customizadas. Opções válidas são um nome de nó ou uma sequência de caracteres vazia "".
server Especifica o servidor em que desempenhar a ação.

Esse parâmetro é necessário somente para ações customizadas. Opções válidas são um nome de servidor ou uma das sequências a seguir: "Servidor inconforme" ou "Agente do nó do servidor inconforme". Se uma dessas duas sequências for usada, o valor de nó válido é a sequência de caracteres vazia, "".

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.
type 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.
node Especifica o nome do nó. O nome do nó é necessário se você selecionar o tipo SERVER.

Exemplos do Comando modifyHealthPolicy

Exemplo de uso no modo interativo:

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

Exemplo de uso do modo de lote:

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

Comando deleteHealthPolicy

O comando deleteHealthPolicy remove \ 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.

Exemplos do Comando deleteHealthPolicy

Exemplo de uso do modo de lote:

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

Exemplo de uso no modo interativo:

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

Comando listHealthPolicies

O comando listHealthPolicies lista cada política de funcionamento configurada na célula.

Exemplos do Comando listHealthPolicies

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

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.

Exemplos do Comando createHealthAction

Exemplo de uso do modo de lote:

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

Exemplo de uso no modo interativo:

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

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.

Exemplos do Comando modifyHealthAction

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 no modo interativo:

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

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.

Exemplos do Comando deleteHealthAction

Exemplo de uso do modo de lote:

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

Comando listHealthActions

O comando listHealthActions lista cada uma das ações de funcionamento definidas na célula.

Exemplos do Comando listHealthActions

Exemplo de uso do modo de lote:

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

Comando executeHealthAction

O comando executeHealthAction executa uma 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.
nó (necessário) Especifica o nó no qual a ação deve ser tomada. Esse parâmetro é necessário somente para ações customizadas. Opções válidas são um nome de nó ou uma sequência de caracteres vazia "".
servidor (necessário) Especifica o servidor em que desempenhar a ação.
célula Especifica a célula em que desempenhar a ação de funcionamento.
tempo limite Especifica um valor de tempo limite para execução da ação de funcionamento.
variables Especifica valores de variáveis java.util.Properties.

Exemplos do Comando executeHealthAction

Exemplo de uso do modo de lote:

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

Exemplo de uso no modo interativo:

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

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwve_adtaskhealth
Nome do arquivo: rwve_adtaskhealth.html