Guía de Instalación

Plataforma de aplicaciones empresariales JBoss 6.2

Para uso con la plataforma de aplicaciones empresariales JBoss de Red Hat

Edición 1

Darrin Mison

Misty Stanley-Jones

Resumen

Este libro es un manual para la instalación de la plataforma de aplicaciones empresariales JBoss 6 y sus lanzamientos de parches.

Capítulo 1. Sinopsis del producto

1.1. Plataforma de aplicaciones empresariales JBoss de Red Hat (JBoss EAP 6)

La plataforma de aplicaciones empresariales JBoss 6 de Red Hat (JBoss EAP 6) es una plataforma middleware poderosa, rápida y segura construída con base en estándares libres y cumple con los requerimientos de la especificación Java empresarial edición 6. Integra el servidor de aplicaciones JBoss 7 con clústers de alta disponiblidad, mensajería poderosa, caché distribuído y otras tecnologías para crear una plataforma estable y escalable.
La nueva estructura modular permite habilitar servicios sólamente cuando se requiera, incrementando de manera importante la velocidad. La consola de administración y la interfaz de la línea de comandos de administración eliminan la necesidad de modificar archivos de configuración XML manualmente, agregando la habilidad para utilizar scripts y automatizar tareas. Además, incluye APIs y marcos de trabajo de desarrollo que se pueden utilizar para desarrollar aplicaciones Java EE seguras, poderosas y escalables de manera rápida.

1.2. Funcionalidades de JBoss EAP 6

Tabla 1.1. Funcionalidades 6.1.0

Funcionalidad Descripción
Certificación Java Implementación certificada del perfil completo de la edición 6 de Java empresarial y las especificaciones del perfil web.
Dominio administrado
  • Administración centralizada de múltiples instancias del servidor y hosts físicos, mientras que un servidor autónomo permite solo una instancia del servidor.
  • Las configuraciones, implementaciones, enlaces de socket, módulos, extensiones y propiedades del sistema se pueden administrar por grupo de servidores.
  • La seguridad de aplicaciones incluyendo los dominios de seguridad se administran de manera central para una configuración simplificada.
Consola de administración y CLI de gestión Las nuevas interfaces se proporcionan para administrar el dominio o servidor autónomo. Ya no se requiere la modificación manual de archivos de configuración XML. El CLI de gestión también ofrece un modo grupal que puede utilizar scripts y automatizar tareas de administración.
Estructura del directorio simplificada El directorio modules/ ahora contiene los módulos del servidor de aplicaciones en lugar de utilizar los directorios específicos y comunes del servidor lib/. Los directorios domain/ y standalone/ contienen los artefactos y archivos de configuración para las implementaciones de dominio y autónomas.
Mecanismo modular de carga de clases Los módulos se cargan y descargan cuando se necesite para brindar beneficios de rendimiento y seguridad y un tiempo de arranque y reinicio más rápidos.
Administración optimizada de la fuente de datos Los controladores de la base de datos se pueden implementar tal como los otros servicios. Además, las fuentes de datos se crean y se administran directamente en la consola de administración o CLI de administración.
Tiempos de inicio y para detener más rápidos La plataforma de aplicaciones empresariales JBoss 6 utiliza menos recursos y es extremadamente eficiente en su uso de recursos del sistema. Este beneficia en especial a los desarrolladores.

Capítulo 2. Introducción

2.1. Sobre el portal del cliente de Red Hat

El portal del cliente de Red Hat es la plataforma centralizada para los recursos de subscripción de Red Hat. Use el portal del cliente de Red Hat para:
  • Administrar y mantener derechos y contratos de soporte a Red Hat;
  • Descargar software soportado oficialmente;
  • Acceder la documentación de productos y la base de conocimiento de Red Hat;
  • Contactar los servicios de soporte global y
  • Registrar errores de productos de Red Hat.
El portal del cliente está disponible aquí: https://access.redhat.com.

Capítulo 3. Requerimientos del sistema

3.1. Prerequisitos de instalación de JBoss EAP 6

Cada proceso de instalación para JBoss EAP 6 tiene un número de prerequisitos. Esta sección aborda los requerimientos comunes así como los específicos de la instalación.

Prerequisitos comunes

Prerequisitos de ZIP/instalador

  • Privilegios de administración para el directorio de instalación.
  • Asegúrese de que el JDK escogido ya se extrajo (o instaló). Consulte la documentación de JDK para encontrar mayor información sobre cómo hacer esto.
  • En un servidor Microsoft Windows, asegúrese de que se han configurado las variables de entorno JAVA_HOME y PATH de otra manera los atajos no funcionarán.
  • En Hewlett-Packard HP-UX, asegúrese de que se ha instalado una funcionalidad unzip.

Prerequisitos RPM

  • Registre el servidor en la red de Red Hat.
  • Suscríbase al canal software base Red Hat Enterprise Linux Server apropiado para su versión de Red Hat Enterprise Linux.
  • Suscríbase al sub-canal JBoss Application Platform for Server en el grupo JBoss Enterprise Platform.
  • Se requiere un JDK Java 6. Se puede obtener suscribiéndose al canal de software supplementary para su instalación de Red Hat Enterprise Linux. Por ejemplo; el canal para la versión 6 de Red Hat Enterprise Linux instalado en la arquitectura i386 es rhel-i386-server-supplementary-6.

    Importante

    Se requiere un JDK Java 6 incluso si desea usar un JDK Java 7.

Capítulo 4. Instrucciones de instalación

4.1. Métodos de instalación de JBoss EAP 6

Hay diferentes maneras de instalar JBoss EAP 6. Cada método es apropiado para ciertas situaciones. Este tema proporciona una pequeña sinopsis para cada tipo de instalación y enlaza a las secciones que abordan los procesos de instalación relevantes.

Tabla 4.1. Métodos de instalación

Método
Descripción
Instrucciones
Instalación zip
El archivador zip es apropiado para la instalación en todos los sistemas operativos soportados. Este proceso se debe utilizar si desea extraer la instancia manualmente.
Instalador JAR
El instalador JAR se puede ejecutar en una consola o como un asistente gráfico. Ambas opciones proporcionan instrucciones paso a paso para instalar y configurar la instancia del servidor. Con el instalador también es posible realizar configuraciones adicionales incluyendo los inicios rápidos y el repositorio Maven.
Instalación RPM
JBoss EAP 6 se puede instalar con el instalador gráfico del paquete RPM soportado o con una interfaz de la línea de comandos. Este método es apropiado para instalaciones soportadas de Red Hat Enterprise Linux 5 y 6.

4.2. Instalación zip

4.2.1. Descargar JBoss EAP 6 (instalación zip)

Resumen

El archivo zip de JBoss EAP 6 está disponible en https://access.redhat.com. La instalación del archivo zip no depende de la plataforma y es la manera preferida de instalar JBoss EAP 6 en todas las plataformas soportadas. Este tema aborda los pasos para descargar el archivador.

Procedimiento 4.1. Descargar el archivo zip

  1. Inicie sesión en https://access.redhat.com.
  2. Seleccione la opción del menú DownloadsJBoss Enterprise MiddlewareDownloads.
  3. Seleccione Application Platform del menú desplegable Product.
  4. Seleccione la versión correcta de la versión de JBoss EAP del menú desplegable Version.
  5. Haga clic en Download al lado de la opción Application Platform 6.1.0.
Resultado

JBoss EAP 6 se descargó exitosamente en la máquina destino y está lista para la instalación.

4.2.2. Instalación de JBoss EAP 6 (instalación zip)

Resumen

Este tema aborda los pasos para instalar JBoss EAP 6 usando el archivo zip descargable.

Procedimiento 4.2. Instalación del archivo zip

  1. Mueva el archivador zip a la ubicación deseada.

    Mueva el archivo zip al servidor y directorio en donde instalará JBoss EAP 6. El usuario que va a detener e iniciar el servidor debe tener acceso de lectura y escritura en este directorio.
  2. Use una aplicación apropiada para extraer el archivador zip en la ubicación deseada.

    En un entorno Red Hat Enterprise Linux use la funcionalidad unzip para extraer el contenido del archivador zip.
    En un entorno Microsoft Windows haga clic con el botón derecho del ratón en el archivo y seleccione Extract All.
    En un entorno Hewlett-Packard HP-UX use la funcionalidad unzip para extraer el contenido del archivador zip.
