Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

Guía de Instalación

Plataforma de aplicaciones empresariales JBoss 6.4

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

Red Hat Customer Content Services

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 6 de Red Hat

Red Hat JBoss Enterprise Application Platform 6 (JBoss EAP 6) es una plataforma middleware construida con base en estándares libres, que cumple con las especificaciones de Java empresarial edición 6. Integra JBoss Application Server 7 con clústeres de alta disponibilidad, mensajería, caché distribuido y otras tecnologías.
JBoss EAP 6 incluye una nueva estructura modular, la cual permite la habilitación de servicios solo cuando se requieran, mejorando así, la velocidad de arranque.
La consola de administración y la interfaz de línea de comandos de administración hacen innecesaria la modificación de archivos de configuración XML y agregan la habilidad para utilizar scripts y automatizar tareas.
Además, JBoss EAP 6 incluye APIs y marcos de trabajo de desarrollo para desarrollar rápidamente aplicaciones Java EE seguras y escalables.

1.2. Funcionalidades de JBoss EAP 6

Tabla 1.1. Funcionalidades de JBoss EAP 6

Funcionalidad Descripción
Certificación Java Certificado para Java Enterprise Edition 6 perfil completo y perfil de red.
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.
  • Administración de grupos por servidor de configuración, implementación, enlaces de socket, módulos, extensiones y propiedades del sistema.
  • Administración centralizada y simplificada de seguridad de aplicaciones (incluyendo dominios de seguridad).
Consola y CLI administrativas Interfaces de administración del servidor autónomo o nuevo dominio. Ya no se requiere la modificación del archivo de configuración XML. La CLI de administración también incluye un modo grupal que puede establecer scripts y automatizar tareas de administración.
Estructura del directorio simplificada El directorio modules ahora contiene todos los módulos del servidor de aplicaciones. Los directorios comunes y específicos de servidores lib ya no se utilizan. Los directorios domain y standalone contienen los artefactos y archivos de configuración para implementaciones de dominios y autónomas respectivamente.
Mecanismo modular de carga de clases Los módulos se cargan y descargan a demanda. Esto mejora el rendimiento, la seguridad y reduce el tiempo de arranque y reinicio.
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 administran directamente en la Consola de administración o en la CLI de administración.
Uso de recursos más eficiente y reducido. JBoss EAP 6 usa menos recursos del sistema y los utiliza de forma más eficiente que versiones anteriores. Entre otros beneficios, JBoss EAP 6 inicia y se detiene más rápidamente que JBoss EAP 5.

Capítulo 2. Introducción

2.1. Acerca del portal del cliente de Red Hat

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

Capítulo 3. Instrucciones de instalación

3.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 3.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. Esta es la manera preferida de instalar JBoss EAP 6 en todas las plataformas soportadas.
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,6 y 7.

3.2. Prerrequisitos de instalación de JBoss EAP 6

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

Prerrequisitos comunes

Prerrequisitos de ZIP/instalador

  • Privilegios de administración para el directorio de instalación.
  • Asegúrese de que se haya instalado un kit desarrollador Java soportado.
  • 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.

Prerrequisitos RPM

Desde Red Hat Enterprise Linux 7, el término canal fue reemplazado con el término repositorio.
  • Registre el servidor en la red de Red Hat.
  • Asegúrese de que se haya instalado un kit desarrollador Java soportado. El RPM kit de desarrollo Java debe proporcionar y exportar la funcionalidad java al sistema.
  • Suscríbase a los siguientes canales, los cuales aplican a todas las versiones de Red Hat Enterprise Linux y todas las arquitecturas:
    • Los canales/repositorios software base y supplementary de Red Hat Enterprise Linux Server apropiados para su versión de Red Hat Enterprise Linux. Se requiere el canal/repositorio supplementary para la instalación del kit desarrollador Java.
    • Canal o repositorio de JBoss Enterprise Application Platform. Para obtener detalles del canal o repositorio apropiados, consulte: Sección 3.5, “Instalación RPM”
  • Si la arquitectura host es ppc64 suscríbase al siguiente canal/repositorio.
    • Red Hat Enterprise Linux 6, subscríbase al canal rhel-ppc64-server-optional-6.
    • Red Hat Enterprise Linux 7, subscríbase al repositorio rhel-7-for-power-server-optional-rpms-7Server.

3.3. Instalación zip

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

Resumen

El archivo zip de JBoss EAP 6 está disponible en el Portal del cliente de Red Hat. La instalación del archivo zip no depende de la plataforma. Este tema aborda los pasos para descargar el archivador.

Procedimiento 3.1. Descargar el archivo zip

  1. Abra un navegador e inicie sesión en el Portal de clientes en https://access.redhat.com.
  2. Haga clic en Downloads.
  3. Haga clic en Red Hat JBoss Enterprise Application Platform en la lista Product Downloads.
  4. Seleccione la versión correcta de la versión de JBoss EAP del menú desplegable Version.
  5. Busque Red Hat JBoss Enterprise Application Platform 6.x.x en la lista y haga clic en la opción Download.
Resultado

Ahora JBoss EAP 6 se descarga en su máquina destino y está lista para la instalación.

3.3.2. Instalación de JBoss EAP 6 (instalación ZIP)

Resumen

Este tema aborda los pasos para instalar JBoss EAP 6 mediante el archivo zip descargado.

Procedimiento 3.2. Instalación del archivo zip

  1. Mueva el archivo 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 correctamente. El directorio creado por el archivador ZIP que realiza la extracción es el directorio superior para el servidor. Se conoce como EAP_HOME/.

3.3.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 3.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.

3.4. Instalador

3.4.1. Descargar JBoss EAP 6 (instalador)

Resumen

El archivador del instalador de JBoss EAP 6 está disponible en el Portal de clientes de Red Hat. El archivador .jar se puede utilizar para ejecutar los instaladores gráficos o basados en texto. El instalador es la manera preferida de instalar JBoss EAP 6 en todas las plataformas soportadas. Este tema aborda los pasos para descargar el archivador.

Procedimiento 3.4. Descargue el instalador

  1. Abra un navegador e inicie sesión en el Portal de clientes en https://access.redhat.com.
  2. Haga clic en Downloads.
  3. Haga clic en Red Hat JBoss Enterprise Application Platform en la lista Product Downloads.
  4. Seleccione la versión correcta de la versión de JBoss EAP del menú desplegable Version.
  5. Busque Red Hat JBoss Enterprise Application Platform 6.x.x Installer en la lista y haga clic en la opción Download.
Resultado

Ahora JBoss EAP 6 se descarga en su máquina destino y está lista para la instalación.

3.4.2. Ejecute el programa de instalación de JBoss EAP

El programa de instalación de JBoss EAP se puede ejecutar en el modo gráfico o de texto. Este tema aborda el comando para ejecutar el programa de instalación en el modo gráfico.

