Grupo de Comandos JobManagerNode para o Objeto AdminTask Utilizando a Programação de Script Wsadmin

É possível utilizar a linguagem de script Jython para gerenciar as configurações do gerenciador de tarefas com a ferramenta wsadmin. Use os comandos e parâmetros no grupo JobManagerNode para registrar destinos que não contêm um agente administrativo com o gerenciador de tarefa.

Use comandos que possuem Target nos nomes do comando: cleanupTarget, queryTargets, getTargetProperties, modifyTargetProperties e getTargetKeys. Esses comandos substituem os comandos descontinuados que possuem ManagedNode nos nomes dos comandos.

Recurso Reprovado Recurso Reprovado: Os comandos no grupo de comandos JobManagerNode que possuem ManagedNode nos nomes do comando e que foram descontinuados no WebSphere Application Server Versão 8.0 incluem cleanupManagedNode, queryManagedNodes, getManagedNodeProperties, modifyManagedNodeProperties e getManagedNodeKeys. Em vez disso, use comandos que possuem Target nos nomes dos comandos.depfeat

cleanupManagedNode (Descontinuado)

O comando cleanupManagedNode limpa informações de registro para um nó gerenciado. Se o sistema falha ao remover o nó do gerenciador de tarefa, utilize esse comando para limpar as informações de registro no gerenciador de tarefa. O comando não remove o histórico de tarefas do nó. As tarefas em progresso continuam a ser executadas, mas novas tarefas não são iniciadas no nó.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

-managedNodeName
Especifica o nome do nó de interesse. (Sequência, obrigatória)

Valor de retorno

O comando retorna o UUID do gerenciador de tarefas que o sistema limpou.

Exemplo de uso do modo em lote

  • Utilizando a sequência Jython:
    AdminTask.cleanupManagedNode('-managedNodeName Node1')
  • Utilizando a lista Jython:
    AdminTask.cleanupManagedNode(['-managedNodeName', 'Node1'])

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.cleanupManagedNode('-interactive')

cleanupTarget

O comando cleanupTarget limpa as informações de registro para um destino. Se o sistema falhar ao remover um destino do gerenciador de tarefa, utilize esse comando para limpar as informações de registro no gerenciador de tarefa. O comando não remove o histórico da tarefa para o destino. As tarefas em andamento continuam a executar, mas as novas tarefas não iniciam para o destino.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

-targetName
Especifica o nome do destino de seu interesse. (Sequência, obrigatória)

Valor de retorno

O comando retorna o UUID do gerenciador de tarefas que o sistema limpou.

Exemplo de uso do modo em lote

  • Utilizando a sequência Jython:
    AdminTask.cleanupTarget('-targetName Target1')
  • Utilizando a lista Jython:
    AdminTask.cleanupTarget(['-targetName', 'Target1'])

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.cleanupTarget('-interactive')

getContexts

O comando getContexts exibe todos os contextos no modelo de gerenciamento, incluindo nós e servidores.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

Nenhum.

Valor de retorno

O comando retorna uma lista de todos os caminhos do contexto.

Exemplo de uso do modo em lote

  • Utilizando a sequência Jython:
    AdminTask.getContexts()
  • Utilizando a lista Jython:
    AdminTask.getContexts()

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.getContexts('-interactive')

getManagedNodeKeys (Descontinuado)

O comando getManagedNodeKeys exibe as chaves a serem utilizadas para consultar nós gerenciados, incluindo as chaves name, alias e uuid.

Objeto de destino

Nenhum.

Parâmetros Opcionais

-managedNodeName
Especifica o nome do nó de interesse. (Sequência, opcional)

Valor de retorno

O comando retorna uma lista das chaves.

Exemplo de uso do modo em lote

  • Utilizando a sequência Jython:
    AdminTask.getManagedNodeKeys('-managedNodeName Node1')
  • Utilizando a lista Jython:
    AdminTask.getManagedNodeKeys(['-managedNodeName', 'Node1'])

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.getManagedNodeKeys('-interactive')

getTargetKeys

O comando getTargetKeys exibe as chaves a serem utilizadas para consultar destinos, incluindo as chaves name, alias e uuid.

Objeto de destino

Nenhum.

Parâmetros Opcionais

-targetName
Especifica o nome do destino de seu interesse. (Sequência, opcional)

Valor de retorno

O comando retorna uma lista das chaves.