Resultado

JBoss EAP 6 se ha instalado exitósamente. El directorio creado por el archivador zip que realiza la extracción es el directorio superior para el servidor. Se conoce como EAP_HOME/.

4.2.3. Desinstalación de JBoss EAP 6 (instalación zip)

Prerrequisitos

Realice una copia de seguridad de los archivos de configuración modificados y las implementaciones que puede que se vuelvan a utilizar posteriormente.

Resumen

Esta sección aborda los pasos requeridos para desinstalar una instalación zip de JBoss EAP 6.

Procedimiento 4.3. Desinstalación de JBoss EAP 6 (instalación zip)

  1. Vaya al directorio en donde había extraído la carpeta de JBoss EAP 6 del archivo zip.
  2. Borre el directorio de instalación.

    JBoss EAP 6 instala un sólo directorio cuando usa el método de instalación Zip. Borre el directorio de instalación para desinstalar JBoss EAP 6.
  3. Opcional: borre cualquier script de inicialización que haya creado.

    Si creó scripts de inicialización u otros scripts que dependían de que JBoss EAP 6 estuviese instalado en su computador entonces bórrelos.
Resultado

JBoss EAP 6 se desinstala del servidor.

4.3. Instalador

4.3.1. Descargar JBoss EAP 6 (instalador)

Resumen

El archivador del instalador de JBoss EAP 6 está disponible en https://access.redhat.com. El archivador .jar se puede utilizar para ejecutar los instaladores gráficos o basados en texto. Este tema aborda los pasos para descargar el archivador.

Procedimiento 4.4. Descargue el instalador

  1. Inicie sesión en https://access.redhat.com.
  2. Seleccione la opción del menú DownloadsJBoss Enterprise MiddlewareDownloads.
    Descarga de JBoss EAP 6

    Figura 4.1.

  3. Seleccione Application Platform del menú desplegable Product que aparece en la siguiente pantalla.
  4. Seleccione Application Platform 6.1.0 Installer.
  5. Haga clic en Download.
Resultado

JBoss EAP 6 se descargó exitosamente en la máquina destino y está lista para la instalación.

4.3.2. Ejecute el instalador de la plataforma de aplicaciones empresariales JBoss

El instalador JBoss EAP se puede ejecutar en modo gráfico o de texto. Este tema aborda el comando para ejecutar el instalador en cada modo y también detalla las pantallas y opciones de configuración individuales que forman parte del proceso de instalación.

Procedimiento 4.5. Inicie el instalador

  1. Ejecute uno de los siguientes comandos para iniciar el proceso de instalación:
    • Modo gráfico

      java -jar jboss-eap-6.1.1.ER4-installer.jar
    • Modo de texto

      java -jar jboss-eap-6.1.1.ER4-installer.jar -console
  2. Siga los pasos, etc.

Tabla 4.2. Pantallas del instalador JBoss EAP

Nombre
Aparece
Descripción
Material de referencia
Siempre
Seleccione el idioma requerido para el instalador y haga clic en siguiente.
N/A
Siempre
El EULA para JBoss Enterprise Middleware. Seleccione "I accept the terms of this license agreement" y haga clic en siguiente.
N/A
Siempre
Configure la ruta de instalación para JBoss EAP 7 y haga clic en siguiente.
N/A
Siempre
Cree un usuario de administración y asigne una contraseña. La contraseña debe tener por lo menos ocho caracteres con un dígito y un caracter que no sea alfanumérico. Luego haga clic en siguiente.
N/A
Siempre
Instale los ejemplos de inicio rápido. Si no desea instalarlos haga clic en siguiente. Si si desea instalarlo haga clic en Si, configure la ubicación de la instalación y luego haga clic en siguiente.
N/A
Si decide instalar los ejemplos de inicio rápido
Seleccione la ruta de archivo del JDK y luego haga clic en siguiente.
N/A
Si decide instalar los ejemplos de inicio rápido
Si quiere saltarse la configuración del repositorio maven entonces seleccione siguiente. Para configurar el repositorio maven seleccione "Especificar la ruta (o URL) a un repositorio maven existente", establezca la ubicación del repositorio maven y del archivo settings.xml de maven y haga clic en siguiente.
N/A
Siempre
Seleccione los paquetes a instalar. Despliegue el paquete JBoss Core y borre el seleccionador para los paquetes AppClient/Docs si piensa que no son necesarios. Luego haga clic en siguiente.
N/A
Siempre
Determine si la instalación utilizará los enlaces de puerto predeterminados o enlaces personalizados. Si selecciona enlaces personalizados entonces seleccione si debe configurar los puertos para modo autónomo, modo de dominio o ambos. Luego haga clic en siguiente.
N/A
Si selecciona el configurar los enlaces de puertos predeterminados para modo autónomo
Configure los puertos y propiedades del sistema tal como se requiere y luego haga clic en siguiente.
N/A
Si selecciona el configurar los enlaces de puerto predeterminados para el modo de dominio
Configure los puertos y propiedades del sistema tal como se requiere y luego haga clic en siguiente.
N/A
Si selecciona el configurar los enlaces de puerto predeterminados para el modo de dominio
Configure los puertos y propiedades del sistema tal como se requiere y luego haga clic en siguiente.
N/A
Si selecciona el configurar los enlaces de puerto predeterminados para el modo de dominio
Configure los puertos y propiedades del sistema tal como se requiere y luego haga clic en siguiente.
N/A
Si selecciona el configurar los enlaces de puerto predeterminados para el modo de dominio
Configure los puertos y propiedades del sistema tal como se requiere y luego haga clic en siguiente.
N/A
Lanzar el servidor
Siempre
Seleccione la opción de arranque requerida. Si desea lanzar el servidor inmediatamente puede seleccionar el lanzar un navegador se complete la instalación. Luego haga clic en siguiente.
N/A
Resultado

La instalación está completa y JBoss EAP 6 está instalada en su máquina destino.

4.3.3. Desinstalar JBoss EAP 6 (instalador)

Resumen

Esta sección detalla los pasos requeridos para desinstalar una instancia de JBoss EAP 6 que se instaló usando el instalador gráfico o basado en texto.

Procedimiento 4.6. Desinstalación de JBoss EAP 6 (instalación gráfica)

  1. Durante la instalación de JBoss EAP 6 en la maquina destino se creó un directorio llamado Uninstaller en el directorio en donde tenía instalado JBoss EAP 6. Este directorio contiene un archivo llamado uninstaller.jar. Navegue a este directorio en una terminal.
  2. Lance el desinstalador GUI con el siguiente comando:
    java -jar uninstaller.jar
  3. La ejecución del comando lanzará el desinstalador gráfico como se puede ver en la siguiente figura. Seleccione la casilla si desea borrar el directorio de instalación de JBoss EAP 6.
    Desinstalación de JBoss EAP 6 usando el instalador gráfico

    Figura 4.2. Desinstalación de JBoss EAP 6 usando el instalador gráfico

  4. Presione el botón Uninstall para iniciar el proceso de desinstalación.
  5. Cuando el proceso de desinstalación ha terminado, presione el botón Quit para salir del desinstalador.
  6. Después de que ha desinstalado de manera exitosa, es posible que quiera borrar manualmente el directorio Uninstaller desde donde lanzó el desinstalador.

Procedimiento 4.7. Proceso de desinstalación basado en texto

  1. En una consola, navegue al directorio Uninstaller creado durante el proceso de instalación. Este se puede encontrar un nivel arriba de EAP_HOME.
  2. Lance el desinstalador basado en texto ejecutando el siguiente comando:
    java -jar uninstaller.jar -console
  3. Siga los pasos para desinstalar JBoss EAP 6.
Resultado:

JBoss EAP 6 se desinstala de su servidor.

4.4. Instalación gráfica RPM

4.4.1. Instalación de JBoss EAP 6 (instalación gráfica RPM)