Procedimiento 3.5. Ejecute el programa de instalación de JBoss EAP

  1. Abra una terminal y navegue al directorio que contiene la JAR del programa de instalación descargado.
  2. Escriba el siguiente comando:
    java -jar jboss-eap-6.x.x-installer.jar
  3. Siga las instrucciones en la tabla a continuación.

Tabla 3.2. Pantallas del programa de instalación de JBoss EAP

Nombre de la pantalla
Aparece
Descripción
Siempre
Seleccione el lenguaje deseado para el programa de instalación y haga clic en OK.
Siempre
EULA para RED HAT JBOSS MIDDLEWARE.
Seleccione "I accept the terms of this license agreement" y haga clic en Next.
Siempre
Seleccione la ruta de instalación para JBoss EAP y haga clic en Next. Se le solicitará que cree el nuevo directorio o si ya existe que reemplace el directorio nombrado.
Siempre
Seleccione los paquetes a instalar. No se pueden desactivar l os paquetes requeridos.
Siempre
Cree un usuario de administración y asigne una contraseña. La contraseña debe tener por lo menos ocho caracteres con un caracter alfabético, un dígito y un caracter que no sea alfanumérico. Luego haga clic en Next.
Siempre
Instale los ejemplos del inicio rápido. Si desea instalarlos, escoja Yes y seleccione la ruta de instalación. Si no desea instalarlos entonces escoja No. Luego haga clic en Next.
Si decide instalar los ejemplos de inicio rápido
Hay disponible un repositorio Maven como host público para uso con los inicios rápidos. Los valores predeterminados configuran automáticamente su instalación para utilizar este repositorio. Esta es la manera más fácil de ejecutar los inicios rápidos. Si lo prefiere, especifique la ruta a un repositorio instalado localmente. Especifique una ruta si su archivo de configuración Maven no está en la ubicación predeterminada.
Siempre
Determine si la instalación utilizará los enlaces de puerto predeterminados, configure los enlaces de puerto personalizados o configure los puertos de compensación para todos los enlaces predeterminados. Si selecciona los enlaces predeterminados, seleccione si configura los puertos para modo autónomo, modo de dominio o ambos. Si selecciona el configurar los puertos de compensación, seleccione la compensación. Luego haga clic en Next.
Si selecciona el configurar los enlaces de puertos personalizados para modo autónomo
Configure los puertos y propiedades del sistema para los varios modos autónomos, luego haga clic en Next.
Si selecciona el configurar los enlaces de puertos personalizados para modo de dominio.
Configure los puertos y propiedades del sistema para los varios modos de dominio, luego haga clic en Next.
Siempre
Seleccione la opción preferida al finalizar el proceso de instalación. Luego haga clic en Next.
Siempre
Seleccione Yes para configurar los niveles de registro o No para saltarse esta configuración. Luego haga clic en Next.
Siempre
Seleccione Perform default configuration para instalar la configuración predeterminada. Seleccione Perform advanced configuration para escoger de una lista de opciones de configuración avanzadas. Las opciones avanzadas también se pueden configurar después de la instalación. Luego haga clic en Next.
Si decide instalar la bóveda de contraseñas en la configuración avanzada del entorno del tiempo de ejecución
Configure una bóveda de contraseñas para almacenar todas sus contraseñas confidenciales en un almacén de llaves cifradas y haga clic en Next. Para obtener más información consulte: La guía de administración y configuración, "Enmascare la contraseña del almacén de llaves e inicie la bóveda de contraseñas"
Si decide habilitar la seguridad SSL en la configuración avanzada del entorno del tiempo de ejecución
Configure un almacén de llaves SSL para asegurar interfaces de administración EAP. Luego haga clic en Next. Para obtener más información consulte: Guía de seguridad, "Generar una llave de cifrado SSL y certificado"

Aviso

Red Hat recomienda que inhabilite explícitamente SSL a favor de TLSv1.1 o TLSv1.2 en todos los paquetes afectados.
Si decide habilitar la configuración LDAP en la configuración avanzada del entorno del tiempo de ejecución
Habilite la autenticación LDAP para utilizar un servidor de directorios LDAP como la fuente de autenticación para la consola de administración, el CLI de administración o la API de administración. Cuando termine haga clic en Next. Para obtener más información, consulte: La guía de administración y configuración, "Use LDAP para autenticar en las interfaces de administración"
Si decide instalar el caché Infinispan en la configuración avanzada del entorno del tiempo de ejecución
Cree un caché Infinispan para administrar datos en caché. Proporcione un nombre Infinispan, configure los otros campos y haga clic en Next. Para más información, consulte: La guía de administración y configuración, "Capítulo 14 Infinispan"
Si decide agregar un dominio de seguridad en la configuración avanzada del entorno del tiempo de ejecución
Configure un dominio de seguridad para incorporar los servicios proporcionados por parte de PicketBox en una instancia del servidor JBoss EAP. La mayoría de los campos ya se propagaron con los valores predeterminados y no necesitan modificaciones. Cuando termine haga clic en Next. Para obtener más información, consulte: La guía de administración y configuración, "Dominios de seguridad"
Si decide instalar un controlador JDBC en la configuración avanzada del entorno del tiempo de ejecución
Instale y configure un controlador JDBC para convertir el código de su aplicación al lenguaje de la base de datos relevante. Escoja un controlador apropiado de la lista de controladores soportados que aparece en la lista desplegable de "Vendedores de controladores". Para obtener más información, consulte: La guía de administración y configuración, "Capítulo 6 Administración de fuentes de datos"
Si decide instalar una fuente de datos en la configuración avanzada del entorno del tiempo de ejecución
Configure una fuente de datos que las aplicaciones puedan utilizar. Proporcione un nombre de fuente de datos, configure los otros campos y haga clic en Next. Para obtener más información, consulte: La guía de administración y configuración, "Configuración de fuentes de datos"
Siempre
Revise sus elecciones y haga clic en Next.
Siempre
Cuando el progreso de la instalación se complete, haga clic en Next.
Siempre
Cuando el procesamiento termina, haga clic en Next.
Siempre
Escoja si quiere crear atajos y la manera de configurarlos. Solo se permiten caracteres alfanuméricos con la excepción de '-' y '_'. Solo en Microsoft Windows, también se permiten los caracteres '/' y '\'. Luego haga clic en Next.
Siempre
Haga clic en Generate installation script and properties file si quiere capturar las opciones de instalación seleccionadas. Luego haga clic en Done.
La instalación está completa.
Resultado

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

3.4.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 3.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 3.1. 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 haya 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 3.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.

3.5. Instalación RPM

3.5.1. Canales de software JBoss EAP 6

La instalación de JBoss EAP 6 por medio de RPM requiere una suscripción a varios canales de software de Red Hat Network. Se requiere suscripción al canal de software base Red Hat Enterprise Linux Server y un canal JBoss EAP 6 específico.

Nota

