Comando stopServer

O comando stopServer lê o arquivo de configuração para o processo de servidor especificado. Este comando envia um comando JMS (Java™ management extensions) para o servidor informando-o a fechar.

O processo do servidor pode ser um servidor de aplicativos, um DMZ Secure Proxy Server for IBM® WebSphere Application Server, um servidor de agente administrativo ou um servidor de gerenciador de tarefas

Por padrão, o comando stopServer não retorna o controle à linha de comandos até que o servidor conclua o processo de encerramento. Há uma opção -nowait de retornar imediatamente e outras opções para controlar o comportamento do comando stopServer. Para obter informações adicionais sobre onde executar esse comando, consulte o tópico Utilizando ferramentas de linha de comandos.

[AIX Solaris HP-UX Linux Windows]Se você estiver executando o produto em um sistema operacional Microsoft Windows e tiver o servidor em execução como um serviço do sistema operacional Windows, o comando stopServer irá parar o serviço do Windows que é responsável por iniciar o servidor.

[IBM i]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 (JVM) 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.

[AIX][Linux][Solaris][HP-UX]Se a segurança estiver ativada, você deverá usar um nome de usuário e senha porque o comando chama um método MBean no servidor.

[Windows]Os parâmetros de nome de usuário e senha não são necessários com o comando stopServer. Os parâmetros são automaticamente transmitidos ao script que o serviço do sistema operacional Windows usa para fechar o sistema.

Evitar Problemas Evitar Problemas: Se a mensagem ADMC0074E: A conexão será fechada devido a um erro irrecuperável for exibida no arquivo de log do sistema, um cliente pode ter tentado enviar um nome de usuário e uma senha a outro servidor no qual a segurança está desativada. Você pode ignorar esta mensagem porque o cliente altera automaticamente sua configuração de segurança para corresponder a configuração de segurança ao servidor com o qual o cliente está tentando se comunicar. A conexão finalmente foi concluída com êxito. No entanto, a segurança está desativada agora para o cliente administrativo e o servidor de recebimento.gotcha

Sintaxe

A sintaxe de comando é uma das seguintes:

stopServer <server_name> [options]

em que server_name é o nome do diretório de configuração do servidor de aplicativos ou o DMZ Secure Proxy Server for IBM WebSphere Application Server que você deseja parar.

[AIX Solaris HP-UX Linux Windows][z/OS]Esse argumento é obrigatório.

[IBM i]Este argumento é opcional. Se o perfil padrão está sendo utilizado, o servidor será padronizado como server1. Se o nome do perfil não for o padrão, o servidor será padronizado como o nome do perfil.

stopServer <adminagent_name>

em que adminagent_name é o nome do agente administrativo que você deseja parar.

stopServer <job_manager>

em que job_manager é o nome do gerenciador de tarefas que você deseja parar.

Executar Como

As opções a seguir estão disponíveis para o comando stopServer:

-nowait
Instrui ao comando stopServer para não aguardar um encerramento bem-sucedido do processo de servidor.
-quiet
Suprime as informações de progresso que o comando stopServer 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 é denominado stopServer.log e é criado no diretório logs.
-profileName
Define o perfil do processo do servidor em uma instalação de 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 stopServer.log que está localizado no diretório profile_root/logs/server.
-timeout <seconds>
Especifica o tempo de espera para o encerramento do servidor antes do tempo limite e retorna um erro.
-statusport <Número_da_porta>
Um parâmetro opcional que permite que um administrador configure o número de porta para o retorno de chamada de status do servidor. A ferramenta abre essa porta e aguarda pelo retorno de chamada de status do servidor imediatamente antes do servidor ser parado. Se o parâmetro não estiver configurado, uma porta não utilizada será automaticamente alocada.
-conntype <tipo>
Especifica o tipo de conector JMX a ser utilizado para conexão com o 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 do servidor para usar explicitamente, para que você pode evitar a leitura dos arquivos de configuração para obter as informações.
-username <nome>
Especifica o nome de usuário para autenticação, caso a segurança esteja ativada. Age da mesma forma que a opção -user.
-user <nome>
Especifica o nome de usuário para autenticação, caso a segurança esteja ativada. Age da mesma forma que a opção -username.
-password <password>
Especifica a senha para autenticação se a segurança estiver ativada no servidor.
Evitar Problemas Evitar Problemas: 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:
ADMN0022E: Acesso negado para a operação stop no Server MBean devido 
a credenciais insuficientes ou vazias.
Para solucionar esse problema, forneça as informações de ID do usuário e senha.gotcha
-help
Imprime uma instrução de uso.
-?
Imprime uma instrução de uso.

Cenário de uso

Os exemplos a seguir demonstram a sintaxe correta:

[AIX Solaris HP-UX Linux Windows][z/OS]
stopServer server1

stopServer server1 -nowait 

stopServer server1 -trace (produz o arquivo stopserver.log)

stopServer adminagent
stopServer jobmgr

stopServer proxy1 (para o perfil de proxy seguro)
[IBM i]
stopServer server1   (pára o servidor server1 para o perfil padrão)
 
stopServer server1 -nowait 

stopServer server1 -trace (produz o arquivo stopserver.log)

stopServer -profileName mytest (pára o servidor mytest 
configurado para o perfil mytest)

stopServer AdminAgent01
stopServer JobMgr01

stopServer proxy1 (nome do servidor padrão para o perfil SecureProxySrv01)

Í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_stopserver
Nome do arquivo: rxml_stopserver.html