Resumen

El metodo del paquete RPM gráfico de instalación de JBoss EAP 6 es apropiado para Red Hat Enterprise Linux 5 y Red Hat Enterprise Linux 6. Este tema aborda los pasos requeridos para completar la instalación.

Procedimiento 4.8. Instalación de JBoss EAP 6 (instalación gráfica RPM)

Use PackageKit para instalar gráficamente JBoss EAP 6 en su máquina destino.
  1. Lanzar PackageKit

    PackageKit es un software de administración de paquetes de código abierto instalado como parte de Red Hat Enterprise Linux. En la máquina destino lance PackageKit seleccionando SystemAdministrationAdd/Remove Software.
  2. Escriba
    jboss-eap6
    en la casilla de búsqueda y luego presione el botón Find. Se le presentará el paquete JBoss EAP 6 en la casilla de resultados.
  3. Seleccione el paquete JBoss EAP 6 y presione el botón Apply. Vea la figura a continuación.
    Instalación de PackageKit JBoss EAP 6

    Figura 4.3. Instalación de PackageKit JBoss EAP 6

  4. Siga el resto de los pasos para instalar JBoss EAP 6 en su máquina destino.
Resultado

La instalación está completa y JBoss EAP 6 está instalada en su máquina destino.

4.5. Instalación RPM basada en texto

4.5.1. Instalación de JBoss EAP 6 (instalación RPM basada en texto)

Resumen

El metodo del paquete RPM de instalación de JBoss EAP 6 es apropiado para Red Hat Enterprise Linux 5 y Red Hat Enterprise Linux 6. Este tema aborda los pasos requeridos para instalar una instancia usando la línea de comandos.

Procedimiento 4.9. Pasos de instalación basados en texto

Acceso e instalación del paquete RPM usando la instalación YUM por medio de Red Hat Network.
  1. Instalación del paquete RPM usando YUM y Red Hat Network.

    Puede utilizar YUM para instalar el paquete predeterminado del grupo de JBoss EAP 6 usando el comando groupinstall.
    [user@host ~]$ yum groupinstall jboss-eap6
  2. Configuración de las opciones de inicio.

    La instalación RPM contiene scripts de inicialización para lanzar el servidor. La configuración para estos scripts se encuentra en varios archivos adicionales. Consulte Sección A.4, “Archivos de configuración de la instalación RPM para JBoss EAP 6” para obtener los detalles sobre estos archivos y las opciones en ellos.
Resultado

La instalación está completa. La ruta predeterminada EAP_HOME para la instalación RPM es /usr/share/jbossas. Consulte Sección A.3, “Lista de paquetes RPM para JBoss EAP 6” para ver una lista completa de todos los paquetes instalados..

4.6. Instalación automatizada

4.6.1. Instalación de múltiples instancias de JBoss EAP 6 (instalador)

Prerrequisitos

Resumen

Se pueden instalar múltiples instancias idénticas de JBoss EAP 6 usando un script automatizado, generado durante el proceso de instalación, usando el instalador gráfico o el basado en texto. Este tema aborda los pasos requeridos para instalar JBoss EAP 6 usando un script generado.

Procedimiento 4.10. Instalación automatizada

  • En una terminal, ejecute el siguiente comando para instalar JBoss EAP 6 usando el script automatizado:
    java -jar jboss-eap-6.1.0-installer.jar SCRIPT_NAME.xml
Resultado

Se ha instalado una instancia idéntica de JBoss EAP 6 basada en el script generado automáticamente.

4.7. Configuración de servicios

4.7.1. Configuración de JBoss EAP 6 como un servicio en Red Hat Enterprise Linux (método RPM)

Prerrequisitos

Resumen

Use el siguiente procedimiento para instalar JBoss EAP 6 como un servicio en Red Hat Enterprise Linux cuando la instalación se ha realizado usando el método RHN (RPM).

Procedimiento 4.11. Configure JBoss EAP 6 como un servicio usando el método RPM en Red Hat Enterprise Linux

  1. Instalación de JBoss EAP 6

    Instale JBoss EAP 6 por medio del método RPM usando uno de los pasos listados en las secciones de prerequisitos mencionadas anteriormente.
  2. Habilitar el servicio

    El método de instalación RPM para JBoss EAP 6 instala los archivos requisitos del servicio en los lugares correctos. Todo lo que necesita hacer para configurarlo como un servicio es emitir el siguiente comando:
    chkconfig jbossas on
Resultado

JBoss EAP 6 inicia de manera automática cuando Red Hat Enterprise Linux llega a su nivel de ejecución predeterminado y se detiene automáticamente cuando el sistema operativo lleva acabo su rutina de apagado.

4.7.2. Configuración de JBoss EAP 6 como un servicio en Red Hat Enterprise Linux (zip, instalador)

Prerrequisitos

Resumen

Use el siguiente procedimiento para instalar JBoss EAP 6 como un servicio en Red Hat Enterprise Linux cuando la instalación se ha realizado usando el método gráfico, zip o de texto. Este proceso no aplica cuando la instalación se realiza usando el método RHN (RPM).

Procedimiento 4.12. Configure el servicio

Nota

Los pasos a continuación describen la ejecución de JBoss EAP 6 como un servicio en modo autónomo. Con el fin de ejecutar JBoss EAP 6 como un servicio en modo de dominio, use los mismos pasos pero reemplace jboss-as-standalone.sh con jboss-as-domain.sh.
  1. Ubique el script de arranque y el archivo de configuración

    El script de arranque y un archivo de configuración asociado se encuentran en el directorio EAP_HOME/bin/init.d/. Abra el archivo de configuración jboss-as.conf para modificarlo.
  2. Personalice las opciones de arranque en el archivo jboss-as.conf

    Hay varias opciones dentro del archivo jboss-as.conf. Como mínimo, especifique los valores correctos para las variables JBOSS_HOME y JBOSS_USER. Si estas variables no están presentes entonces agréguelas.
  3. Copie archivos en los directorios del sistema

    1. Copie el archivo de configuración modificado en el directorio /etc/jboss-as.
      [user@host init.d]$sudo mkdir /etc/jboss-as
      [user@host init.d]$sudo cp jboss-as.conf /etc/jboss-as/
    2. Copie el script de arranque en el directorio /etc/init.d.
      [user@host init.d]$sudo cp jboss-as-standalone.sh /etc/init.d
  4. Agregue el script de arranque como servicio.

    Agregue el nuevo servicio jboss-as-standalone.sh a la lista de servicios iniciados automáticamente usando el comando de administración del servicio chkconfig.
    [user@host init.d]$sudo chkconfig --add jboss-as-standalone.sh
  5. Inicie el servicio.

    Pruebe que el servicio haya sido instalado correctamente usando la sintaxis estándar para iniciar los servicios de Red Hat Enterprise Linux.
    [user@host bin]$sudo service jboss-as-standalone.sh start
    Si todo ha tenido lugar correctamente entonces debe ver un [OK] verde. Si obtiene un error, chequee los registros de errores y asegúrese de que sus rutas son correctas en el archivo de configuración.
  6. Haga que el servicio inicie automáticamente cuando reinicie su servidor.

    Para agregar el servicio a la lista de servicios que inician automáticamente cuando su servidor re-inicia, emita el siguiente comando.
    [user@host init.d]$sudo chkconfig jboss-as-standalone.sh on
Resultado

JBoss EAP 6 inicia de manera automática cuando Red Hat Enterprise Linux llega a su nivel de ejecución predeterminado y se detiene automáticamente cuando el sistema operativo lleva acabo su rutina de apagado.

4.7.3. Configuración de JBoss EAP 6 como servicio en el servidor de Microsoft Windows (zip, instalador)

Prerrequisitos

Resumen

Use los siguientes procedimientos para configurar JBoss EAP 6 como un servicio en el servidor de Microsoft Windows.

