red hat jboss enterprise application platform 7.0 guía · pdf filered hat jboss...

44
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación Para usar con Red Hat JBoss Enterprise Application Platform 7.0 Last Updated: 2018-04-16

Upload: dangminh

Post on 06-Feb-2018

221 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Red Hat JBoss EnterpriseApplication Platform 7.0

Guía de Instalación

Para usar con Red Hat JBoss Enterprise Application Platform 7.0

Last Updated: 2018-04-16

Page 2: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para
Page 3: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Red Hat JBoss Enterprise Application Platform 7.0 Guía deInstalaciónPara usar con Red Hat JBoss Enterprise Application Platform 7.0

Page 4: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Legal NoticeCopyright © 2018 Red Hat, Inc.

The text of and illustrations in this document are licensed by Red Hat under a CreativeCommons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation ofCC-BY-SA is available athttp://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it,you must provide the URL for the original version.

Red Hat, as the licensor of this document, waives the right to enforce, and agrees not toassert, 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, theInfinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United Statesand other countries.

Linux ® is the registered trademark of Linus Torvalds in the United States and othercountries.

Java ® is a registered trademark of Oracle and/or its affiliates.

XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in theUnited States and/or other countries.

MySQL ® is a registered trademark of MySQL AB in the United States, the EuropeanUnion and other countries.

Node.js ® is an official trademark of Joyent. Red Hat Software Collections is not formallyrelated to or endorsed by the official Joyent Node.js open source or commercial project.

The OpenStack ® Word Mark and OpenStack logo are either registeredtrademarks/service marks or trademarks/service marks of the OpenStack Foundation, inthe United States and other countries and are used with the OpenStack Foundation'spermission. We are not affiliated with, endorsed or sponsored by the OpenStackFoundation, or the OpenStack community.

All other trademarks are the property of their respective owners.

ResumenEste libro es una guía de instalación de Red Hat JBoss Enterprise Application Platform7.0.

Page 5: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table of ContentsCAPÍTULO 1. SINOPSIS DEL PRODUCTO

1.1. ACERCA DE RED HAT JBOSS ENTERPRISE APPLICATION PLATFORM 71.2. ACERCA DEL PORTAL DEL CLIENTE DE RED HAT1.3. ACERCA DEL USO DE EAP_HOME EN ESTE DOCUMENTO

CAPÍTULO 2. PREPARACIÓN PARA UNA INSTALACIÓN2.1. ELECCIÓN DE UN MÉTODO DE INSTALACIÓN JBOSS EAP2.2. PRERREQUISITOS DE INSTALACIÓN DE JBOSS EAP

CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP3.1. INSTALACIÓN ZIP

3.1.1. Descarga de JBoss EAP (instalación ZIP)3.1.2. Instalación de JBoss EAP (Instalación ZIP)

3.2. INSTALACIÓN DEL INSTALADOR3.2.1. Descarga de JBoss EAP (instalación del instalador)3.2.2. Ejecutar el instalador JBoss EAP

3.3. INSTALACIÓN RPM3.3.1. Selección de un repositorio

3.3.1.1. Suscripción al repositorio actual de JBoss EAP 7.3.3.1.2. Suscripción al repositorio menor de JBoss EAP 7.

3.3.2. Instalación de JBoss EAP (Instalación RPM)3.3.3. Cambio de repositorios

3.4. INSTALACIÓN DEL INSTALADOR AUTOMATIZADA3.4.1. Instalación del instalador automatizada sin asistencia

CAPÍTULO 4. CONFIGURACIÓN DE JBOSS EAP PARA EJECUTAR COMO UN SERVICIO4.1. CONFIGURACIÓN DE JBOSS EAP COMO UN SERVICIO EN RED HAT ENTERPRISE LINUX(INSTALACIONES ZIP Y DEL INSTALADOR).4.2. CONFIGURACIÓN DE JBOSS EAP COMO UN SERVICIO EN RED HAT ENTERPRISE LINUX(INSTALACIÓN RPM)4.3. CONFIGURAR JBOSS EAP COMO UN SERVICIO EN EL SERVIDOR DE MICROSOFT WINDOWS4.4. CONFIGURAR JBOSS EAP COMO UN SERVICIO MEDIANTE JSVC

CAPÍTULO 5. DESINSTALAR JBOSS EAP5.1. DESINSTALAR JBOSS EAP (INSTALACIÓN ZIP)5.2. DESINSTALAR JBOSS EAP (INSTALACIÓN DE INSTALADOR)5.3. DESINSTALAR EL JBOSS EAP (INSTALACIÓN RPM)

3333

555

7777888

2424252525262627

29

29

303133

39393940

Table of Contents

1

Page 6: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

2

Page 7: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

CAPÍTULO 1. SINOPSIS DEL PRODUCTO

1.1. ACERCA DE RED HAT JBOSS ENTERPRISE APPLICATIONPLATFORM 7Red Hat JBoss Enterprise Application Platform 7 (JBoss EAP) es una plataforma demiddleware construida con estándares libres y en cumplimiento con la especificación deJava Enterprise Edition 7. Integra a WildFly Application Server 10 con mensajería,agrupamiento de alta disponibilidad y otras tecnologías.

JBoss EAP incluye una nueva estructura modular que permite la habilitación de serviciosúnicamente cuando se requiere, mejorando así, la velocidad de arranque.

La consola administrativa y la interfaz de línea de comandos administrativa (CLI) haceninnecesaria la modificación de archivos de configuración XML y agregan la capacidad decodificar y automatizar tareas.

JBoss EAP proporciona dos modos operativos para instancias JBoss EAP: el servidorautónomo o el dominio administrado. El servidor autónomo representa la ejecución de JBossEAP como una instancia de servidor sencilla. El modo operativo de dominio administradopermite la administración de múltiples instancias JBoss EAP desde un punto de controlúnico.

Además, JBoss EAP incluye APIs y marcos de trabajo de desarrollo para desarrollarrápidamente aplicaciones Java EE seguras y escalables.

1.2. ACERCA DEL PORTAL DEL CLIENTE DE RED HATEl Portal del cliente de Red Hat es la plataforma centralizada para el conocimiento y losrecursos de suscripción de Red Hat. Utilice el Portal del cliente de Red Hat para:

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.

