Capítulo 4. Configuración de JBoss EAP para ejecutar como un servicio

Configuración de JBoss EAP como un servicio en Red Hat Enterprise Linux

1. Personalice las opciones de arranque en el archivo jboss-eap.conf.

   El script de arranque y un archivo de configuración asociado se localizan en el directorio EAP_HOME/bin/init.d/. Abra jboss-eap.conf en un editor de texto y establezca las opciones para su instalación de JBoss EAP.

   Hay varias opciones dentro del archivo jboss-eap.conf. Como mínimo, especifique los valores correctos para las variables JBOSS_HOME y JBOSS_USER.

   Puede personalizar las otras opciones provistas en el archivo de configuración descomentando y editando las líneas respectivas. Pero si no, se predeterminará a iniciará un JBoss EAP autónomo mediante el archivo de configuración predeterminado, standalone.xml.

   Nota

   Si desea que el servicio inicie JBoss EAP en modo de dominio, agregue JBOSS_MODE=domain to jboss-eap.conf.

   Para especificar archivos de configuración de dominio personalizados, agregue JBOSS_DOMAIN_CONFIG=DOMAIN_CONFIG_FILE.xml y JBOSS_DOMAIN_CONFIG=DOMAIN_CONFIG_FILE.xml. De forma predeterminada, JBoss EAP utiliza domain.xml y host.xml como archivos de configuración de dominio.

2. Copie los archivos de servicio en los directorios del sistema

   1. Copie el archivo de configuración de servicio modificado en el directorio /etc/default .

      sudo cp EAP_HOME/bin/init.d/jboss-eap.conf /etc/default

   2. Copie el script de arranque en el directorio /etc/init.d y otórguele permisos de ejecución:

      sudo cp EAP_HOME/bin/init.d/jboss-eap-rhel.sh /etc/init.d
      sudo chmod +x /etc/init.d/jboss-eap-rhel.sh

3. Agregue el nuevo servicio jboss-eap-rhel.sh a la lista de servicios iniciados automáticamente, mediante el comando de administración del servicio chkconfig.

   sudo chkconfig --add jboss-eap-rhel.sh

4. Utilice uno de los siguientes comandos para probar si el servicio ha sido instalado correctamente.

   1. Para Red Hat Enterprise Linux 6:

      sudo service jboss-eap-rhel.sh start

   2. Para Red Hat Enterprise Linux 7:

      sudo service jboss-eap-rhel start

   El servicio iniciará. Si obtiene un error, revise los registros de errores y asegúrese de que las opciones en el archivo de configuración estén correctas.

5. Para que el servicio inicie automáticamente cuando el servidor de Red Hat Enterprise Linux inicie, ejecute el siguiente comando:

   sudo chkconfig jboss-eap-rhel.sh on

Borre la instalación del servicio JBoss EAP de Red Hat Enterprise Linux

1. Si el servicio está ejecutándose, abra una terminal y detenga el servicio con uno de los siguientes comandos:

   1. Para Red Hat Enterprise Linux 6:

      sudo service jboss-eap-rhel.sh stop

   2. Para Red Hat Enterprise Linux 7:

      sudo service jboss-eap-rhel stop

2. Borre JBoss EAP de la lista de servicios:

   sudo chkconfig --del jboss-eap-rhel.sh

3. Borre el archivo de configuración e inicie el script:

   sudo rm /etc/init.d/jboss-eap-rhel.sh
   sudo rm /etc/default/jboss-eap.conf

Configurar JBoss EAP como un servicio en el servidor de Microsoft Windows

1. Crear dos variables de entorno del sistema:

   • JBOSS_HOME apuntando al directorio de instalación JBoss EAP.
   • NOPAUSE=1

2. Instale el paquete Jsvc de JBoss Core Services

   Si no está aún configurado, descargue y extraiga el paquete Jsvc JBoss Core Services

   1. Abra un navegador e inicie sesión en el Portal del cliente de Red Hat en la Página de descargas de software JBoss.
   2. Seleccione Apache Jsvc en el menú desplegable de Producto.
   3. Seleccione la versión más reciente en el menú desplegable Versión.
   4. Busque Red Hat JBoss Core Services Apache Jsvc en la lista, asegurándose de seleccionar la plataforma y la arquitectura correctas para su sistema, luego haga clic en el enlace Descargar.

   5. Extraiga el archivo ZIP descargado en el directorio que contiene su directorio de instalación JBoss EAP.

      Como resultante tendrá el directorio jbcs-jsvc-<VERSION> en la misma profundidad que el directorio de instalación de JBoss EAP. Por ejemplo:

      C:\Program Files
      ├── jboss-eap-7.0
      │   ├── bin
      │   └── ...
      └── jbcs-jsvc-<VERSION>