Desde Red Hat Enterprise Linux 7, el término canal fue reemplazado por el término repositorio. En estas instrucciones solo se utiliza el término channel.
Hasta JBoss EAP 6.3.2 la selección de canal JBoss EAP se determina solamente por la versión de Red Hat Enterprise Linux y la arquitectura de hardware. Con una suscripción para esto, el canal actual proporciona el último lanzamiento JBoss EAP.
Desde JBoss EAP 6.3.3 puede suscribirse al canal JBoss EAP actual o un canal menor que proporcione un lanzamiento menor específico y todos los parches aplicables. Esto le permite mantener la misma versión menor de JBoss EAP 6, mientras que se mantiene actualizado con los parches de seguridad y de alto impacto.

3.5.2. Convención de denominación del canal JBoss EAP

La convención de denominación para el canal actual es jbappplatform-6-<ARCHITECTURE>-server-6-rpm. El instalar JBoss EAP 6.3.2 en una arquitectura x86_64 y Red Hat Enterprise Linux 6 requiere una suscripción al canal jbappplatform-6-x86_64-server-6-rpm.
La convención de denominación del canal de la versión menor para Red Hat Enterprise Linux 5 y Red Hat Enterprise Linux 6 es jbappplatform-<EAP_VERSION>-<ARCHITECTURE>-server-<RHEL_VERSION>-rpm.
La convención de denominación del canal de la versión menor para Red Hat Enterprise Linux 7 es jb-eap-<EAP_VERSION>-for-rhel-7-server-rpms para la arquitectura x86_64 y jb-eap-<EAP_VERSION>-for-rhel-7-for-power-rpms para la arquitectura ppc64
EAP_VERSION
Estas son las versiones principales y menores de JBoss EAP. Un valor EAP_VERSION 6.3 instala JBoss EAP 6.3, mientras que un valor 6 instala JBoss EAP 6.
ARCHITECTURE
Puede ser i386, x86_64 o ppc.
RHEL_VERSION
Puede ser 5 para Red Hat Enterprise Linux 5, 6 para Red Hat Enterprise Linux 6 o 7 para Red Hat Enterprise Linux 7.

3.5.3. Cómo suscribirse al canal actual de JBoss EAP 6

El comando de suscripción depende del método de registro - Red Hat Network Classic o Red Hat Subscription Manager.
Para RHN Classic, ingrese el siguiente comando.
rhn-channel --add -c jbappplatform-6-x86_64-server-6-rpm
Para Red Hat Subscription Manager, ingrese el siguiente comando.
subscription-manager repos --enable=jb-eap-6-for-rhel-6-server-rpms

3.5.4. Cómo suscribirse al canal menor de JBoss EAP 6

El comando de suscripción depende del método de registro - Red Hat Network Classic o Red Hat Subscription Manager.
Para RHN Classic, ingrese el siguiente comando:
rhn-channel --add -c jbappplatform-6.3-x86_64-server-6-rpm
Para Red Hat Subscription Manager, ingrese el siguiente comando:
subscription-manager repos --enable=jb-eap-6.3-for-rhel-6-server-rpms

3.5.5. Soporte para cambiar canales de suscripción

Es posible que durante la vida útil de una instalación de JBoss EAP 6.3.3 (o posterior) quiera cambiar la suscripción de software de un canal JBoss EAP a otro. Se soporta el cambio entre canales pero con las siguientes condiciones.
Cambio del canal actual a un canal menor
Soportado si cambia al canal menor más reciente.
Cambio de un canal actual menor a otro canal menor
Soportado si cambia a la siguiente versión menor JBoss EAP. Por ejemplo, al cambiar de JBoss EAP 6.3 a JBoss EAP 6.4 recibe soporte, pero de JBoss EAP 6.3 a JBoss EAP 6.5 no.
Cambio de un canal menor al canal actual
Soportado si cambia del último canal menor.

3.5.6. Cómo cambiar del canal actual al canal menor

Complete este procedimiento si un sistema Red Hat Enterprise Linux está suscrito al canal actual y si en su lugar, desea cambiar al canal menor. Al hacerlo, asegúrese de que el sistema reciba únicamente actualizaciones para JBoss EAP 6.3 RPMs y no sea actualizado a una versión posterior.
Para Red Hat Classic, ingrese los siguientes comandos para eliminar su suscripción del canal actual y suscribirse al canal menor.
rhn-channel --remove -c jbappplatform-6-x86_64-server-6-rpm
rhn-channel --add -c jbappplatform-6.3-x86_64-server-6-rpm
Para Red Hat Subscription Manager, ingrese el siguiente comando para eliminar la suscripción del canal actual y suscribirse al canal menor.
subscription-manager repos --disable=jb-eap-6-for-rhel-6-server-rpms --enable=jb-eap-6.3-for-rhel-6-server-rpms

3.5.7. 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 3.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. Lance 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 3.2. 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.

3.5.8. 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 y Red Hat Enterprise Linux 7. Este tema aborda los pasos requeridos para instalar una instancia usando la línea de comandos.

Procedimiento 3.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..

3.6. Instalación automatizada

3.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 de instalación automático, 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 3.10. Instalación automatizada

  • En una terminal, ejecute el siguiente comando para instalar JBoss EAP 6 usando el script de instalación automático:
    java -jar jboss-eap-6.x.x-installer.jar auto.xml

    Nota

    Cuando utiliza el script de instalación automático (auto.xml) para instalación automatizada, el instalador por defecto generará un prompt para ingresar todas las contraseñas.
Resultado

Se ha instalado una instancia idéntica de JBoss EAP 6 basada en el script de instalación automático.

3.6.2. Uso del script de instalación automático (auto.xml) de diferentes fuentes para instalar JBoss EAP 6

El instalador puede utilizar el script de instalación automático (auto.xml) desde cualquiera de los lugares de la red sin importar desde donde se ejecuta. Por lo tanto el instalador (jboss-eap-6.x.x-installer.jar) y el script de instalación automático (auto.xml) se pueden encontrar en máquinas diferentes. Este tema aborda los pasos para instalar JBoss EAP 6 automáticamente desde un lugar de la red diferente.
  • En una terminal escriba cualquiera de los siguientes comandos para especificar el script de instalación automático (presente en un lugar diferente de la red) en su ubicación de red actual:
    java -jar jboss-eap-6.x.x-installer.jar http://network-host/auto.xml (For HTTP)
    java -jar jboss-eap-6.x.x-installer.jar ftp://network-host/auto.xml (For FTP)
Resultado

JBoss EAP 6 se instala en su máquina.

3.7. Enfoques de instalación automatizados

3.7.1. Sobre los enfoques de instalación automatizados

Prerrequisitos

Ejecute el instalador y genere un script de instalación automático usando el instalador gráfico o basado en texto: Sección 3.4.2, “Ejecute el programa de instalación de JBoss EAP”

Resumen

Puede utilizar dos enfoques para instalar JBoss EAP 6 automáticamente usando el script de instalación automático generado por el instalador:

  • El primer enfoque es especificar todos los valores de llaves/contraseñas que se necesitan para la instalación automática en el archivo de variables de instalación automática
  • El segundo enfoque es especificar los valores de la llave/contraseña durante la instalación

