Capítulo 3. Instalación de JBoss EAP

Descarga del archivo ZIP de JBoss EAP

1. Abra un navegador e inicie sesión en el Portal de clientes de Red Hat en https://access.redhat.com.
2. Haga clic en Descargas.
3. Haga clic en Red Hat JBoss Enterprise Application Platform en la lista Descargas de productos
4. Seleccione la versión correcta de la versión de JBoss EAP en el menú desplegable Version.
5. Busque Red Hat JBoss Enterprise Application Platform 7.x.x en la lista y haga clic en el enlace Descargar.

1. Si es necesario, desplace el archivo ZIP al servidor y el sitio donde JBoss EAP debe ser instalado.

   • El usuario que ejecutará JBoss EAP debe tener acceso de lectura y escritura para este directorio.

2. Extraiga el archivador ZIP.

   $ unzip jboss-eap-7.x.x.zip

   Nota

   Para Windows Server, haga clic derecho en el archivo ZIP y seleccione Extraer todo.

Descargar el instalador JBoss EAP

1. Abra un navegador e inicie sesión en el Portal de clientes de Red Hat en https://access.redhat.com.
2. Haga clic en Descargas.
3. Haga clic en Red Hat JBoss Enterprise Application en la lista Descargas de productos.
4. Seleccione la versión correcta de la versión de JBoss EAP en el menú desplegable Version.
5. Busque Red Hat JBoss Enterprise Application 7.x.xInstalador en la lista y haga clic en el enlace Descargar.

Ejecutar el instalador gráfico JBoss EAP

1. Abra una terminal y vaya al directorio que contiene el archivo JAR del instalador JBoss EAP descargado.

2. Ejecute el instalador gráfico mediante el siguiente comando:

   java -jar jboss-eap-7.x.x-installer.jar -console

   Nota

   En entornos de Hewlett-Packard HP-UX o Solaris, especifique la arquitectura requerida con la opción -d32 o -d64. Lance el instalador mediante estos comandos:

   java -jar jboss-eap-7.x.x-installer.jar -console

   o

   java -jar -d64 jboss-eap-7.x.x-installer.jar