Procedimiento 4.13. Configure un servicio para JBoss EAP 6 en el servidor de Microsoft Windows

  1. Crear variables del entorno del sistema

    Crear dos variables de entorno del sistema:
    • JBOSS_HOME apuntando al directorio de instalación de JBoss EAP 6.
    • NOPAUSE=1
  2. Si todavía no está configurado, descargue y extraiga el paquete de funcionalidades nativas para su arquitectura

    Si las funcionalidades nativas para el paquete del servidor Windows no se ha instalado como parte de la instalación de JBoss EAP 6, descargue el paquete relevante de 32-bits o 64-bits del pportal del cliente de Red Hat en https://access.redhat.com. Extraiga el archivador zip de funcionalidades nativas a través de la instalación de JBoss EAP 6.
    Esto generará un directorio native en la siguiente ubicación en la instalación JBoss EAP 6: EAP_HOME\modules\system\layers\base\
  3. Instale el servicio

    Abra una terminal y vaya al directorio EAP_HOME\modules\system\layers\base\native\sbin
    Se puede crear un nuevo servicio con el comando service install con las opciones disponibles que se pueden ver en la siguiente tabla.

    Tabla 4.3. opciones service install

    Opción o argumento Descripción
    /controller HOST:PORT
    El host y puerto de la interfaz de administración. Si se omite entonces el valor predeterminado es localhost:9999.
    /host [DOMAIN_HOST]
    Indica que el modo de dominio se utilizará, opcionalmente especificando el nombre del controlador de dominio. Si se omite el nombre del controlador de dominio entonces el nombre predeterminado es master.
    /loglevel LEVEL
    El nivel de registro para el servicio puede ser: ERROR, INFO, WARN o DEBUG. Si se omite entonces el valor predeterminado es INFO
    /name SERVICE_NAME
    El nombre del servicio a crearse no debe contener espacios. Si se omite, el valor predeterminado es JBossEAP6
    /desc "DESCRIPTION"
    La descripción del servicio. Si se omite, el valor predeterminado es "JBoss Enterprise Application Platform 6"
    /serviceuser DOMAIN\USERNAME
    Especifica el nombre de la cuenta bajo la cual el servicio ejecutará. Use un nombre de cuenta con el formato DOMAIN\USERNAME. Si se omite entonces el servicio ejecuta como la cuenta del sistema local.
    /servicepass PASSWORD
    Contraseña para la cuenta /serviceuser.
    /jbossuser USERNAME
    Opcional, el nombre de usuario JBoss EAP 6 a utilizar para el comando de apagado.
    /jbosspass PASSWORD
    Se requiere contraseña para la cuenta /jbossuser, si se especifica /jbossuser.
    A continuación encontrará ejemplos básicos de un comando install para crear un nuevo servicio en modo autónomo o de dominio. Ejecute el siguiente comando, ajustando el nivel de registro para el servicio tal como se requiere:
    • Modo autónomo:
      service.bat install /loglevel INFO
    • Modo de dominio:
      Si no está usando el maestro predeterminado para su controlador de dominios JBoss EAP 6 reemplace master con el nombre correcto de host o alias del controlador de dominio de JBoss EAP.
      service.bat install /host master /loglevel INFO
    Se creará un nuevo servicio Windows con el nombre JBossEAP6.
  4. Verifique el nuevo servicio en la consola de servicios

    Ejecute el siguiente comando en una terminal para abrir la consola de servicios Windows:
    services.msc
    Si se utilizó el nombre predeterminado del servicio en la lista de servicios Windows entonces el nuevo servicio presentará el nombre: JBoss Enterprise Application Platform 6. Desde la consola de servicios puede iniciar y detener el servicio así como cambiar su configuración y la manera y el cuándo inicia.
  5. Iniciar y detener el servicio JBoss EAP 6 desde una terminal

    Para iniciar el servicio desde una terminal, use el siguiente comando, cambiando el nombre del servicio si es necesario:
    net start JBossEAP6
    Para detener el servicio desde una terminal, use el siguiente comando, cambiando el nombre del servicio si es necesario:
    net stop JBossEAP6
Resultado

Un servicio JBoss EAP 6 se configura en el servidor de Microsoft Windows.

Procedimiento 4.14. Desinstalar el servicio JBoss EAP 6 del servidor de Microsoft Windows

  • Si el servicio está ejecutando, primero abra una terminal y detenga el servicio ejecutando el comando net stop con el nombre del servicio:
    net stop JBossEAP6
    En una terminal vaya al directorio EAP_HOME\modules\system\layers\base\native\sbin y ejecute el siguiente comando:
    service uninstall
Resultado

Se borró el servicio JBoss EAP 6 del servidor Microsoft Windows.

Capítulo 5. Aplicación de parches y actualización de JBoss EAP 6

5.1. Parches y actualizaciones

El mecanismo de parches en JBoss EAP 6 aplica actualizaciones que se hacen disponibles para una versión 'menor' especifica de JBoss EAP 6, por ejemplo JBoss EAP 6.2. Los parches pueden contener actualizaciones de seguridad, una sola actualización o acumulativas.
El actualizar entre lanzamientos importantes y menores de JBoss EAP (por ejemplo, de 6.1 a 6.2) requiere un proceso diferente.

5.2. Instalación de parches

5.2.1. Mecanismos para uso de parches

Los parches de JBoss se lanzan de dos formas.
  • Actualizaciones asincrónicas: parches únicos que se lanzan por fuera del ciclo normal de actualización del producto existente. Estos pueden incluir parches de de seguridad así como otros parches únicos proporcionados por los servicios globales de soporte de Red Hat (GSS) para arreglar problemas específicos.
  • Actualizaciones planeadas: estas incluyen parches acumulativos así como actualizaciones menores, mayores o micro actualizaciones de un producto existente. Los parches acumulativos incluyen todas las actualizaciones asincrónicas desarrolladas anteriormente para esa versión del producto.
El decidir si un parche se lanza como parte de una actualización planeada o como una actualización asincrónica depende de la gravedad del problema que se está arreglando. Un problema de bajo impacto usualmente se pospone y se resuelve en el siguiente parche acumulativo o lanzamiento menor de los productos afectados. Los problemas de impacto moderado o mayor usualmente se abordan en orden de importancia con una actualización del producto con un lanzamiento asincrónico y solo contiene una solución para un problema específico.
Los parches acumulativos y de seguridad para los productos de JBoss se distribuyen en dos formas: zip (para todos los productos) y RPM (para un subgrupo de productos).

Importante

Una instalación del producto JBoss siempre se debe actualizar utilizando un sólo método de parche: ya sea parches zip o RPM.
Las actualizaciones de seguridad para los productos JBoss se proporcionan por medio de erratas (para métodos zip y RPM). Las erratas encapsulan una lista de las fallas resueltas, el grado de severidad, los productos afectados, la descripción textual de las fallas y una referencia a los parches. Las actualizaciones de los arreglos de errores no se anuncian por medio de erratas.
Para obtener mayor información sobre la manera en que Red Hat evalúa las fallas de seguridad de JBoss, consulte: Sección 5.2.5, “Clasificación de severidad e impacto de los parches de seguridad de JBoss”
Red Hat mantiene una lista de correo para notificar a los suscriptores sobre las fallas relacionadas con la seguridad. Consulte Sección 5.2.2, “Suscripción a las listas de correo de parches”

5.2.2. Suscripción a las listas de correo de parches

Resumen

El grupo de JBoss en Red Hat mantiene una lista de correo para anuncios de seguridad para los productos middleware empresariales de Red Hat. Este tema aborda lo que necesita hacer para suscribirse a esta lista.

Prerrequisitos

  • Ninguno

Procedimiento 5.1. Suscribirse a la lista de observación de JBoss

  1. Haga clic en el siguiente enlace para ir a la página de la lista de correo de observación de JBoss: Lista de correo de observación de JBoss.
  2. Ingrese su dirección de correo-e en la sección Subscribing to Jboss-watch-list.
  3. [También puede ingresar su nombre y seleccionar una contraseña. Esto es completamente opcional pero se recomienda.]
  4. Presione el botón Subscribe para iniciar el proceso de suscripción.
  5. Puede navegar los archivadores de la lista de correo dirigiéndose a : JBoss Watch Mailing List Archives.
Resultado