3.7.2. Instale JBoss EAP 6 preestableciendo los valores de llave/contraseña en el archivo de variables de instalación automática

Use el siguiente procedimiento para instalar automáticamente JBoss EAP 6 preestableciendo los valores de llave/contraseña en el archivo de variables de instalación automática.

Procedimiento 3.11.

  1. Ingrese los valores de la llave en el archivo de variables

    El instalador JBoss EAP 6 crea un script de instalación automático y un archivo de variables de instalación automático. El archivo de variables de instalación automático contiene una lista de parámetros de llave/contraseña que se necesitan para la instalación automática. Para ingresar los valores de llave abra el archivo de variables de instalación automática. Llene el valor de llave/contraseñas válidas para cada parámetro. Por ejemplo:
    adminPassword = password#2
    vault.keystorepwd = vaultkeystorepw
    ssl.password = user12345
  2. Ejecute el instalador con el argumento variablefile filename para iniciar la instalación automatizada

    Puede iniciar la instalación de EAP automatizada ejecutando el instalador con el argumento variablefile auto.xml.variables. Este argumento proporciona los valores llave/contraseña del archivo de variables (paso 1) al instalador. Para iniciar una instalación completamente automatizada abra una terminal e ingrese el siguiente comando con los nombres de archivos relevantes:
    java -jar jboss-eap-6.x.x-installer.jar auto.xml -variablefile auto.xml.variables
Resultado

JBoss EAP 6 se instala en su máquina.

3.7.3. Instale JBoss EAP 6 automáticamente especificando los valores clave/contraseñas durante la instalación

Use el siguiente procedimiento para instalar automáticamente JBoss EAP 6 especificando los valores clave/contraseñas durante la instalación.

Procedimiento 3.12.

  • Ejecute el instalador con el argumento de las variables

    Puede iniciar la instalación automatizada ejecutando el instalador con el argumento de las variables y luego especificando una lista de variables. Este argumento de variables le ayudará a definir las variables junto con los valores de clave/contraseña durante la instalación. Para iniciar el proceso de instalación abra una terminal e ingrese el siguiente comando con los nombres de archivos relevantes:
    java -jar jboss-eap-6.x.x-installer.jar auto.xml -variables adminPassword=password#2,vault.keystorepwd=vaultkeystorepw,ssl.password=user12345

    Nota

    Para realizar una instalación correcta, es importante especificar los nombres de las variables (adminPassword, keystorepwd y ssl.password) sin dejar ningún espacio.

3.8. Instalación de componentes y funcionalidades Native

Los componentes nativos son componentes opcionales, los cuales se han compilado para optimizarlos en un sistema operativo y arquitectura específicos. En algunos casos, el uso de componentes nativos puede mejorar el rendimiento. Los componentes nativos incluyen soporte nativo para HornetQ (AIO) y la biblioteca Tomcat Native. Para obtener más información consulte: Sección 3.9.2, “Configuración de JBoss EAP 6 como un servicio en Red Hat Enterprise Linux (zip, instalador)” y la Jsvc de la Guía de administración y configuración.
Las funcionalidades nativas son funcionalidades opcionales especificas para cada sistema operativo y arquitectura soportados. Estos incluyen scripts y funcionalidades para instalar JBoss EAP 6 como un servicio en su sistema operativo y generando llaves de cifrado SSL y certificados.
Además de los componentes y funcionalidades Native, Webserver Connector Natives sirve para el equilibrio de carga y agrupamiento. Consulte la Guía de administración y configuración para configurar Webserver Connector Natives.

3.8.1. Instalación de componentes nativos y funcionalidades nativas (Zip, instalador)

Prerrequisitos

  • Instale JBoss EAP 6 usando la instalación zip, el instalador gráfico o el instalador basado en texto:
  • Acceda a la CLI de administración o a la Consola de administración para el servidor JBoss EAP 6. Consulte Lanzar la CLI de administración o Iniciar sesión en la consola de administración en la Guía de administración y configuración.
  • Para componentes nativos:
    • En entornos Red Hat Enterprise Linux 6 y 7 asegúrese de que el tiempo de ejecución portátil de Apache (APR del inglés Apache Portability Runtime) y las bibliotecas OpenSSL estén instaladas. Si piensa utilizar la biblioteca nativa Tomcat, la cual es parte de los componentes nativos JBoss EAP entonces el paquete tomcatjss del sistema operativo se debe borrar antes de la instalación.
    • En un entorno HP-UX se debe instalar OpenSSL.

Procedimiento 3.13. Descarga e instalación de Native Components

  1. Descargue el paquete Native Components para su sistema operativo y arquitectura del Portal de clientes de Red Hat. Puede descargar los paquetes de la misma ubicación especificada en Sección 3.3.1, “Descargar JBoss EAP 6 (instalación zip)”.
  2. Extraiga el archivador zip descargado de Native Components en su instalación JBoss EAP 6.
    Puede verificar si la extracción ha sido exitosa chequeando si hay una nueva carpeta para su sistema operativo y arquitectura en EAP_HOME/modules/system/layers/base/org/jboss/as/web/main/lib/.
  3. Usando la CLI de administración, active los componentes nativos para el subsistema de red con el siguiente comando:
    [standalone@localhost:9999 /] /subsystem=web:write-attribute(name=native,value=true)
  4. Reinicie el servidor JBoss EAP 6 para aplicar los cambios.

Procedimiento 3.14. Descargue e instale funcionalidades nativas

  1. Descargue el paquete Native Utilities para su sistema operativo y arquitectura del Portal de clientes de Red Hat. Puede descargar los paquetes de la misma ubicación especificada en Sección 3.3.1, “Descargar JBoss EAP 6 (instalación zip)”.
  2. Extraiga el archivador zip descargado de Native Components en su instalación JBoss EAP 6.
    Puede verificar una extracción exitosa chequeando si hay un directorio native en EAP_HOME/modules/system/layers/base/.
  3. Consulte el procedimiento en la documentación de JBoss EAP y en el Portal de clientes de Red Hat para configurar las funcionalidades específicas nativas.

3.8.2. Instalación de componentes nativos y funcionalidades nativas (instalación RPM)

Puede utilizar el método de instalación RPM para instalar componentes nativos, funcionalidades y todas las dependencias correspondientes solo si instaló EAP utilizando el método de instalación RPM. El método del paquete RPM de instalación de nativos es apropiado para Red Hat Enterprise Linux 5, 6 y 7. Este tema aborda los pasos requeridos para instalar los componentes y funcionalidades nativos utilizando la línea de comandos.

