![[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.
![[Windows]](../images/windows.gif)

![[Windows]](../images/windows.gif)
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]
![[Linux]](../images/linux.gif)
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]

Sintaxe 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
- IBM WebSphere Application Server V9.x - node_name_of_the_deployment_manager_node
- IBM WebSphere Application Server V9.x - node_name_of_the_server1_node
- 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]](../images/windows.gif)
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 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_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 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_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 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.
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.
