Grupo de Comandos Utility do Objeto AdminTask
É possível utilizar as linguagens de script Jython ou Jacl para gerenciar servidores com a ferramenta wsadmin. Os comandos e os parâmetros no grupo Utility podem ser utilizados para alterar o nome de host de um nó, para consultar o nome do gerenciador de implementação e para determinar se o sistema é um único servidor ou implementação de rede.
O grupo de comandos Utility do objeto AdminTask inclui os seguintes comandos:
changeHostName
Use o comando changeHostName para mudar o nome do host de um nó.
Objeto de destino
Nenhuma.
Parâmetros e valores de retorno
- -hostName
- O novo nome do host. (Cadeia, obrigatória)
- -nodeName
- O nome do nó cujo nome do host é mudado. (Cadeia, obrigatória)
Parâmetros opcionais:
- -systemName
- O nome do sistema z/OS no qual esse nó é executado. Esse campo somente é necessário se um nó será movido de um sistema para outro, por exemplo, do sistema SYSA para o sistema SYSB. Se não tiver certeza do valor que deve especificar para esse parâmetro, emita o comando IPLINFO no seu sistema z/OS, e use o nome exibido no campo Sysname= como o valor para esse parâmetro. Nota: Ao executar o comando changeHostName interativamente, o parâmetro systemName aparece, mas deve ser usado somente para um sistema z/OS. O parâmetro systemName representa o nome do sistema z/OS que é definido no arquivo server.xml como um valor para a propriedade, was.ConfiguredSystemName. Quando o parâmetro systemName for selecionado, essa propriedade será mudada.
- -regenDefaultCert
- Um pedido para gerar novamente certificados padrão. O único valor válido para esse parâmetro é "true" se você desejar gerar novamente certificados padrão. Qualquer outro valor assume NÃO gerar novamente certificados padrão. O argumento de sequência é processado como um Booleano. O booleano retornado representará o valor true se o argumento de sequência não for nulo e for igual, ignorando maiúsculas e minúsculas, para a sequência "true". O parâmetro regenDefaultCert opera como AdminTask.createChainedCertificate e tem os valores padrão a seguir:
- -keyStoreName "NodeDefaultKeyStore"
- -keyStoreScope "(node):" + nodeName
- -certificateAlias" "default_" + hostName
- -certificateCommonName" nodeName
- -certificateOrganization" "IBM"
- -certificateOrganizationalUnit" nodeName
- -certificateCountry "US"
Nota: Para os parâmetros AdminTask.createChainedCertificate e regenDefaultCert, se estiver usando o nó do gerenciador de implementação, o valor -keyStoreName será mudado para -keyStoreName "CellDefaultKeyStore" e o valor -keyStoreScope para -keyStoreScope "(cell):" + cellname.O comutador é um comutador de conveniência que faz suposições sobre os valores padrão dos parâmetros do certificado. Se os valores padrão não forem usados, AdminTask.createChainedCertificate ou regenDefaultCert deve ser então usado.
Esteja ciente desses detalhes funcionais:- keyStoreName e keyStoreScope não são válidos com o parâmetro regenDefaultCert.
- Ao executar o comando changeHostName, não é possível especificar certificateCommonName (CN de nova certificação). Para especificar um novo nome do host como o CN, é preciso usar AdminTask.createChainedCertificate.
Exemplos
Exemplo de uso do modo de lote:
Utilizando Jacl:
$AdminTask changeHostName {-hostName host_name -nodeName node_name -systemName system_name}
Utilizando a cadeia Jython:
AdminTask.changeHostName('-hostName host_name -nodeName node_name -systemName system_name')
Utilizando a lista Jython:
AdminTask.changeHostName(['-hostName', 'host_name', '-nodeName', 'node_name', '-systemName', 'system_name'])
Uso do exemplo do modo interativo:
Utilizando Jacl:
$AdminTask changeHostName {-interactive}
Utilizando a cadeia Jython:
AdminTask.changeHostName ('[-interactive]')
Utilizando a lista Jython:
AdminTask.changeHostName (['-interactive'])
getDmgrProperties
Use o comando getDmgrProperties para retornar o nome do gerenciador de implementação.
Objeto de destino
Nenhuma.
Parâmetros e valores de retorno
- Parâmetros: Nenhum
- Retorna: O nome do gerenciador de implementação em um sistema de implementação de rede. Retorna uma cadeia vazia se o sistema for um servidor único.
Exemplos
Exemplo de uso do modo de lote:
Utilizando Jacl:
$AdminTask getDmgrProperties {}
Utilizando Jython:
AdminTask.getDmgrProperties()
isFederated
Utilize o comando isFederated para verificar se o sistema é um servidor único ou uma implementação de rede.
Objeto de destino
Nenhuma.
Parâmetros e valores de retorno
- Parâmetros: Nenhum
- Retorna: Boolean. true se o sistema for do tipo implementação de rede. Caso contrário, ele retornará falso.
Exemplos
Exemplo de uso do modo de lote:
- Utilizando Jacl:
$AdminTask isFederated {}
- Utilizando a cadeia Jython:
AdminTask.isFederated ()
renameCell


