![[Windows]](../images/windows.gif)
![[Linux]](../images/linux.gif)
Mandato WASService
La herramienta de línea de mandatos WASService permite crear un servicio para un proceso Java™ del producto en sistemas operativos Linux y Windows.
Si el asistente de instalación crea un servicio, el programa desinstalador puede eliminar el servicio. Si utiliza el mandato WASService para crear un servicio, es responsabilidad suya eliminar el servicio cuando ya no sea válido. El programa desinstalador no elimina los servicios que se crean con el mandato WASService.
Avoid trouble: Como alternativa al mandato WASService, puede utilizar el
programa de utilidad WASServiceHelper, que complementa el mandato
WASService y reduce los errores de configuración posibles. Para obtener más información, consulte la documentación sobre el uso del WASServiceHelper para crear servicios de Windows. gotcha
Para configurar y ejecutar esta función en sistemas operativos Microsoft Windows, el usuario debe pertenecer al grupo de administradores y tener los siguientes permisos de usuario avanzado:Ubicación del archivo de mandatos
El archivo de mandatos wasservice.sh se
encuentra en el directorio
raíz_servidor_aplic\bin.
El archivo de mandatos WASService.exe se
encuentra en el directorio
raíz_servidor_aplic\bin.
Sintaxis del mandato
Sintaxis del mandato para iniciar un servicio existente
La sintaxis del mandato es la siguiente:
![[Linux]](../images/linux.gif)
wasservice.sh -start nombre_servicio [parámetros opcionales de
startServer.bat]
![[Windows]](../images/windows.gif)
WASService.exe -start
nombre_servicio [parámetros opcionales de startServer.bat]
Sintaxis del mandato para crear un servicio o actualizar un servicio existente
La sintaxis del mandato es la siguiente:
![[Linux]](../images/linux.gif)
wasservice.sh -add nombre_servicio
-serverName nombre_servidor
-profilePath
directorio_perfil_servidor
[-wasHome raíz_servidor_aplic]
[-startArgs argumentos_inicio_adicionales]
[-stopArgs argumentos_parada_adicionales]
[-userid ID_usuario -password contraseña]
Note: Para WebSphere Application Server Versión 7.0 y versiones posteriores, no utilice el signo "@" como prefijo en el ID de usuario cuando especifique wasservice.sh. El uso del signo "@" como prefijo en el ID de usuario para wasservice.sh sólo se aplica a WebSphere Application Server Versión 6.1. La especificación de wasservice.sh con -userid @myuser no debe utilizarse en la versión 7.0 y posteriores.
![[Windows]](../images/windows.gif)
WASService.exe -add
nombre_servicio
-serverName nombre_servidor
-profilePath
directorio_perfil_servidor
[-wasHome raíz_servidor_aplic]
[-configRoot directorio_depósito_configuración]
[-startArgs argumentos_inicio_adicionales]
[-stopArgs argumentos_parada_adicionales]
[-userid ID_usuario -password contraseña]
[-logFile archivo_anotaciones_servicio]
[-logRoot directorio_anotaciones_servidor]
[-restart true | false]
[-startType automatic | manual | disabled]
Avoid trouble: Aunque el parámetro
-logroot es opcional, se recomienda incluirlo.
En algunos casos, si no se especifica este parámetro opcional, es
posible que aparezca un error en el registro de sucesos que indique
que el servidor de aplicaciones está intentando crear un servicio con
el parámetro -logroot. gotchaSintaxis del mandato para suprimir un servicio
La sintaxis del mandato es la siguiente:
![[Linux]](../images/linux.gif)
wasservice.sh -remove nombre_servicio
![[Windows]](../images/windows.gif)
WASService.exe
-remove nombre_servicio
Sintaxis del mandato para dejar de ejecutar un servicio
La sintaxis del mandato es la siguiente:
![[Linux]](../images/linux.gif)
wasservice.sh -stop nombre_servicio [parámetros opcionales de
stopServer.bat]
![[Windows]](../images/windows.gif)
WASService.exe -stop
nombre_servicio [parámetros opcionales de stopServer.bat]
Sintaxis del mandato para recuperar el estado del servicio
La sintaxis del mandato es la siguiente:
![[Linux]](../images/linux.gif)
wasservice.sh -status nombre_servicio
![[Windows]](../images/windows.gif)
WASService.exe -status nombre_servicio
Parámetros necesarios
Los parámetros siguientes son obligatorios con este mandato:
- Utilice esta opción para especificar la vía de acceso del directorio del perfil que define el proceso de servidor.
- Utilice esta opción para identificar el servidor que controla el servicio.
Parámetros opcionales
Los siguientes parámetros son opcionales con este mandato:
- -add nombre_servicio
- Utilice esta opción para crear un servicio denominado nombre_servicio o para actualizar uno existente. La sintaxis es idéntica en ambos casos.
- -configRoot directorio_repositorio_configuración (sólo para Windows)
- Utilice esta opción para identificar el directorio de configuración del directorio raíz de instalación de un producto WebSphere Application Server.
- -encodeParams nombre_servicio (sólo para Windows)
- Utilice esta opción para obligar a que el servicio codifique
-startArgs y -stopArgs de modo que los argumentos no puedan
determinarse editando el registro. Utilice este parámetro para crear un servicio con el parámetro -add
mediante la adición de -encodeParams a la línea de mandatos sin
argumentos.
O codifique los parámetros de un servicio existente: WASService -encodeParams nombre_servicio - -logFile archivo_registro_servicio (sólo para Windows)
- Utilice esta opción para identificar un archivo de anotaciones
cronológicas que utiliza el mandato WASService
para registrar su actividad.
Avoid trouble: Asegúrese de especificar el archivo de registro de servicio como un nombre completo que tenga una vía de acceso exclusiva. Si el sistema tiene varias instancias, sin esta calificación, los resultados serán imprevisibles y WASService no podrá determinar cuándo ha finalizado la inicialización. gotcha - -logRoot directorio_registro_servidor (sólo para Windows)
- Utilice esta opción para identificar el directorio de anotaciones cronológicas de servidor del perfil. El mandato WASService busca un archivo denominado nombre_servidor.pid para determinar si el servidor se está ejecutando.
- -remove nombre_servicio
- Utilice esta opción para suprimir el servicio especificado.
- -restart true | false (sólo para Windows)
- Utilice este parámetro para especificar si el servicio existente se reinicia automáticamente si el servicio falla o no. El servicio existente no se reinicia automáticamente si establece el valor en false. De forma predeterminada, el comportamiento del reinicio está establecido en true, lo que permite que el servicio existente se reinicie automáticamente si falla.
- -start nombre_servicio [parámetros opcionales de startServer.bat]
- Utilice esta opción para iniciar el servicio existente.
- -startArgs argumentos_inicio_adicionales
- Utilice esta opción para identificar parámetros adicionales.
- -startType automatic | manual | disabled (sólo para Windows)
- Utilice esta opción para definir el tipo de arranque del nuevo servicio. Un tipo de arranque automático se inicia automáticamente cuando se inicia el sistema o cuando se llama al servicio por primera vez. Debe iniciar el servicio manual antes de que el sistema operativo pueda cargarlo y hacerlo disponible. No puede iniciar un servicio inhabilitado antes de cambiar el tipo de arranque. De forma predeterminada, el valor de este parámetro se establece en manual.
- -status nombre_servicio
- Utilice esta opción para devolver el estado actual del servicio, que incluye si el servicio se está ejecutando o se ha detenido.
- -stop nombre_servicio [parámetros opcionales de stopServer.bat]
- Utilice esta opción para detener el servicio especificado.
- -stopArgs argumentos_parada_adicionales
- Utilice esta opción para especificar parámetros adicionales.
- -userid ID_usuario -password contraseña
- Utilice esta opción para identificar un ID y contraseña de usuario con privilegios con el que se ejecutará el servicio de Windows.
- -wasHome raíz_servidor_aplic
- Utilice esta opción para identificar el directorio raíz de la instalación del producto.
- -configRoot
- -encodeParams
- -logFile
- -logRoot
- -restart
- -startType
Nombres predeterminados para servicios creados por el asistente
El nombre del servicio que crea el asistente de instalación es IBM® WebSphere Application Server V9.x - DefaultNode.
Visualización del panel de servicios
Para ver los servicios, abra el panel de control y pulse Herramientas administrativas > Servicios. Seleccione un servicio para visualizar información sobre él. Pulse con el botón derecho del ratón en el servicio y pulse Propiedades. Cuatro pestañas proporcionan información y funcionalidad. Por ejemplo, seleccione el campo tipo de instalación en la pestaña General para modificar el tipo de configuración.
![[Windows]](../images/windows.gif)
Ejemplos
Creación de un servicio de servidor de aplicaciones
Este ejemplo crea un servicio llamado IBM WebSphere Application Server V9.x - nombre_del_servicio_de_servidor_aplicaciones que inicia un proceso de servidor de aplicaciones:
WASService -add nombre_del_servicio_de_servidor_aplicaciones
-servername nombre_servidor_aplicaciones
-profilePath raíz_perfil
-wasHome
raíz_servidor_aplic
-logFile WS_startServer.log
-logRoot
raíz_perfil\logs\nombre_servidor_aplicaciones
-restart true
dondeDespués de especificar el mandato, los mensajes que son similares a los que aparecen en el ejemplo siguiente se visualizan en la ventana de mandato:
Añadir servicio:
nombre_del_servicio_de_servidor_aplicaciones
Raíz de configuración:
raíz_perfil\config
Nombre de servidor: nombre_servidor_aplicaciones
Vía de acceso del perfil:
raíz_perfil
Inicio de WAS:
raíz_servidor_aplic
Args de inicio:
Reinicio: 1
El servicio IBM WebSphere Application Server V9.x - nombre_servicio_servidor_aplicaciones se ha añadido
satisfactoriamente.
Actualización de un servicio de servidor de aplicaciones existente
Este ejemplo para el sistema operativo Windows actualiza un servicio existente llamado IBM WebSphere Application Server V9.x - Servicio servidor2 con argumentos stop, nombre de usuario y contraseña adicionales. Los parámetros se pasan automáticamente al script que el servicio Windows utiliza para concluir el sistema.
WASService -add "Servicio servidor2"
-servername servidor2
-profilePath raíz_perfil
-logRoot
raíz_perfil\logs\servidor2
-stopArgs "-username nombre_usuario -password
contraseña"
-encodeParams
![[Windows]](../images/windows.gif)
Inicio y detención de un proceso de servidor después de crear un servicio Windows
Para este ejemplo del sistema operativo Windows, si emite el mandato startServer servidor1 o stopServer servidor1 después de crear un servicio Windows para servidor1, aparecerá un mensaje parecido al del ejemplo siguiente:
Como servidor1 se registra para ejecutarse como servicio Windows, la
solicitud para iniciar este servidor se llevará a cabo al iniciar el
servicio Windows asociado.
Avoid trouble: Crear y eliminar un servicio de WebSphere en Windows puede resultar confuso y propenso a errores. Para obtener ayuda sobre los errores de diagnóstico, consulte la
información relativa a la utilización de WASServiceCmd para crear
servicios de Windows para WebSphere Application Servers. gotcha
Reference topic