Procedimiento 3.15. Instalación de componentes nativos y funcionalidades nativas

  1. Instalación de componentes y funcionalidades nativas

    Para instalar componentes y funcionalidades nativas en Red Hat Enterprise Linux 5, 6 y 7 (con sus dependencias) ejecute el siguiente comando utilizando su cuenta de administración reemplazando package_name con el nombre del componente nativo que necesita instalar:
    yum install package_name
    Puede instalar estos componentes nativos: mod_cluster-native, mod_jk, mod_rt, mod_snmp, apache-commons-daemon-jsvc-eap6, httpd, httpd-devel, jbossas-hornetq-native, jbossas-jbossweb-native.

    Importante

    Los componentes nativos jbossas-hornetq-native y jbossas-jbossweb-native se instalan de forma predeterminada al ejecutar el comando yum groupinstall jboss-eap6 para instalar el paquete del grupo JBoss EAP 6. Si utilizó Sección 3.5.7, “Instalación de JBoss EAP 6 (instalación gráfica RPM)” o Sección 3.5.8, “Instalación de JBoss EAP 6 (instalación RPM basada en texto)” para la instalación de JBoss EAP 6 no necesita instalar jbossas-hornetq-native y jbossas-jbossweb-native.

    Nota

    Es importante dar el nombre del paquete correcto para instalar un componente nativo específico. Los nombres de paquetes son sensibles al uso de mayúsculas y minúsculas. En Red Hat Enterprise Linux 7 el nombre del paquete httpd es httpd22. Por lo tanto el paquete httpd se debe reemplazar con httpd22 cuando ejecuta el comando yum install package_name para instalar el servidor Apache HTTP en Red Hat Enterprise Linux 7.
  2. Reinicie el servidor

    Reinicie el servidor JBoss EAP 6 para aplicar los cambios

3.9. Configuración de servicios

3.9.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 3.16. 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 prerrequisitos 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 ejecutar el siguiente comando:
    chkconfig jbossas on
    Para establecerlo como un servicio en modo de dominio, emita el siguiente comando:
    chkconfig jbossas-domain 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.

3.9.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 3.17. Configuración del 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 por 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.

    Utilice uno de los siguientes comandos de Red Hat Enterprise Linux para probar si el servicio ha sido instalado correctamente.
    • Para Red Hat Enterprise Linux 5 y 6:
      [user@host bin]$ sudo service jboss-as-standalone.sh start
    • Para Red Hat Enterprise Linux 7:
      [user@host bin]$ sudo service jboss-as-standalone 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 estén correctas en el archivo de configuración.

    Nota

    El [OK] verde no aparece para Red Hat Enterprise Linux 7.
  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 reinicia, 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.

Procedimiento 3.18. Borre la instalación del servicio JBoss EAP 6 de Red Hat Enterprise Linux

Nota

Los pasos a continuación describen cómo desinstalar el servicio JBoss EAP 6 en modo autónomo. Con el fin de desinstalar el servicio JBoss EAP 6 en modo de dominio, use los mismos pasos pero reemplace jboss-as-standalone.sh por jboss-as-domain.sh.
  1. Si el servicio está ejecutando, primero abra una terminal y detenga el servicio ejecutando el comando stop con el nombre del servicio:
    sudo service jboss-as-standalone.sh stop
  2. Borre JBoss EAP de la lista de servicios:
    sudo chkconfig --del jboss-as-standalone.sh
  3. Borre los archivos del directorio del sistema.
    1. Borre el script de arranque del servicio:
      sudo rm /etc/init.d/jboss-as-standalone.sh
    2. Borre el archivo de configuración del servicio:
      sudo rm /etc/jboss-as/jboss-as.conf

      Importante

      /etc/jboss-as no es un directorio estándar del sistema. Solo en el caso de que no haya otros archivos en uso allí, puede borrar también el directorio:
      sudo rm -rf /etc/jboss-as/
Resultado

El servicio JBoss EAP 6 se desinstala del servidor.

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

Prerrequisitos

Importante

Al configurar las variables de entorno del sistema utilizando el comando set en una línea de comandos del servidor Windows Server no establecerá de manera permanente la variable de entorno. Debe utilizar el comando setx o la interfaz System en el Control Panel.
Resumen

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

Procedimiento 3.19. 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 Native Utilities 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 portal del cliente de Red Hat en https://access.redhat.com. Extraiga el archivador zip de Native Utilities 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 3.3. opciones service install

    Opción o argumento Descripción
    /startup
    Indica los servicios que van a iniciar automáticamente. Si no se especifica entonces el servicio se debe iniciar manualmente.
    /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.
    /config XML_FILE
    Especifica el server-config a utilizar. El valor predeterminado es standalone.xml o domain.xml.
    /hostconfig XML_FILE
    Especifica la configuración de host a utilizar en modo de Dominio solamente. El valor predeterminado es host.xml.
    /base directory
    Especifica el directorio base para contenido de servidor/dominio como una ruta completamente calificada. El valor predeterminado es %JBOSS_HOME%\standalone o %JBOSS_HOME%\domain.
    /logpath path
    Especifica la ruta de los archivos de registro. /base aplica cuando /logpath no se define. El valor predeterminado depende del modo de dominio o el modo autónomo, %JBOSS_HOME%\domain\log o %JBOSS_HOME%\standalone\log.
    /debug
    Ejecuta la instalación del servicio en modo de depuración.
    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 por 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: JBossEAP6. 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 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 3.20. Desinstalar el servicio JBoss EAP 6 del servidor de Microsoft Windows

  • Si el servicio está en ejecución, primero abra una terminal y detenga el servicio mediante 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 4. Aplicación de parches y actualización de JBoss EAP 6

4.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 individuales o acumulativas.
Actualizar es el proceso de moverse a una versión principal más nueva (por ejemplo, de 5.0 a 6.0) o una versión menor más nueva (por ejemplo, de 6.1 a 6.2) y no se puede lograr a través de parches.

4.2. Aplicación de parches en JBoss EAP 6

4.2.1. Mecanismos para uso de parches

Los parches 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 solo método de parches: ya sea parches zip o RPM. Solo los parches de seguridad y acumulativos estarán disponibles a través de RPM, y los clientes que utilizan una instalación RPM no podrán actualizar mediante parches zip.
Los parches de JBoss pueden ser una actualización asincrónica o planeada:
  • Actualizaciones asincrónicas: parches individuales que se lanzan por fuera del ciclo normal de actualización del producto existente. Estos pueden incluir parches de seguridad así como otros parches individuales proporcionados por los servicios globales de soporte de Red Hat (GSS) para solucionar problemas específicos.
  • Actualizaciones planeadas: los parches acumulativos de un producto existente, lo cual incluye las actualizaciones 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.
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 gravedad, los productos afectados, la descripción textual de las fallas y una referencia a los parches. Las actualizaciones de las correcciones de errores no se anuncian por medio de erratas.

Importante