Después de confirmar su dirección de correo-e se le suscribirá para recibir anuncios relacionados con seguridad de la lista de correo de parches de JBoss.

5.2.3. Instalación de parches en forma zip

5.2.3.1. El comando patch

El comando patch se utiliza para aplicar parches zip descargados en una sola instancia del servidor JBoss EAP 6. No se puede utilizar para aplicar parches de manera automática las instancias del servidor JBoss EAP 6 a través de un dominio administrado, pero se pueden aplicar parches de manera independiente a instancias individuales del servidor en un dominio administrado.

Importante

Las instancias del servidor JBoss EAP 6 que se han instalado usando el método RPM no se pueden actualizar usando el comando patch. Consulte Sección 5.2.4, “Instalación de parches en forma RPM” para actualizar los servidores JBoss EAP 6 instalados por medio de RPM.

Nota

El comando patch solo se puede utilizar con los parches producidos para las versiones de JBoss EAP 6.2 y posteriores. Para los parches para las versiones de JBoss EAP previas a 6.2 se debe referir a la versión relevante de la documentación disponible en https://access.redhat.com/site/documentation/.
Además de aplicar los parches, el comando patch puede proporcionar información básica sobre el estado de parches instalados y también proporciona una manera de deshacer inmediatamente la aplicación de un parche.
Antes de iniciar la aplicación de un parche o una operación para deshacer, la herramienta patch verificará los módulos y otros archivos misceláneos que estén cambiando para cualquier modificación de usuario. Si se detecta una modificación de usuario y no se ha especificado una opción para el manejo de conflictos entonces la herramienta patch abortará la operación y advertirá que hay un conflicto. La advertencia incluirá una lista de los módulos y otros archivos que estén en conflicto. Para completar la operación, el comando patch se debe volver a ejecutar con una opción que especifique la manera de resolver el conflicto: ya sea preservando las modificaciones del usuario o sobreescribiéndolas.

Tabla 5.1. Opciones y argumentos del comando patch

Opción o argumento Descripción
apply Aplica un parche.
--override-all Si hay un conflicto entonces la operación parche sobreescribe las modificaciones de cualquier usuario.
--override-modules Si hay un conflicto generado por cualquiera de los módulos modificados, esta opción sobreescribe estas modificaciones con el contenido de la operación de aplicación del parche.
--override=path(,path) Sólo para archivos misceláneos especificados, esto sobreescribirá los archivos modificados en conflicto con los archivos en la operación de aplicación del parche.
--preserve=path(,path) Sólo para archivos misceláneos especificados, esto preservará los archivos modificados en conflicto.
info Retorna información sobre los parches instalados actualmente.
rollback Deshace la aplicación de un parche.
--reset-configuration=TRUE|FALSE Se requiere para revertir, especifica si debe reestablecer los archivos de configuración del servidor como parta de la operación para revertir.

5.2.3.2. Instalación de parches en forma zip usando el comando patch

Resumen

Esta tarea describe la manera de utilizar el comando patch para instalar parches para JBoss EAP 6 que se encuentren en formato zip.

Importante

El comando patch es una funcionalidad que se agregó en JBoss EAP 6.2. Para las versiones de JBoss EAP previas a 6.2, el proceso para instalar parches en forma zip es diferente y debe consultar la documentación de la versión relevante disponible en https://access.redhat.com/site/documentation/.

Prerrequisitos

  • Acceso y suscripción válidos al portal del cliente de Red Hat.
  • Una suscripción actual a un producto JBoss instalado en un formato zip.
  • Acceso al CLI de administración para la instancia del servidor se va a actualizar. Consulte el Lanzamiento del CLI de administración en la Guía de administración y configuración.

Procedimiento 5.2. Aplique un parche zip a una instancia del servidor JBoss EAP 6 usando el comando patch

Aviso

Antes de instalar un parche, debe realizar una copia de seguridad de su producto JBoss junto con todos los archivos de configuración personalizados.
  1. Descargue el archivo zip parche del portal del cliente en https://access.redhat.com/downloads/
  2. Desde el CLI de administración, aplique el parche con el siguiente comando con la ruta apropiada al archivo parche:
    [standalone@localhost:9999 /] patch apply /path/to/downloaded-patch.zip
    La herramienta patch le advertirá si hay algún conflicto al tratar de aplicar el parche. Consulte Sección 5.2.3.1, “El comando patch para ver las opciones disponibles para volver a ejecutar el comando para resolver cualquier conflicto.
  3. Reinicie la instancia del servidor JBoss EAP 6 para que el parche tenga efecto:
    [standalone@localhost:9999 /] shutdown --restart=true
Resultado

Se aplica el parche de la última actualización a la instancia del servidor JBoss EAP 6.

5.2.3.3. Deshacer la aplicación de un parche en forma zip usando el comando patch

Resumen

Esta tarea describe la manera de utilizar el comando patch para deshacer la aplicación de un parche zip aplicado previamente en JBoss EAP 6.

Aviso

El deshacer la aplicación de un parche usando el comando patch no es una funcionalidad general de desinstalación. Sólo se debe utilizar inmediatamente después de la aplicación de un parche que tuvo consecuencias no deseadas.

Importante

El comando patch es una funcionalidad que se agregó en JBoss EAP 6.2. Para las versiones de JBoss EAP previas a 6.2, el proceso para deshacer parches en forma zip es diferente y debe consultar la documentación de la versión relevante disponible en https://access.redhat.com/site/documentation/.

Prerrequisitos

  • Un parche que se aplicó previamente usando el comando patch.
  • Acceso al CLI de administración para la instancia del servidor. Consulte Launch the Management CLI en la Administration and Configuration Guide.

Procedimiento 5.3. Deshacer un parche de una instancia del servidor JBoss EAP 6 usando el comando patch

  1. Desde el CLI de administración, use el comando patch info para encontrar el ID del parche que se va a deshacer.
    • Para los parches acumulativos, el ID del parche es el valor del primer cumulative-patch-id que se puede ver en la salida patch info.
    • Los IDs de parches para solucionar errores o parches únicos de seguridad se listan como el valor del primer patches que se puede ver en la salida patch info con el parche único aplicado más recientemente listado de primero.
  2. Desde el CLI de administración, deshaga el parche con el ID de parche apropiado del paso anterior.

    Aviso

    Tenga cuidado al especificar el valor de la opción --reset-configuration.
    Si se configura como TRUE entonces el proceso para deshacer el parche también deshará los archivos de configuración del servidor de JBoss EAP 6 a su estado previo antes de aplicar el parche. Los cambios realizados a los archivos de configuración del servidor JBoss EAP 6 después de que se aplicó el parche también se perderán.
    Si se configura como FALSE entonces los archivos de configuración del servidor no se desharán. En esta situación, es posible que el servidor no inicie después de deshacer los cambios ya que es posible que el parche ya haya alterado la configuración tal como los espacios de nombres, los cuales pueden que ya no sean válidos y se tengan que arreglar manualmente.
    [standalone@localhost:9999 /] patch rollback PATCH_ID --reset-configuration=TRUE
    La herramienta patch le advertirá si hay algún conflicto al tratar de deshacer el parche. Consulte Sección 5.2.3.1, “El comando patch para ver las opciones disponibles para volver a ejecutar el comando para resolver cualquier conflicto.
  3. Reinicie la instancia del servidor JBoss EAP 6 para que se deshagan los cambios de manera efectiva:
    [standalone@localhost:9999 /] shutdown --restart=true
Resultado

Se deshacen los cambios del parche y opcionalmente también los archivos de configuración en la instancia del servidor JBoss EAP 6.

5.2.4. Instalación de parches en forma RPM

Resumen

Los parches de JBoss se distribuyen de dos formas: zip (para todos los productos) y RPM (para un subgrupo de productos). Esta tarea describe los pasos que necesita tomar para instalar los parches por medio del formato RPM.

Prerrequisitos

  • Una subscripción válida a Red Hat Network.
  • Una suscripción actual a un producto JBoss instalado por medio de un paquete RPM.

Procedimiento 5.4. Aplicar un parche a un producto JBoss por medio del método RPM.