Objeto de destino
Nenhuma.
Parâmetros e valores de retorno
- -newCellName
- O nome da nova célula. (Cadeia, obrigatória)
- -dmgr_host
- O nome do host ou endereço IP do computador do gerenciador de implementação. (Sequência, necessária se o comando for executado em um nó federado)
- -dmgr_port
- A porta de conexão Java Management Extensions (JMX). (Sequência, necessária se o comando for executado em um nó federado. O valor padrão "8879" será usado se não for especificado)
- -connType
- O tipo de conector JMX a ser usado para conexão com o gerenciador de implementação. SOAP é o tipo de conector JMX padrão para o comando. Outros tipos válidos são JSR160RMI ou Remote Method Invocation (RMI). (Sequência, necessária se o comando for executado em um nó federado. O valor padrão "SOAP" será utilizado se não for especificado)
- -userName
- O nome do usuário para autenticação, se a segurança estiver ativada. (Sequência, necessária se o comando for executado em um nó federado e a segurança for ativada)
- -password
- A senha para autenticação, se a segurança estiver ativada. (Sequência, necessária se o comando for executado em um nó federado e a segurança for ativada)
Parâmetros opcionais:
- -regenCerts
- Se os certificados Secure Sockets Layer (SSL) devem ser gerados novamente para todos os nós de uma célula. Somente certificados para os keystores padrão são regenerados. Este parâmetro não se aplica a células em sistemas operacionais z/OS. Lembre-se de que regenerar certificados pode fazer com que os clientes acessem o servidor para restabelecer a confiança com o servidor, obtendo o novo certificado. O valor padrão é false Configure para true para regenerar certificados SSL para nós de uma célula. (Booleano, opcional)
- -updateJaccContextID
- Determina se atualizar o ID de contexto de segurança de aplicativos usados por um provedor Java Authorization Contract for Containers (JACC). O valor padrão é false. Configure como true para atualizar o ID de contexto de segurança. (Booleano, opcional)
Exemplo de uso do modo de lote:
- Utilizando a cadeia Jython:
AdminTask.renameCell('-newCellName new_cell_name')
- Utilizando a lista Jython:
AdminTask.renameCell(['-newCellName', 'new_cell_name'])
Uso do exemplo do modo interativo:
- Utilizando a cadeia Jython:
AdminTask.renameCell ('[-interactive]')
- Utilizando a lista Jython:
AdminTask.renameCell (['-interactive'])
Cenários de exemplo que usam renameCell


- Renomeando uma célula para um servidor de aplicativos independente:
- Pare um servidor independente.
- Renomeie a célula utilizando wsadmin no modo local:
AdminTask.renameCell('-newCellName new_cell_name')
- Renomeando uma célula para um gerenciador de implementação e seus nós federados:
Para renomear uma célula para uma topologia de implementação de rede, o comando precisa ser executado em um nó/perfil do gerenciador de implementação e em todos os nós/perfis federados.
Evitar Problemas: Se a célula for uma parte de uma topologia de múltiplas células, desvincule a célula de outras células antes dessas etapas e vincule novamente após as etapas.gotcha
- Pare todos os servidores na célula, incluindo o servidor do gerenciador de implementação, servidores do agente do nó e todos os servidores de aplicativos.
- Renomeie a célula de um nó/perfil do gerenciador de implementação: execute o comando abaixo com wsadmin no nó local, o que faz com que o nome da célula seja mudado juntamente com as mudanças no certificado SSL no repositório principal dmgr.
AdminTask.renameCell('[-newCellName new_cell_name]')
- Execute o comando Renomear célula para todos os nós/perfis federados na célula.
- Inicie o servidor do gerenciador de implementação.
- No perfil de cada agente do nó e para cada nó que não é o nó do gerenciador de implementação, inicie wsadmin no modo local e execute o comando mostrado abaixo:
AdminTask.renameCell('[-newCellName new_cell_name –dmgr_host dmgr_hostname –dmgrPort dmgr_connector_port –connType SOAP –username my_user –password my_password]')
- Renomeando uma célula para um servidor de agente de administração:
- Pare um servidor de agente de administração.
- Renomeie a célula usando wsadmin no modo local:
AdminTask.renameCell('-newCellName new_cell_name')
Nota: Se você desejar renomear uma célula para um servidor de aplicativos independente que esteja registrado em um servidor de agente de administração, precisará cancelar o registro desse nó independente com esse servidor de administração primeiro. Será necessário registrar o nó com o servidor de administração novamente após a execução do comando Renomear célula se você desejar que o servidor de administração continue a gerenciar esse nó independente.
- Renomeando uma célula para um servidor do gerenciador de tarefa:
- Pare um servidor do gerenciador de tarefa.
- Renomeie a célula utilizando wsadmin no modo local:
AdminTask.renameCell('-newCellName new_cell_name')
Evitar Problemas: Ele destina-se somente a perfis do gerenciador de tarefa independente. Não o utilize para um gerenciador de implementação que esteja funcionando como um gerenciador de tarefa.gotcha
- Renomeando uma célula na topologia de múltiplas células:
Para renomear a célula na topologia de múltiplas células, omo a topologia em estrela, a célula deve ser separada das outras células antes da renomeação. Depois da renomeação da célula, em seguida, a célula deverá ser anexada novamente às outras células.