[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
  • Proceso agentenodo de un servidor de aplicaciones que forme parte de una célula de gestor de despliegue
  • Proceso del gestor de despliegue, dmgr
[Windows]Nota: No añada un servidor de aplicaciones que forme parte de un nodo federado o gestionado como servicio Windows. Utilice el agente de nodo para gestionar nodos federados.
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

Los nombres de los servicios que puede crear la Herramienta de gestión de perfiles son:
Gestor de despliegue
IBM WebSphere Application Server V9.x - nombre_nodo_gestor_despliegue
Servidor de aplicaciones
IBM WebSphere Application Server V9.x - nombre_nodo_servidor1
Perfil personalizado
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]

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
donde
  • nombre_servicio_gestor_despliegue es el nombre que desea dar al servicio
  • nombre_servidor_gestor_despliegue 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_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
donde
  • nombre_servicio_agente_nodo es el nombre que desea dar al servicio
  • raíz_perfil es la ubicación donde reside el agente de nodo en el sistema de archivos
  • nombre_servidor_agente_nodo es el nombre del agente de nodo

    Normalmente, esto es simplemente agentenodo.

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

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.
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-nd-mp&topic=rins_wasservice
File name: rins_wasservice.html