Es importante observar que después de que se ha aplicado un parche, las jars que se detectan en tiempo de ejecución se detectan del directorio EAP_HOME/modules/system/layers/base/.overlays/$PATCH_ID/$MODULE. Los archivos originales se dejan en EAP_HOME/modules/system/layers/base/$MODULE. El mecanismo de aplicación de parches inhabilita los archivos jar originales por razones de seguridad. Esto significa que si aplica un parche que actualiza un módulo, los archivos jar del módulo original se alteran y no se pueden utilizar. Si el parche se deshace entonces los archivos originales se podrán volver a utilizar. Esto significa que se debe utilizar el procedimiento apropiado para deshacer para poder deshacer cualquier parche aplicado. Consulte Sección 4.2.2.3, “Deshacer la aplicación de un parche en forma zip utilizando el sistema de administración de parches” para ver el procedimiento para deshacer apropiadamente.
Para obtener mayor información sobre la manera en que Red Hat evalúa las fallas de seguridad de JBoss, consulte: Sección 4.2.5, “Clasificación de gravedad 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 4.2.4, “Suscripción a las listas de correo de parches”

4.2.2. Aplicación de parches en una instalación zip/con instalador

4.2.2.1. El sistema de administración de parches

El sistema de administración de parches JBoss EAP 6 se utiliza para aplicar parches zip descargados en un solo servidor JBoss EAP 6. Se puede acceder ya sea por la CLI de administración usando el comando patch o por medio de la Consola de administración. El sistema de administración de parches no se puede utilizar para aplicar parches automáticamente en instancias del servidor JBoss EAP 6 a través de un dominio administrado, pero sí se pueden aplicar parches a las instancias individuales del servidor en un dominio administrado.

Importante

Las instancias del servidor JBoss EAP 6 que se han instalado utilizando el método RPM no se pueden actualizar utilizando el sistema de administración de parches. Consulte: Sección 4.2.3, “Aplicación de parches en una instalación RPM” para actualizar los servidores JBoss EAP 6 instalados por medio de RPMs.

Nota

El sistema de administración de parches solo se puede utilizar con los parches producidos para las versiones de JBoss EAP 6.2 y posteriores. Para los parches de las versiones JBoss EAP previas a 6.2 se debe referir a la documentación de la versión relevante, disponible en https://access.redhat.com/site/documentation/.
Además de aplicar los parches, el sistema de administración de parches proporciona información básica sobre el estado de los parches instalados y la manera de deshacer inmediatamente la aplicación de un parche.
Al aplicar o deshacer un parche, el sistema de administración de parches verificará los módulos y otros archivos varios que estén cambiando para cualquier modificación del usuario. Si se detecta una modificación del usuario y no se ha especificado una opción para el manejo de conflictos, entonces el sistema de administración de parches 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, 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 sobrescribiéndolas.
La tabla a continuación lista los argumentos y opciones para el comando patch de la CLI de administración.

Tabla 4.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 sobrescribe las modificaciones de cualquier usuario.
--override-modules Si hay un conflicto generado por cualquiera de los módulos modificados, esta opción sobrescribe estas modificaciones con el contenido de la operación de aplicación del parche.
--override=path(,path) Sólo para archivos varios especificados, esto sobrescribirá los archivos modificados en conflicto con los archivos en la operación de aplicación del parche.
--preserve=path(,path) Solo para archivos varios especificados, esto preservará los archivos modificados que están en conflicto.
--host=HOST_NAME Disponible para servidores en dominios administrados, esto especifica el host en donde se realizará la operación de aplicación del parche.
info
Retorna información sobre los parches instalados actualmente.
Opcionalmente puede proporcionar --patch-id=PATCH_ID -v para obtener información detallada para un parche en específico, incluyendo parches de capas/agregados.
inspect Examina un archivo de parche descargado y retorna información importante sobre el parche.
history Muestra información básica sobre el historial de aplicación de parches.
rollback Deshace la aplicación de un parche.
--patch-id=PATCH_ID Requerido para deshacer, el ID del parche para deshacer.
--reset-configuration=TRUE|FALSE Se requiere para revertir, especifica si debe restablecer los archivos de configuración del servidor como parte de la operación a revertir.
--rollback-to Si el parche a deshacer es un parche individual (solo uno), el utilizar este argumento especifica que la operación para deshacer también deshará los otros parches únicos que se han aplicado encima del parche especificado.

4.2.2.2. Instalación de parches en forma zip utilizando el sistema de administración de parches

Resumen

Los parches que están en formato zip se pueden instalar usando el sistema de administración de parches JBoss EAP 6 por medio de la CLI de administración o la consola de administración.

Importante

El sistema de administración de parches es una funcionalidad que se agregó en JBoss EAP 6.2. Para las versiones de JBoss EAP previas a 6.2, el proceso de instalación de parches en forma zip es diferente y debe consultar la documentación de la versión relevante disponible en https://access.redhat.com/documentation/en-US/JBoss_Enterprise_Application_Platform/.

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.
  • Acceda a la CLI de administración o a la consola de administración para el servidor JBoss EAP 6 que se va a actualizar. Consulte los capítulos: Log in to the Management Console o Launch the Management CLI de la Guía de administración y configuración

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.

Procedimiento 4.1. Aplicar un parche zip a una instancia del servidor JBoss EAP 6 usando la CLI de administración

  1. Descargue el archivo zip parche del portal de clientes en https://access.redhat.com/downloads/
  2. Desde el CLI de administración, aplique el parche con el siguiente comando incluyendo 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 4.2.2.1, “El sistema de administración de parches” para ver las opciones disponibles de patch para volver a ejecutar el comando para resolver cualquier conflicto.
  3. Reinicie el servidor JBoss EAP 6 para que el parche tenga efecto:
    [standalone@localhost:9999 /] shutdown --restart=true

Procedimiento 4.2. Aplicar un parche zip a una instancia del servidor JBoss EAP 6 usando la consola de administración

  1. Descargue el archivo zip parche del portal de clientes en https://access.redhat.com/downloads/
  2. En la consola de administración:
    • Para un servidor autónomo: haga clic en la pestaña Runtime en la parte superior de la pantalla luego haga clic en Patch Management.
    • Para un dominio administrado: haga clic en la pestaña Domain en la parte superior de la pantalla, seleccione el host al que le quiere aplicar el parche del menú desplegable Host luego haga clic en Patch Management.
  3. Haga clic en Apply a New Patch.
    1. Si está aplicando un parche en el host de dominios administrados, en la siguiente pantalla seleccione si debe apagar los servidores en el host y haga clic en Next.
  4. Haga clic en el botón Browse, seleccione el parche descargado que quiere aplicar y luego haga clic en Next.
    1. Si hay algún problema al tratar de aplicar el parche entonces se presentará una advertencia. Haga clic en View error details para ver los detalles de los conflictos. Si hay un conflicto entonces puede cancelar la operación o seleccionar la casilla Override all conflicts y hacer clic en Next. El anular conflictos hará que el contenido del parche anule cualquier modificación de los usuarios.
  5. Después de que se ha aplicado el parche de manera exitosa, seleccione si va reiniciar el servidor JBoss EAP 6 ahora para que el parche tenga efecto y haga clic en Finish.
Resultado

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