Exemplo de uso do modo em lote

  • Utilizando a sequência Jython:
    AdminTask.getTargetKeys('-targetName Target1')
  • Utilizando a lista Jython:
    AdminTask.getTargetKeys(['-targetName', 'Target1'])

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.getTargetKeys('-interactive')

getManagedNodeProperties (Descontinuado)

O comando getManagedNodeProperties exibe as propriedades para um ou mais nós gerenciados ou não gerenciados.

Objeto de destino

Nenhum.

Parâmetros Opcionais

-managedNodeNameList
Especifica uma lista de nomes dos nós de interesse. (Sequência[], opcional)

Valor de retorno

O comando retorna uma lista de propriedades para cada nó especificado com o parâmetro -managedNodeNameList.

Exemplo de uso do modo em lote

  • Utilizando a sequência Jython:
    AdminTask.getManagedNodeProperties('-managedNodeNameList "[Node1 Node2]"')
  • Utilizando a lista Jython:
    AdminTask.getManagedNodeProperties(['-managedNodeNameList', '[Node1 Node2]'])

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.getManagedNodeProperties('-interactive')

getTargetProperties

O comando getTargetProperties exibe as propriedades para um ou mais destinos.

Objeto de destino

Nenhum.

Parâmetros Opcionais

-targetNameList
Especifica uma lista de nomes dos destinos de interesse. (Sequência[], opcional)

Valor de retorno

O comando retorna uma lista de propriedades para cada destino especificado com o parâmetro -targetNameList.

Exemplo de uso do modo em lote

  • Utilizando a sequência Jython:
    AdminTask.getTargetProperties('-targetNameList "[Target1 Target2]"')
  • Utilizando a lista Jython:
    AdminTask.getTargetProperties(['-targetNameList', '[Target1 Target2]'])

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.getTargetProperties('-interactive')

getManagedResourceProperties

O comando getManagedResourceProperties exibe as propriedades de um ou mais recursos gerenciados. Os recursos gerenciados são instâncias dentro de um contexto de nó ou um contexto de servidor. Por exemplo, dentro de um contexto de servidor, é possível ter os recursos gerenciados server1, server2 ou server3.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

-resourceIdList
Especifica uma lista de identificadores exclusivos para os recursos de interesse. (Sequência, opcional)

Valor de retorno

O comando retorna uma lista de propriedades para cada recurso gerenciado.