3. Siga las instrucciones en la tabla a continuación.

   Tabla 3.1. Pantallas del instalador JBoss EAP

   Nombre de la pantalla	Cuando aparezca	Descripción
   Selección del idioma	Siempre	Elija el idioma deseado para la instalación y haga clic en Aceptar.
   Acuerdo de licencia	Siempre	EULA para RED HAT JBOSS MIDDLEWARE. Seleccione "I accept the terms of this license agreement.(Acepto los términos de este contrato de licencia)", y haga clic en Siguiente.
   Ruta de instalación	Siempre	Seleccione la ruta de instalación para JBoss EAP y haga clic en Siguiente.
   Selección del componente	Siempre	Seleccione los componentes que va a instalar. No está autorizado para deshacer la selección de los componentes requeridos.
   	Figura 3.1. JBoss EAP Installer - Pantalla de selección de componentes
   Creación de usuario admin	Siempre	Cree un usuario administrativo y asigne una contraseña. Luego haga clic en Siguiente.
   Sinopsis de instalación	Siempre	Revise las opciones de instalación y haga clic en Siguiente.
   Instalación de componentes	Siempre	Cuando el curso de la instalación termine, haga clic en Siguiente.
   Configure el entorno de tiempo de ejecución	Siempre	Puede seleccionar una configuración predeterminada para su instalación de JBoss EAP o realizar una configuración avanzada con el instalador. Observe que incluso si elige una configuración predeterminada, aún podrá alterar posteriormente su configuración mediante las interfaces administrativas JBoss EAP. Seleccione Realizar configuración predeterminada o seleccione Realizar configuración avanzada y seleccione los ítemes a configurar, luego haga clic en Siguiente.
   	Figura 3.2. JBoss EAP Installer - Pantalla de configuración del entorno de ejecución
   Configure la boveda de contraseña	Si decide instalar la bóveda de contraseñas en la configuración avanzada del entorno de ejecución:	Configure una bóveda de contraseñas para almacenar todas sus contraseñas confidenciales y haga clic en Siguiente. Para obtener más información, consulte la: documentación de bóveda de contraseñas en la guía sobre Cómo configurar la seguridad de servidor.
   	Figura 3.3. JBoss EAP Installer - Pantalla de configuración de la bóveda de contraseñas
   Seguridad SSL	Si decide habilitar la seguridad SSL en la configuración avanzada del entorno de ejecución:	Especifique un almacén de llaves SSL y la contraseña del almacén de llaves para proteger las interfaces administrativas de JBoss EAP, luego haga clic en Siguiente. Para obtener más información, consulte la documentación sobre Cómo proteger las interfaces administrativas en la Guía sobre Cómo configurar la seguridad del servidor. Aviso Red Hat recomienda inhabilitar SSLv2, SSLv3 y TLSv1.0 de forma explícita, en favor de TLSv1.1 o TLSv1.2 en todos los paquetes afectados.
   Configuración LDAP	Si decide habilitar la autenticación LDAP en la configuración avanzada del entorno 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, la CLI administrativa o la API de administración. Cuando termine, haga clic en Siguiente. Para obtener más información, consulte la documentación LDAP en la Guía sobre Cómo configurar administración de identidades.
   	Figura 3.4. JBoss EAP Installer - Pantalla de configuración LDAP
   Configuración del dominio de seguridad LDAP	Si decide habilitar la autenticación LDAP en la configuración avanzada del entorno de ejecución:	Se creará un dominio de seguridad y será asociado con las interfaces administrativas, mediante la conexión LDAP definida en el paso anterior. Especifique los valores para su entorno LDAP, luego haga clic en Siguiente. Para obtener más información, consulte Documentación LDAP en la Guía sobre Cómo configurar administración de identidades.
   	Figura 3.5. JBoss EAP Installer - Pantalla de configuración de dominio de seguridad LDAP
   Configuración Infinispan	Si decide instalar una caché Infinispan en la configuración avanzada del entorno de ejecución.	Cree una caché Infinispan para administrar datos en caché. Proporcione un nombre Infinispan y configure los otros campos, luego,haga clic en Siguiente. Para obtener más información, consulte la documentación de Infinispan en la Guía de configuración.
   	Figura 3.6. JBoss EAP Installer - Pantalla de configuración Infinispan
   Configuración del dominio de seguridad	Si decide agregar un dominio de seguridad en la configuración avanzada del entorno de ejecución.	Configure un dominio de seguridad para la instancia de servidor JBoss EAP. La mayoría de los campos ya han sido llenados con los valores predeterminados y no necesitan modificación. Cuando termine, haga clic en Siguiente. Para obtener más información, consulte Dominios de seguridad en la Guía de arquitectura de seguridad.
   	Figura 3.7. JBoss EAP Installer - Pantalla de configuración de dominio de seguridad
   Configuración JSSE	Si decide agregar un dominio de seguridad en la configuración avanzada del entorno de ejecución.	Configure Java Secure Socket Extension (JSSE) para el dominio de seguridad definido en el paso anterior, usando un keystore o un truststore. Cuando haya terminado, haga clic en Siguiente.
   	Figura 3.8. JBoss EAP Installer - Pantalla de configuración JSSE
   Quickstarts	Si decide instalar inicios rápidos en la configuración avanzada del entorno de ejecución.	Seleccione la ruta de instalación del inicio rápido y luego haga clic en Siguiente.
   Configuración del repositorio Maven	Si decide instalar inicios rápidos en la configuración avanzada del entorno de ejecución.	Seleccione su repositorio Maven y el archivo de parámetros.
   	Figura 3.9. JBoss EAP Installer - Pantalla de configuración del repositorio Maven
   Enlaces de socket	Si decide configurar enlaces de puerto de servidor en la configuración avanzada del entorno de ejecución.	Determine si la instalación debe utilizar los enlaces de puertos predeterminados, configurar los desfases de puertos para todos los enlaces predeterminados o configurar los enlaces de puertos personalizados. Si decide seleccionar desfases de puertos, elija el número de desfase. Si opta por configurar enlaces personalizados, elija si desea configurar el puerto para modo autónomo, modo de dominio o ambos. Si el host está configurado para IPv6 únicamente, seleccione la casilla de verificación Habilitar la configuración IPv6 pura y el instalador hará los cambios de configuración requeridos . Haga clic en Siguiente.
   	Figura 3.10. JBoss EAP Installer - Pantalla de enlaces de sockets
   Enlaces de sockets personalizados para configuraciones autónomas	Si elige configurar los enlaces de puertos personalizados para modo autónomo.	Configure los puertos y las propiedades del sistema para cada una de las configuraciones autónomas (standalone, standalone ha, standalone full, standalone full-ha), luego haga clic en Siguiente.
   	Figura 3.11. JBoss EAP Installer - - Enlaces de sockets personalizados para pantalla de configuración autónoma
   Enlaces de sockets personalizados para configuraciones de dominios	Si opta por configurar los enlaces de puertos personalizados para modo de dominio.	Configure los puertos y las propiedades del sistema para la configuración del host (domain host) y cada uno de los perfiles de dominio (domain default, domain ha, domain full, domain full-ha), luego haga clic en Siguiente.
   	Figura 3.12. JBoss EAP Installer - Enlaces de sockets personalizados para pantalla de configuración de dominio de seguridad
   Opciones de registro	Si opta por configurar niveles de registro en la configuración avanzada del entorno de ejecución.	Seleccione los niveles de registro deseados y luego haga clic en Siguiente.
   Configuración del controlador JDBC	Si opta por instalar un controlador JDBC en la configuración avanzada del entorno de ejecución	Instale y configure un controlador JDBC. Elija el proveedor de controladores apropiado en la lista desplegable y especifique la ubicación del JAR del controlador. Cuando haya terminado, haga clic en Siguiente. Para obtener más información, consulte la sección fuente de datos para controladores JDBC en la Guía de configuración.
   	Figura 3.13. JBoss EAP Installer - Pantalla de configuración del controlador JDBC
   Configuración de la fuente de datos	Si decide instalar un controlador JDBC y una fuente de datos en la configuración avanzada del entorno de ejecución.	Configure una fuente de datos que pueda ser utilizada por aplicaciones. Proporcione una nombre de fuente de datos y configure las demás opciones, luego haga clic en Siguiente. Para obtener más información, consulte la información de datasource management en la Guía de configuración.
   	Figura 3.14. JBoss EAP Installer - Pantalla de configuración de fuente de datos
   Configuración del servidor	Siempre	Cuando el curso de la instalación termine, haga clic en Siguiente.
   Configuración de atajos	Siempre	Seleccione Crear atajos en el menú de inicio en la casilla de verificación. Únicamente están permitidos los caracteres alfanuméricos, guión (-) y barra baja (_). En Microsoft Windows, los caracteres de barra oblicua (/) y barra invertida (\) también están permitidos. Haga clic en Siguiente.
   Instalación completa	Siempre	Haga clic en Generar script de instalación y archivo de propiedades si desea capturar las opciones de instalación seleccionadas para una futura instalación automatizada, luego haga clic en Listo. La instalación ha terminado. El directorio creado por el instalador es el directorio del nivel más alto del servidor. Este se conoce como EAP_HOME.

