[Windows][Linux]

Comando WASService

A ferramenta de linha de comandos WASService permite criar um serviço para um processo Java™ do produto em sistemas operacionais Linux e Windows.

Você pode criar serviços para processos Java do WebSphere Application Server. Os serviços potenciais incluem os seguintes processos do servidor:
  • O processo server1 padrão em um nó do servidor de aplicativos
  • Os processos do servidor de aplicativos que você cria em um nó do servidor de aplicativos
  • O processo nodeagent em um nó do servidor de aplicativos que faz parte de uma célula do gerenciador de implementação
  • O processo do gerenciador de implementação, dmgr
[Windows]Nota: Não inclua um servidor de aplicativos que faça parte de um nó federado ou gerenciado como um serviço do Windows. Utilize o agente do nó para gerenciar nós federados.
Evitar Problemas Evitar Problemas: Como uma alternativa para o comando WASService, é possível usar o utilitário WASServiceHelper, o qual complementa o comando WASService e reduz possíveis erros de configuração. Para obter informações adicionais, consulte a documentação sobre como usar o WASServiceHelper para criar serviços do Windows.gotcha
[Windows]Para configurar e executar essa função em um sistema operacional Microsoft Windows, o usuário deve pertencer ao grupo de administrador e ter os seguintes direitos de usuário avançado:
  • Agir como parte do sistema operacional
  • Efetuar logon como serviço

Localização do Arquivo de Comandos

[Linux]O arquivo de comando wasservice.sh está localizado no diretório app_server_root\bin.

[Windows]O arquivo de comando WASService.exe está localizado no diretório app_server_root\bin.

Sintaxe de comando

Sintaxe de Comandos para Iniciar um Serviço Existente

A sintaxe do comando é a seguinte:

[Linux]
wasservice.sh -start nome_do_serviço [parâmetros opcionais do startServer.bat] 
[Windows]
WASService.exe -start nome_do_serviço [parâmetros opcionais do startServer.bat] 

Sintaxe de Comando para Criar um Serviço ou Atualizar um Serviço Existente

A sintaxe do comando é a seguinte:

[Linux]
wasservice.sh -add service_name
   -serverName  server_name
   -profilePath server_profile_directory
   [-wasHome  app_server_root]
   [-startArgs argumentos_adicionais_de_início]
   [-stopArgs argumentos_adicionais_de_parada]
   [-userid user_id -password password]
        
[Linux]Note: Para o WebSphere Application Server Versão 7.0 e versões mais recentes, não use o sinal "@" como um prefixo no ID do usuário ao especificar wasservice.sh. O uso do sinal "@" como um prefixo no ID do usuário para wasservice.sh se aplica apenas ao WebSphere Application Server Versão 6.1.

A especificação de wasservice.sh com -userid @myuser não deve ser usada na Versão 7.0 e mais recente.

[Windows]
WASService.exe -add nome_do_serviço
   -serverName  server_name
   -profilePath server_profile_directory
   [-wasHome  app_server_root]
   [-configRoot diretório_do_repositório_de_configuração]
   [-startArgs argumentos_adicionais_de_início]
   [-stopArgs argumentos_adicionais_de_parada]
   [-userid user_id -password password]
   [-logFile arquivo_de_log_de_serviço]
   [-logRoot diretório_de_log_do_servidor]
   [-restart true | false]
   [-startType automatic | manual | disabled]
      
Evitar Problemas Evitar Problemas: Embora o parâmetro -logroot seja opcional, é aconselhável incluir esse parâmetro opcional. Em alguns casos, quando você não especifica esse parâmetro opcional, pode ver um erro no log de eventos que diz que o servidor de aplicativos está tentando criar um serviço com o parâmetro -logroot.gotcha

Sintaxe de Comandos para Excluir um Serviço

A sintaxe de comando é a seguinte:

[Linux]
wasservice.sh -remove service_name
[Windows]
WASService.exe -remove nome_do_serviço

Sintaxe de Comandos para Parar um Serviço em Execução

A sintaxe do comando é a seguinte:

[Linux]
wasservice.sh -stop nome_do_serviço [parâmetros opcionais do stopServer.bat]
[Windows]
WASService.exe -stop nome_do_serviço [parâmetros opcionais do stopServer.bat]

Sintaxe de Comandos para Recuperar um Status de Serviço

A sintaxe do comando é a seguinte:

[Linux]
wasservice.sh -status service_name
[Windows]
WASService.exe -status nome_do_serviço

Parâmetros Obrigatórios

Os parâmetros a seguir são necessários com esse comando:

-profilePath server_profile_directory
Use essa opção para especificar o caminho do diretório do perfil que define o processo do servidor.
-serverName server_name
Use essa opção para identificar o servidor que o serviço controla.

Parâmetros Opcionais

Os seguintes parâmetro são opcionais com este comando:

-add nome_do_serviço
Use essa opção para criar um serviço denominado service_name ou atualizar um serviço existente. A sintaxe é a mesma para ambos os casos.
-configRoot configuration_repository_directory (Somente Windows)
Use essa opção para identificar o diretório de configuração do diretório-raiz de instalação de um produto WebSphere Application Server.
-encodeParams service_name (Somente Windows)
Use essa opção para forçar o serviço para codificar os -startArgs e -stopArgs de maneira que os argumentos não possam ser determinados pela edição do registro. Utilize o parâmetro ao criar um serviço com o parâmetro -add, incluindo -encodeParams na linha de comandos sem argumentos.
[Windows]Ou codifique os parâmetros de um serviço existente:
WASService -encodeParams service_name
-logFile service_log_file (Somente Windows)
Use essa opção para identificar o arquivo de log que o comando WASService usa para registrar sua atividade.
Evitar Problemas Evitar Problemas: Certifique-se de especificar o arquivo de log de serviço como um nome completo que tem um caminho exclusivo. Se o seu sistema tiver diversas instâncias, então, sem essa qualificação, os resultados serão imprevisíveis e o WASService não poderá determinar quando a inicialização está concluída.gotcha
-logRoot server_log_directory (Somente Windows)
Use essa opção para identificar o diretório de log do servidor para o perfil. O comando WASService procura por um arquivo denominado server_name.pid para determinar se o servidor está em execução.
-remove nome_do_serviço
Use essa opção para excluir o serviço especificado.
-restart true | false (Somente Windows)
Utilize este parâmetro para especificar se o serviço existente reinicia ou não automaticamente em caso de falha. O serviço existente não reinicia automaticamente se você configurar o valor como false. Por padrão, o comportamento de reinício é configurado como verdade, o que possibilita ao serviço existente reiniciar automaticamente se ele falhar.
-start service_name [parâmetros opcionais do startServer.bat]
Use essa opção para iniciar o serviço existente.
-startArgs argumentos_adicionais_de_início
Use essa opção para identificar os parâmetros adicionais.
-startType automatic | manual | disabled (Somente Windows)
Use essa opção para definir o tipo de inicialização do novo serviço. Um tipo de inicialização automática é iniciado automaticamente no início do sistema ou quando o serviço é chamado pela primeira vez. Você deve iniciar um serviço manual antes que o sistema operacional possa carregá-lo e torná-lo disponível. Você não pode iniciar um serviço desativado antes de alterar o tipo de inicialização. Por padrão, o valor desse parâmetro é configurado como manual.
-status nome_do_serviço
Use essa opção para retornar o status atual do serviço, que inclui se o serviço está em execução ou interrompido.
-stop service_name [optional stopServer.bat parameters]
Use essa opção para parar o serviço especificado.
-stopArgs argumentos_adicionais_de_parada
Use essa opção para especificar parâmetros adicionais.
-userid ID_do_usuário -password senha
Use essa opção para identificar um ID do usuário e senha privilegiados com os quais o serviço do Windows será executado.
-wasHome app_server_root
Use essa opção para identificar o diretório-raiz de instalação do produto.
Note: Os seguintes parâmetros são parâmetros "Somente Windows":
  • -configRoot
  • -encodeParams
  • -logFile
  • -logRoot
  • -restart
  • -startType
