Comando startServer
O comando startServer lê o arquivo de configuração para o processo de servidor especificado e inicia o processo do servidor.
- Inicie um servidor de aplicativos.
- Inicie um DMZ Secure Proxy Server for IBM® WebSphere Application Server.
- Inicie um agente administrativo.
- Inicie um gerenciador de tarefa.
Se você estiver executando o produto em um sistema operacional Windows Windows e o servidor estiver em execução como um serviço do sistema operacional Windows, o comando
startServer iniciará o servidor e o serviço do Windows associado.
Você não precisa usar um nome de usuário e senha com o comando startServer, pois esse comando ativa um processo do servidor mas não chama um método MBean.

- A emissão do comando startServer -script cria um script com valores estáticos. Quando você altera parâmetros JVM a partir do console, um novo script precisa ser gerado para acomodar esses parâmetros JVM alterados.
- Quando você executa startServer -script, o comando gera um novo script que tem todos os valores de parâmetro no momento em que o comando é executado. Se você alterar os valores dos parâmetros (ou incluir novos parâmetros), o script gerado não terá esses novos valores de parâmetro. Esses novos valores são passados para o script recém-gerado de maneira estática, portanto, quaisquer mudanças feitas após esse script ser criado exigirão que um novo startServer -script gere um novo script com esses valores atualizados.
- Se você alterar o valor da configuração do caminho de classe da Java virtual machine, esse novo valor substituirá o valor do parâmetro do caminho de classe no comando de ativação configurado, por padrão, no script gerado quando você emite o comando startServer -script.
- Se você incluir uma nova entrada de ambiente na página Entradas do Ambiente ou alterar a configuração de uma entrada existente, os novos valores e os valores alterados aparecerão como parâmetros no script gerado quando você emite o comando startServer -script.
- Se uma das entradas de ambiente que você inclui for chamada de PATH, o valor especificado para essa entrada substituirá o valor especificado para a variável PATH que, por padrão, é configurada como WAS_PATH no arquivo setUpCmdLine. Se o valor da variável PATH for substituído, a seguinte mensagem será enviada para o arquivo no qual suas mensagens de erros são registradas:
WSVR0009E: Ocorreu um erro durante a inicialização. com.ibm.ws.exception.RuntimeError: java.lang.NoClassDefFoundError: com/ibm/ws/process/Win32ProcessGlue
Para obter mais informações sobre onde executar este comando, consulte o tópico Usando a Ferramenta de Linha de Comandos.
Sintaxe
startServer server_name [options]
em que server_name é o nome do servidor de aplicativos ou o DMZ Secure Proxy Server for IBM WebSphere Application Server que você deseja iniciar.
Esse argumento é obrigatório.
Este argumento é opcional. Se este argumento não for especificado, um servidor será designado com base no nome do perfil. Se você utilizar o perfil chamado default, o argumento <server> será definido como server1. Se o nome do perfil não for default, o argumento <server> será definido como o nome do perfil.
startServer <adminagent_name>
em que adminagent_name é o nome do agente administrativo que você deseja iniciar.
startServer <job_manager>
em que job_manager é o nome do gerenciador de tarefas que você deseja iniciar.
Parameters
As opções a seguir estão disponíveis para o comando startServer:
- -?
- Imprime uma instrução de uso.
-curlib <product_library>
Especifica a biblioteca atual a ser utilizada para o comando de CL Submeter Job (SBMJOB) subjacente.
-cpyenvvar
Orienta o comando startServer a configurar as variáveis de ambiente que estão atualmente definidas para o processo do servidor. O padrão é não definir as variáveis de ambiente atualmente definidas.
- -help
- Imprime uma instrução de uso.
-inllibl <library_list>
Especifica a lista de bibliotecas inicial a ser utilizada para o comando de CL Submeter Job (SBMJOB) subjacente.
-inlaspgrp <ASP_group>
Especifica o grupo ASP inicial para o comando de CL Submeter Job (SBMJOB) subjacente.
-J <opção_java>
Especifica opções para transmitir para o intérprete Java.
-jobd <product_library/job_description>
Especifica a descrição do job para o comando de CL Submeter Job (SBMJOB) subjacente.
-jobq <product_library/job_queue>
Especifica a fila de jobs para o comando de CL Submeter Job (SBMJOB) subjacente.
-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 startServer.log e é criado em seu diretório logs.
-nowait
Instrui ao comando startServer para não aguardar uma inicialização bem-sucedida do processo do servidor ativado.
-outq <product_library/output_queue>
Especifica a fila de saída para o comando de CL Submeter Job (SBMJOB) subjacente.
- -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.
-quiet
Suprime as informações de progresso que o comando startServer imprime no modo normal.
-replacelog
Substitui o arquivo de log ao invés de anexar o log atual.
- -recovery
- Especifica se o servidor será iniciado no modo de recuperação, desempenhará
uma recuperação transacional e será encerrado. O servidor não aceitará nenhuma nova transação enquanto estiver no modo de recuperação. Quando você iniciar o servidor novamente, os recursos que não estavam disponíveis devido a transações questionáveis estarão disponíveis.
Utilize esta opção se um servidor falhar e você não desejar aceitar novas transações durante o processo de recuperação.
transição: Se estiver migrando de uma versão anterior do produto, certifique-se de que o parâmetro ENV incluído na instrução de procedimento do JCL do controlador inclua o elemento REC=N ou REC=Y. Se o parâmetro ENV não incluir o elemento REC=N ou REC=Y, o servidor não será reiniciado no modo de recuperação mesmo se especificar a opção -recovery.Se o parâmetro ENV incluir o elemento REC=N, a configuração será alterada automaticamente para REC=Y, se especificar -recovery ao reiniciar o servidor. O elemento REC=N será automaticamente incluído no parâmetro ENV caso não tenha migrado de uma versão anterior do produto. Este é um exemplo de como sua instrução PROC atualizada pode parecer:
//BBO6ACR PROC ENV=,PARMS=' ',REC=N,Z=BBO6ACRZ
Quando você chama o comando startServer com o parâmetro -recovery e o processo de recuperação é malsucedido, a seguinte mensagem de erro ocorre nos arquivos SystemErr.log e SystemOut.log:
A mensagem não indica que o processo de recuperação foi malsucedido. Se você utilizar o parâmetro -recovery, verifique os arquivos SystemErr.log e SystemOut.log para o servidor que você está iniciando para determinar se o processo de recuperação foi bem-sucedido.CWNATV03I: O servidor de aplicativos xxxxxx no perfil xxxxxx concluiu a recuperação. Servidor parado.
-sbs <product_library/subsystem_description>
Especifica o subsistema a ser utilizado para o comando CL Submeter Tarefa (SBMJOB) subjacente.
-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 do status do servidor, indicando que o servidor foi iniciado. Se o parâmetro não for definido, uma porta não utilizada será alocada automaticamente.
-script [<nome_do_arquivo_de_script>] -background
Gera um script de ativação com o comando startServer em vez de ativar diretamente o processo do servidor. O nome do script de ativação é um argumento opcional. Se você não fornecer o nome do script de ativação, o nome do arquivo de script padrão será start_server, com base no nome do servidor transmitido como o primeiro argumento para o comando startServer. O parâmetro -background é um parâmetro opcional que especifica que o script gerado executará em segundo plano.
- -trace
Gera informações de rastreio no arquivo de log para finalidades de depuração.
Ativa o rastreio do código de processo nativo que inicia o servidor. 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 antes do tempo limite da inicialização do servidor e retorna um erro.
-usejobd
Especifica a utilização da descrição do job a partir do processo Submeter Job (SBMJOB) do servidor ao comutar para o ID do usuário Run-As.
Nota: Esse comando não afeta o campo USER da descrição de job atual.
Cenário de uso
Os exemplos a seguir demonstram a sintaxe correta. As informações entre parênteses são uma descrição da saída criada se você emite o comando precedente.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
startServer server1
startServer server1 -script (produz os arquivos start_server1.sh ou .bat)
startServer server1 -trace (produz o arquivo startserver.log)
startServer adminagent
startServer.sh server1 -trace -username MyUserName -password MyUserPassword
-profileName MyProfileName (inicia o servidor server1 usando o
perfil MyProfileName. O servidor executa no MyUserName de nome de usuário
e produz arquivos de rastreio no diretório profile_root/logs)
startServer jobmgr
startServer proxy1 (para o perfil de proxy seguro)
![[z/OS]](../images/ngzos.gif)
startServer server1
startServer server1 -script (produz o arquivo start_server1.sh)
startServer server1 -trace (produz o arquivo startserver.log)
startServer adminagent
startServer jobmgr
startServer proxy1 (para o perfil de proxy seguro)
startServer.sh server1 -trace -username MyUserName -password MyUserPassword
-profileName MyProfileName (inicia o servidor server1 usando o
perfil MyProfileName. O servidor executa no MyUserName de nome de usuário
e produz arquivos de rastreio no diretório profile_root/logs)
![[IBM i]](../images/iseries.gif)
startServer server1 (inicia o servidor server1 para o perfil padrão)
startServer server1 -trace (inicia o servidor server1 para
o perfil padrão e produz arquivos de rastreio no
diretório profile_root/logs)
startServer -profileName mytest (inicia o servidor mytest
configurado sob o perfil mytest)
startServer AdminAgent01
startServer JobMgr01
startServer proxy1 (nome do servidor padrão para o perfil SecureProxySrv01)
startServer.sh server1 -trace -username MyUserName -password MyUserPassword
-profileName MyProfileName (inicia o servidor server1 usando o
perfil MyProfileName. O servidor executa no MyUserName de nome de usuário
e produz arquivos de rastreio no diretório profile_root/logs)
Códigos de saída
Como você captura o código de retorno startServer e stopServer para determinar se ele foi bem-sucedido ou não? Esta tabela mostra os códigos de retorno para um servidor considerando um comando de início ou de parada.
#!/bin/sh
exitCode=`./startServer.sh server1`
Estado do servidor | Código de retorno |
---|---|
Falha na inicialização do servidor | -1 |
A inicialização do servidor atingiu o tempo limite | -2 |
Início do servidor em andamento | 1 |
O servidor está iniciando os aplicativos que estão presentes | 2 |
A inicialização do servidor foi concluída (êxito) | 0 |
Falha na parada do servidor | -10 |
Parada do servidor atingiu tempo limite | -11 |
Operação de parada do servidor iniciada | 1000 |
Servidor interrompido com êxito | 0 |