Ejecución del instalador JBoss EAP basado en texto

1. Abra una terminal y navegue al directorio que contiene el JAR del instalador JBoss EAP descargado

2. Ejecute el instalador basado en texto mediante el siguiente comando:

   java -jar jboss-eap-7.x.x-installer.jar -console

3. Siga las indicaciones para instalar JBoss EAP. El directorio creado por el instalador es el directorio del nivel más alto del servidor. Este se conoce como EAP_HOME.

1. Instalar JBoss EAP desde un repositorio suscrito mediante el siguiente comando:

   yum groupinstall jboss-eap7

Cómo cambiar el repositorio JBoss EAP

1. Antes de cambiar el repositorio, asegúrese de que la instalación JBoss EAP tenga todas las actualizaciones aplicables al día:

   yum update

2. Con la ayuda de Red Hat Subscription Manager, elimine la suscripción del repositorio existente y suscríbase al nuevo repositorio al que desea cambiar. En el comando a continuación, remplace EXISTING_REPOSITORY y NEW_REPOSITORY por los nombres de repositorios respectivos.

   subscription-manager repos --disable=EXISTING_REPOSITORY --enable=NEW_REPOSITORY

Instalación automatizada sin asistencia del instalador, mediante un archivo de variables.

1. Abra el archivo .variables en el editor de texto y proporcione un valor de contraseña para cada llave. Por ejemplo:

   adminPassword = password#2
   vault.keystorepwd = vaultkeystorepw
   ssl.password = user12345

2. Ejecute el instalador mediante el archivo de script de instalación automático. El instalador detectará automáticamente el archivo de variables, si el archivo de variables completo está en el mismo directorio como un archivo XML de script de instalación y si no ha modificado su nombre de archivo.

   java -jar jboss-eap-7.x.x-installer.jar auto.xml
   
   Checking for corresponding .variables file
   Variables file detected: auto.xml.variables
   [ Starting automated installation ]
   ...

   También puede especificar directamente la ruta al archivo de variables mediante -variablefile:

   java -jar jboss-eap-7.x.x-installer.jar auto.xml -variablefile auto.xml.variables

Instalación del instalador de forma automatizada y sin asistencia, mediante el argumento -variables

1. Ejecute el instalador mediante el archivo XML de script de instalación automático y especifique las contraseñas requeridas como par llave-valor, mediante el argumento -variables. Por ejemplo:

   java -jar jboss-eap-7.x.x-installer.jar auto.xml -variables adminPassword=password#2,vault.keystorepwd=vaultkeystorepw,ssl.password=user12345

   Nota

   Es importante que no dejar ningún espacio al especificar los pares llave-valor de -variables.