Las actualizaciones de seguridad para los productos JBoss se proporcionan por medio de erratas (para los métodos zip y RPM). Las erratas encapsulan una lista de las fallas resueltas, el grado de severidad, los productos afectados, la descripción textual de las fallas y una referencia a los parches.
Para las distribuciones RPM de los productos JBoss, la errata incluye referencias a los paquetes RPM actualizados. El parche se puede instalar usando yum.

Aviso

Antes de instalar un parche, debe realizar una copia de seguridad de su producto JBoss junto con todos los archivos de configuración personalizados.
  1. Obtenga notificaciones sobre el parche de seguridad ya sea suscribiéndose a la lista de correo de observación de JBoss o navegando los archivadores de la lista de correo de observación de JBoss.
  2. Lea la errata para el parche de seguridad y confirme que aplica a un producto JBoss en su entorno.
  3. Si el parche de seguridad aplica a un producto JBoss en su entorno entonces siga el enlace para descargar el paquete RPM actualizado, incluído en la errata.
  4. Uso
    yum update
    para instalar el parche.

    Importante

    Al actualizar una instalación RPM, su producto JBoss se actualiza de manera acumulativa con todos los arreglos lanzados en el RPM.
Resultado

El producto JBoss recibe el parche con la última actualización usando el formato RPM.

5.2.5. Clasificación de severidad e impacto de los parches de seguridad de JBoss

Para comunicar el riesgo de cada falla de seguridad de JBoss, Red Hat usa una escala de severidad de cuatro puntos: bajo, moderado, importante y crítico, además de los puntajes base de la versión 2 del sistema de puntaje de vulnerabilidad común (CVSS del inglés Common Vulnerability Scoring System), los cuales se pueden utilizar para identificar el impacto de la falla.

Tabla 5.2. Clasificación de severidad de los parches de seguridad de JBoss

Intensidad Descripción
Crítico
Esta clasificación se da para las fallas que puedan ser explotadas fácilmente por parte de un atacante no autenticado remoto y llevar a comprometer el sistema (ejecución arbitraria de código) sin requerir interacción con el usuario. Estos son los tipos de vulnerabilidades que pueden ser explotadas por parte de los gusanos. Las fallas que requieren un usuario remoto autenticado, un usuario local o una configuración poco probable no se clasifican como de impacto crítico.
Importante
Esta calificación se le da a las fallas que pueden fácilmente comprometer la confidencialidad, integridad o la disponibilidad de los recursos.Estos son los tipos de vulnerabilidades que le permiten a los usuarios locales el ganar privilegios, permitirle a los usuarios remotos no autenticados el ver recursos que de otra manera deben estar protegidos por la autenticación, permitirle a los usuarios remotos autenticados el ejecutar código arbitrario o permitirle a los usuarios locales o remotos el generar una negación de servicio.
Moderado
Esta calificación se le da a las fallas que puedan ser más difíciles de explotar pero que podrían conllevar a comprometer la confidencialidad, integridad o disponibilidad de los recursos, bajo ciertas circunstancias. Estos son los tipos de vulnerabilidades que podrían haber tenido un impacto crítico o importante pero que se explotan de manera menos fácil con base en una evaluación técnica de la falla o afectan muy poco probablemente las configuraciones.
Bajo
Esta calificación se le da a los otros problemas que tengan impacto en la seguridad. Estas son los tipos de vulnerabilidades que se cree que requieren circunstancias poco posibles para que se puedan explotar o en donde si se explotara de manera exitosa entonces generaría consecuencias mínimas.
El componente impacto de una calificación CVSS v2 se basa en una evaluación combinada de tres impactos potenciales: confidencialidad (C), integridad (I) y disponibilidad (A). Cada una de estas se puede calificar como Ninguno (N), Parcial (P) o Completo (C).
Debido a que el proceso del servidor JBoss ejecuta como un usuario no privilegiado y se aisla del sistema operativo host, las fallas de seguridad de JBoss sólo se califican con un nivel de impacto de Ninguno (N) o Parcial (P).

Ejemplo 5.1. Calificación de impacto CVSS v2

El ejemplo a continuación muestra una calificación de impacto CVSS v2, en donde el explotar la falla no tendría impacto en la confidencialidad del sistema, impacto parcial en la integridad del sistema e impacto completo en la disponibilidad del sistema (es decir, el sistema quedaría en estado completamente no disponible para cualquier uso, por ejemplo, a través de un fallo del kernel).
C:N/I:P/A:C
Combinado con la calificación de severidad y el puntaje CVSS, las organizaciones pueden realizar decisiones con la suficiente información sobre el riesgo que cada problema conlleva en su entorno único y programar actualizaciones de acuerdo con esto.
Para mayor información sobre CVSS2, por favor consulte: CVSS2 Guide.

5.3. Instrucciones de actualización

5.3.1. Actualización de la instalación ZIP de JBoss EAP 6

Prerrequisitos

  • Asegúrese de que el sistema operativo base esté actualizado.
  • Determine los archivos que se han modificado desde que se instaló JBoss EAP 6.
  • Realice una copia de seguridad de los archivos de configuración modificados, las implementaciones y todos los datos del usuario.
Resumen

Este procedimiento aborda la actualización de una instalación zip JBoss EAP 6 entre versiones menores (por ejemplo, de JBoss EAP 6.1 a 6.2). Para instalar los parches para una versión menor específica consulte la sección Patch Installation. El actualizar al último lanzamiento de JBoss EAP 6 requiere algo de trabajo inicial para realizar una copia de seguridad de la instalación existente.

Aviso

Para los dominios administrados primero se debe actualizar la instancia del controlador host maestro (o controlador de dominio) antes de actualizar cada controlador host.

Procedimiento 5.5. Actualización a la última versión de JBoss EAP 6

  1. Mueva el archivador zip descargado a la ubicación deseada. Se recomienda que sea una ubicación diferente a la de la instalación de JBoss EAP 6 que ya existe.

    Importante

    Si desea instalar la última versión de JBoss EAP 6 en el mismo directorio que la instalación existente, necesitará mover la instalación existente a un lugar diferente antes de proceder. Esto previene la pérdida de los archivos de configuración modificados, las implementaciones y actualizaciones.
  2. Descomprima el archivador. Este paso instala una instancia limpia del último lanzamiento de JBoss EAP 6.
  3. Manualmente agrupe sus cambios de los directorios EAP_HOME/domain/ y EAP_HOME/standalone/ de la versión previa en la nueva instalación.

    Aviso

    Los archivos de configuración no se deben copiar de la versión anterior a la nueva instalación. Los cambios se deben realizar manualmente.
  4. Revise los cambios realizados al directorio bin de la instalación anterior y realice las modificaciones equivalentes al nuevo directorio.

    Aviso

    Los archivos en el directorio bin no deben ser sobreescritos por los archivos de versiones anteriores. Los cambios se deben realizar manualmente.
  5. Revise los archivos modificados que quedan de la instalación anterior y mueva estos cambios a la instalación. Estos archivos pueden incluir:
    • El directorio welcome-content.
    • Módulos personalizados en el diretcorio modules.
    • Paquetes personalizados en el directorio bundles.
Resultado

La instalación zip de JBoss EAP 6 se actualizó exitosamente al último lanzamiento.

5.3.2. Actualización de la instalación RPM de JBoss EAP 6

Prerrequisitos

  • Asegúrese de que el sistema operativo base esté actualizado y que el sistema esté suscrito y habilitado para obtener actualizaciones para el canal SO Base.
  • Asegúrese de que el canal correcto RHN de JBoss EAP 6 esté habilitado. Por ejemplo, en una arquitectura x86, 64 bits, este será la plataforma de aplicaciones JBoss (v 6) para el canal 6Server x86_64 (jbappplatform-6-x86_64-server-6-rpm).
  • Realice una copia de seguridad de los archivos de configuración modificados, las implementaciones y todos los datos del usuario.
Resumen

La actualización al último lanzamiento de JBoss EAP 6 requiere realizar una copia de seguridad de la instalación ya existente. Este tema aborda la actualización de la instalación RPM por medio de Red Hat Network (RHN).