Uma alternativa para a criação de log e o lançamento de erros no Linux é usar o padrão do sistema sysvinit para executar o script normal startServer.sh.
CAUTION:
Os parâmetros não reconhecidos são ignorados.

Nomes Padrão para Serviços Criados pelo Assistente

Os nomes dos serviços que o Ferramenta de Gerenciamento de Perfil pode criar são:
Gerenciador de implementação
IBM WebSphere Application Server V9.x - node_name_of_the_deployment_manager_node
Servidor de aplicativos
IBM WebSphere Application Server V9.x - node_name_of_the_server1_node
Perfil Personalizado
Após federar o nó e criar um servidor de aplicativos, pode ser criado um serviço chamado IBM WebSphere Application Server V9.x – node_name_of_the_managed_node.

Depois de criar um perfil personalizado, você deve federar o nó para criar um servidor do agente de nós no nó. Você também pode utilizar o console administrativo do gerenciador de implementação para criar processos do servidor de aplicativos no nó. Você pode criar um serviço do Windows para o processo do servidor de agente de nó.

Um servidor nodeagent também é criado depois de incluir um nó do servidor de aplicativos em uma célula do gerenciador de implementação. Você pode criar um serviço para o processo do servidor do agente do nó conforme descrito posteriormente.

Visualizando o Painel de Serviços

Para visualizar os serviços, abra o Painel de Controle e clique em Ferramentas administrativas > Serviços. Selecione um serviço para visualizar as informações sobre ele. Clique com o botão direito no serviço e clique em Propriedades. Quatro guias fornecem informações e funcionalidade. Por exemplo, selecione o campo Tipo de Configuração na guia Geral para alterar o tipo de configuração.

[Windows]

Exemplos

Criando um Serviço do Deployment Manager

Esse exemplo cria um serviço chamado IBM® WebSphere Application Server V9.x – name_of_the_deployment_manager_service que inicia o processo dmgr:

WASService -add nome_do_serviço_do_gerenciador_de_implementação
   -servername nome_do_servidor_do_gerenciador_de_implementação
   -profilePath profile_root
   -wasHome raiz_do_servidor_de_apl
   -logFile WS_startManager.log
   -logRoot raiz_do_perfil\logs\nome_do_servidor_do_gerenciador_de_implementação
   -restart true
em que
  • nome_do_serviço_do_gerenciador_de_implementação é o nome que você deseja fornecer ao serviço
  • nome_do_servidor_do_gerenciador_de_implementação é o nome de seu servidor

Depois de digitar o comando, as mensagens semelhantes às do exemplo a seguir são exibidas na janela de comandos:

Incluindo Serviço: nome_do_serviço_do_gerenciador_de_implementação
   Raiz de Config.: profile_root\config
   Nome do Servidor: nome_do_servidor_do_gerenciador_de_implementação
   Caminho de Perfil: profile_root
   Home do Was: app_server_root
   Arg Iniciais:
   Reiniciar: 1
IBM WebSphere Application Server V9.x - Serviço name_of_the_deployment_manager_service incluído com sucesso.

Clique em Iniciar > Configurações > Painel de controle > Ferramentas administrativas > Serviços para trabalhar com o novo serviço.

Criando um Serviço do Agente de Nós

Esse exemplo cria um serviço chamado IBM WebSphere Application Server V9.x – name_of_the_node_agent_service que inicia o processo do servidor do agente do nó:

WASService -add nome_do_serviço_do_agente_do_nó
   -servername nome_do_servidor_do_agente_do_nó
   -profilePath raiz_do_perfil
   -wasHome raiz_do_servidor_de_apl
   -logFile WS_startNode.log
   -logRoot raiz_do_perfil\logs\nome_do_servidor_de_agente_do_nó
   -restart true
em que
  • nome_do_serviço_do_agente_do_nó é o nome que você deseja fornecer ao serviço
  • profile_root é o local em que o agente do nó reside no sistema de arquivos
  • node_agent_server_name é o nome do agente do nó

    Normalmente, ele é simplesmente nodeagent.

Depois de digitar o comando, as mensagens semelhantes às do exemplo a seguir são exibidas na janela de comandos:

Incluindo Serviço: nome_do_serviço_do_agente_do_nó
   Raiz de Config.: profile_root\config
   Nome do Servidor: nome_do_servidor_do_agente_do_nó
   Caminho de Perfil: profile_root
   Home do Was: app_server_root
   Arg Iniciais:
   Reiniciar: 1
IBM WebSphere Application Server V9.x - Serviço name_of_the_node_agent_service incluído com sucesso.

Criando um Serviço do Servidor de Aplicativos

Esse exemplo cria um serviço chamado IBM WebSphere Application Server V9.x – name_of_the_application_server_service que inicia um processo do servidor de aplicativos:

WASService -add nome_do_serviço_do_servidor_de_aplicativos
   -servername nome_do_servidor_de_aplicativos
   -profilePath raiz_do_perfil
   -wasHome raiz_do_servidor_de_apl
   -logFile WS_startServer.log
   -logRoot raiz_do_perfil\logs\nome_do_servidor_de_aplicativos
   -restart true
em que
  • nome_do_serviço_do_servidor_de_aplicativos é o nome que você deseja fornecer ao serviço
  • nome_do_servidor_de_aplicativos é o nome de seu servidor

Depois de digitar o comando, as mensagens semelhantes às do exemplo a seguir são exibidas na janela de comandos:

Incluindo Serviço: nome_do_serviço_do_servidor_de_aplicativos
  Raiz de Config.: profile_root\config
  Nome do Servidor: nome_do_servidor_de_aplicativos
  Caminho de Perfil: profile_root
  Home do Was: app_server_root
  Arg Iniciais:
  Reiniciar: 1
IBM WebSphere Application Server V9.x - Serviço name_of_the_application_server_service incluído com sucesso.

Atualizando um Serviço Existente do Servidor de Aplicativos

Esse exemplo para o sistema operacional Windows atualiza um serviço existente chamado IBM WebSphere Application Server V9.x – Server2 Service com argumentos de parada adicionais, o nome do usuário e senha. Os parâmetros são automaticamente passados no script que o serviço do Windows usa para encerrar o sistema.

WASService -add "Server2 Service"
   -servername server2
   -profilePath raiz_do_perfil
   -logRoot raiz_do_perfil\logs\server2
   -stopArgs "-username user_name  -password password"
   -encodeParams
[Windows]

Iniciando e parando um processo do servidor depois de criar um serviço do Windows

Para esse exemplo do sistema operacional Windows, se você emitir o comando startServer server1 ou o stopServer server1 depois de criar um serviço do Windows para server1, uma mensagem semelhante ao seguinte exemplo será exibida:

Como o server1 é registrado para ser executado como um Serviço do Windows, o
pedido para iniciar esse servidor será concluído iniciando o
Serviço do Windows associado.

Se você emitir o comando startNode ou o comando stopNode depois de criar um serviço do Windows para o processo nodeagent, uma mensagem semelhante ao seguinte exemplo será exibida:

Como o nodeagent é registrado para ser executado como um Serviço do Windows, o
pedido para iniciar ou parar esse servidor será concluído 
iniciando ou parando o Serviço do Windows associado. Examine 
os arquivos de log para visualizar mensagens relacionadas a esse comando.

Se você emitir o comando startManager ou o comando stopManager depois de criar um serviço do Windows para o gerenciador de implementação, uma mensagem semelhante ao seguinte exemplo será exibida:

Como o dmgr é registrado para ser executado como um Serviço do Windows, o
pedido para iniciar ou parar esse servidor será concluído 
iniciando ou parando o Serviço do Windows associado. Examine 
os arquivos de log para visualizar mensagens relacionadas a esse comando.
Evitar Problemas Evitar Problemas: Criar e remover um serviço do WebSphere no Windows pode ser confuso e propenso a erros. Para obter ajuda em quaisquer erros de diagnóstico, consulte as informações sobre como usar WASServiceCmd para criar serviços do Windows para o WebSphere Application Servers.gotcha

Í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=rins_wasservice
Nome do arquivo: rins_wasservice.html