4.2.2.3. Deshacer la aplicación de un parche en forma zip utilizando el sistema de administración de parches

Resumen

El sistema de administración de parches JBoss EAP 6 se puede utilizar para deshacer la aplicación de un parche zip aplicado previamente a través de la CLI de administración o la consola de administración.

Aviso

El deshacer la aplicación de un parche usando el sistema de administración de parches no es una funcionalidad general de desinstalación. Solo se debe utilizar inmediatamente después de la aplicación de un parche que tuvo consecuencias no deseadas.

Importante

El sistema de administración de parches 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 sistema de administración de parches JBoss EAP 6.
  • Acceda a la CLI de administración o a la consola de administración para el servidor JBoss EAP 6. Consulte Lanzar el CLI de administración o Iniciar sesión en la consola de administración en la Guía de administración y configuración Guide.

Aviso

Al utilizar cualquier procedimiento 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.

Procedimiento 4.3. Deshacer un parche de una instancia del servidor JBoss EAP 6 usando la CLI de administración

  1. Desde la 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.
    • Seguridad individual o IDs de parches de arreglo de errores se listan como el valor del primer patches que se puede ver en la salida patch info con el parche individual aplicado más recientemente listado de primero.
  2. Desde la CLI de administración, deshaga el parche con el ID de parche apropiado del paso anterior.
    [standalone@localhost:9999 /] patch rollback --patch-id=PATCH_ID --reset-configuration=TRUE
    La herramienta patch le advertirá si hay algún conflicto al tratar de deshacer el parche. Consulte Sección 4.2.2.1, “El sistema de administración de parches” para ver las opciones disponibles de patch para volver a ejecutar el comando para resolver cualquier conflicto.
  3. Reinicie el servidor JBoss EAP 6 para que se deshagan los cambios de manera efectiva:
    [standalone@localhost:9999 /] shutdown --restart=true

Procedimiento 4.4. Deshacer un parche de una instancia del servidor JBoss EAP 6 usando la consola de administración

  1. En la consola de administración:
    • Para un servidor autónomo: haga clic en la pestaña Runtime en la parte superior de la pantalla luego haga clic en Patch Management.
    • Para un dominio administrado: haga clic en la pestaña Domain en la parte superior de la pantalla, seleccione el host relevante del menú desplegable Host luego haga clic en Patch Management.
  2. En la tabla Recent Patch History seleccione el parche que desea deshacer luego haga clic en Rollback.
    1. Para un host de dominio administrado, en la siguiente pantalla seleccione si debe apagar los servidores en el host y haga clic en Next.
  3. Escoja sus opciones para el proceso para deshacer luego haga clic en Next.
  4. Confirme las opciones y el parche que se va a deshacer luego haga clic en Next.
    1. Si la opción Override all no se seleccionó y hay conflictos al tratar de deshacer un parche entonces se presentará una advertencia. Haga clic en View error details para ver los detalles de los conflictos. Si hay un conflicto puede cancelar la operación o haga clic en Choose Options e intente la operación nuevamente con la casilla Override all seleccionada. El anular conflictos hará que la operación para deshacer anule cualquier modificación del usuario.
  5. Después de que se ha deshecho el parche de manera exitosa, seleccione si va reiniciar el servidor JBoss EAP 6 ahora para que los cambios tengan efecto y haga clic en Finish.
Resultado

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

4.2.2.4. Limpieza del historial de parches

Cuando se aplican parches a un servidor JBoss EAP 6, el contenido e historial de los parches se preserva para uso en casos de operaciones para deshacer cambios. Si se aplican múltiples parches acumulativos, el historial de parches puede llegar a tomar una cantidad importante de espacio del disco.
Puede utilizar el comando CLI de administración a continuación para borrar todos los parches antiguos que actualmente no se están utilizando. Al utilizar este comando, solo se preserva el último parche acumulativo junto con el lanzamiento de disponibilidad general. Esto solo es útil para liberar espacio si se han aplicado múltiples parches acumulativos previamente.
/core-service=patching:ageout-history

Importante

Si limpia el historial de parches entonces no podrá deshacer y regresar a un parche aplicado anteriormente.

4.2.3. Aplicación de parches en una instalación 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 4.5. 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, las erratas incluyen 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 las erratas para el parche de seguridad y confirme que aplican 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, incluido en las erratas.
  4. Use
    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.

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

Resumen

El equipo de JBoss en Red Hat mantiene una lista de correo para anuncios de seguridad para los productos middleware empresariales de Red Hat JBoss. Esta sección aborda lo que necesita hacer para suscribirse a esta lista.

Prerrequisitos

  • Ninguno

Procedimiento 4.6. 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.

4.2.5. Clasificación de gravedad 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 gravedad 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, por sus siglas en inglés), los cuales se pueden utilizar para identificar el impacto de la falla.

Tabla 4.2. Clasificación de gravedad 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 4.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 no disponible para ningún uso, por ejemplo, a través de un fallo de kernel).
C:N/I:P/A:C
Combinado con la calificación de gravedad 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 las actualizaciones correspondientes.
Para mayor información sobre CVSS2, por favor consulte: CVSS2 Guide.

4.3. Actualización de JBoss EAP 6

4.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 4.7. 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. Copie los directorios EAP_HOME/domain/ y EAP_HOME/standalone/ de la instalación anterior en los directorios de la nueva instalación.

    Nota

    Si los archivos de configuración se copian desde una instalación vieja de JBoss EAP 6, es posible que no estén activadas las nuevas funcionalidades en el nuevo lanzamiento (tal como nuevos subsistemas). Para utilizar las nuevas funcionalidades es necesario comparar y actualizar los archivos de configuración viejos con los de la nueva versión.
  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 sobrescritos 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 directorio modules.
    • Paquetes personalizados en el directorio bundles.
  6. Optional: Si JBoss EAP 6 se configuró previamente para ejecutar como un servicio, borre el servicio existente y configure un nuevo servicio para la instalación actualizada.
Resultado

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

4.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 dominios administrados, se debe actualizar el controlador host maestro (o controlador de dominio) antes de actualizar cada controlador host.

Procedimiento 4.8. 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.

4.3.3. Actualización de JBoss EAP Cluster

Prerrequisitos

  • Ninguno
Resumen

JBoss EAP 6 no soporta la creación de clústeres, 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.

Aviso

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

Procedimiento 4.9. Configuración de un JBoss EAP Cluster

  1. Consulte el capítulo de Agrupamiento HTTP y equilibrio de carga de la Guía de configuración y administración de JBoss EAP 6.4 para ver las instrucciones sobre cómo configurar un clúster JBoss EAP en 6.4.
  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ústeres de la Guía de configuración y administración de JBoss EAP 6.4
Resultado

