[Windows][Linux]

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.

Puede crear servicios para los procesos Java de WebSphere Application Server. Los servicios potenciales incluyen los siguientes procesos de servidor:
  • Proceso servidor1 de un nodo de servidor de aplicaciones.
  • Procesos de servidor de aplicaciones que cree en un nodo de servidor de aplicaciones

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 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
[Windows]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:
  • Actuar como parte del sistema operativo
  • Conectarse como un servicio

Ubicación del archivo de mandatos

[Linux]El archivo de mandatos wasservice.sh se encuentra en el directorio raíz_servidor_aplic\bin.

[Windows]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]
wasservice.sh -start nombre_servicio [parámetros opcionales de
startServer.bat] 
[Windows]
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]
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]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]
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 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. gotcha

Sintaxis del mandato para suprimir un servicio

La sintaxis del mandato es la siguiente:

[Linux]
wasservice.sh -remove nombre_servicio
[Windows]
WASService.exe
-remove nombre_servicio

Sintaxis del mandato para dejar de ejecutar un servicio

La sintaxis del mandato es la siguiente:

[Linux]
wasservice.sh -stop nombre_servicio [parámetros opcionales de
stopServer.bat]
[Windows]
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]
wasservice.sh -status nombre_servicio
[Windows]
WASService.exe -status nombre_servicio

Parámetros necesarios

Los parámetros siguientes son obligatorios con este mandato:

-profilePath directorio_perfil_servidor
Utilice esta opción para especificar la vía de acceso del directorio del perfil que define el proceso de servidor.
-serverName nombre_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.
[Windows]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 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.
Note: Los siguientes parámetros son parámetros "sólo para Windows":
  • -configRoot
  • -encodeParams
  • -logFile
  • -logRoot
  • -restart
  • -startType
Una alternativa para el registro y la generación de errores en Linux es utilizar el estándar del sistema sysvinit para ejecutar el script startServer.sh normal.
CAUTION:
Los parámetros no reconocidos se ignoran.

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]

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
donde
  • nombre_servicio_servidor_aplicaciones es el nombre que desea dar al servicio
  • nombre_servidor_aplicaciones es el nombre del servidor

Despué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]

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 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

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=rins_wasservice
File name: rins_wasservice.html