Aviso

Para los dominios administrados primero se debe actualizar la instancia del controlador host maestro (o controlador de dominio) antes de actualizar cada controlador host.

Procedimiento 5.6. Actualización a la última versión de JBoss EAP 6

  1. Ejecute el siguiente comando en una terminal para actualizar la instalación:
    [user@host] yum update
  2. Fusione manualmente cada archivo *.rpmnew creado que contenga cambios en los archivos de configuración de producción.
Resultado

JBoss EAP 6 se ha actualizado exitosamente.

5.3.3. Actualización del clúster JBoss EAP de 6.0 a 6.1

Prerrequisitos

  • Ninguno
Resumen

JBoss EAP 6.1 no soporta la creación de clústers, en donde los diferentes nodos están compuestos de diferentes versiones de los servidores JBoss EAP. Por lo tanto no se soporta un clúster mezclado basado en diferentes versiones y todos los nodos dentro de un clúster deben tener la misma versión - 6.1.

Aviso

El proceso de actualización para migrar tráfico de un clúster 6.0 a un clúster 6.1 por lo tanto está basado en la transferencia de todo el tráfico al clúster 6.1 y luego apagar los servidores o nodos en el clúster 6.0.

Procedimiento 5.7. Configuración de un clúster JBoss EAP en 6.1

  1. Consulte el capítulo de Clústers HTTP y balanceo de carga de la Guía de configuración y administración de JBoss EAP 6.1 para ver las instrucciones sobre cómo configurar un clúster JBoss EAP en 6.1.
  2. Migre todo el tráfico a este nuevo clúster usando los pasos establecidos en el capítulo sobre Migración del tráfico entre clústers de la Guía de configuración y administración de JBoss EAP 6.1
Resultado

Su clúster JBoss EAP 6.0 se ha migrado a un clúster basado en JBoss EAP 6.1.

Apéndice A. Material de referencia

A.1. Descargas disponibles para JBoss EAP 6

JBoss EAP incluye un número de tipos de instalación diferentes y componentes opcionales, los cuales están disponibles para descargarlos en el portal del cliente de Red Hat en https://access.redhat.com/. La siguiente tabla explica las diferentes opciones. Algunos componentes sólo son apropiados para ciertos sistemas operativos o arquitecturas y por lo tanto sólo están disponibles para esas variaciones específicas.

Tabla A.1. Descargas disponibles

Nombre Descripción Sistemas operativos
Servidor Apache HTTP
Una instancia del servidor autónomo Apache HTTP para cada sistema operativo soportado y las arquitecturas. Este servidor HTTP ha sido probado y verificado para trabajar con JBoss EAP 6.
Red Hat Enterprise Linux 5, Red Hat Enterprise Linux 6, Microsoft Windows Server 2008, Solaris 10 y 11
Componentes nativos
Los componentes se han compilado para ser optimizados para una plataforma específica. Por ejemplo, se proporcionan DLLs para entornos del servidor Microsoft Windows. En algunos casos, los componentes nativos pueden brindar mejoras en el rendimiento.
Red Hat Enterprise Linux 5, Red Hat Enterprise Linux 6, Microsoft Windows Server 2008, Solaris 10 y 11, Hewlett-Packard HP-UX
Funcionalidades nativas
Funcionalidades específicas para cada sistema operativo y arquitectura soportadas tal como scripts y funcionalidades para instalar JBoss EAP 6 como un servicio en su sistema operativo y generación de llaves de encripción SSL y certificados.
Red Hat Enterprise Linux 5, Red Hat Enterprise Linux 6, Microsoft Windows Server 2008, Solaris 10 y 11, Hewlett-Packard HP-UX
Webserver Connector Natives
Módulos pre-compilados para los servidores de red Apache, Microsoft y Oracle iPlanet para el balanceo de carga HTTP y funcionalidades de alta disponibilidad. Estos binarios se prueban de manera extensiva y se sabe que funcionan bien con JBoss EAP 6.
Red Hat Enterprise Linux 5, Red Hat Enterprise Linux 6, Microsoft Windows Server 2008, Solaris 10 y 11, Hewlett-Packard HP-UX
Javadocs
Documentación para todas las APIs públicas expuestas por JBoss EAP 6. Puede instalarlos en su servidor local HTTP o IDE o puede verlos en su máquina local.
Independiente de la plataforma
Instalador
Instalador Java para JBoss EAP 6. Incluye los pasos para instalar los inicios rápidos y el repositorio Maven.
Independiente de la plataforma
Repositorio Maven
Un repositorio Maven, el cual se puede descargar y hacerlo disponible en su entorno de desarrollo local y el cual contiene objetos comunes para las aplicaciones construídas en JBoss EAP 6. El repositorio Maven también está disponible por medio del instalador de JBoss EAP 6.
Independiente de la plataforma
Inicios rápidos
Aplicaciones de ejemplo para ayudarle a empezar a desarrollar aplicaciones Java EE 6 con APIs proporcionadas con JBoss EAP 6. Los inicios rápidos también están disponibles por medio del instalador de JBoss EAP 6.
Independiente de la plataforma
Código fuente
El código fuente Java para JBoss EAP 6 proporcionado de manera que pueda recompilarlo en su propio entorno o auditarlo usted mismo.
Independiente de la plataforma
Plataforma de aplicaciones
Un paquete de instalación zip, el cual se puede instalar y ejecutar en toda plataforma soportada. Esta es la manera más común de instalar JBoss EAP 6.
Independiente de la plataforma

Importante

Las descargas del método de instalación RPM no están disponibles en el portal del cliente si no por medio de Red Hat Network (RHN).

A.2. Estructura de directorios de JBoss EAP 6

Resumen

JBoss EAP 6 incluye una estructura de directorio simplificada comparada con versiones anteriores. Este tema aborda un listado de los directorios y una descripción de lo que cada directorio contiene.

También incluye estructuras de directorio de las carpetas standalone/ y domain/.

Tabla A.2. Archivos y directorios a nivel superior

Nombre Propósito
appclient/ Contiene los detalles de configuración para el contenedor del cliente de la aplicación.
bin/ Contiene los scripts de arranque para JBoss EAP 6 en Red Hat Enterprise Linux y Microsoft Windows.
bundles/ Contiene grupos OSGi, los cuales pertenecen a la funcionalidad interna de JBoss EAP 6.
docs/ Archivos de licencia, archivos, esquemas y ejemplos.
domain/ Los archivos de configuración, el contenido de la implementación y las áreas de escritura utilizadas cuando JBoss EAP 6 ejecuta como un dominio administrado.
modules/ Los módulos que JBoss EAP 6 carga de manera dinámica cuando los servicios los requieren.
standalone/ Los archivos de configuración, el contenido de la implementación y las áreas de escritura utilizadas cuando JBoss EAP 6 ejecuta como un servidor autónomo.
welcome-content/ Tiene contenido que la aplicación web de bienvenida utiliza, la cual está disponible en el puerto 8080 de una instalación predeterminada.
jboss-modules.jar
El mecanismo bootstrap que carga los módulos.

Tabla A.3. Directorios dentro del directorio domain/

Nombre Propósito
configuration/ Los archivos de configuración para el dominio administrado. Estos archivos se modifican por medio de la consola de administración y el CLI de administración y no se debe modificar directamente.
data/ Información sobre los servicios implementados. Los servicios se implementan usando la consola de administración y el CLI de administración en lugar de un escaner de implementación. Por lo tanto no ponga archivos en este directorio manualmente.
log/ Contiene los archivos de registro del tiempo de ejecución para el host y los controladores de procesos, los cuales ejecutan en la instancia local.
servers/ Contiene los directorios data/, log/ y tmp/ equivalentes para cada instancia del servidor en un dominio, el cual contiene datos similares a los mismos directorios dentro del nivel superior del directorio domain/.
tmp/ Contiene datos temporales tales como archivos que pertenecen al mecanismo de clave compartida que el CLI de administración utiliza para autenticar a los usuarios locales en el dominio administrado.

Tabla A.4. Directorios dentro del directorio standalone/