3. Instale el servicio

   Abra una terminal y cambie de directorio a EAP_HOME\bin.

   Abajo verá los ejemplos de un comando básico service.bat installpara crear un nuevo servicio para un servidor autónomo o un servidor en un dominio administrado. Para obtener una lista de todas las opciones posibles, ejecute service.bat sin ningún argumento.

   Ejecute el siguiente comando, ajustando el nivel de registro para el servicio como se requiera:

   1. Para un servidor autónomo:

      service.bat install /loglevel INFO

   2. Para un servidor en un dominio administrado:

      Utilice el parámetro /host para especificar el nombre del controlador de host de JBoss EAP que está controlado por el servicio. Puede ver los valores válidos para el nombre ejecutando ls /host en la CLI de administración.

      Reemplace EAP_HOST_NAME en el comando siguiente con el nombre del controlador de host de JBoss EAP. Si especifica el parámetro /host sin proporcionar un nombre de controlador de host de JBoss EAP, el nombre se omite en master.

      service.bat install /host EAP_HOST_NAME /loglevel INFO

   Se creará un nuevo servicio Windows con el nombre JBossEAP7.

4. Verifique el nuevo servicio en la consola de Servicios

   Abra la consola de servicios de Windows (services.msc) y verifique si el servicio ha sido creado.

   Si se utilizó el nombre predeterminado del servicio en la lista de servicios Windows, entonces el nuevo servicio tendrá por nombre: JBossEAP. Desde la consola de servicios puede iniciar y detener el servicio así como cambiar su configuración y la manera y momento de inicio.

5. Iniciar y detener el servicio JBoss EAP desde una terminal

   Para iniciar el servicio desde una terminal, use el siguiente comando, cambiando el nombre del servicio si es necesario:

   net start JBossEAP7

   Para detener el servicio desde una terminal, use el siguiente comando, cambiando el nombre del servicio si es necesario:

   net stop JBossEAP7

Suprimir el servicio JBoss EAP en Microsoft Windows Server

1. Si el servicio está ejecutándose, primero abra una terminal y detenga el servicio con el comando net stop con el nombre del servicio:

   net stop JBossEAP7

2. En una terminal, cambie los directorios a EAP_HOME\bin y ejecute el siguiente comando:

   service.bat uninstall

1. Abra un navegador e inicie sesión en el Portal del cliente de Red Hat en la Página de descargas de software JBoss.
2. Seleccione Apache Jsvc en el menú desplegable de Producto.
3. Seleccione la versión más reciente en el menú desplegable Versión.
4. Busque Red Hat JBoss Core Services Apache Jsvc en la lista, asegurándose de seleccionar la plataforma y la arquitectura correctas para su sistema, luego haga clic en el enlace Descargar.

5. Extraiga el archivo ZIP descargado en el directorio que contiene su directorio de instalación JBoss EAP.

   Como resultante tendrá el directorio jbcs-jsvc-<VERSION> en la misma profundidad que el directorio de instalación de JBoss EAP. Por ejemplo:

   /var/opt/
   ├── jboss-eap-7.0
   │   ├── bin
   │   └── ...
   └── jbcs-jsvc-<VERSION>

6. Los ejemplos de comandos para usar Jsvc e iniciar JBoss EAP presumen que el usuario jboss ha sido creado. Si aún no ha creado un usuario para JBoss EAP, ejecute los siguientes comandos para crear el usuario y grupo jboss.

   # groupadd -f -g 185 -r jboss
   # useradd -r -u 185 -g jboss -d EAP_HOME -s /sbin/nologin -c "JBoss" jboss

1. Ingrese a Red Hat Subscription Manager.
2. Haga clic en Sistemas en el Inventario de suscriptor.

3. Suscríbase a los repositorios JBoss Core Services CDN en funcionamiento para la versión y arquitectura de su sistema operativo:

   1. Para Red Hat Enterprise Linux 6:

      • jb-coreservices-1-for-rhel-6-server-rpms

   2. Para Red Hat Enterprise Linux 7:

      • jb-coreservices-1-for-rhel-7-server-rpms

4. Ejecute el siguiente comando como usuario root para instalar Jsvc:

   # yum groupinstall jbcs-jsvc