1.3. ACERCA DEL USO DE EAP_HOME EN ESTE DOCUMENTOEn este documento, se utiliza la variable EAP_HOME para denotar la ruta a la instalación deJBoss EAP. Remplace esta variable por la ruta real a su instalación de JBoss EAP.

Si instaló JBoss EAP mediante el método de instalación ZIP, el directorio deinstalación jboss-eap-7.0 es el directorio de donde usted extrajo el archivador ZIP.

Si instaló JBoss EAP mediante el método de instalación RPM, el directorio deinstalación es /opt/rh/eap7/root/usr/share/wildfly/.

Si utilizó el instalador para instalar JBoss EAP, la ruta predeterminada para EAP_HOME

CAPÍTULO 1. SINOPSIS DEL PRODUCTO

3

Page 8: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

es ${user.home}/EAP-7.0.0:

Para Red Hat Enterprise Linux, Solaris y HP-UX: /home/USER_NAME/EAP-7.0.0/

Para Microsoft Windows: C:\Users\USER_NAME\EAP-7.0.0\

Si utilizó el instalador JBoss Developer Studio para instalar JBoss EAP, la rutapredeterminada para EAP_HOME es ${user.home}/jbdevstudio/runtimes/jboss-eap:

Para Red Hat Enterprise Linux: /home/USER_NAME/jbdevstudio/runtimes/jboss-eap/

Para Microsoft Windows: C:\Users\USER_NAME\jbdevstudio\runtimes\jboss-eap o C:\Documents and Settings\USER_NAME\jbdevstudio\runtimes\jboss-eap\

NOTA

EAP_HOME no es una variable de entorno. JBOSS_HOME es la variable de entornoutilizada en scripts.

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

4

Page 9: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

CAPÍTULO 2. PREPARACIÓN PARA UNA INSTALACIÓN

2.1. ELECCIÓN DE UN MÉTODO DE INSTALACIÓN JBOSS EAPHay diferentes maneras de instalar JBoss EAP. Cada método es apropiado para ciertassituaciones. Esta tabla proporciona una sinopsis de cada tipo de instalación y las seccionesque abordan los procesos de instalación correspondientes.

NOTA

Si planea usar JBoss ON para implementar e instalar parches JBoss EAP, lasinstancias JBoss EAP de destino deberán ser instaladas mediante el método deinstalación ZIP.

Tabla 2.1. Métodos de instalación

Método Descripción

Instalación ZIP El archivador ZIP es apropiado para la instalación en todos lossistemas operativos soportados. Utilice este método si deseaextraer la instancia de forma manual.

La instalación ZIP instala una instalación predeterminada deJBoss EAP , toda la configuración se debe realizar después de lainstalación.

Instalador JAR El instalador JAR se puede ejecutar en una consola o como unasistente gráfico. Ambas opciones proporcionan instruccionespaso a paso para instalar y configurar la instancia del servidor.Esta es la forma preferida de instalar JBoss EAP en todas lasplataformas soportadas.

Con el instalador también es posible hacer configuracionesadicionales, incluidos los Quickstarts y el repositorio Maven.

Instalación RPM JBoss EAP puede ser instalado mediante los paquetes RPM eninstalaciones soportadas de Red Hat Enterprise Linux 6 yRed Hat Enterprise Linux 7.

2.2. PRERREQUISITOS DE INSTALACIÓN DE JBOSS EAPCada método de instalación tiene una serie de prerrequisitos. Esta tabla muestra losrequerimientos comunes, así como los específicos de cada método de instalación.

Tabla 2.2. Prerrequisitos de instalación de JBoss EAP

Tipo de instalación Prerrequisitos

CAPÍTULO 2. PREPARACIÓN PARA UNA INSTALACIÓN

5

Page 10: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Prerrequisitos comunesEstablezca una cuenta en el Portal del cliente de RedHat.

Revise el enlace de Configuraciones soportadas deJBoss EAP 7 y asegúrese de que su sistema seacompatible.

Asegúrese de que su sistema esté al día en lasactualizaciones y erratas emitidas de Red Hat.

Prerrequisitos deZIP/instalador Asegúrese de que se haya instalado Java Development

Kit (JDK) con soporte

En un servidor Microsoft Windows, asegúrese de que sehayan configurado las variables de entorno JAVA_HOMEy PATH, de lo contrario los atajos no funcionarán.

En Hewlett-Packard HP-UX, asegúrese de que se hayainstalado una herramienta para descomprimir.

Prerrequisitos RPMRegistre el servidor Red Hat Enterprise Linux medianteRed Hat Subscription Manager.

Asegúrese de que se haya instalado Java DevelopmentKit (JDK) con soporte

Tipo de instalación Prerrequisitos

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

6

Page 11: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP

3.1. INSTALACIÓN ZIP

3.1.1. Descarga de JBoss EAP (instalación ZIP)

Prerrequisitos

Prerrequisitos de instalación JBoss EAP

El archivo ZIP de JBoss EAP está disponible en el Portal del cliente de Red Hat. La instalacióndel archivo ZIP es independiente de la plataforma.

Descarga del archivo ZIP de JBoss EAP

1. Abra un navegador e inicie sesión en el Portal de clientes de Red Hat enhttps://access.redhat.com.

2. Haga clic en Descargas.

3. Haga clic en Red Hat JBoss Enterprise Application Platform en la listaDescargas de productos

4. Seleccione la versión correcta de la versión de JBoss EAP en el menú desplegableVersion.

5. Busque Red Hat JBoss Enterprise Application Platform 7. x.x en la lista y hagaclic en el enlace Descargar.

3.1.2. Instalación de JBoss EAP (Instalación ZIP)Una vez haya sido descargado el archivo de instalación EAP ZIP, puede ser instalado alextraer el contenido del paquete.

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

El usuario que ejecutará JBoss EAP debe tener acceso de lectura y escritura paraeste 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 seleccioneExtraer todo.

El directorio creado al extraer el archivador ZIP es el directorio del nivel superior para lainstalación JBoss EAP. Este directorio se conoce como EAP_HOME.

CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP

7

Page 12: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

3.2. INSTALACIÓN DEL INSTALADOR

3.2.1. Descarga de JBoss EAP (instalación del instalador)

Prerrequisitos

Prerrequisitos de instalación JBoss EAP

El instalador JAR JBoss EAP 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. Elinstalador es la forma preferida de instalar JBoss EAP en todas las plataformas soportadas.

Descargar el instalador JBoss EAP

