Comando startServer

O comando startServer lê o arquivo de configuração para o processo de servidor especificado e inicia o processo do servidor.

Use o comando startServer para:
  • 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.
Nota: Esse tópico faz referência a um ou mais arquivos de log do servidor de aplicativos. Como uma recomendação alternativa, é possível configurar o servidor para usar a infraestrutura de log e rastreio do High Performance Extensible Logging (HPEL) em vez de usar os arquivos SystemOut.log , SystemErr.log, trace.log e activity.log em sistemas distribuídos e IBM i. Também é possível usar HPEL em conjunção com os recursos de criação de log z/OS nativos. Se você estiver usando HPEL, será possível acessar todas as informações de log e rastreio usando a ferramenta de linha de comandos LogViewer a partir do diretório bin do perfil do servidor. Consulte as informações sobre a utilização do HPEL para resolução de problemas dos aplicativos para obter mais informações sobre o uso do HPEL.

[Windows]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.

Evitar Problemas Evitar Problemas: Você pode usar o console administrativo para alterar a configuração do caminho de classe da Java™ virtual machine ou as configurações de entrada do ambiente para um servidor. No entanto, antes de fazer essas alterações, deve conhecer suas conseqüências:
  • 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
gotcha

Para obter mais informações sobre onde executar este comando, consulte o tópico Usando a Ferramenta de Linha de Comandos.

Sintaxe

A sintaxe de comando é uma das seguintes:
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.

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

[IBM i]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.
[IBM i]-curlib <product_library>
[IBM i]Especifica a biblioteca atual a ser utilizada para o comando de CL Submeter Job (SBMJOB) subjacente.
[IBM i]-cpyenvvar
[IBM i]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.
[IBM i]-inllibl <library_list>
[IBM i]Especifica a lista de bibliotecas inicial a ser utilizada para o comando de CL Submeter Job (SBMJOB) subjacente.
[IBM i]-inlaspgrp <ASP_group>
[IBM i]Especifica o grupo ASP inicial para o comando de CL Submeter Job (SBMJOB) subjacente.
[AIX Solaris HP-UX Linux Windows][z/OS]-J <opção_java>
[AIX Solaris HP-UX Linux Windows][z/OS]Especifica opções para transmitir para o intérprete Java.
[IBM i]-jobd <product_library/job_description>
[IBM i]Especifica a descrição do job para o comando de CL Submeter Job (SBMJOB) subjacente.
[IBM i]-jobq <product_library/job_queue>
[IBM i]Especifica a fila de jobs para o comando de CL Submeter Job (SBMJOB) subjacente.
[AIX Solaris HP-UX Linux Windows][z/OS]-logfile <Nome_do_arquivo>
[AIX Solaris HP-UX Linux Windows][z/OS]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.
[AIX Solaris HP-UX Linux Windows][IBM i]-nowait
[AIX Solaris HP-UX Linux Windows][IBM i]Instrui ao comando startServer para não aguardar uma inicialização bem-sucedida do processo do servidor ativado.
[IBM i]-outq <product_library/output_queue>
[IBM i]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.
[AIX Solaris HP-UX Linux Windows][z/OS]-quiet
[AIX Solaris HP-UX Linux Windows][z/OS]Suprime as informações de progresso que o comando startServer imprime no modo normal.
[AIX Solaris HP-UX Linux Windows][z/OS]-replacelog
[AIX Solaris HP-UX Linux Windows][z/OS]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.

[z/OS]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
[IBM i]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:
CWNATV03I: O servidor de aplicativos xxxxxx no perfil xxxxxx concluiu a recuperação. Servidor parado.
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.
[IBM i]-sbs <product_library/subsystem_description>
[IBM i]Especifica o subsistema a ser utilizado para o comando CL Submeter Tarefa (SBMJOB) subjacente.
[AIX Solaris HP-UX Linux Windows][z/OS]-statusport <Número_da_porta>
[AIX Solaris HP-UX Linux Windows][z/OS]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.
[AIX Solaris HP-UX Linux Windows][z/OS]-script [<nome_do_arquivo_de_script>] -background
[AIX Solaris HP-UX Linux Windows][z/OS]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
[AIX Solaris HP-UX Linux Windows][z/OS]Gera informações de rastreio no arquivo de log para finalidades de depuração.
[IBM i]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.
[IBM i]-usejobd
[IBM i]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]
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]
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]
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.

O exemplo a seguir é um script executando e capturando o código de retorno para server1:
#!/bin/sh
exitCode=`./startServer.sh server1`
O valor exitCode pode ser comparado à lista a seguir de códigos de retorno para determinar os resultados do comando:
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

Í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_startserver
Nome do arquivo: rxml_startserver.html