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.
set nodeparm "node1"
$AdminTask setJVMMaxHeapSize [subst {-serverName server1 -nodeName $nodeparm -maximumHeapSize 100}]
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:
- Utilizando Jacl:
$AdminTask help
- Utilizando Jython:
print AdminTask.help()
- Utilizando
Jacl:
$AdminTask help -commands
- Utilizando Jython:
print AdminTask.help('-commands')
- Utilizando
Jacl:
$AdminTask help createJ2CConnectionFactory
- Utilizando Jython:
print AdminTask.help('createJ2CConnectionFactory')
- Utilizando Jacl:
$AdminTask help -commands *create*
- Utilizando Jython:
print AdminTask.help('-commands *create*')
- 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')