1. Abra un navegador e inicie sesión en el Portal de clientes de Red Hat enhttps://access.redhat.com.

2. Haga clic en Descargas.

3. Haga clic en Red Hat JBoss Enterprise Application en la lista Descargas deproductos.

4. Seleccione la versión correcta de la versión de JBoss EAP en el menú desplegableVersion.

5. Busque Red Hat JBoss Enterprise Application 7.x.xInstalador en la lista y hagaclic en el enlace Descargar.

3.2.2. Ejecutar el instalador JBoss EAPPuede ejecutar el instalador en modo gráfico o en modo texto.

Ejecutar el instalador gráfico JBoss EAP

1. Abra una terminal y vaya al directorio que contiene el archivo JAR del instaladorJBoss 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 laarquitectura requerida con la opción -d32 o -d64. Lance el instaladormediante estos comandos:

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

o

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

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

8

Page 13: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

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

Tabla 3.1. Pantallas del instalador JBoss EAP

Nombre de lapantalla

Cuando aparezca Descripción

Selección delidioma

Siempre Elija el idioma deseado para la instalacióny haga clic en Aceptar.

Acuerdo de licencia Siempre EULA para RED HAT JBOSS MIDDLEWARE.

Seleccione "I accept the terms of thislicense agreement.(Acepto los términos deeste contrato de licencia)", y haga clic enSiguiente.

Ruta de instalación Siempre Seleccione la ruta de instalación paraJBoss EAP y haga clic en Siguiente.

Selección delcomponente

Siempre Seleccione los componentes que va ainstalar. No está autorizado para deshacerla selección de los componentesrequeridos.

Figura 3.1. JBoss EAP Installer - Pantalla de selección decomponentes

Creación de usuarioadmin

Siempre Cree un usuario administrativo y asigneuna contraseña. Luego haga clic enSiguiente.

Sinopsis deinstalación

Siempre Revise las opciones de instalación y hagaclic en Siguiente.

CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP

9

Page 14: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Instalación decomponentes

Siempre Cuando el curso de la instalación termine,haga clic en Siguiente.

Configure elentorno de tiempode ejecución

Siempre Puede seleccionar una configuraciónpredeterminada para su instalación deJBoss EAP o realizar una configuraciónavanzada con el instalador. Observe queincluso si elige una configuraciónpredeterminada, aún podrá alterarposteriormente su configuración mediantelas interfaces administrativas JBoss EAP.

Seleccione Realizar configuraciónpredeterminada o seleccione Realizarconfiguración avanzada y seleccione losítemes a configurar, luego haga clic enSiguiente.

Figura 3.2. JBoss EAP Installer - Pantalla de configuracióndel entorno de ejecución

Configure laboveda decontraseña

Si decide instalar labóveda decontraseñas en laconfiguraciónavanzada delentorno deejecución:

Configure una bóveda de contraseñas paraalmacenar todas sus contraseñasconfidenciales y haga clic en Siguiente.Para obtener más información, consulte la:documentación de bóveda de contraseñasen la guía sobre Cómo configurar laseguridad de servidor.

Nombre de lapantalla

Cuando aparezca Descripción

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

10

Page 15: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Figura 3.3. JBoss EAP Installer - Pantalla de configuraciónde la bóveda de contraseñas

Nombre de lapantalla

Cuando aparezca Descripción

CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP

11

Page 16: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Seguridad SSL Si decide habilitarla seguridad SSL enla configuraciónavanzada delentorno deejecución:

Especifique un almacén de llaves SSL y lacontraseña del almacén de llaves paraproteger las interfaces administrativas deJBoss EAP, luego haga clic en Siguiente.Para obtener más información, consulte ladocumentación sobre Cómo proteger lasinterfaces administrativas en la Guía sobreCómo configurar la seguridad del servidor.

AVISO

Red Hat recomiendainhabilitar SSLv2,SSLv3 y TLSv1.0 deforma explícita, enfavor de TLSv1.1 oTLSv1.2 en todos lospaquetes afectados.

Configuración LDAP Si decide habilitarla autenticaciónLDAP en laconfiguraciónavanzada delentorno deejecución:

Habilite la autenticación LDAP para utilizarun servidor de directorios LDAP como lafuente de autenticación para la consola deadministración, la CLI administrativa o laAPI de administración. Cuando termine,haga clic en Siguiente. Para obtener másinformación, consulte la documentaciónLDAP en la Guía sobre Cómo configuraradministración de identidades.

Nombre de lapantalla

Cuando aparezca Descripción

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

12

Page 17: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Figura 3.4. JBoss EAP Installer - Pantalla de configuraciónLDAP

Configuración deldominio deseguridad LDAP

Si decide habilitarla autenticaciónLDAP en laconfiguraciónavanzada delentorno deejecución:

Se creará un dominio de seguridad y seráasociado con las interfacesadministrativas, mediante la conexiónLDAP definida en el paso anterior.

Especifique los valores para su entornoLDAP, luego haga clic en Siguiente. Paraobtener más información, consulteDocumentación LDAP en la Guía sobreCómo configurar administración deidentidades.

Nombre de lapantalla

Cuando aparezca Descripción

CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP

13

Page 18: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Figura 3.5. JBoss EAP Installer - Pantalla de configuraciónde dominio de seguridad LDAP

ConfiguraciónInfinispan

Si decide instalaruna cachéInfinispan en laconfiguraciónavanzada delentorno deejecución.

Cree una caché Infinispan para administrardatos en caché. Proporcione un nombreInfinispan y configure los otros campos,luego,haga clic en Siguiente. Paraobtener más información, consulte ladocumentación de Infinispan en la Guía deconfiguración.

Nombre de lapantalla

Cuando aparezca Descripción

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

14

Page 19: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Figura 3.6. JBoss EAP Installer - Pantalla de configuraciónInfinispan

Configuración deldominio deseguridad

Si decide agregarun dominio deseguridad en laconfiguraciónavanzada delentorno deejecución.

Configure un dominio de seguridad para lainstancia de servidor JBoss EAP. Lamayoría de los campos ya han sidollenados con los valores predeterminadosy no necesitan modificación. Cuandotermine, haga clic en Siguiente. Paraobtener más información, consulteDominios de seguridad en la Guía dearquitectura de seguridad.

Nombre de lapantalla

Cuando aparezca Descripción

CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP

15