Exemplo de uso do modo em lote

  • Utilizando a sequência Jython:
    AdminTask.getManagedResourceProperties('-resourceIdList AppSrv01-BASE-b83dc35c-69d4-40af-af60-127de7002cfb
    /nodes/myNode/servers/server1')  
  • Utilizando a lista Jython:
    AdminTask.getManagedResourceProperties('-resourceIdList', 'AppSrv01-BASE-b83dc35c-69d4-40af-af60-127de7002cfb
    /nodes/myNode/servers/server1')  

Uso de exemplo do modo interativo

  • Utilizando Jython:
    AdminTask.getManagedResourceProperties('-interactive')

getManagedResourcePropertyKeys

O comando getManagedResourcePropertyKeys exibe as chaves de propriedade para um tipo de recurso gerenciado específico.

Objeto de Destino

Nenhum.

Parâmetros Obrigatórios

-resourceType
Especifica o tipo de recurso gerenciado de interesse. (Sequência, obrigatória)

Valor de retorno

O comando retorna uma lista de chaves de recursos gerenciados para o tipo de recurso específico.

Exemplo de uso do modo em lote

  • Utilizando a sequência Jython:
    AdminTask.getManagedResourcePropertyKeys('-resourceType server')
  • Utilizando a lista Jython:
    AdminTask.getManagedResourcePropertyKeys('-resourceType', 'server')

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.getManagedResourcePropertyKeys('-interactive')

getManagedResourceTypes

O comando getManagedResourceTypes exibe cada um dos tipos de recurso gerenciado.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

Nenhum.

Valor de retorno

O comando retorna uma lista de tipos de recursos gerenciados.

Exemplo de uso do modo em lote

  • Utilizando a sequência Jython:
    AdminTask.getManagedResourceTypes()
  • Utilizando a lista Jython:
    AdminTask.getManagedResourceTypes()

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.getManagedResourceTypes('-interactive')

modifyManagedNodeProperties (Descontinuado)

O comando modifyManagedNodeProperties substitui as propriedades em uma configuração de nó gerenciado. Se o nó gerenciado tiver um agente administrativo, o comando modificará apenas a propriedade alias. Se o nó gerenciado não tiver um agente administrativo, o comando substituirá todas as propriedades.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

-managedNodeName
Especifica o nome do nó de interesse. (Sequência, obrigatória)
-managedNodeProps
Especifica os pares de propriedade name e value a serem modificados para o nó de interesse. (Properties, obrigatório)

Parâmetros Opcionais

-replace
Especifica se deve substituir as propriedades existentes. Especifique true para substituir as propriedades existentes. Especifique false para combinar as propriedades. O valor padrão é false. (Booleano, opcional)

Valor de retorno

O comando não retorna saída.

Exemplo de uso do modo em lote

  • Utilizando a sequência Jython:
    AdminTask.modifyManagedNodeProperties('-managedNodeName Node1 -managedNodeProps "[alias myNewAlias]"')
  • Utilizando a lista Jython:
    AdminTask.modifyManagedNodeProperties('-managedNodeName', 'Node1', '-managedNodeProps', '[alias myNewAlias]')

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.modifyManagedNodeProperties('-interactive')

modifyTargetProperties

O comando modifyTargetProperties substitui as propriedades em uma configuração de destino. Se o destino tiver um agente administrativo, o comando apenas modifica a propriedade alias. Se o destino não tiver um agente administrativo, o comando substitui todas as propriedades.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

-targetName
Especifica o nome do destino de seu interesse. (Sequência, obrigatória)
-targetProps
Especifica os pares de propriedade nome e valor a serem modificados para o destino de interesse. (Properties, obrigatório)

Parâmetros Opcionais

-replace
Especifica se deve substituir as propriedades existentes. Especifique true para substituir as propriedades existentes. Especifique false para combinar as propriedades. O valor padrão é false. (Booleano, opcional)

Valor de retorno

O comando não retorna saída.

Exemplo de uso do modo em lote

  • Utilizando a sequência Jython:
    AdminTask.modifyTargetProperties('-targetName Target1 -targetProps "[alias myNewAlias]"')
  • Utilizando a lista Jython:
    AdminTask.modifyTargetProperties('-targetName', 'Target1', '-targetProps', '[alias myNewAlias]')

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.modifyTargetProperties('-interactive')

queryManagedNodes (Descontinuado)

O comando queryManagedNodes procura por nós gerenciados com base em uma expressão de consulta. Se você não especificar uma expressão de consulta, o comando retornará todos os nós gerenciados.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

-maxReturn
Especifica o número máximo de nós gerenciados a serem retornados. (Número inteiro, obrigatório)

Parâmetros Opcionais

-query
Especifica uma consulta que consiste em uma ou mais expressões de consulta separadas por espaços. Se você não especificar esse parâmetro, o comando retornará todos os nós gerenciados. (Sequência, opcional)
Construa suas consultas com base nas seguintes diretrizes:
  • Cada expressão de consulta consiste nos elementos key, operator e value.
  • Os seguintes operadores são suportados:
    Tabela 1. Operadores queryManagedNodes -query. Use um operador em uma consulta.
    Caractere Valor
    = Igual a. Especifique se o valor for nulo utilizando = NULL.
    != Diferente de. Especifique se o valor não for nulo utilizando != NULL
    > Maior que
    < Menor que
    >= Maior que ou igual a
    <= Menor que ou igual a
  • Você pode especificar um valor ou vários valores separados por vírgulas.
  • É possível utilizar a correspondência de padrões para especificar o valor.
-validate
Especifica se deve validar a consulta de procura. (Booleano, opcional)

Valor de retorno

O comando retorna o número de correspondências que a consulta deve localizar. Em seguida, o comando retorna uma lista dos nós gerenciados que atendem aos critérios de consulta de procura.

Exemplo de uso do modo em lote

  • Utilizando a sequência Jython:
    AdminTask.queryManagedNodes('-maxReturn 20 -query "managedNodeName=Node1" -validate true')
  • Utilizando a lista Jython:
    AdminTask.queryManagedNodes(['-maxReturn', '20', '-query', 'managedNodeName=Node1', '-validate', 'true'])

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.queryManagedNodes('-interactive')

queryTargets

O comando queryTargets procura por destinos com base em uma expressão de consulta. Se você não especificar uma expressão de consulta, o comando retornará todos os destinos.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

-maxReturn
Especifica o número máximo de destinos a serem retornados. (Número inteiro, obrigatório)

Parâmetros Opcionais

-query
Especifica uma consulta que consiste em uma ou mais expressões de consulta separadas por espaços. Se você não especificar esse parâmetro, o comando retornará todos os destinos. (Sequência, opcional)
Construa suas consultas com base nas seguintes diretrizes:
  • Cada expressão de consulta consiste nos elementos key, operator e value.
  • Os seguintes operadores são suportados:
    Tabela 2. Operadores queryTargets -query. Use um operador em uma consulta.
    Caractere Valor
    = Igual a. Especifique se o valor for nulo utilizando = NULL.
    != Diferente de. Especifique se o valor não for nulo utilizando != NULL
    > Maior que
    < Menor que
    >= Maior que ou igual a
    <= Menor que ou igual a
  • Você pode especificar um valor ou vários valores separados por vírgulas.
  • É possível utilizar a correspondência de padrões para especificar o valor.
-validate
Especifica se deve validar a consulta de procura. (Booleano, opcional)

Valor de retorno

O comando retorna o número de correspondências que a consulta deve localizar. Em seguida, o comando retorna uma lista de destinos que atendem aos critérios de consulta de procura.

Exemplo de uso do modo em lote

  • Utilizando a sequência Jython:
    AdminTask.queryTargets('-maxReturn 20 -query "targetName=target1" -validate true')
  • Utilizando a lista Jython:
    AdminTask.queryTargets(['-maxReturn', '20', '-query', 'targetName=target1', '-validate', 'true'])

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.queryTargets('-interactive')

queryManagedResources

O comando queryManagedResources consulta seus recursos gerenciados por nós gerenciados com base em uma expressão de consulta.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

-maxReturn
Especifica o número máximo de recursos gerenciados a serem retornados. (Número inteiro, obrigatório)

Parâmetros Opcionais

-query
Especifica uma consulta que consiste em uma ou mais expressões de consulta separadas por espaços. Se você não especificar esse parâmetro, o comando retornará todos os nós gerenciados. (Sequência, opcional)
Construa suas consultas com base nas seguintes diretrizes:
  • Cada expressão de consulta consiste nos elementos key, operator e value.
  • Os seguintes operadores são suportados:
    Tabela 3. queryManagedResources -query operators. Use um operador em uma consulta.
    Caractere Valor
    = Igual a. Especifique se o valor for nulo utilizando = NULL.
    != Diferente de. Especifique se o valor não for nulo utilizando != NULL
    > Maior que
    < Menor que
    >= Maior que ou igual a
    <= Menor que ou igual a
  • Você pode especificar um valor ou vários valores separados por vírgulas.
  • É possível utilizar a correspondência de padrões para especificar o valor.
-validate
Especifica se deve validar a consulta de procura. (Booleano, opcional)

Valor de retorno

O comando retorna o número de correspondências que a consulta deve localizar. Em segundo lugar, o comando retorna uma lista de UUIDs dos nós gerenciados que atendem aos critérios de consulta de procura.

Exemplo de uso do modo em lote

  • Utilizando a sequência Jython:
    AdminTask.queryManagedResources('-maxReturn 20 -query "alias=managedNode1"')
  • Utilizando a lista Jython:
    AdminTask.queryManagedResources('-maxReturn', '20', '-query', '"alias=managedNode1"')

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.queryManagedResources('-interactive')

registerHost

O comando registerHost define um destino de host remoto para o gerenciador de tarefa. Utilize o comando registerHost para:

  • Registre um destino de host remoto com o gerenciador de tarefa. Diferentemente dos destinos que são perfis do WebSphere Application Server e são registrados utilizando o comando registerWithJobManager no gerenciador de implementação ou agente administrativo, um destino de host remoto não é necessário instalar algum produto do WebSphere Application Server. Não há requisitos de software para esse host além de seu sistema operacional.
  • Colete um inventário do host remoto. As informações relacionadas aos recursos gerenciados e aos tipos de tarefa estão disponíveis após a conclusão bem-sucedida do comando registerHost.

É possível trabalhar com destinos de host remotos da mesma forma que aqueles registrados utilizando registerWithJobManager, mas os tipos de tarefas disponíveis para um destino de host remoto são diferentes.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

-host
Especifica o nome do computador remoto para registrar com o gerenciador de tarefa. (Sequência, obrigatória)
-hostProps
Especifica as propriedades do host. É possível definir todas as propriedades que desejar. As propriedades definidas na tabela afetam o comportamento do comando. (Sequência, obrigatória)
Tabela 4. Propriedades Definidas registerHost -hostProps. É possível especificar uma ou mais propriedades definidas para o comando registerHost ou especificar propriedades definidas para o comando.
Nome da Propriedade Descrição da propriedade
osType O tipo do sistema operacional. Especifique osType para ativar o comando para concluir mais rápido. Essa propriedade opcional determina os meios para conexão com o host. Os valores válidos são:
  • aix
  • hpux
  • os400
  • linux
  • solaris
  • windows
  • os390
nome do usuário Um usuário com autoridade para efetuar login no host. Essa propriedade é requerida.
senha A senha para o nome de usuário especificado. Deve ser especificado um valor para password ou privateKeyFile. Se o host não exigir uma senha, será possível especificar um valor nulo de Sequência igual a "".
privateKeyFile O caminho para o arquivo-chave privado. Se não especificar um valor para password, você deverá especificar um valor para privateKeyFile.
passphrase Uma passphrase para privateKeyFile, se necessário.
saveSecurity Especifica se deve armazenar os não as propriedades de segurança (username, password, privateKeyFile, passphrase) com o host e se deve ser usado como valores padrão para envios de tarefa. Se o valor especificado para essa propriedade for true, as propriedades de segurança serão armazenadas com o host e usadas para envios de tarefas subsequentes para esse host.

Parâmetros Opcionais

-imDataLocations
Insira o caminho completo dos locais de dados do Installation Manager. É possível inserir diversos caminhos separados por um ponto e vírgula. Essa propriedade é útil se houver locais de dados não padrão do Installation Manager nos destinos. Por exemplo, se você tiver especificado locais de dados ao instalar o Installation Manager, talvez a tarefa de inventário do CIM não localize os locais de dados não padrão. Portanto, talvez seja necessário especificar locais de dados adicionais ao registrar um host. Se um local de dados inválido for especificado, ele não será salvo. Se o local de dados especificado puder ser detectado pela tarefa de inventário, ele não será salvo. Também é possível usar a tarefa Localizar local de dados para localizar locais de dados no sistema. A tarefa Localizar local de dados automaticamente atualiza essa propriedade. Por exemplo:
AdminTask.registerHost('[-host hostname -hostProps [ [imDataLocations datalocation1; datalocation2] 
[password ****] [saveSecurity true] [username username] ]]') 
É possível utilizar o comando registerHost para especificar caminhos para as variáveis do Liberty; por exemplo:
AdminTask.registerHost('-host hostname -hostProps [ [username admin][password password][saveSecurity true]
 [WLP_WORKING_DIR C:/working][WLP_SHARED_DIR C:/shared][WLP_ADDITIONAL_DIRS C:/addl] ]')

Valor de retorno

O comando retorna um inventário do host remoto.

Exemplo de uso do modo em lote

  • Utilizando a sequência Jython:
    AdminTask.registerHost('-host myHost.acme.com -hostProps [ [osType linux][username root]
     [privateKeyFile /root/.ssh/id_dsa] [passphrase myPassphrase] [saveSecurity true] ]')
  • Utilizando a lista Jython:
    AdminTask.registerHost('-host', 'myHost.acme.com', '-hostProps', '[ [osType linux] [username root]
     [privateKeyFile /root/.ssh/id_dsa] [passphrase myPassphrase] [saveSecurity true]' ]')

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.registerHost('-interactive')

unregisterHost

O comando unregisterHost remove o host remoto a partir do gerenciador de tarefa. Utilize o comando unregisterHost para cancelar o registro de um destino de host remoto a partir do gerenciador de tarefa. Após o cancelamento de registro de um host, o gerenciador de tarefa não pode executar tarefas no destino.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

-host
Especifica o nome do computador remoto para cancelar o registro a partir do gerenciador de tarefa. (Sequência, obrigatória)

Parâmetros Opcionais

Nenhum

Valor de retorno

Nenhuma

Exemplo de uso do modo em lote

  • Utilizando a sequência Jython:
    AdminTask.unregisterHost('-host myHost.acme.com')
  • Utilizando a lista Jython:
    AdminTask.unregisterHost('-host', 'myHost.acme.com')

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.unregisterHost('-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=rxml_7sysmannode
Nome do arquivo: rxml_7sysmannode.html