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

Utilize o objeto AdminTask para executar comandos administrativos com a ferramenta wsadmin.

Comandos administrativos são carregados dinamicamente quando você inicia a ferramenta wsadmin. Os comandos administrativos disponíveis para uso e o que pode ser feito com eles depende da edição do produto que você utiliza.

Você pode iniciar o cliente de script sem ter um servidor em execução utilizando a opção -conntype NONE com a ferramenta wsadmin. Os comandos administrativos do AdminTask estão disponíveis nos modos conectado e local. Se um servidor estiver em execução atualmente, não é recomendado executar os comandos de AdminTask em modo local, pois alterações na configuração feitas no modo local não são refletidas na configuração do servidor em execução e vice-versa. Se você salvar uma configuração conflitante, poderá corromper a configuração.

Em um ambiente de gerenciador de implementação, as atualizações de configuração estão disponíveis apenas se um cliente de script estiver conectado a um gerenciador de implementação. Quando conectado a um agente de nó ou a um servidor de aplicativos gerenciado, você não pode atualizar a configuração porque a configuração para esses processos do servidor são cópias da configuração principal que reside no gerenciador de implementação. As cópias são criadas em uma máquina de nó quando uma sincronização da configuração ocorre entre o gerenciador de implementação e o agente do nó. Faça mudanças na configuração dos processos do servidor conectando um cliente de sript a um gerenciador de implementação. Para alterar uma configuração, não execute um cliente de script em modo local em uma máquina do nó porque isso não é suportado.

Nota de Configuração: Com a linguagem de script Jacl, o comando subst permite substituir um valor configurado anteriormente por uma variável no comando. Por exemplo:
set nodeparm "node1"
$AdminTask setJVMMaxHeapSize [subst {-serverName server1 -nodeName $nodeparm -maximumHeapSize 100}]
O comandos AdminTask a seguir estão disponíveis, mas não pertencem a um grupo:

createTCPEndPoint

O comando createTCPEndPoint cria um novo terminal que é possível associar a um canal de entrada TCP.

Objeto de destino

Instância-pai do TransportChannelService que contém o TCPInboundChannel. (ObjectName, obrigatório)

Parâmetros Requeridos

-name
Especifica o nome do novo terminal. (Cadeia, necessário)
-host
Especifica o host para o novo terminal. (Cadeia, necessário)
-port
Especifica a porta para o novo terminal. (Cadeia, necessário)

Parâmetros Opcionais

Nenhum.

Saída de amostra

O comando retorna o nome do objeto do terminal criado.

Exemplos

Uso de exemplo do modo em lote:

  • Utilizando Jacl:
    $AdminTask createTCPEndPoint (cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TransportChannelService_1)
      {-name Sample_End_Pt_Name -host mybuild.location.ibm.com -port 8978}
  • Utilizando a sequência Jython:
    AdminTask.createTCPEndPoint('cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TransportChannelService_1',
      '[-name Sample_End_Pt_Name -host mybuild.location.ibm.com -port 8978]')
  • Utilizando a lista Jython:
    AdminTask.createTCPEndPoint('cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TransportChannelService_1', 
     ['-name', 'Sample_End_Pt_Name', '-host', 'mybuild.location.ibm.com', '-port', '8978'])

Uso de exemplo de modo interativo:

  • Utilizando Jacl:
    $AdminTask createTCPEndPoint {-interactive}
  • Utilizando Jython:
    AdminTask.createTCPEndPoint('-interactive')

getTCPEndPoint

O comando getTCPEndPoint obtém o terminal nomeado associado a um canal de entrada TCP ou uma cadeia que contém um canal de entrada TCP.

Objeto de destino

TCPInboundChannel, ou contendo cadeia, instância que esteja associada a um NamedEndPoint. (ObjectName, obrigatório)

Parâmetros Obrigatórios

Nenhum.

Parâmetros Opcionais

Nenhum.

Saída de amostra

O comando retorna o nome de objeto de um terminal denominado existente que é associado à instância do canal de entrada TCP ou de uma cadeia de canais.

Exemplos