Page 20: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Figura 3.7. JBoss EAP Installer - Pantalla de configuraciónde dominio de seguridad

Configuración JSSE Si decide agregarun dominio deseguridad en laconfiguraciónavanzada delentorno deejecución.

Configure Java Secure Socket Extension(JSSE) para el dominio de seguridaddefinido en el paso anterior, usando unkeystore o un truststore. Cuando hayaterminado, haga clic en Siguiente.

Nombre de lapantalla

Cuando aparezca Descripción

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

16

Page 21: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Figura 3.8. JBoss EAP Installer - Pantalla de configuraciónJSSE

Quickstarts Si decide instalarinicios rápidos en laconfiguraciónavanzada delentorno deejecución.

Seleccione la ruta de instalación del iniciorápido y luego haga clic en Siguiente.

Configuración delrepositorio Maven

Si decide instalarinicios rápidos en laconfiguraciónavanzada delentorno deejecución.

Seleccione su repositorio Maven y elarchivo de parámetros.

Nombre de lapantalla

Cuando aparezca Descripción

CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP

17

Page 22: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Figura 3.9. JBoss EAP Installer - Pantalla de configuracióndel repositorio Maven

Nombre de lapantalla

Cuando aparezca Descripción

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

18

Page 23: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Enlaces de socket Si decide configurarenlaces de puertode servidor en laconfiguraciónavanzada delentorno deejecución.

Determine si la instalación debe utilizar losenlaces de puertos predeterminados,configurar los desfases de puertos paratodos los enlaces predeterminados oconfigurar los enlaces de puertospersonalizados.

Si decide seleccionar desfases de puertos,elija el número de desfase.

Si opta por configurar enlacespersonalizados, elija si desea configurar elpuerto para modo autónomo, modo dedominio o ambos.

Si el host está configurado para IPv6únicamente, seleccione la casilla deverificación Habilitar la configuraciónIPv6 pura y el instalador hará los cambiosde configuración requeridos .

Haga clic en Siguiente.

Figura 3.10. JBoss EAP Installer - Pantalla de enlaces desockets

Nombre de lapantalla

Cuando aparezca Descripción

CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP

19

Page 24: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Enlaces de socketspersonalizadosparaconfiguracionesautónomas

Si elige configurarlos enlaces depuertospersonalizadospara modoautónomo.

Configure los puertos y las propiedades delsistema para cada una de lasconfiguraciones autónomas (standalone, standalone ha, standalone full, standalone full-ha), luego haga clicen Siguiente.

Figura 3.11. JBoss EAP Installer - - Enlaces de socketspersonalizados para pantalla de configuración autónoma

Enlaces de socketspersonalizadosparaconfiguraciones dedominios

Si opta porconfigurar losenlaces de puertospersonalizadospara modo dedominio.

Configure los puertos y las propiedades delsistema para la configuración del host(domain host) y cada uno de los perfilesde dominio (domain default, domain ha, domain full, domain full-ha),luego haga clic en Siguiente.

Nombre de lapantalla

Cuando aparezca Descripción

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

20

Page 25: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Figura 3.12. JBoss EAP Installer - Enlaces de socketspersonalizados para pantalla de configuración de dominio

de seguridad

Opciones deregistro

Si opta porconfigurar nivelesde registro en laconfiguraciónavanzada delentorno deejecución.

Seleccione los niveles de registrodeseados y luego haga clic en Siguiente.

Configuración delcontrolador JDBC

Si opta por instalarun controladorJDBC en laconfiguraciónavanzada delentorno deejecución

Instale y configure un controlador JDBC.Elija el proveedor de controladoresapropiado en la lista desplegable yespecifique la ubicación del JAR delcontrolador. Cuando haya terminado, hagaclic en Siguiente. Para obtener másinformación, consulte la sección fuente dedatos para controladores JDBC en la Guíade configuración.

Nombre de lapantalla

Cuando aparezca Descripción

CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP

21

Page 26: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Figura 3.13. JBoss EAP Installer - Pantalla de configuracióndel controlador JDBC

Configuración de lafuente de datos

Si decide instalarun controladorJDBC y una fuentede datos en laconfiguraciónavanzada delentorno deejecución.

Configure una fuente de datos que puedaser utilizada por aplicaciones. Proporcioneuna nombre de fuente de datos yconfigure las demás opciones, luego hagaclic en Siguiente. Para obtener másinformación, consulte la información dedatasource management en la Guía deconfiguración.

Nombre de lapantalla

Cuando aparezca Descripción

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

22

Page 27: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Figura 3.14. JBoss EAP Installer - Pantalla de configuraciónde fuente de datos

Configuración delservidor

Siempre Cuando el curso de la instalación termine,haga clic en Siguiente.

Configuración deatajos

Siempre Seleccione Crear atajos en el menú deinicio en la casilla de verificación.Únicamente están permitidos loscaracteres alfanuméricos, guión (-) y barrabaja (_). En Microsoft Windows, loscaracteres de barra oblicua (/) y barrainvertida (\) también están permitidos.Haga clic en Siguiente.

Instalacióncompleta

Siempre Haga clic en Generar script deinstalación y archivo de propiedadessi desea capturar las opciones deinstalación seleccionadas para una futurainstalación automatizada, luego haga clicen Listo.

La instalación ha terminado. El directoriocreado por el instalador es el directorio delnivel más alto del servidor. Este se conocecomo EAP_HOME.

Nombre de lapantalla

Cuando aparezca Descripción

Ejecución del instalador JBoss EAP basado en texto

CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP

23

Page 28: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Ejecución del instalador JBoss EAP basado en texto

1. Abra una terminal y navegue al directorio que contiene el JAR del instalador JBossEAP 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 esel directorio del nivel más alto del servidor. Este se conoce como EAP_HOME.

3.3. INSTALACIÓN RPM

NOTA

Para los usuarios que deseen manejar las instalaciones JBoss EAP conRed Hat Satellite: aunque Red Hat Satellite 6 se recomienda para administrarlas instalaciones JBoss EAP 7, los siguientes canales de Red Hat Network (RHN)también se proporcionan específicamente para los usuarios de Satellite 5:

Para Red Hat Enterprise Linux 6:

jbappplatform-7.0-i386-server-6-rpm

jbappplatform-7.0-x86_64-server-6-rpm

Para Red Hat Enterprise Linux 7:

jbappplatform-7.0-x86_64-server-7-rpm

Los usuarios de Red Hat Satellite 6 pueden usar los repositorios que aparecenen Cómo elegir un repositorio.

NOTA

Desde Red Hat Enterprise Linux 7, el término canal fue remplazado por eltérmino repositorio. En estas instrucciones solo se utiliza el términorepositorio.

3.3.1. Selección de un repositorioLa instalación de JBoss EAP por medio de RPM requiere una suscripción a un repositorio desoftware de base de Red Hat Enterprise Linux Server, así como a un repositorioespecífico de JBoss EAP.

Para el repositorio JBoss EAP, debe suscribirse, ya sea al repositorio JBoss EAP actual o alrepositorio JBoss EAP menor.

Repositorio actual de JBoss EAP.El repositorio actual proporciona el lanzamiento más reciente de JBoss EAP 7. Cuandoactualice su instalación JBoss EAP, recibirá todas las actualizaciones para JBoss EAP 7,incluidas las actualizaciones menores.Por ejemplo, la actualización desde este repositorio incluirá actualizaciones de JBossEAP 7.0 a JBoss EAP 7.1, si es publicado.

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

24

Page 29: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Repositorio JBoss EAP menorUn repositorio menor proporciona un lanzamiento menor específico de JBoss EAP 7 ytodos los parches aplicables. Esto le permite mantener la misma versión menor de JBossEAP, y a su vez, permanecer al día con los parches de seguridad y de alta gravedad.Por ejemplo, la actualización desde este repositorio, incluirá parches y actualizacionesde seguridad para la versión menor de JBoss EAP, pero no incluirá actualizaciones deJBoss EAP 7.0 a JBoss EAP 7.1, si este es lanzado.

NOTA

Para entornos de producción, recomendamos el uso de un repositorio menorde JBoss EAP. De esta manera, se reduce el riesgo a cambios inesperados enlos módulos del subsistema o los cambios en la configuración causados poractualizaciones inesperadas de JBoss EAP. Siempre puede cambiar repositoriosen una fecha diferente si desea recibir una actualización.

3.3.1.1. Suscripción al repositorio actual de JBoss EAP 7.

1. Verifique si su sistema Red Hat Enterprise Linux está registrado en su cuentamediante Red Hat Subscription Manager. Para obtener más información, consulte laDocumentación de Red Hat Subscription Management.

2. Con la ayuda de Red Hat Subscription Manager, suscríbase al repositorio 'actual' deJBoss EAP 7 mediante el siguiente comando. Remplace RHEL_VERSION ya sea con 6 o7 según la versión de su Red Hat Enterprise Linux.

subscription-manager repos --enable=jb-eap-7-for-rhel-RHEL_VERSION-server-rpms

3.3.1.2. Suscripción al repositorio menor de JBoss EAP 7.

1. Verifique si su sistema Red Hat Enterprise Linux está registrado en su cuentamediante Red Hat Subscription Manager. Para obtener más información, consulte laDocumentación de Red Hat Subscription Management.

2. Con la ayuda de Red Hat Subscription Manager, suscríbase al repositorio menor deJBoss EAP 7 mediante el siguiente comando. Asegúrese de:

Remplace EAP_MINOR_VERSION por su versión JBoss EAP menor. Por ejemplo,para este lanzamiento menor, ingrese: 7.0.

Remplazar RHEL_VERSION ya sea con 6 o 7 según la versión de su Red HatEnterprise Linux.

subscription-manager repos --enable=jb-eap-EAP_MINOR_VERSION-for-rhel-RHEL_VERSION-server-rpms

3.3.2. Instalación de JBoss EAP (Instalación RPM)

Prerrequisitos

Prerrequisitos de instalación JBoss EAP

CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP

25

Page 30: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Suscribirse a un repositorio JBoss EAP

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

yum groupinstall jboss-eap7

Su instalación está completa. La ruta predeterminada EAP_HOME para la instalación RPM es /opt/rh/eap7/root/usr/share/wildfly.

3.3.3. Cambio de repositoriosEs posible que durante la vida útil de una instalación de JBoss EAP, usted quiera cambiar lasuscripción de un repositorio JBoss EAP a otro. El cambio de repositorios recibe soporte,pero con las siguientes condiciones:

Cambio de un repositorio 'actual' a un repositorio menorSoportado si cambia al canal menor más reciente.

Cambio de un repositorio menor a otro repositorio menorSoportado, si cambia a la siguiente versión menor de JBoss EAP. Por ejemplo, al cambiarde JBoss EAP 7.0 a JBoss EAP 7.1 sí recibe soporte, pero de JBoss EAP 7.0 a JBoss EAP 7.2no lo recibe.

Cambio de un repositorio menor al repositorio 'actual'Soportado, si cambia desde el repositorio menor más reciente.

Prerrequisitos

Instale JBoss EAP como una instalación RPM.

Seleccione un repositorio de cambio, y asegúrese de que cumpla con las condicionesde soporte descritas arriba.

Cómo cambiar el repositorio JBoss EAP

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

yum update

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

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

3.4. INSTALACIÓN DEL INSTALADOR AUTOMATIZADASi utiliza el Instalador JARr para instalar JBoss EAP, puede usar un script de instalacióngenerado desde una instalación anterior para automatizar instalaciones futuras con lamisma configuración.

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

26

Page 31: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

AVISO

El instalador automatizado no es retrocompatible. Usted no puede usar unscript de instalación generado desde una versión anterior de JBoss EAPcon el instalador automatizado. Debe instalar únicamente los scriptsgenerados por la misma versión menor de JBoss EAP, por ejemplo: JBossEAP 7.0.

Prerrequisitos

Use elInstalador JAR para generar un script de instalación automático. El script deinstalación automático es un archivo XML.

Instalación del instalador automatizada

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

2. En una terminal, ejecute el siguiente comando para instalar JBoss EAP mediante elarchivo XML del script de instalación automático:

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

El instalador le solicitará, por defecto, ingresar las contraseñas que se requieranpara la configuración de JBoss EAP. Puede realizar instalaciones sin asistencia enestablecer de antemano contraseñas para la instalación.

NOTA

Puede almacenar el archivo XML del script de instalación automático enun host de red y usar HTTP o FTP para señalar el instalador a usar parauna instalación. Por ejemplo:

java -jar jboss-eap-7.x.x-installer.jar http://network-host.local/auto.xml

