![[Windows]](../images/windows.gif)
![[Linux]](../images/linux.gif)
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.
Quando o assistente de instalação cria um serviço, o programa desinstalador pode remover o serviço. Se você utilizar o comando WASService para criar um serviço, será sua responsabilidade remover o serviço quando ele não for mais válido. O programa do desinstalador não remove serviços que você cria com o comando WASService.
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
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:Localização do Arquivo de Comandos
O arquivo de comando wasservice.sh está localizado no diretório
app_server_root\bin.
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]](../images/linux.gif)
wasservice.sh -start nome_do_serviço [parâmetros opcionais do startServer.bat]
![[Windows]](../images/windows.gif)
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]](../images/linux.gif)
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]
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]](../images/windows.gif)
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: 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.gotchaSintaxe de Comandos para Excluir um Serviço
A sintaxe de comando é a seguinte:
![[Linux]](../images/linux.gif)
wasservice.sh -remove service_name
![[Windows]](../images/windows.gif)
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]](../images/linux.gif)
wasservice.sh -stop nome_do_serviço [parâmetros opcionais do stopServer.bat]
![[Windows]](../images/windows.gif)
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]](../images/linux.gif)
wasservice.sh -status service_name
![[Windows]](../images/windows.gif)
WASService.exe -status nome_do_serviço
Parâmetros Obrigatórios
Os parâmetros a seguir são necessários com esse comando:
- Use essa opção para especificar o caminho do diretório do perfil que define o processo do servidor.
- 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.
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: 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.
- -configRoot
- -encodeParams
- -logFile
- -logRoot
- -restart
- -startType
Nomes Padrão para Serviços Criados pelo Assistente
O nome do serviço que é criado pelo assistente de instalação é IBM® WebSphere Application Server V9.x – DefaultNode.
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]](../images/windows.gif)
Exemplos
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 queDepois 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]](../images/windows.gif)
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.
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
Tópico de Referência