Uso de exemplo do modo em lote:

  • Utilizando Jacl:
    $AdminTask getTCPEndPoint TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01
    /servers/dmgr|server.xml#TCPInboundChannel_1)
    $AdminTask getTCPEndPoint DCS(cells/mybuildCell01/nodes/mybuildCellManager01
    /servers/dmgr|server.xml#Chain_3)
  • Utilizando a sequência Jython:
    print AdminTask.getTCPEndPoint('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01
    /servers/dmgr|server.xml#TCPInboundChannel_1)')
    print AdminTask.getTCPEndPoint('DCS(cells/mybuildCell01/nodes/mybuildCellManager01
    /servers/dmgr|server.xml#Chain_3)')
  • Utilizando a lista Jython:
    print AdminTask.getTCPEndPoint('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01
    /servers/dmgr|server.xml#TCPInboundChannel_1)')
    print AdminTask.getTCPEndPoint('DCS(cells/mybuildCell01/nodes/mybuildCellManager01
    /servers/dmgr|server.xml#Chain_3)')

Uso de exemplo de modo interativo:

  • Utilizando Jacl:
    $AdminTask getTCPEndPoint {-interactive}
  • Utilizando Jython:
    print AdminTask.getTCPEndPoint('-interactive')

ajuda

O comando help oferece um resumo dos comandos de ajuda e de maneiras de chamar um comando administrativo. É possível utilizar caracteres curinga (*) ou expressões comuns Java (.*) na sintaxe de comando para customizar a consulta de procura.

Objeto de destino

Nenhum.

Parâmetros Opcionais

-commands
O comando help fornece uma lista de comandos administrativos disponíveis se você utilizar o parâmetro -commands. (Sequência, opcional)
-commandGroups
O comando help fornece uma lista de grupos de comandos administrativos se você utilizar o parâmetro -commandGroups. (Sequência, opcional)
-commandName
O comando help fornece informações da ajuda para determinado comando administrativo. (Sequência, opcional)
-stepName
O comando help fornece informações da ajuda para uma etapa específica de um comando administrativo. (Sequência, opcional)

Saída de amostra

O comando retorna informações gerais de comando para o objeto AdminTask.

Exemplos

Uso de exemplo do modo em lote:

Os exemplos de comando a seguir retornam informações gerais de ajuda para o objeto AdminTask:
  • Utilizando Jacl:
    $AdminTask help
  • Utilizando Jython:
    print AdminTask.help()
Os exemplos de comando a seguir exibem cada comando para o objeto AdminTask:
  • Utilizando Jacl:
    $AdminTask help -commands
  • Utilizando Jython:
    print AdminTask.help('-commands')
Os exemplos de comando a seguir retornam informações de comando detalhadas para o comando createJ2CConnectionFactory para o objeto AdminTask:
  • Utilizando Jacl:
    $AdminTask help createJ2CConnectionFactory
  • Utilizando Jython:
    print AdminTask.help('createJ2CConnectionFactory')
Os exemplos a seguir demonstram o uso do caractere curinga (*) para retornar cada comando que contém a cadeia create:
  • Utilizando Jacl:
    $AdminTask help -commands *create*
  • Utilizando Jython:
    print AdminTask.help('-commands *create*')
Os exemplos a seguir demonstram a sintaxe para utilizar expressões Java comuns (.*):
  • Utilizando Jacl:
    $AdminTask help -commands <pattern>
  • Utilizando Jython:
    print AdminTask.help('-commands <pattern>')

listTCPEndPoints

O comando listTCPEndPoints lista todos os terminais nomeados que podem ser associados a um canal de entrada TCP.

Objeto de destino

A instância TCP Inbound Channel para a qual os candidatos de terminais nomeados são listados. (ObjectName, obrigatório)

Parâmetros Requeridos

Nenhum.

Parâmetros Opcionais

-excludeDistinguished
Especifica se mostra apenas os terminais nomeados não distintos. Esse parâmetro não requer um valor. (Booleano, opcional)
-unusedOnly
Especifica se mostra os terminais nomeados que não estão em uso por outras instâncias do canal de entrada TCP. Esse parâmetro não requer um valor. (Boolean, opcional)

Saída de amostra

O comando retorna uma lista de nomes de objeto para os terminais denominados elegíveis.

Exemplos

Exemplo de uso do modo de lote:

  • Utilizando Jacl:
    $AdminTask listTCPEndPoints TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)
    $AdminTask listTCPEndPoints TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)
      {-excludeDistinguished}
    $AdminTask listTCPEndPoints TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)
       {-excludeDistinguished -unusedOnly}
  • Utilizando a sequência Jython:
    print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)',
       '[-excludeDistinguished]')
    print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', 
       '[-excludeDistinguished]')
    print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)',
       '[-excludeDistinguished -unusedOnly]')
  • Utilizando a lista Jython:
    print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)',
      ['-excludeDistinguished'])
    print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)',
       ['-excludeDistinguished'])
    print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)',
      ['-excludeDistinguished', '-unusedOnly'])