java -jar jboss-eap-7.x.x-installer.jar ftp://network-host.local/auto.xml

3.4.1. Instalación del instalador automatizada sin asistencia

Prerrequisitos

Use elInstalador JAR para generar un script de instalación automático. El script deinstalación automático es un archivo XML.

Para realizar una instalación automatizada sin asistencia, debe establecer las contraseñasrequeridas para la instalación de JBoss EAP.

CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP

27

Page 32: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Cuando el archivo XML del script de instalación es generado desde un instalador anterior,se generará un archivo de variables de script de instalación incompleto. Tiene el mismonombre del archivo de script de instalación, pero con el sufijo .variables.

Este archivo de variables contiene una lista de llaves y parámetros de contraseñasrequeridos para una instalación automatizada sin asistencia.

Usted puede proporcionar las contraseñas requeridas como un archivo de variablescompleto o como un argumento durante la ejecución del comando del instalador.

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

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

adminPassword = password#2vault.keystorepwd = vaultkeystorepwssl.password = user12345

2. Ejecute el instalador mediante el archivo de script de instalación automático. Elinstalador detectará automáticamente el archivo de variables, si el archivo devariables completo está en el mismo directorio como un archivo XML de script deinstalació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 fileVariables 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 elargumento -variables

1. Ejecute el instalador mediante el archivo XML de script de instalación automático yespecifique 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 paresllave-valor de -variables.

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

28

Page 33: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

CAPÍTULO 4. CONFIGURACIÓN DE JBOSS EAP PARAEJECUTAR COMO UN SERVICIO

4.1. CONFIGURACIÓN DE JBOSS EAP COMO UN SERVICIO ENRED HAT ENTERPRISE LINUX (INSTALACIONES ZIP Y DELINSTALADOR).

Prerrequisitos

Instale JBoss EAP como una instalación ZIP o Instalador.

Privilegios de administrador en el servidor.

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

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

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

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

NOTA

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

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

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

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

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

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

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

CAPÍTULO 4. CONFIGURACIÓN DE JBOSS EAP PARA EJECUTAR COMO UN SERVICIO

29

Page 34: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

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

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

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

a. Para Red Hat Enterprise Linux 6:

sudo service jboss-eap-rhel.sh start

b. Para Red Hat Enterprise Linux 7:

sudo service jboss-eap-rhel start

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

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

sudo chkconfig jboss-eap-rhel.sh on

Si desea retirar el servicio JBoss EAP, use el siguiente procedimiento.

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

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

a. Para Red Hat Enterprise Linux 6:

sudo service jboss-eap-rhel.sh stop

b. Para Red Hat Enterprise Linux 7:

sudo service jboss-eap-rhel stop

2. Borre JBoss EAP de la lista de servicios:

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

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

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

4.2. CONFIGURACIÓN DE JBOSS EAP COMO UN SERVICIO ENRED HAT ENTERPRISE LINUX (INSTALACIÓN RPM)

Prerrequisitos

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

30

Page 35: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Instale JBoss EAP como una instalación RPM.

Privilegios de administrador en el servidor.

Una instalación RPM deJBoss EAP instala todo lo que se requiere para ejecutar JBoss EAPcomo un servicio. Use uno de los siguientes comandos para activar el servicio de formaautomática en el arranque del sistema.

Para los comandos que aparecen abajo, remplace EAP_SERVICE_NAME ya sea con eap7-standalone para un servidor autónomo de JBoss EAP o eap7-domain par un dominioadministrado.

Para Red Hat Enterprise Linux 6:

chkconfig EAP_SERVICE_NAME on

Para Red Hat Enterprise Linux 7:

systemctl enable EAP_SERVICE_NAME.service

Para iniciar o detener una instalación RPM de JBoss EAP a petición, consulte lasInstrucciones RPM en la Guía de configuración JBoss EAP.

NOTA

Consulte el Apéndice de configuración de servicios RPM en la Guía deconfiguración para obtener más información y opciones.

4.3. CONFIGURAR JBOSS EAP COMO UN SERVICIO EN ELSERVIDOR DE MICROSOFT WINDOWS

Prerrequisitos

Instale JBoss EAP como una instalación ZIP o Instalador.

Privilegios de administrador en el servidor.

Defina la variable de entorno del sistema JAVA_HOME.

La instancia del servidor JBoss EAP no debe estar ejecutándose.

IMPORTANTE

Al configurar las variables de entorno del sistema utilizando el comandoset enuna línea de comandos del Windows Server no establecerá de formapermanente la variable de entorno. Debe utilizar el comando setx o la interfazSystem en el Panel de control.

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

1. Crear dos variables de entorno del sistema:

JBOSS_HOME apuntando al directorio de instalación JBoss EAP.

CAPÍTULO 4. CONFIGURACIÓN DE JBOSS EAP PARA EJECUTAR COMO UN SERVICIO

31

Page 36: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

NOPAUSE=1

2. Instale el paquete Jsvc de JBoss Core ServicesSi no está aún configurado, descargue y extraiga el paquete Jsvc JBoss Core Services

a. Abra un navegador e inicie sesión en el Portal del cliente de Red Hat en la Páginade descargas de software JBoss.

b. Seleccione Apache Jsvc en el menú desplegable de Producto.

c. Seleccione la versión más reciente en el menú desplegable Versión.

d. Busque Red Hat JBoss Core Services Apache Jsvc en la lista, asegurándosede seleccionar la plataforma y la arquitectura correctas para su sistema, luegohaga clic en el enlace Descargar.

e. Extraiga el archivo ZIP descargado en el directorio que contiene su directorio deinstalación JBoss EAP.Como resultante tendrá el directorio jbcs-jsvc-<VERSION> en la mismaprofundidad que el directorio de instalación de JBoss EAP. Por ejemplo:

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

3. Instale el servicioAbra una terminal y cambie de directorio a EAP_HOME\bin.

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

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

a. Para un servidor autónomo:

service.bat install /loglevel INFO

b. Para un servidor en un dominio administrado:Utilice el parámetro /host para especificar el nombre del controlador de host deJBoss EAP que está controlado por el servicio. Puede ver los valores válidos parael nombre ejecutando ls /host en la CLI de administración.

Reemplace EAP_HOST_NAME en el comando siguiente con el nombre delcontrolador de host de JBoss EAP. Si especifica el parámetro /host sinproporcionar un nombre de controlador de host de JBoss EAP, el nombre se omiteen master.