Nombre Propósito
configuration/ Los archivos de configuración para el servidor autónomo. Estos archivos se modifican por medio de la consola de administración y el CLI de administración y no se debe modificar directamente.
deployments/ Información sobre los servicios implementados. El servidor autónomo incluye un escaner de implementación de manera que pueda poner los archivadores en este directorio a implementarse. Sin embargo, el enfoque que se recomienda es administrar las implementaciones usando la consola de administración o CLI de administración.
lib/ Bibliotecas externas, las cuales pertenecen al modo del servidor autónomo. Vacío por defecto.
tmp/ Contiene datos temporales tales como los archivos que pertenecen al mecanismo de clave compartida que el CLI de administración utiliza para autenticar a los usuarios locales en el servidor.

A.3. Lista de paquetes RPM para JBoss EAP 6

Resumen

JBoss EAP 6 se instala en Red Hat Enterprise Linux 6 usando el grupo de paquetes YUM JBoss EAP 6. Ese grupo está compuesto de los siguientes paquetes.

Tabla A.5. Lista de Paquetes

Paquete Descripción
jbossas-appclient Contenedor del cliente de aplicaciones JEE
jbossas-bundles Paquetes OSGi
jbossas-core Componentes centrales. Esto se requiere para todas las configuraciones.
jbossas-domain Configuración del dominio
jbossas-hornetq-native Contenedor para los archivos JBoss AS HornetQ
jbossas-jbossweb-native Plataforma web empresarial JBoss
jbossas-modules-eap Módulos JBoss EAP
jbossas-product-eap Componentes de configuración del producto. Esto personaliza la ejecución del producto.
jbossas-standalone Configuración autónomo
jbossas-welcome-content-eap Contenido de bienvenida utilizado en los mensajes de arranque y las páginas de la consola

Importante

El paquete jbossas-hornetq-native se incluye para brindar alta disponibilidad en lJBoss EAP 6 y no se activa por defecto.

A.4. Archivos de configuración de la instalación RPM para JBoss EAP 6

Resumen

La instalación RPM de JBoss EAP 6 incluye tres archivos de configuración adicionales para la instalación zip. Estos archivos son utilizados por el script de inicio de servicios para especificar el entorno para lanzar el servidor de aplicaciones. Uno de estos archivos aplica a todas las instancias de la plataforma de aplicaciones empresariales JBoss 6, los otros dos brindan sobreescrituras para servidores autónomos y de dominio.

Tabla A.6. Archivos de configuración RPM adicionales

Archivo Descripción
/etc/jbossas/jbossas.conf El archivo se lee primero y se aplica a todas las instancias de JBoss EAP 6.
/etc/sysconfig/jbossas Configuración específica para los servidores autónomos. Los valores especificados aquí sobreescribirán los que se encuentren en jbossas.conf al ejecutar como un servidor autónomo.
/etc/sysconfig/jbossas-domain Configuración específica para los servidores de modo de dominio. Los valores especificados aquí sobreescribirán los que se encuentren en jbossas.conf al ejecutar como un servidor de modo de dominio.
La siguiente tabla muestra una lista de propiedades de configuración disponibles junto con sus valores predeterminados.

Tabla A.7. Propiedades de configuración de instalación RPM

Propiedad Descripción
JBOSS_USER
La cuenta del usuario del sistema en la que ejecuta JBoss EAP 6. Este usuario también es propietario de los archivos.
Valor predeterminado: jboss
JBOSS_GROUP
El grupo de usuarios del sistema al cual pertenecen los archivos de JBoss EAP 6.
Valor predeterminado: jboss
JBOSS_STARTUP_WAIT
El número de segundos que el script de arranque esperará hasta confirmar que el servidor se haya lanzado exitosamente después de recibir una comando start o restart.
Valor predeterminado: 60
JBOSS_SHUTDOWN_WAIT
El número de segundos que el script de arranque esperará para que el servidor se apague antes de continuar cuando recibe un comando stop o restart.
Valor predeterminado: 20
JBOSS_CONSOLE_LOG
El archivo al que se redireccionará el manejador de registros CONSOLE.
Valor predeterminado: /var/log/jbossas/$JBOSSCONF/console.log
JAVA_HOME
El directorio en donde se instala el entorno de ejecución Java.
Valor predeterminado: /usr/lib/jvm/jre
JBOSS_HOME
El directorio en donde se instalan los archivos del servidor de aplicaciones.
Valor predeterminado: /usr/share/jbossas
JAVAPTH
La ruta en donde se instalan los archivos ejecutables Java.
Valor predeterminado: $JAVA_HOME/bin
JBOSSCONF
El modo del servidor para lanzar este servidor en standalone o domain.
Valor predeterminado: standalone or domain dependiendo del modo del servidor.
JBOSSSH
El script que se utilizó para iniciar en el servidor.
Valor predeterminado: $JBOSS_HOME/bin/$JBOSSCONF.sh
JBOSS_SERVER_CONFIG
El archivo de configuración del servidor a utilizar.
No hay un valor predeterminado para esta propiedad. standalone.xml o domain.xml se pueden definir al iniciar.
JBOSS_HOST_CONFIG Esta propiedad le permite al usuario el especificar la configuración host (tal como host.xml). No tiene un valor predeterminado.

Apéndice B. Tomas de pantalla del instalador

B.1. Selección del idioma

Seleccione el idioma requerido para el instalador.

Figura B.1. Selección del idioma del instalador de JBoss EAP

B.2. Acuerdo de licencia del usuario final

Acepte el acuerdo de licencia del usuario final para continuar.

Figura B.2. Acuerdo de licencia del usuario final del instalador de JBoss EAP

B.3. Ruta de instalación

Defina la ruta de instalación para la instancia de JBoss EAP.

Figura B.3. Ruta de instalación del instalador JBoss EAP

B.4. Creación del usuario administrativo

Crear un usuario administrativo.

Figura B.4. Creación del usuario administrativo del instalador de JBoss EAP

B.5. Instalación de inicio rápido

Instale los inicios rápidos de JBoss EAP.

Figura B.5. Configuración de inicio rápido del instalador JBoss EAP

B.6. Configuración JDK

Configurar la ubicación del JDK instalado.

Figura B.6. Configuración JDK del instalador JBoss EAP

B.7. Configuración del repositorio Maven

Configure el repositorio Maven de JBoss EAP.

Figura B.7. Instalación del repositorio Maven del instalador JBoss EAP

B.8. Instalación del paquete

Seleccione los paquetes opcionales a instalar.

Figura B.8. Instalación del paquete instalador de JBoss EAP

B.9. Configuración de enlace de sockets

Determine si debe utilizar los enlaces predeterminados o si debe configurar enlaces personalizados.

Figura B.9. Enlaces de socket del instalador JBoss EAP

B.10. Configuración (autónoma) de enlaces de socket

Configuración de enlaces de socket personalizados para el modo autónomo.

Figura B.10. Configuración de enlace de socket autónoma del instalador JBoss EAP

B.11. Configuración de enlaces de socket (dominio)

Configuración de enlaces de socket personalizados para el modo de dominio.

Figura B.11. Configuración de enlaces de socket de dominio del instalador JBoss EAP

B.12. Configuración de enlaces de socket Bindings (dominio ha)

Configuración de enlaces de socket personalizados para el modo dominio ha.

Figura B.12. Configuración de enlaces de socket dominio ha del instalador JBoss EAP

B.13. Configuración de enlaces de socket (dominio completo)

Configuración de enlaces de socket personalizados para el modo de dominio completo.

Figura B.13. Configuración de enlaces de socket dominio completo del instalador JBoss EAP

B.14. Configuración de enlaces de socket Bindings (dominio ha completo)

Configuración de enlaces de socket personalizados para el modo de dominio ha completo.

Figura B.14. Configuración de enlaces de socket dominio ha completo del instalador JBoss EAP

Apéndice C. Historial de revisiones

Historial de revisiones
Revisión 1.0.0-1Thu Apr 10 2014CS Builder Robot
Built from Content Specification: 14873, Revision: 551090

Aviso Legal

Copyright © 2014 Red Hat, Inc..
This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.