Comando stopNode
O comando stopNode lê o arquivo de configuração para o processo do agente do nó e envia um comando JMX (Java™ Management Extensions) informando o agente do nó que ele deve encerrar.
Por padrão, o comando stopNode aguarda o agente de nó concluir o encerramento antes de retornar o controle à linha de comandos. Há uma opção -nowait para retornar imediatamente, assim como outras opções para controlar o comportamento do comando stopNode. Para obter mais informações sobre onde executar este comando, consulte Usando Ferramentas de Linha de Comandos.
Se você estiver utilizando um sistema operacional Windows e
o agente do nó estiver em execução como um serviço do Windows, o comando stopNode usa
o serviço do Windows associado para parar o agente do nó.
Se você parar o servidor antes de parar o
agente do nó usando o comando stopServer -servers,
o servidor não reiniciará quando um comando startServer for emitido.
Apesar do comando stopServer retornar o controle quando o servidor conclui o encerramento, ele poderá retornar antes do processo do IBM® i ter sido concluído. Dependendo da quantidade de memória que a Java Virtual
Machine deve retornar para o conjunto de memórias, o processo pode demorar alguns segundos ou minutos para terminar completamente. Você não deve tentar iniciar o servidor novamente até o processo ter terminado. Utilize o comando WRKACTJOB SBS(subsystem) CL para determinar se o processo está completamente terminado. Por padrão, o subsistema é QWAS85.

Sintaxe
stopNode [options]
Parameters
As opções a seguir estão disponíveis para o comando stopNode:
- -nowait
- Instrui ao comando stopNode para não aguardar um encerramento bem-sucedido do processo do agente do nó.
- -quiet
- Suprime as informações de progresso que o comando stopNode imprime no modo normal.
- -logfile <Nome_do_arquivo>
- Especifica o local do arquivo de log no qual as informações de rastreio são gravadas. Por padrão, o arquivo de log é nomeado stopServer.log e é criado no diretório logs do perfil para o nó que está sendo interrompido.
-profileName
Define o perfil do processo do Servidor de Aplicativos em uma instalação com vários perfis. A opção -profileName não é requerida para execução em um ambiente de perfil único. O padrão para essa opção é o perfil padrão.
- -replacelog
- Substitui o arquivo de log ao invés de anexar o log atual.
- -trace
- Gera informações de rastreio em um arquivo para propósitos de depuração. A saída de rastreio é gravada no arquivo was_jobname-jobuser-jobnum.log que está localizado no diretório profile_root/logs.
- -timeout <seconds>
- Especifica o tempo de espera para o encerramento do agente antes do tempo limite e retorna um erro.
Configurações suportadas: O parâmetro timeout é usado para parar um servidor de cada vez. Se você usar o parâmetro timeout com o parâmetro stopservers, o valor do parâmetro timeout será ignorado.sptcfg
- -statusport <Número_da_porta>
- Um parâmetro opcional que permite a um administrador configurar o número da porta para o retorno de chamada do status do agente do nó. A ferramenta abre essa porta e aguarda pelo retorno de chamada do status do agente de nós imediatamente antes que o agente de nós seja completamente parado. Se o parâmetro não for configurado, uma porta não utilizada será alocada automaticamente.
- -stopservers [-saveNodeState]
- Para todos os servidores
de aplicativos no nó antes de parar o agente de nó.
Utilize a opção -saveNodeState para salvar o estado de reinicialização de servidor para que você possa iniciar os servidores de aplicativos com base no estado anterior utilizando o comando startNode.
- -conntype <tipo>
- Especifica o tipo de conector JMX (Java Management Extensions) a ser usado para se conectar ao gerenciador de implementação. Os tipos válidos são SOAP ou RMI (Remote Method Invocation).
- -port <número_da_porta>
- Especifica a porta JMX que o agente de nó deve utilizar explicitamente, para que você possa evitar a leitura dos arquivos de configuração para obter informações.
- -username <nome>
- Especifica o nome do usuário para autenticação, caso a segurança esteja ativada no agente do nó. Age da mesma forma que a opção -user.
- -user <nome>
- Especifica o nome do usuário para autenticação, caso a segurança esteja ativada no agente do nó. Age da mesma forma que a opção -username.
- -password <password>
- Especifica a senha para autenticação, caso a segurança esteja ativada no agente do nó.Nota: Se você estiver executando em um ambiente seguro, mas não tiver fornecido um ID do usuário e senha, você receberá a seguinte mensagem de erro:
Para solucionar esse problema, forneça as informações de ID do usuário e senha.ADMN0022E: Acesso negado para a operação stop no Server MBean devido a credenciais insuficientes ou vazias.
- -help
- Imprime uma instrução de uso.Nota: Ao solicitar ajuda para a instrução de uso para o comando stopNode, é exibida uma referência para o comando stopServer. Todas as opções exibidas para essa instrução de uso aplicam-se ao comando stopNode.
- -?
- Imprime uma instrução de uso.Nota: Ao solicitar ajuda para a instrução de uso para o comando stopNode, é exibida uma referência para o comando stopServer. Todas as opções exibidas para essa instrução de uso aplicam-se ao comando stopNode.
Cenário de uso
Os exemplos a seguir demonstram a sintaxe correta:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
stopNode
stopNode -nowait
stopNode -trace (produz o arquivo stopnode.log)
![[IBM i]](../images/iseries.gif)
stopNode
stopNode -profileName mynode
stopNode -nowait
stopNode -trace (produz arquivos de rastreio no
diretório profile_root/logs.)