service.bat install /host EAP_HOST_NAME /loglevel INFO

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

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

32

Page 37: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

4. Verifique el nuevo servicio en la consola de ServiciosAbra la consola de servicios de Windows (services.msc) y verifique si el servicio hasido creado.

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

5. Iniciar y detener el servicio JBoss EAP desde una terminalPara iniciar el servicio desde una terminal, use el siguiente comando, cambiando elnombre del servicio si es necesario:

net start JBossEAP7

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

net stop JBossEAP7

Si desea retirar el servicio JBoss EAP, use el siguiente procedimiento.

Suprimir el servicio JBoss EAP en Microsoft Windows Server

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

net stop JBossEAP7

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

service.bat uninstall

4.4. CONFIGURAR JBOSS EAP COMO UN SERVICIO MEDIANTEJSVCLos paquetes de los servicios JBoss Core de Apache Jsvc pueden ser utilizados para ejecutarJBoss EAP como un servicio de segundo plano en Red Hat Enterprise Linux y Solaris.

NOTA

En Red Hat Enterprise Linux, le recomendamos usar métodos nativos paraejecutar JBoss EAP como un servicio.

Jsvc es un grupo de bibliotecas y aplicaciones que le permiten a las aplicaciones Javaejecutar en plataformas similares a UNIX como un servicio de segundo plano. Le permite alas aplicaciones realizar operaciones como un usuario privilegiado y luego cambiar deidentidad como un usuario sin privilegios.

Jsvc usa tres procesos: un proceso para lanzar, un proceso de controlador y un procesocontrolado. El proceso controlado también es el hilo Java principal. Si la JVM se caeentonces el proceso controlador reiniciará dentro de 60 segundos. Jsvc es un proceso de

CAPÍTULO 4. CONFIGURACIÓN DE JBOSS EAP PARA EJECUTAR COMO UN SERVICIO

33

Page 38: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

daemon y para JBoss EAP debe ser iniciado por el usuario privilegiado.

Instale el paquete Jsvc de JBoss Core Services

Para instalaciones ZIP o de instalador:

1. Abra un navegador e inicie sesión en el Portal del cliente de Red Hat en la Página dedescargas de software JBoss.

2. Seleccione Apache Jsvc en el menú desplegable de Producto.

3. Seleccione la versión más reciente en el menú desplegable Versión.

4. Busque Red Hat JBoss Core Services Apache Jsvc en la lista, asegurándose deseleccionar la plataforma y la arquitectura correctas para su sistema, luego haga clicen el enlace Descargar.

5. Extraiga el archivo ZIP descargado en el directorio que contiene su directorio deinstalación JBoss EAP.Como resultante tendrá el directorio jbcs-jsvc-<VERSION> en la misma profundidadque el directorio de instalación de JBoss EAP. Por ejemplo:

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

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

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

Para instalaciones RPM en Red Hat Enterprise Linux.

1. Ingrese a Red Hat Subscription Manager.

2. Haga clic en Sistemas en el Inventario de suscriptor.

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

a. Para Red Hat Enterprise Linux 6:

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

b. Para Red Hat Enterprise Linux 7:

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

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

# yum groupinstall jbcs-jsvc

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

34

Page 39: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

NOTA

Asegúrese de establecer la variable JAVA_HOME del entorno del sistema.

Utilice Jsvc para iniciar JBoss EAP como un servidor autónomoLos siguientes comandos se utilizan para iniciar y detener JBoss EAP en modo autónomomediante Jsvc. Las tablas a continuación muestran las rutas para los comandos de unainstalación ZIP/Instalador JBoss EAP o una Instalación RPM.

Tabla 4.1. Ubicación del archivo Jsvc para instalaciones ZIP/Instalador - Servidorautónomo

Referencia de archivos eninstrucciones

Ubicación del archivo

JSVC_BIN EAP_HOME/../jbcs-jsvc-<VERSION>/sbin/jsvc

JSVC_JAR EAP_HOME/../jbcs-jsvc-<VERSION>/lib/commons-daemon.jar

CONF_DIR EAP_HOME/standalone/configuration

LOG_DIR EAP_HOME/standalone/log

Tabla 4.2. Ubicación del archivo Jsvc para instalaciones RPM - Servidor autónomo

Referencia de archivos eninstrucciones

Ubicación del archivo

JSVC_BIN /usr/bin/jbcs-jsvc/jsvc

JSVC_JAR /usr/bin/jbcs-jsvc/commons-daemon.jar

CONF_DIR /opt/rh/eap7/root/usr/share/wildfly/standalone/configuration

LOG_DIR /opt/rh/eap7/root/usr/share/wildfly/standalone/log

Iniciar un servidor JBoss EAP mediante Jsvc:

JSVC_BIN \ -outfile LOG_DIR/jsvc.out.log \ -errfile LOG_DIR/jsvc.err.log \ -pidfile LOG_DIR/jsvc.pid \ -user jboss \ -D[Standalone] -XX:+UseCompressedOops -Xms1303m \ -Xmx1303m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \

CAPÍTULO 4. CONFIGURACIÓN DE JBOSS EAP PARA EJECUTAR COMO UN SERVICIO

35

Page 40: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

-Djava.awt.headless=true \ -Dorg.jboss.boot.log.file=LOG_DIR/server.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -cp EAP_HOME/jboss-modules.jar:JSVC_JAR \ -Djboss.home.dir=EAP_HOME \ -Djboss.server.base.dir=EAP_HOME/standalone \ @org.jboss.modules.Main -start-method main \ -mp EAP_HOME/modules \ -jaxpmodule javax.xml.jaxp-provider \ org.jboss.as.standalone

Detener los procesos de servidor JBoss EAP:

JSVC_BIN \ -stop \ -outfile LOG_DIR/jsvc.out.log \ -errfile LOG_DIR/jsvc.err.log \ -pidfile LOG_DIR/jsvc.pid \ -user jboss \ -D[Standalone] -XX:+UseCompressedOops -Xms1303m \ -Xmx1303m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true \ -Dorg.jboss.boot.log.file=LOG_DIR/server.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -cp EAP_HOME/jboss-modules.jar:JSVC_JAR \ -Djboss.home.dir=EAP_HOME \ -Djboss.server.base.dir=EAP_HOME/standalone \ @org.jboss.modules.Main -start-method main \ -mp EAP_HOME/modules \ -jaxpmodule javax.xml.jaxp-provider \ org.jboss.as.standalone

