Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
The text of and illustrations in this document are licensed by Red Hat under a Creative
Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of
CC-BY-SA is available at
http://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 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.
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.
Resumen
Este libro es una guía de instalación de Red Hat JBoss Enterprise Application Platform 7.
Table of Contents
Table of Contents
.CAPÍTULO
. . . . . . . .1.. .SINOPSIS
. . . . . . . DEL
. . . .PRODUCTO
................................................3
.........
1.1. ACERCA DE RED HAT JBOSS ENTERPRISE APPLICATION PLATFORM 7 3
1.2. ACERCA DEL PORTAL DEL CLIENTE DE RED HAT 3
1.3. ACERCA DEL USO DE EAP_HOME EN ESTE DOCUMENTO 3
.CAPÍTULO
. . . . . . . .2.. .PREPARACIÓN
. . . . . . . . . . . PARA
. . . . .UNA
. . . .INSTALACIÓN
.......................................5
.........
2.1. ELECCIÓN DE UN MÉTODO DE INSTALACIÓN JBOSS EAP 5
2.2. PRERREQUISITOS DE INSTALACIÓN DE JBOSS EAP 5
.CAPÍTULO
. . . . . . . .3.. .INSTALACIÓN
. . . . . . . . . . .DE
. . JBOSS
. . . . . EAP
.........................................7
.........
3.1. INSTALACIÓN ZIP 7
3.2. INSTALACIÓN DEL INSTALADOR 8
3.3. INSTALACIÓN RPM 24
3.4. INSTALACIÓN DEL INSTALADOR AUTOMATIZADA 27
.CAPÍTULO
. . . . . . . .4.. .CONFIGURACIÓN
. . . . . . . . . . . . . DE
. . .JBOSS
. . . . .EAP
. . . PARA
. . . . .EJECUTAR
. . . . . . . .COMO
. . . . . UN
. . .SERVICIO
. . . . . . . . . . . . . 30
..........
4.1. CONFIGURACIÓN DE JBOSS EAP COMO UN SERVICIO EN RED HAT ENTERPRISE LINUX
(INSTALACIONES ZIP Y DEL INSTALADOR). 30
4.2. CONFIGURACIÓN DE JBOSS EAP COMO UN SERVICIO EN RED HAT ENTERPRISE LINUX
(INSTALACIÓN RPM) 31
4.3. CONFIGURAR JBOSS EAP COMO UN SERVICIO EN EL SERVIDOR DE MICROSOFT WINDOWS 32
4.4. CONFIGURAR JBOSS EAP COMO UN SERVICIO MEDIANTE JSVC 34
.CAPÍTULO
. . . . . . . .5.. .DESINSTALAR
. . . . . . . . . . .JBOSS
. . . . .EAP
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
..........
5.1. DESINSTALAR JBOSS EAP (INSTALACIÓN ZIP) 41
5.2. DESINSTALAR JBOSS EAP (INSTALACIÓN DE INSTALADOR) 41
5.3. DESINSTALAR EL JBOSS EAP (INSTALACIÓN RPM) 42
1
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
2
CAPÍTULO 1. SINOPSIS DEL PRODUCTO
JBoss EAP incluye una nueva estructura modular que permite la habilitación de servicios
únicamente cuando se requiere, mejorando así, la velocidad de arranque.
JBoss EAP proporciona dos modos operativos para instancias JBoss EAP: el servidor
autónomo o el dominio administrado. El servidor autónomo representa la ejecución de
JBoss EAP como una instancia de servidor sencilla. El modo operativo de dominio
administrado permite 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 desarrollar
rápidamente aplicaciones Java EE seguras y escalables.
3
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
Si utilizó el instalador para instalar JBoss EAP, la ruta predeterminada para EAP_HOME
es ${user.home}/EAP-7.0.0:
Si utilizó el instalador JBoss Developer Studio para instalar JBoss EAP, la ruta
predeterminada para EAP_HOME es ${user.home}/jbdevstudio/runtimes/jboss-
eap:
Nota
4
CAPÍTULO 2. PREPARACIÓN PARA UNA INSTALACIÓN
Nota
Si planea usar JBoss ON para implementar e instalar parches JBoss EAP, las
instancias JBoss EAP de destino deberán ser instaladas mediante el método de
instalación ZIP.
Método Descripción
Instalación RPM JBoss EAP puede ser instalado mediante los paquetes RPM en
instalaciones soportadas de Red Hat Enterprise Linux 6 y
Red Hat Enterprise Linux 7.
5
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
Prerrequisitos comunes Establezca una cuenta en el Portal del cliente de Red Hat.
6
CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP
Prerrequisitos
El archivo ZIP de JBoss EAP está disponible en el Portal del cliente de Red Hat. La
instalación del archivo ZIP es independiente de la plataforma.
Una vez haya sido descargado el archivo de instalación EAP ZIP, puede ser instalado al
extraer el contenido del paquete.
El usuario que ejecutará JBoss EAP debe tener acceso de lectura y escritura
para este directorio.
$ unzip jboss-eap-7.x.x.zip
Nota
El directorio creado al extraer el archivador ZIP es el directorio del nivel superior para la
instalación JBoss EAP. Este directorio se conoce como EAP_HOME.
7
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
Prerrequisitos
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. El instalador es la forma preferida de instalar JBoss EAP en todas las plataformas
soportadas.
1. Abra una terminal y vaya al directorio que contiene el archivo JAR del instalador
JBoss EAP descargado.
8
CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP
Nota
9
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
10
CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP
11
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
Aviso
12
CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP
13
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
14
CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP
15
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
16
CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP
17
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
18
CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP
19
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
20
CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP
21
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
22
CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP
23
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
1. Abra una terminal y navegue al directorio que contiene el JAR del instalador
JBoss EAP descargado
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.
Nota
Para los usuarios que deseen manejar las instalaciones JBoss EAP con
Red Hat Satellite: aunque Red Hat Satellite 6 se recomienda para administrar
las instalaciones JBoss EAP 7, los siguientes canales de Red Hat Network (RHN)
también se proporcionan específicamente para los usuarios de Satellite 5:
jbappplatform-7.0-i386-server-6-rpm
jbappplatform-7.0-x86_64-server-6-rpm
jbappplatform-7.0-x86_64-server-7-rpm
Los usuarios de Red Hat Satellite 6 pueden usar los repositorios que aparecen
en Cómo elegir un repositorio.
Nota
Desde Red Hat Enterprise Linux 7, el término canal fue remplazado por el
término repositorio. En estas instrucciones solo se utiliza el término
repositorio.
La instalación de JBoss EAP por medio de RPM requiere una suscripción a un repositorio
de software de base de Red Hat Enterprise Linux Server, así como a un repositorio
específico de JBoss EAP.
Para el repositorio JBoss EAP, debe suscribirse, ya sea al repositorio JBoss EAP actual o
al repositorio JBoss EAP menor.
24
CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP
Nota
25
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
Prerrequisitos
Es posible que durante la vida útil de una instalación de JBoss EAP, usted quiera
cambiar la suscripción de un repositorio JBoss EAP a otro. El cambio de repositorios
recibe soporte, pero con las siguientes condiciones:
Prerrequisitos
yum update
26
CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP
Aviso
Prerrequisitos
1. Abra una terminal y vaya al directorio que contiene el archivo JAR del instalador
JBoss EAP descargado.
2. En una terminal, ejecute el siguiente comando para instalar JBoss EAP mediante
el archivo XML del script de instalación automático:
27
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
Nota
Prerrequisitos
Para realizar una instalación automatizada sin asistencia, debe establecer las
contraseñas requeridas para la instalación de JBoss EAP.
adminPassword = password#2
vault.keystorepwd = vaultkeystorepw
ssl.password = user12345
28
CAPÍTULO 3. INSTALACIÓN DE JBOSS EAP
Nota
29
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
Prerrequisitos
Nota
30
CAPÍTULO 4. CONFIGURACIÓN DE JBOSS EAP PARA EJECUTAR COMO UN SERVICIO
Borre la instalación del servicio JBoss EAP de Red Hat Enterprise Linux
1. Si el servicio está ejecutándose, abra una terminal y detenga el servicio con uno
de los siguientes comandos:
sudo rm /etc/init.d/jboss-eap-rhel.sh
sudo rm /etc/default/jboss-eap.conf
Prerrequisitos
31
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
Una instalación RPM deJBoss EAP instala todo lo que se requiere para ejecutar JBoss
EAP como un servicio. Use uno de los siguientes comandos para activar el servicio de
forma automá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 oeap7-domain par un dominio
administrado.
chkconfig EAP_SERVICE_NAME on
Para iniciar o detener una instalación RPM de JBoss EAP a petición, consulte las
Instrucciones RPM en la Guía de configuración JBoss EAP.
Nota
Prerrequisitos
Importante
NOPAUSE=1
32
CAPÍTULO 4. CONFIGURACIÓN DE JBOSS EAP PARA EJECUTAR COMO UN SERVICIO
C:\Program Files
├── jboss-eap-7.0
│ ├── bin
│ └── ...
└── jbcs-jsvc-<VERSION>
3. Instale el servicio
33
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
Para iniciar el servicio desde una terminal, use el siguiente comando, cambiando
el nombre del servicio si es necesario:
service.bat uninstall
Nota
Jsvc usa tres procesos: un proceso para lanzar, un proceso de controlador y un proceso
controlado. El proceso controlado también es el hilo Java principal. Si la JVM se cae
entonces el proceso controlador reiniciará dentro de 60 segundos. Jsvc es un proceso
de demonio y para JBoss EAP debe ser iniciado por el usuario privilegiado.
34
CAPÍTULO 4. CONFIGURACIÓN DE JBOSS EAP PARA EJECUTAR COMO UN SERVICIO
1. Abra un navegador e inicie sesión en el Portal del cliente de Red Hat en la Página
de descargas de software JBoss.
4. Busque Red Hat JBoss Core Services Apache Jsvc en la lista, asegurándose
de seleccionar la plataforma y la arquitectura correctas para su sistema, luego
haga clic en el enlace Descargar.
/var/opt/
├── jboss-eap-7.0
│ ├── bin
│ └── ...
└── jbcs-jsvc-<VERSION>
6. Los ejemplos de comandos para usar Jsvc e iniciar JBoss EAP presumen que el
usuario jboss ha sido creado. Si aún no ha creado un usuario para JBoss EAP,
ejecute los siguientes comandos para crear el usuario y grupo jboss.
jb-coreservices-1-for-rhel-6-server-rpms
jb-coreservices-1-for-rhel-7-server-rpms
35
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
Nota
Los siguientes comandos se utilizan para iniciar y detener JBoss EAP en modo
autónomo mediante Jsvc. Las tablas a continuación muestran las rutas para los
comandos de una instalación ZIP/Instalador JBoss EAP o una Instalación RPM.
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
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
36
CAPÍTULO 4. CONFIGURACIÓN DE JBOSS EAP PARA EJECUTAR COMO UN SERVICIO
LOG_DIR /opt/rh/eap7/root/usr/share/wildfly/standalone
/log
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 \
-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
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
37
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
Los siguientes comandos se utilizan para iniciar y detener JBoss EAP en modo
autónomo mediante Jsvc. Las tablas a continuación muestran las rutas requeridas para
los comandos de una instalación ZIP/Instalador JBoss EAP o una Instalación RPM.
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
LOG_DIR EAP_HOME/domain/log
Tabla 4.4. Ubicación del archivo Jsvc para instalaciones RPM - Dominio
administrado
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/con
figuration
LOG_DIR /opt/rh/eap7/root/usr/share/wildfly/domain/log
38
CAPÍTULO 4. CONFIGURACIÓN DE JBOSS EAP PARA EJECUTAR COMO UN SERVICIO
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 \
&
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 \
39
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
-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
40
CAPÍTULO 5. DESINSTALAR JBOSS EAP
3. También borre cualquier otro script que dependía de la instalación JBoss EAP
que se realiza en su máquina.
Si instaló JBoss EAP mediante el Instalador,puede desinstalar JBoss EAP a través del
modo gráfico o del modo texto.
41
Red Hat JBoss Enterprise Application Platform 7.0 Guía de Instalación
Aviso
42