Su clúster JBoss EAP 6.3 se ha migrado a un clúster basado en JBoss EAP 6.4.

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 ser descargados en el Portal del cliente de Red Hat en https://access.redhat.com/. La siguiente tabla explica las diferentes opciones. Algunos componentes solo son apropiados para ciertos sistemas operativos o arquitecturas y por lo tanto, solamente 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 Native
Los componentes que se han compilado para ser optimizados para una plataforma específica. Por ejemplo, se proporcionan DLL para entornos del servidor Microsoft Windows. En algunos casos, los componentes Native 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 Native
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.
.installation/ Contiene metadatos para el mecanismo de aplicación de parches. No se requieren modificaciones para el contenido de este directorio.
jboss-modules.jar
El mecanismo bootstrap que carga los módulos.
JBossEULA.txt
Contiene los detalles del acuerdo de licencia.
LICENSE.txt
Contiene los detalles de la licencia.
version.txt
Contiene los detalles de la versión.

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.
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.
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.
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.
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 sobrescrituras 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í sobrescribirá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í sobrescribirá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

Choose the desired language for the installation program.

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

B.2. Acuerdo de licencia del usuario final

Agree to the End User License Agreement to continue.

Figura B.2. Acuerdo de licencia del usuario final del programa de instalación de JBoss EAP

B.3. Ruta de instalación

Define the installation path for the JBoss EAP instance.

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

B.4. Selección de paquetes a instalar

Seleccione o desactive los paquetes a instalar. No se pueden desactivar los paquetes requeridos.
Paquetes de selección del programa de instalación de JBoss EAP a instalar

Figura B.4. Paquetes de selección del programa de instalación de JBoss EAP a instalar

B.5. Creación del usuario administrativo

Create an administrative user.

Figura B.5. Creación del usuario administrativo del programa de instalación de JBoss EAP

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

Install the JBoss EAP quickstarts.

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

B.7. Configuración del repositorio Maven

Configuración del repositorio Maven del programa de instalación de JBoss EAP

Figura B.7. Configuración del repositorio Maven del programa de instalación de JBoss EAP

B.8. Configuración de enlace de sockets

Determine si debe utilizar los enlaces predeterminados o si debe configurar enlaces personalizados.
Use the default bindings for standalone and domain mode.

Figura B.8. Enlaces de socket predeterminados del programa de instalación de JBoss EAP

Configure custom port bindings.

Figura B.9. Enlaces de sockets de puertos personalizados del programa de instalación de JBoss EAP

Configure an offset for all default bindings.

Figura B.10. Compensación de la configuración del programa de instalación de JBoss EAP para enlaces de sockets predeterminados

B.9. Enlaces de sockets personalizados para configuraciones autónomas

La siguiente secuencia de pantallas aparecen si elige configurar los enlaces de puertos personalizados para el modo autónomo.
Configure custom socket bindings for standalone mode.

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

Configure custom socket bindings for standalone HA mode.

Figura B.12. Configuración autónoma del enlace de sockets HA del instalador JBoss EAP

Configure custom socket bindings for standalone full mode.

Figura B.13. Configuración completa autónoma de enlace de sockets autónomos JBoss EAP

Configure custom socket bindings for standalone full HA mode.

Figura B.14. Configuración HA completa autónoma de enlace de sockets autónomos JBoss EAP

B.10. Enlaces de sockets personalizados para configuraciones de dominios

La siguiente secuencia de pantallas aparecen si elige configurar los enlaces de puertos personalizados para el modo de dominio.
Configure custom socket bindings for the domain host.

Figura B.15. Configuración de enlaces de sockets hosts de dominio del instalador JBoss EAP

Configure custom socket bindings for default domain mode.

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

Configure custom socket bindings for HA domain mode.

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

Configure custom socket bindings for full domain mode.

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

Configure custom socket bindings for full HA domain mode.

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

B.11. Inicio del servidor

Select the startup option desired on completion of the installation process.

Figura B.20. Iniciar el servidor del programa de instalación de JBoss EAP

B.12. Configuración de los niveles de registro

Choose No to skip configuration of logging level.

Figura B.21. Cómo evitar los niveles de registro de JBoss EAP Installation Program

Choose Yes to configure logging level.

Figura B.22. Niveles de registro de configuración del programa de instalación de JBoss EAP

B.13. Configuración del entorno del tiempo de ejecución

Seleccione Perform advanced configuration para personalizar la instalación y configurar la seguridad, caché, LDAP y las opciones de la fuente de datos.
Entorno del tiempo de ejecución de la configuración del programa de la instalación de JBoss EAP - Predeterminado

Figura B.23. Entorno del tiempo de ejecución de la configuración del programa de la instalación de JBoss EAP - Predeterminado

Entorno del tiempo de ejecución de la configuración del programa de la instalación de JBoss EAP - Avanzado

Figura B.24. Entorno del tiempo de ejecución de la configuración del programa de la instalación de JBoss EAP - Avanzado

B.14. Configuración de la bóveda de contraseñas

Configure passwords and other options for the password vault.

Figura B.25. Configuración de la bóveda de contraseñas de la instalación JBoss EAP

B.15. Configuración de la seguridad SSL

Configure SSL Security.

Figura B.26. Seguridad SSL de configuración de la instalación de JBoss EAP

B.16. Configuración de LDAP

Configure the LDAP server as the authentication and authorization authority for applications and the management interface.

Figura B.27. Configuración LDAP de instalación de JBoss EAP

B.17. Configuración Infinispan

Configure Infinispan cache.

Figura B.28. Configuración Infinispan de instalación de JBoss EAP

B.18. Configuración del dominio de seguridad

Configure a security domain.
Configure a JSSE security domain element.

Figura B.29. Configuración del dominio de seguridad de instalación de JBoss EAP

B.19. Configuración del controlador JDBC

Configure a JDBC Driver.

Figura B.30. Instalación JBoss EAP configura un controlador JDBC

B.20. Configuración de la fuente de datos

Configure the datasource for the JDBC Driver.

Figura B.31. Configuración de la fuente de datos del instalador JBoss EAP

B.21. Revisión de los componentes de instalación

Review the list of selected components. Click the Next to continue or Previous to go back and make changes.

Figura B.32. Componentes seleccionados para la revisión del programa de instalación de JBoss EAP

B.22. Progreso de la instalación

When the installation progress completes, click Next.

Figura B.33. Progreso de la instalación de los componentes del programa de instalación de JBoss EAP

B.23. Procesamiento de la instalación completado

Procesamiento del programa de instalación JBoss EAP completado

Figura B.34. Procesamiento del programa de instalación JBoss EAP completado

B.24. Creación de atajos

Choose whether to create shortcuts and how to configure them. Then click Next.

Figura B.35. Crear atajos del instalador JBoss EAP

B.25. Generación del script de instalación

Choose whether to generate an installation script containing the selected install options. Then click Done to finish.

Figura B.36. Script de instalación genera el programa de instalación de JBoss EAP

Apéndice C. Historial de revisiones

Historial de revisiones
Revisión 6.4.0-11Tuesday April 14 2015Lucas Costi
Red Hat JBoss Enterprise Application Platform 6.4.0.GA

Aviso Legal

Copyright © 2015 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.