Utilice Jsvc para iniciar JBoss EAP de dominio administradoLos siguientes comandos se utilizan para iniciar y detener JBoss EAP en modo autónomomediante Jsvc. Las tablas a continuación muestran las rutas requeridas para los comandosde una instalación ZIP/Instalador JBoss EAP o una Instalación RPM.

Tabla 4.3. Ubicación del archivo Jsvc para instalaciones ZIP/Instalador - Dominioadministrado

Referencia de archivos eninstrucciones

Ubicación del archivo

JSVC_BIN EAP_HOME/../jbcs-jsvc-<VERSION>/sbin/jsvc

JSVC_JAR EAP_HOME/../jbcs-jsvc-<VERSION>/lib/commons-daemon.jar

CONF_DIR EAP_HOME/domain/configuration

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

36

Page 41: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

LOG_DIR EAP_HOME/domain/log

Referencia de archivos eninstrucciones

Ubicación del archivo

Tabla 4.4. Ubicación del archivo Jsvc para instalaciones RPM - Dominioadministrado

Referencia de archivos eninstrucciones

Ubicación del archivo

JSVC_BIN /usr/bin/jbcs-jsvc/jsvc

JSVC_JAR /usr/bin/jbcs-jsvc/commons-daemon.jar

CONF_DIR /opt/rh/eap7/root/usr/share/wildfly/domain/configuration

LOG_DIR /opt/rh/eap7/root/usr/share/wildfly/domain/log

Antes de ejecutar el siguiente comando, asegúrese de establecer la variable del entorno delsistema JAVA_HOME.

Inicie un dominio administrado JBoss EAP mediante Jsvc:

JSVC_BIN \ -outfile LOG_DIR/jsvc.out.log \ -errfile LOG_DIR/jsvc.err.log \ -pidfile LOG_DIR/jsvc.pid \ -user jboss \ -nodetach -D"[Process Controller]" -server -Xms64m \ -Xmx512m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true \ -Dorg.jboss.boot.log.file=LOG_DIR/process-controller.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -cp "EAP_HOME/jboss-modules.jar:JSVC_JAR" \ org.apache.commons.daemon.support.DaemonWrapper \ -start org.jboss.modules.Main -start-method main \ -mp EAP_HOME/modules org.jboss.as.process-controller \ -jboss-home EAP_HOME -jvm "${JAVA_HOME}"/bin/java \ -mp EAP_HOME/modules -- \ -Dorg.jboss.boot.log.file=LOG_DIR/host-controller.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -server -Xms64m -Xmx512m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true -- -default-jvm "${JAVA_HOME}"/bin/java \&

CAPÍTULO 4. CONFIGURACIÓN DE JBOSS EAP PARA EJECUTAR COMO UN SERVICIO

37

Page 42: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

Detenga un dominio administrado JBoss EAP mediante Jsvc:

JSVC_BIN \ -stop \ -outfile LOG_DIR/jsvc.out.log \ -errfile LOG_DIR/jsvc.err.log \ -pidfile LOG_DIR/jsvc.pid \ -user jboss \ -nodetach -D"[Process Controller]" -server -Xms64m \ -Xmx512m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true \ -Dorg.jboss.boot.log.file=LOG_DIR/process-controller.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -cp "EAP_HOME/jboss-modules.jar:JSVC_JAR" \ org.apache.commons.daemon.support.DaemonWrapper \ -start org.jboss.modules.Main -start-method main \ -mp EAP_HOME/modules org.jboss.as.process-controller \ -jboss-home EAP_HOME -jvm $JAVA_HOME/bin/java \ -mp EAP_HOME/modules -- \ -Dorg.jboss.boot.log.file=LOG_DIR/host-controller.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -server -Xms64m -Xmx512m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true -- -default-jvm $JAVA_HOME/bin/java

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

38

Page 43: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

CAPÍTULO 5. DESINSTALAR JBOSS EAP

5.1. DESINSTALAR JBOSS EAP (INSTALACIÓN ZIP)1. Asegúrese de hacer una copia de seguridad de los archivos de configuración

modificados y de las implementaciones que pueden ser reutilizadas.

2. El método de instalación ZIP instala JBoss EAP en un directorio individual. Borre eldirectorio de instalación para desinstalar JBoss EAP.

3. También borre cualquier otro script que dependía de la instalación JBoss EAP que serealiza en su máquina.

5.2. DESINSTALAR JBOSS EAP (INSTALACIÓN DEINSTALADOR)Si instaló JBoss EAP mediante el Instalador,puede desinstalar JBoss EAP a través del modográfico o del modo texto.

Ejecución del desinstalador gráfico JBoss EAP

1. Abra una terminal y vaya a EAP_HOME/Uninstaller.

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

java -jar uninstaller.jar

La ejecución del comando lanzará el desinstalador gráfico como se puede ver en lasiguiente figura. Seleccione la casilla si desea borrar el directorio de instalación deJBoss EAP.

Figura 5.1. Desinstalador gráfico JBoss EAP

3. Haga clic en Uninstall para iniciar el proceso de instalación.

4. Cuando el proceso de desinstalación haya terminado, haga clic en Quit para salir deldesinstalador.

Ejecución del desinstalador JBoss EAP basado en texto

CAPÍTULO 5. DESINSTALAR JBOSS EAP

39

Page 44: Red Hat JBoss Enterprise Application Platform 7.0 Guía · PDF fileRed Hat JBoss Enterprise Application Platform 7 ... JBoss EAP incluye APIs y marcos de trabajo de desarrollo para

1. Abra una terminal y vaya a EAP_HOME/Uninstaller.

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

java -jar uninstaller.jar -console

3. Siga las indicaciones para desinstalar JBoss EAP.

5.3. DESINSTALAR EL JBOSS EAP (INSTALACIÓN RPM)

AVISO

No se recomienda la desinstalación de un JBoss EAP que haya sidoinstalado con el método RPM.

Debido a la naturaleza de administración de paquetes RPM, no segarantiza que todos los paquetes y dependencias puedan ser retiradoscompletamente o que el sistema no quede en un estado inconsistenteporque falten algunas dependencias de paquetes.

Revised on 2018-04-16 16:10:49 EDT

Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación

40