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

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

Sintaxis 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
- IBM WebSphere Application Server V9.x - nombre_nodo_gestor_despliegue
- IBM WebSphere Application Server V9.x - nombre_nodo_servidor1
- Después de federar el nodo y crear un servidor de aplicaciones, se puede crear un servicio denominado IBM WebSphere Application Server V9.x - nombre_nodo_gestionado.
Después de crear un perfil, debe federar el nodo para crear un servidor de agente de nodo en el nodo. Asimismo, puede utilizar la consola administrativa del gestor de despliegue para crear procesos de servidor de aplicaciones en el nodo. Puede crear un servicio Windows para el proceso del servidor del agente de nodo.
También se crea un servidor de agente de nodo después de añadir un nodo de servidor de aplicaciones a una célula del gestor de despliegue. Puede crear un servicio para el proceso de servidor de agente de nodo como se describe posteriormente.
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 gestor de despliegue
Este ejemplo crea un servicio llamado IBM® WebSphere Application Server V9.x - nombre_del_servicio_de_gestor_despliegue que inicia el proceso dmgr:
WASService -add nombre_servicio_gestor_despliegue
-servername nombre_servidor_gestor_despliegue
-profilePath raíz_perfil
-wasHome
raíz_servidor_aplic
-logFile WS_startManager.log
-logRoot raíz_perfil\logs\nombre_servidor_gestor_despliegue
-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_gestor_despliegue
Raíz de configuración:
raíz_perfil\config
Nombre de servidor: nombre_servidor_gestor_despliegue
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_gestor_despliegue se ha añadido
satisfactoriamente.
Pulse Inicio > Valores > Panel de control > Herramientas administrativas > Servicios para trabajar con el servicio nuevo.
Creación de un servicio de agente de nodo
Este ejemplo crea un servicio llamado IBM WebSphere Application Server V9.x - nombre_del_servicio_de_agente_de_nodo que inicia el proceso del servidor de agente de nodo:
WASService -add nombre_del_servicio_de_agente_nodo
-servername nombre_servidor_agente_nodo
-profilePath raíz_perfil
-wasHome
raíz_servidor_aplic
-logFile WS_startNode.log
-logRoot
raíz_perfil\logs\nombre_servidor_agente_nodo
-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_agente_nodo
Raíz de configuración:
raíz_perfil\config
Nombre de servidor: nombre_servidor_agente_nodo
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_agente_nodo se ha añadido
satisfactoriamente.
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.
Si emite el mandato startNode o stopNode después de crear un servicio Windows para el proceso agentenodo, aparecerá un mensaje parecido al del ejemplo siguiente:
Como nodeagent está registrado para que se ejecute como un servicio de Windows Service, la
solicitud de iniciar o detener este servidor se realizará
iniciando o deteniendo el servicio de Windows asociado. Examine
los archivos del registro para ver los mensajes relacionados con este mandato.
Si emite el mandato startManager o stopManager después de crear un servicio Windows para gestor de despliegue, aparecerá un mensaje parecido al del ejemplo siguiente:
Como dmgr se registra para ejecutarse como servicio Windows,
la
solicitud de iniciar o detener este servidor se realizará
iniciando o deteniendo el servicio de Windows asociado. Examine
los archivos del registro para ver los mensajes relacionados con este mandato.