Uso de exemplo de modo interativo:

  • Utilizando Jacl:
    $AdminTask listTCPEndPoints {-interactive}
  • Utilizando Jython:
    print AdminTask.listTCPEndPoints('-interactive')

listTCPThreadPools

O comando listTCPThreadPools lista todos os conjuntos de encadeamentos que podem ser associados a um canal de entrada TCP ou a um canal de saída.

Objeto de destino

Instância TCPInboundChannel ou TCPOutboundChannel para a qual os candidatos ThreadPool são listados. (ObjectName, obrigatório)

Parâmetros Obrigatórios

Nenhum.

Parâmetros Opcionais

Nenhum.

Saída de amostra

O comando retorna uma lista de nomes de objeto elegíveis do conjunto de encadeamentos.

Exemplos

Uso de exemplo do modo em lote:

  • Utilizando Jacl:
    $AdminTask listTCPThreadPools TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)
  • Utilizando a sequência Jython:
    print AdminTask.listTCPThreadPools('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)')
  • Utilizando a lista Jython:
    print AdminTask.listTCPThreadPools('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)')

Uso de exemplo de modo interativo:

  • Utilizando Jacl:
    $AdminTask listTCPThreadPools {-interactive}
  • Utilizando Jython:
    print AdminTask.listTCPThreadPools('-interactive')

updateAppOnCluster

O comando updateAppOnCluster pode ser utilizado para sincronizar nós e reiniciar membros de cluster para uma atualização de aplicativo que está implementada em um cluster. Após uma atualização de aplicativo, esse comando pode ser utilizado para sincronizar os nós sem parar todos os membros de cluster em todos os nós ao mesmo tempo. Esse comando sincroniza um nó de cada vez. Cada nó é sincronizado parando os membros do cluster que têm o aplicativo como destino, executando uma operação de sincronização do nó e reiniciando os membros do cluster.

Esse comando pode demorar mais que o período do tempo limite padrão do conector, dependendo do número de nós abrangidos pelo cluster de destino. Certifique-se de configurar os valores apropriados de tempo limite no arquivosoap.client.props no diretório profile_root/properties, quando um conector SOAP for usado; no arquivo sas.client.props, quando um conector JSR160RMI ou um conector RMI for usado; e no arquivo ipc.client.props quando um conector IPC for usado.

Esse comando não é suportado no modo local.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

-ApplicationNames
Especifica os nomes dos aplicativos atualizados. (Cadeia, necessário)

Parâmetros Opcionais

-timeout
Especifica o valor de tempo limite em segundos para cada sincronização de nó. O padrão 300 segundos. (Inteiro, opcional)

Saída de amostra

O comando não retorna saída.

Exemplos

Uso de exemplo do modo em lote:

  • Utilizando Jacl:
    $AdminTask updateAppOnCluster {-ApplicationNames app1}
    $AdminTask updateAppOnCluster { -ApplicationNames app1 -timeout 600}
  • Utilizando a sequência Jython:
    AdminTask.updateAppOnCluster('[-ApplicationNames app1]')
    AdminTask.updateAppOnCluster('[-ApplicationNames app1 -timeout 600]')
  • Utilizando a lista Jython:
    AdminTask.updateAppOnCluster(['-ApplicationNames', 'app1'])
    AdminTask.updateAppOnCluster(['-ApplicationNames', 'app1', '-timeout', '600'])

Uso de exemplo de modo interativo:

  • Utilizando Jacl:
    $AdminTask updateAppOnCluster -interactive
  • Utilizando Jython:
    AdminTask.updateAppOnCluster('-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_admintask
Nome do arquivo: rxml_admintask.html