Download Plataforma de aplicaciones empresariales JBoss 6 Guía de Instalación

Transcript
Plataforma de aplicaciones
empresariales JBoss 6
Guía de Instalación
Para uso con la plataforma de aplicaciones empresariales JBoss 6
Darrin Mison
Tom Wells
David Ryan
Misty Stanley-Jones
Plataforma de aplicaciones empresariales JBoss 6 Guía de Instalación
Para uso con la plataforma de aplicaciones empresariales JBoss 6
Darrin Miso n
David Ryan
Misty Stanley-Jo nes
[email protected] m
To m Wells
[email protected] m
Legal Notice
Co pyright © 20 14 Red Hat, Inc..
This do cument is licensed by Red Hat under the Creative Co mmo ns Attributio n-ShareAlike 3.0
Unpo rted License. If yo u distribute this do cument, o r a mo dified versio n o f it, yo u must pro vide
attributio n to Red Hat, Inc. and pro vide a link to the o riginal. If the do cument is mo dified, all Red
Hat trademarks must be remo ved.
Red Hat, as the licenso r o f this do cument, waives the right to enfo rce, and agrees no t to assert,
Sectio n 4 d o f CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shado wman lo go , JBo ss, MetaMatrix, Fedo ra, the Infinity
Lo go , and RHCE are trademarks o f Red Hat, Inc., registered in the United States and o ther
co untries.
Linux ® is the registered trademark o f Linus To rvalds in the United States and o ther co untries.
Java ® is a registered trademark o f Oracle and/o r its affiliates.
XFS ® is a trademark o f Silico n Graphics Internatio nal Co rp. o r its subsidiaries in the United
States and/o r o ther co untries.
MySQL ® is a registered trademark o f MySQL AB in the United States, the Euro pean Unio n and
o ther co untries.
No de.js ® is an o fficial trademark o f Jo yent. Red Hat So ftware Co llectio ns is no t fo rmally
related to o r endo rsed by the o fficial Jo yent No de.js o pen so urce o r co mmercial pro ject.
The OpenStack ® Wo rd Mark and OpenStack Lo go are either registered trademarks/service
marks o r trademarks/service marks o f the OpenStack Fo undatio n, in the United States and o ther
co untries and are used with the OpenStack Fo undatio n's permissio n. We are no t affiliated with,
endo rsed o r spo nso red by the OpenStack Fo undatio n, o r the OpenStack co mmunity.
All o ther trademarks are the pro perty o f their respective o wners.
Abstract
Este libro es un manual para la instalació n de la platafo rma de aplicacio nes empresariales
JBo ss 6 y sus lanzamiento s de parches.
T able of Cont ent s
T able of Contents
.Prefacio
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. . . . . . . . . .
⁠1. Co nvenc io nes d el Do c umento
3
⁠1.1. Co nvenc io nes tip o g ráfic as
3
⁠1.2. Co nvenc io nes d el d o c umento
4
⁠1.3. No tas y Ad vertenc ias
5
⁠2 . Có mo o b tener ayud a y hac er s us c o mentario s
5
⁠2 .1. ¿Nec es ita ayud a?
⁠2 .2. ¡Nec es itamo s s us c o mentario s !
5
6
. .apít
⁠C
. . . ulo
...1
. .. .Int
. . roducción
. . . . . . . . . .a. la
. . plat
. . . .aforma
. . . . . . de
. . .aplicaciones
. . . . . . . . . . . empresariales
. . . . . . . . . . . . .JBoss
. . . . . .6. . . . . . . . . . . . . . . . 7. . . . . . . . . .
⁠1.1. Intro d uc c ió n a la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6
7
⁠1.2. Func io nalid ad es nuevas y c o n c amb io s en la p latafo rma d e ap lic ac io nes emp res ariales JBo s s
6
7
. .apít
⁠C
. . . ulo
...2
. .. .Descarga
. . . . . . . . de
. . .la
. .plat
. . . aforma
. . . . . . .de
. . .aplicaciones
. . . . . . . . . . . empresariales
. . . . . . . . . . . . .JBoss
.....6
. . . . . . . . . . . . . . . . . . . 8. . . . . . . . . .
⁠2 .1. So b re el p o rtal d el c liente d e Red Hat
⁠2 .2. Des c arg as d is p o nib les p ara la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6
⁠2 .3. Des c arg a d e la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6
8
8
10
. .apít
⁠C
. . . ulo
. . . 3.
. . Preparación
. . . . . . . . . . . para
. . . . .la. .inst
. . . alación
. . . . . . . de
. . .la. .plat
. . . aforma
. . . . . . .de
. . aplicaciones
. . . . . . . . . . . .empresariales
. . . . . . . . . . . . .JBoss
...............
6
11
⁠3 .1. Prerreq uis ito s d e ins talac ió n p ara la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6 .
⁠3 .2. Ento rno s Java s o p o rtad o s p o r la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6
11
11
⁠3 .3. Ins talac ió n d e O p enJDK en Red Hat Enterp ris e Linux
11
. .apít
⁠C
. . . ulo
...4
. .. .Inst
. . . alación
. . . . . . .de
. . .la. .plat
. . . aforma
. . . . . . .de
. . aplicaciones
. . . . . . . . . . . .empresariales
. . . . . . . . . . . . JBoss
. . . . . . 6. . . . . . . . . . . . . . . .1. 4. . . . . . . . . .
⁠4 .1. Méto d o s d e ins talac ió n p ara la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6 .
14
⁠4 .2. Ins talar la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6 us and o el méto d o d el
ins talad o r
14
⁠4 .3. Ins talac ió n d e la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6 us and o la d es c arg a ZIP
15
⁠4 .4. Ins talac ió n d e la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6 us and o Red Hat
Netwo rk (ins talac ió n RPM)
16
⁠4 .5. Arc hivo s d e c o nfig urac ió n d e ins talac ió n RPM
18
⁠4 .6 . Es truc tura d e ins talac ió n y d etalles
19
. .apít
⁠C
. . . ulo
. . . 5.
. . Upgrading
. . . . . . . . . . JBoss
. . . . . . Ent
. . . erprise
. . . . . . .Applicat
. . . . . . . ion
. . . Plat
. . . .form
....6
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2. 2. . . . . . . . . .
⁠5 .1. Ac tualiz ac ió n d e la ins talac ió n ZIP d e la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6
⁠5 .2. Ac tualiz ac ió n d e la ins talac ió n RPM d e la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 22
6
23
. .apít
⁠C
. . . ulo
...6
. .. .Ejecución
. . . . . . . . .de
. . la
. . plat
. . . .aforma
. . . . . . de
. . . aplicaciones
. . . . . . . . . . . .empresariales
. . . . . . . . . . . . JBoss
. . . . . .6. .como
. . . . .un
. . .servicio
..................
⁠6 .1. Ejec ute la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6 c o mo un s ervic io d el s is tema 2 5
o p erativo
25
⁠6 .2. Ins talac ió n d e la p latafo rma d e ap lic ac io nes emp res ariales JBo s s c o mo un s ervic io en
Red Hat Enterp ris e Linux
25
⁠6 .3. Ins talac ió n d e la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6 c o mo un s ervic io en
Mic ro s o ft Wind o ws
26
. .apít
⁠C
. . . ulo
...7
. .. .Inicio
. . . . .con
. . . .la. .plat
. . . aforma
. . . . . . .de
. . aplicaciones
. . . . . . . . . . . .empresariales
. . . . . . . . . . . . JBoss
. . . . . . 6. . . . . . . . . . . . . . . . . . .
⁠7 .1. Ag reg ar el us uario inic ial p ara las interfac es d e ad minis trac ió n
⁠7 .2. Inic iar la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6
⁠7 .3. Inic ie la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6 c o mo un d o minio ad minis trad o
⁠7 .4. Inic ie la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6 c o mo un s ervid o r autó no mo
⁠7 .5. Pro b ar la ins talac ió n
⁠7 .6 . Puerto s d e red q ue la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6 utiliz a
32
.2. 9. . . . . . . . . .
29
30
31
31
33
1
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
⁠7 .6 . Puerto s d e red q ue la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6 utiliz a
33
⁠7 .7. Co nfig urac ió n d e lo s c o rtafueg o s d e red p ara q ue func io nen c o n la p latafo rma d e ap lic ac io nes
emp res ariales JBo s s 6
35
⁠7 .8 . Co nfig urac ió n p red eterminad a d e s eg urid ad d el us uario
38
. .apít
⁠C
. . . ulo
...8
. .. .Desinst
. . . . . . alación
. . . . . . . de
. . .la
. .plat
. . . aforma
. . . . . . .de
. . .aplicaciones
. . . . . . . . . . . empresariales
. . . . . . . . . . . . .JBoss
.....6
. . . . . . . . . . . . .4. 0. . . . . . . . . .
⁠8 .1. Des ins talac ió n d e la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6
40
⁠8 .2. Des ins talar la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6 d es d e una ins talac ió n Zip
40
⁠8 .3. Des ins talar la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6 d es d e una ins talac ió n
g ráfic a
41
⁠8 .4. Des ins talac ió n d e la p latafo rma d e ap lic ac io nes emp res ariales JBo s s 6 d es d e una ins talac ió n
RPM
41
.Paquet
. . . . . .es
. . RPM
. . . . .de
. . la
. . plat
. . . .aforma
. . . . . . de
. . . aplicaciones
. . . . . . . . . . . .empresariales
. . . . . . . . . . . . JBoss
. . . . . .6. . . . . . . . . . . . . . . . . . . . . . .4. 2. . . . . . . . . .
⁠A .1. Lis ta d e p aq uetes RPM y d ep end enc ias
42
. . . . orial
Hist
. . . . de
. . . revisiones
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4. 3. . . . . . . . . .
2
Prefacio
Prefacio
1. Convenciones del Document o
Este manual utiliza varias convenciones para resaltar algunas palabras y frases y llamar la
atención sobre ciertas partes específicas de información.
1.1. Convenciones t ipográficas
Se utilizan cuatro convenciones tipográficas para llamar la atención sobre palabras o frases
específicas. D ichas convenciones y las circunstancias en que se aplican son las siguientes:
Neg ri ta mo no espaci ad o
Utilizado para resaltar la entrada del sistema, incluyendo los comandos de shell, nombres de
archivos y rutas. También sirve para resaltar teclas y combinaciones de teclas. Por ejemplo:
Para ver el contenido del archivo my_next_bestsel l i ng _no vel en su directorio
actual de trabajo, escriba el comando cat my_next_bestsel l i ng _no vel en el
intérprete de comandos de shell y pulse Enter para ejecutar el comando.
El ejemplo anterior incluye un nombre de archivo, un comando de shell y una tecla . Todo se
presenta en negrita-monoespaciado y distinguible gracias al contexto.
Las combinaciones de teclas se pueden distinguir de las individuales con el signo más que conecta
cada partee de la combinación de tecla. Por ejemplo:
Pulse Enter para ejecutar el comando.
Pulse C trl +Al t+F2 para pasar a una terminal virtual.
El primer ejemplo resalta una tecla particular a pulsar. El segundo ejemplo, resalta una combinación
de teclas: un set de tres teclas pulsadas simultáneamente.
Si se discute el código fuente, los nombres de las clase, los métodos, las funciones, los nombres de
variables y valores de retorno mencionados dentro de un párrafo serán presentados en Neg ri tamo no espaci ad o . Por ejemplo:
Las clases de archivo relacionadas incluyen fi l ename para sistema de archivos,
fi l e para archivos y d i r para directorios. Cada clase tiene su propio conjunto
asociado de permisos.
N eg rit a p ro p o rcio n al
Esta denota palabras o frases encontradas en un sistema, incluyendo nombres de aplicación, texto
de cuadro de diálogo, botones etiquetados, etiquetas de cajilla de verificación y botón de radio;
títulos de menú y títulos del submenú. Por ejemplo:
Seleccione Sist ema → Pref eren cias → R at ó n desde la barra del menú principal
para lanzar Pref eren cias d e rat ó n . En la pestaña de Bo to nes, seleccione la
cajilla de rató n d e mano i zq ui erd a y luego haga clic en C errar para cambiar
el botón principal del ratón de la izquierda a la derecha (adecuando el ratón para la
mano izquierda).
Para insertar un carácter especial en un archivo g ed it , seleccione Ap licacio n es →
Acceso rio s → Map a d e caract eres de la barra del menú. Luego, seleccione
B ú sq u ed a → B u scar… de la barra del menú de Map a d e caract eres, escriba el
3
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
nombre del carácter en el campo de Búsq ued a y haga clic en Si g ui ente. El
carácter que buscó será resaltado en la T abl a d e caracteres. Haga doble clic en
ese carácter resaltado para colocarlo en el campo de T exto a co pi ar y luego
haga clic en el botón C o pi ar. Ahora regrese al documento y elija Mo d if icar →
Peg ar de la barra de menú de g ed it .
El texto anterior incluye nombres de aplicación; nombres y elementos del menú de todo el sistema;
nombres de menú de aplicaciones específicas y botones y texto hallados dentro de una interfaz
gráfica de usuario, todos presentados en negrita proporcional y distinguibles por contexto.
Itálicas-negrita monoespaciado o Itálicas-negrita proporcional
Ya sea negrita monoespaciado o negrita proporcional, la adición de itálicas indica texto
reemplazable o variable. Las itálicas denotan texto que usted no escribe literalmente o texto
mostrado que cambia dependiendo de la circunstancia. Por ejemplo:
Para conectar a una máquina remota utilizando ssh, teclee ssh nombre de
usuario@ dominio.nombre en un intérprete de comandos de shell. Si la máquina
remota es exampl e. co m y su nombre de usuario en esa máquina es john, teclee
ssh jo hn@ exampl e. co m.
El comando mo unt -o remo unt file-system remonta el sistema de archivo
llamado. Por ejemplo, para volver a montar el sistema de archivo /ho me, el comando
es mo unt -o remo unt /ho me.
Para ver la versión de un paquete actualmente instalado, utilice el comando rpm -q
paquete. Éste entregará el resultado siguiente: paquete-versión-lanzamiento.
Observe que las palabras resaltadas en itálicas — nombre de usuario, dominio.nombre, sistema de
archivo, paquete, versión y lanzamiento. Cada palabra es un marcador de posición, ya sea de texto
a ingresar cuando se ejecuta un comando o para un texto ejecutado por el sistema.
Aparte del uso estándar para presentar el título de un trabajo, las itálicas denotan el primer uso de
un término nuevo e importante. Por ejemplo:
Publican es un sistema de publicación de DocBook.
1.2. Convenciones del document o
Los mensajes de salida de la terminal o fragmentos de código fuente se distinguen visualmente del
texto circundante.
Los mensajes de salida enviados a una terminal se muestran en ro mano mo no espaci ad o y se
presentan así:
books
books_tests
Desktop
Desktop1
documentation drafts mss
downloads
images notes
photos
scripts
stuff
svgs
Los listados de código fuente también se muestran en ro mano mo no espaci ad o , pero se
presentan y resaltan de la siguiente manera:
​static int kvm_vm_ioctl_deassign_device(struct kvm *kvm,
​
struct kvm_assigned_pci_dev *assigned_dev)
​
{
​
int r = 0;
​
struct kvm_assigned_dev_kernel *match;
4
svn
Prefacio
​
mutex_lock(& kvm->lock);
​
match = kvm_find_assigned_dev(& kvm->arch.assigned_dev_head,
assigned_dev->assigned_dev_id);
if (!match) {
printk(KERN_INFO "%s: device hasn't been assigned
​
​
​
before, "
​
"so cannot be deassigned\n", __func__);
r = -EINVAL;
goto out;
​
​
​
}
​
kvm_deassign_device(kvm, match);
​
kvm_free_assigned_device(kvm, match);
​o ut:
​
mutex_unlock(& kvm->lock);
return r;
​
​}
1.3. Not as y Advert encias
Finalmente, utilizamos tres estilos visuales para llamar la atención sobre la información que de otro
modo se podría pasar por alto.
Nota
Una nota es una sugerencia, atajo o enfoque alternativo para una tarea determinada. Ignorar
una nota no debería tener consecuencias negativas, pero podría perderse de algunos trucos
que pueden facilitarle las cosas.
Importante
Los cuadros con el título de importante dan detalles de cosas que se pueden pasar por alto
fácilmente: cambios de configuración únicamente aplicables a la sesión actual, o servicios
que necesitan reiniciarse antes de que se aplique una actualización. Ignorar estos cuadros
no ocasionará pérdida de datos, pero puede causar enfado y frustración.
Aviso
Las advertencias no deben ignorarse. Ignorarlas muy probablemente ocasionará pérdida de
datos.
2. Cómo obt ener ayuda y hacer sus coment arios
2.1. ¿Necesit a ayuda?
5
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
Si encuentra dificultades con alguno de los procedimientos descritos en este documento, visite el
Portal del cliente de Red Hat en http://access.redhat.com. A través del portal del cliente, usted podrá:
buscar o navegar a través de la base de artículos de soporte técnico sobre productos de Red
Hat.
enviar un caso de soporte a Servicios de Soporte Global de Red Hat (GSS)
acceder a otra documentación del producto.
Red Hat alberga una lista grande de correos electrónicos para discutir sobre software de Red Hat y
tecnología. Encontrará un listado de las listas de correo disponibles al público en
https://www.redhat.com/mailman/listinfo. Haga clic en el nombre de la lista a la que quiera
suscribirse o para acceder a los archivos de listados.
2.2. ¡Necesit amos sus coment arios!
Si encuentra un error tipográfico en este manual o si ha pensado que hay alguna manera de
mejorar este manual, nos gustaría escuchar sus sugerencias. Por favor complete un reporte en
Bugzilla: http://bugzilla.redhat.com/ relacionando el producto Plat af o rma d e ap licacio n es
emp resariales JB o ss.
Cuando envíe un reporte de error no olvide mencionar el identificador' del manual: Installation_Guide
Si tiene alguna sugerencia para mejorar la documentación, trate de ser tan específico como sea
posible. Si ha encontrado algún error, por favor incluya el número de la sección y parte del texto
que lo rodea para que sea más fácil ubicarlo.
6
⁠Capít ulo 1 . Int roducción a la plat aforma de aplicaciones empresariales JBoss 6
Capítulo 1. Introducción a la plataforma de aplicaciones
empresariales JBoss 6
1.1. Int roducción a la plat aforma de aplicaciones empresariales JBoss
6
La plataforma de aplicaciones empresariales JBoss 6 es una plataforma middleware construída con
base en estándares libres y cumple con los requerimientos de Java EE. Integra el servidor de
aplicaciones JBoss con clústers de alta disponiblidad, mensajería poderosa,caché distribuído y
otras tecnologías para crear una plataforma estable, escalable y rápida. Además también incluye
APIs y marcos de trabajo que puede utilizar para desarrollar aplicaciones Java EE seguras,
poderosas y escalables de manera rápida.
Reportar un error
1.2. Funcionalidades nuevas y con cambios en la plat aforma de
aplicaciones empresariales JBoss 6
Error
Topic 229, Revision 340633 failed validation and is not included in this build.
7
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
Capítulo 2. Descarga de la plataforma de aplicaciones
empresariales JBoss 6
2.1. Sobre el port al del client e de Red Hat
El portal del cliente de Red Hat es un sitio web en donde los clientes de Red Hat descargan software
soportado oficialmente, administran sus derechos y contratos de soporte, pueden contactar los
servicios de soporte global y reportar errores frente a productos de Red Hat. La dirección para
acceder al portal del cliente es https://access.redhat.com.
Reportar un error
2.2. Descargas disponibles para la plat aforma de aplicaciones
empresariales JBoss 6
La plataforma de aplicaciones empresariales JBoss 6 incluye un número de tipos de instalación
diferentes y componentes opcionales, los cuales están disponibles para descargarlos en el portal
del cliente de Red Hat en https://access.redhat.com/. La siguiente tabla explica las diferentes
opciones. Algunos componentes sólo son apropiados para ciertos sistemas operativos o
arquitecturas y por lo tanto sólo están disponibles para esas variaciones específicas.
T ab la 2.1. D escarg as d isp o n ib les p ara la p lat af o rma d e ap licacio n es emp resariales
JB o ss 6
N o mb re
D escrip ció n
Sist emas o p erat ivo s
Servidor Apache HTTP
Una instancia del servidor
autónomo Apache HTTP para
cada sistema operativo
soportado y las arquitecturas.
Este servidor HTTP ha sido
probado y verificado para
trabajar con la plataforma de
aplicaciones empresariales
JBoss 6.
Los componentes se han
compilado para ser
optimizados para una
plataforma específica. Por
ejemplo, se proporcionan D LLs
para entornos del servidor
Microsoft Windows. En algunos
casos, los componentes
nativos pueden brindar
mejoras en el rendimiento.
Red Hat Enterprise Linux 5, Red
Hat Enterprise Linux 6,
Microsoft Windows Server
2008, Solaris 10 y 11
Componentes nativos
8
Red Hat Enterprise Linux 5, Red
Hat Enterprise Linux 6,
Microsoft Windows Server
2008, Solaris 10 y 11
⁠Capít ulo 2 . Descarga de la plat aforma de aplicaciones empresariales JBoss 6
N o mb re
D escrip ció n
Sist emas o p erat ivo s
Funcionalidades nativas
Funcionalidades especificas
para cada sistema operativo y
arquitectura soportadas tal
como scripts y funcionalidades
para instalar la plataforma de
aplicaciones empresariales
JBoss como un servicio en su
sistema operativo y generación
de llaves de encripción SSL y
certificados.
Módulos pre-compilados para
los servidores de red Apache,
Microsoft y Oracle iPlanet para
el balanceo de carga HTTP y
funcionalidades de alta
disponibilidad. Estos binarios
se prueban de manera
extensiva y se sabe que
funcionan bien con la
plataforma de aplicaciones
empresariales JBoss 6.
D ocumentación para todas las
APIs públicas expuestas por la
plataforma de aplicaciones
empresariales JBoss 6. Puede
instalarlos en su servidor local
HTTP o ID E o puede verlos en
su máquina local.
Instalador gráfico Java para la
plataforma de aplicaciones
empresariales JBoss 6
Un repositorio Maven, el cual
se puede descargar y hacerlo
disponible en su entorno de
desarrollo local y el cual
contiene objetos comunes para
las aplicaciones construídas
en la plataforma de
aplicaciones empresariales
JBoss 6.
Aplicaciones de ejemplo para
ayudarle a empezar a
desarrollar aplicaciones Java
EE 6 con APIs proporcionadas
con la plataforma de
aplicaciones empresariales
JBoss 6.
El código fuente Java para la
plataforma de aplicaciones
empresariales JBoss 6
proporcionado de manera que
pueda recompilarlo en su
propio entorno o auditarlo
usted mismo.
Red Hat Enterprise Linux 5, Red
Hat Enterprise Linux 6,
Microsoft Windows Server
2008, Solaris 10 y 11
Webserver Connector Natives
Javadocs
Instalador
Repositorio Maven
Inicios rápidos
Código fuente
Red Hat Enterprise Linux 5, Red
Hat Enterprise Linux 6,
Microsoft Windows Server
2008, Solaris 10 y 11
Independiente de la plataforma
Independiente de la plataforma
Independiente de la plataforma
Independiente de la plataforma
Independiente de la plataforma
9
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
N o mb re
D escrip ció n
Sist emas o p erat ivo s
Plataforma de aplicaciones
Un paquete de instalación Z IP,
el cual se puede instalar y
ejecutar en toda plataforma
soportada. Esta es la manera
más común de instalar la
plataforma de aplicaciones
empresariales JBoss 6.
Independiente de la plataforma
Importante
Las descargas del método de instalación RPM no están disponibles en el portal del cliente si
no por medio de Red Hat Network (RHN). Para instalar la plataforma de aplicaciones
empresariales JBoss 6 por medio de RPM consulte el siguiente tema: Sección 4.4, “ Instalación
de la plataforma de aplicaciones empresariales JBoss 6 usando Red Hat Network (instalación
RPM)”
Reportar un error
2.3. Descarga de la plat aforma de aplicaciones empresariales JBoss 6
1. Inicie sesión en el portal de servicios al cliente en https://access.redhat.com.
2. D el menú seleccione D o wn lo ad s → JB o ss En t erp rise Mid d leware → D o wn lo ad s.
3. Seleccione Appl i cati o n P l atfo rm del menú desplegable P ro d uct.
4. Ubique la versión apropiada de la plataforma de aplicaciones y haga clic en el enlace
D o wnl o ad .
5. D escargue los paquetes disponibles que necesite tal como los Quickstarts, el repositorio
Maven, los conectores HTTP o los binarios nativos.
R esu lt ad o
La plataforma de aplicaciones empresariales JBoss 6 y los archivos suplementarios que seleccionó
se descargan en su computador.
Reportar un error
10
⁠Capít ulo 3. Preparación para la inst alación de la plat aforma de aplicaciones empresariales JBoss 6
Capítulo 3. Preparación para la instalación de la plataforma de
aplicaciones empresariales JBoss 6
3.1. Prerrequisit os de inst alación para la plat aforma de aplicaciones
empresariales JBoss 6.
Antes de instalar la plataforma de aplicaciones empresariales JBoss 6 necesita cumplir con los
siguientes requerimientos:
Establezca una cuenta en el portal del cliente de Red Hat en https://access.redhat.com. Consulte
Sección 2.1, “ Sobre el portal del cliente de Red Hat”
Revise y asegúrese de que su computador usa una configuración soportada de acuerdo con
https://access.redhat.com/support/configurations/jboss/.
Reportar un error
3.2. Ent ornos Java soport ados por la plat aforma de aplicaciones
empresariales JBoss 6
La plataforma de aplicaciones empresariales requiere Java 6 o Java 7. La lista de entornos Java
soportados se puede ver en
http://www.jboss.com/products/platforms/application/supportedconfigurations/. Se requiere un kit de
desarrollo Java (JD K) para desarrollo y un entorno de ejecución Java (JRE) para poder ejecutar la
plataforma de aplicaciones empresariales JBoss.
Nota
Si está utilizando una instalación RPM necesita tener Java 6 JD K incluso si usa Java 7 JD K
para desarrollo.
Reportar un error
3.3. Inst alación de OpenJDK en Red Hat Ent erprise Linux
In t ro d u cció n
OpenJD K es uno de los muchos JD KS (del inglés Java D evelopment Kits) soportados en Red Hat
Enterprise Linux para uso con los productos empresariales JBoss. Esta tarea le muestra cómo
instalar OpenJD K en Red Hat Enterprise Linux y la manera de configurar su sistema para utilizarlo
como el JD K predeterminado.
Nota
Es posible el instalar múltiples JD Ks en un solo sistema.
Prerreq u isit o s d e la t area
11
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
D ebe cumplir con las siguientes condiciones antes de continuar con esta tarea:
D ebe estar ejecutando Red Hat Enterprise Linux 6. OpenJD K no está disponible ni soportado
para Red Hat Enterprise Linux 5 en este momento.
El servidor ejecutando Red Hat Enterprise Linux 6 se debe registrar con RHN y se debe suscribir
al canal base. Consulte la sección de administración de paquetes de Red Hat Enterprise Linux 6
Deployment Guide en https://access.redhat.com/knowledge/docs/ para obtener mayor información
sobre la administración de suscripciones y los derechos en los sistemas Red Hat Enterprise
Linux.
1. In st alació n d el R PM O p en JD K .
Hay dos maneras diferentes de instalar un RPM dependiendo de si ha utilizado una CLI (del
inglés command-line interface) o una GUI (del inglés Graphical User Interface).
A. D el C LI
D espués de iniciar sesión con derechos de administrador, ejecute uno de los siguientes
comandos:
O p en JD K 6
yum i nstal l java-1. 6 . 0 -o penjd k-d evel
O p en JD K 7
yum i nstal l java-1. 7. 0 -o penjd k-d evel
B. D esd e G U I
a. En Gnome seleccione Ad mi ni strati o n del menú System y haga clic en Ad d /
R emo ve So ftware.
b. Busque o penjd k y seleccione la opción java-1. 6 . 0 -o penjd k-d evel para
OpenJD K 6 o la opción java-1. 7. 0 -o penjd k-d evel para OpenJD K 7.
c. Haga clic en Appl y para instalar los paquetes seleccionados y las
dependencias.
d. Cuando se le pida ingrese la contraseña del administrador para instalar los
paquetes.
2. O p cio n al: Est ab ez ca la variab le d e en t o rn o JAVA_HO ME.
Algunas aplicaciones tal como Apache Maven y Apache Ant requieren que establezca la
variable de entorno JAVA_HO ME. Si necesita hacer esto entonces siga los siguientes pasos.
a. D etermine el valor correcto para JAVA_HO ME. Red Hat Enterprise Linux instala
OpenJD K 1.6 en /usr/l i b/jvm/java-1. 6 . 0 -o penjd k-1. 6 . 0 . 0 / o
/usr/l i b/jvm/java-1. 6 . 0 -o penjd k-1. 6 . 0 . 0 . x86 _6 4 / dependiendo de si
su sistema es una arquitectura de 32-bits o 64-bits. El JAVA_HO ME debe apuntar al
directorio que contiene un ejecutable bi n/java.
b. Abra el archivo de configuración shell como el usuario que utilizará OpenJD K. Para
la shell bash este archivo es /ho me/username/. bashrc.
12
⁠Capít ulo 3. Preparación para la inst alación de la plat aforma de aplicaciones empresariales JBoss 6
c. Al final del archivo escriba la siguiente línea reemplazando la ruta hipotética con la
ruta real a utilizar en su propio sistema: expo rt
JAVA_HO ME= "/path/to/java/home"
d. Guarde el archivo, cierre la sesión e inicie sesión de nuevo.
3. C amb ie en t re d if eren t es versio n es O p en JD K u san d o la f u n cio n alid ad
al ternati ves.
Red Hat Enterprise Linux incluye una funcionalidad llamada al ternati ves, la cual le
permite cambiar la versión predeterminada para las aplicaciones, lo cual permite instalar
múltiples versiones. OpenJD K es una de dichas aplicaciones.
Para usar la funcionalidad al ternati ves realice los siguientes pasos. Note que el
establecer las variables de entorno sobreescribe el comportamiento del comando
al ternati ves. Por ejemplo, si usa un script, el cual establece manualmente las variables
$JAVA_HO ME y $JAVA a un JD K diferente del especificado por el comando al ternati ves,
las variables de entorno sobreescribirán el comando.
Inicie sesión como el usuario ro o t o anteceda los comandos a continuación con el
comando sud o .
El comando al ternati ves no se instala por defecto pero es posible que ya esté
instalado en su sistema. Si no instale el paquete al ternati ves ejecutando el siguiente
comando:
yum install alternatives
Emita el siguiente comando:
/usr/sbin/alternatives --config java
Siga las siguientes indicaciones para establecer la versión predeterminada de OpenJD K.
R esu lt ad o :
Se instala OpenJD K en su servidor y está disponible para utilizarlo. Si es necesario, la variable de
entorno JAVA_HO ME se ha especificado también. Si es necesario se ha establecido el OpenJD K
predeterminado para su sistema utilizando la funcionalidad al ternati ves.
Reportar un error
13
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
Capítulo 4. Instalación de la plataforma de aplicaciones
empresariales JBoss 6
4 .1. Mét odos de inst alación para la plat aforma de aplicaciones
empresariales JBoss 6.
Las opciones de instalación para la plataforma de aplicaciones empresariales JBoss incluyen un
repositorio RPM, un instalador JAR o la extracción de un archivo Z IP.
Puede utilizar el instalador RPM si tiene un sistema operativo compatible o el archivo zip si desea
extraer el servidor manualmente. El archivo del instalador está disponible para ayudar a nuevos
usuarios en el proceso de configuración y arranque, el cual también crea un script de instalación
XML para automatizar el proceso de instalación para otras o futuras instalaciones.
Reportar un error
4 .2. Inst alar la plat aforma de aplicaciones empresariales JBoss 6
usando el mét odo del inst alador
R esu men
El instalador de la plataforma de aplicaciones empresariales JBoss 6 ofrece múltiples métodos para
la instalación. Seleccione el modo de instalación de la interfaz gráfica del usuario o la interfaz de la
línea de comandos. Un modo de instalación automático le permite generar un archivo XML de su
configuración de instalación seleccionada para ayudarle en instalaciones futuras.
Prereq u isit o s
Sección 2.3, “ D escarga de la plataforma de aplicaciones empresariales JBoss 6 ”
Pro ced imien t o 4 .1. T area
In st alació n d e la p lat af o rma d e ap licacio n es emp resariales JB o ss 6
Seleccione su preferencia de instalación.
A. In st alació n G U I
a. Lance el instalador GUI con el siguiente comando Java.
java -jar jbo ss-eap-6 . 0 . 0 -i nstal l er. jar
b. Siga las indicaciones de la instalación. Al final de la instalación se puede generar un
archivo XML de la instalación para uso futuro con la funcionalidad de instalación
automática.
B. In st alació n d e la co n so la
a. Lance el instalador de la consola con el siguiente comando Java.
java -jar jbo ss-eap-6 . 0 . 0 -i nstal l er. jar -co nso l e
14
⁠Capít ulo 4 . Inst alación de la plat aforma de aplicaciones empresariales JBoss 6
b. Siga las indicaciones de la instalación. Al final de la instalación se puede generar un
archivo XML de la instalación para uso futuro con la funcionalidad de instalación
automática.
C. In st alació n au t o mát ica
a. Si creó una instancia de la instalación anteriormente entonces tendrá un script XML de
instalación automática. Puede utilizar este archivo para ejecutar la opción de
instalación automática.
b. Lance el instalador automático con el siguiente comando Java.
java -jar jbo ss-eap-6 . 0 . 0 -i nstal l er. jar NameOfXML.xml
c. La instalación se completará de acuerdo con los valores en el archivo XML.
R esu lt ad o
La instalación está completa.
Reportar un error
4 .3. Inst alación de la plat aforma de aplicaciones empresariales JBoss
6 usando la descarga ZIP
R esu men
El método de instalación del archivo zip es apropiado para todos los sistemas operativos
soportados.
Prereq u isit o s
Antes de instalar la plataforma de aplicaciones empresariales JBoss 6 necesita descargar el
archivador zip del portal de servicio al cliente de Red Hat.
Pro ced imien t o 4 .2. T area
1. Mu eva el arch ivad o r z ip a la u b icació n d esead a.
Mueva el archivo zip al servidor y al directorio en donde quiere instalar la plataforma de
aplicaciones empresariales JBoss 6. El directorio debe ser accesible para el usuario que
iniciará y detendrá la plataforma.
2. U se u n a ap licació n ap ro p iad a p ara ext raer el f ich ero z ip .
En Linux, el comando para extraer un fichero zip usualmente se llama unzi p. En un entorno
Microsoft Windows haga clic con el botón derecho del ratón en el archivo y seleccione
Extract Al l .
R esu lt ad o
El directorio creado extrayendo el archivador zip es el directorio a nivel superior para la platforma
de aplicaciones empresariales JBoss 6. Usualmente se conoce como EAP_HOME. Si alguna vez
decide mover su instalación, puede mover este directorio a otro directorio u otro servidor.
Reportar un error
15
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
4 .4 . Inst alación de la plat aforma de aplicaciones empresariales JBoss
6 usando Red Hat Net work (inst alación RPM)
R esu men
El metodo del paquete RPM de instalación de la plataforma de aplicaciones empresariales JBoss 6
es apropiada para Red Hat Enterprise Linux 6. El método de instalación recomendado es utilizar
Red Hat Network (RHN) para administrar sus suscripciones de servidores y canales.
Importante
El paquete jbo ssas-ho rnetq -nati ve se incluye para brindar alta disponibilidad en la
plataforma de aplicaciones empresariales JBoss 6 y no se activa por defecto.
Prereq u isit o s
Para instalar la plataforma de aplicaciones empresariales JBoss 6 usando Red Hat Network, el
servidor del host debe cumplir con los siguientes requerimientos:
El servidor debe estar registrado en Red Hat Network.
El servidor debe estar suscrito al cananl de software base R ed Hat Enterpri se Li nux
Server (v. 6 ).
El servidor debe estar suscrito al sub-canal JBo ss Appl i cati o n P l atfo rm (v 6 ) fo r
6 Server x86 _6 4 . El sub-canal está en el grupo Ad d i ti o nal Servi ces C hannel s fo r
R ed Hat Enterpri se Li nux 6 fo r x86 _6 4 .
Se debe instalar un Java 6 JD K. Si desea utilizar un Java 7 JD K es necesario instalar ambas
versiones. Para configurar el JD K que su sistema utiliza por defecto, ejecute el siguiente
comando con privilegios del super-usuario:
[root@ host /root]# al ternati ves --co nfi g java
Se presenta un signo (+) al lado del valor predeterminado actual. Siga las instrucciones en la
pantalla para relizar cambios o presione Enter para mantener la selección actual.
16
⁠Capít ulo 4 . Inst alación de la plat aforma de aplicaciones empresariales JBoss 6
Fig u ra 4 .1. U n sist ema co n f ig u rad o p ara la in st alació n d e R H N id e la p lat af o rma d e
ap licacio n es emp resariales JB o ss 6
Pro ced imien t o 4 .3. T area
Acceso e instalación del paquete RPM usando la instalación YUM por medio de Red Hat Network.
1. In st alació n d el p aq u et e R PM u san d o YU M y R ed H at N et wo rk.
Use YUM para instalar el paquete del grupo predeterminado de la plataforma de
aplicaciones empresariales JBoss 6 usando el comando g ro upi nstal l .
[user@ host ~]$ yum groupinstall jboss-eap6
2. C o n f ig u ració n d e las o p cio n es d e in icio .
La instalación RPM contiene scripts de inicialización para lanzar el servidor. La
configuración para estos scripts se encuentra en varios archivos adicionales. Consulte
Sección 4.5, “ Archivos de configuración de instalación RPM” para obtener los detalles sobre
estos archivos y las opciones en ellos.
R esu lt ad o
17
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
La instalación está completa. Consulte Sección A.1, “ Lista de paquetes RPM y dependencias” para
ver una lista completa de todos los paquetes instalados.
Reportar un error
4 .5. Archivos de configuración de inst alación RPM
La instalación RPM de la plataforma de aplicaciones empresariales JBoss 6 incluye tres archivos de
configuración adicionales que el script de inicio de servicios utiliza para especificar el entorno para
lanzar el servidor de aplicaciones. Uno de estos archivos aplica a todas las instancias de la
plataforma de aplicaciones empresariales JBoss 6 , los otros dos brindan sobreescrituras para
servidores autónomos y de dominio.
T ab la 4 .1. Arch ivo s d e co n f ig u ració n d e in st alació n R PM
Arch ivo
D escrip ció n
El archivo se lee primero y aplica a todas las instancias de la
plataforma de aplicaciones empresariales JBoss.
Configuración específica para los servidores autónomos. Los
valores especificados aquí sobreescribirán los que se
encuentren en jbossas.conf al ejecutar como un servidor
autónomo.
/etc/sysco nfi g /jbo ssas- Configuración específica para los servidores de modo de
d o mai n
dominio. Los valores especificados aquí sobreescribirán los que
se encuentren en jbossas.conf al ejecutar como un servidor de
modo de dominio.
/etc/jbo ssas/jbo ssas. co
nf
/etc/sysco nfi g /jbo ssas
T ab la 4 .2. Pro p ied ad es d e co n f ig u ració n d e in st alació n R PM
Pro p ied ad
D escrip ció n
JBO SS_USER
La cuenta del usuario del sistema en la que ejecuta la plataforma de
aplicaciones empresariales JBoss 6. Este usuario también es propietario
de los archivos.
Valor predeterminado: jbo ss.
JBO SS_G R O UP
El grupo de usuarios del sistema al cual pertenece la plataforma de
aplicaciones empresariales JBoss 6.
Valor predeterminado: jbo ss
JBO SS_ST AR T _WAIT
El número de segundos que el script de arranque esperará hasta
confirmar que el servidor se haya lanzado exitosamente después de
recibir una comando start o restart.
Valor predeterminado: 6 0
JBO SS_SHUT D O WN_W
AIT
El número de segundos que el script de arranque esperará para que el
servidor se apague antes de continuar cuando recibe un comando sto p
o restart.
Valor predeterminado: 20
18
⁠Capít ulo 4 . Inst alación de la plat aforma de aplicaciones empresariales JBoss 6
Pro p ied ad
D escrip ció n
JBO SS_C O NSO LE_LO
G
El archivo al que se redireccionará el manejador de registros CONSOLE.
JAVA_HO ME
El directorio en donde se instala el entorno de ejecución Java.
Valor predeterminado:
/var/l o g /jbo ssas/$JBOSSCONF/co nso l e. l o g
Valor predeterminado: /usr/l i b/jvm/jre
JBO SS_HO ME
El directorio en donde se instalan los archivos del servidor de
aplicaciones.
Valor predeterminado: /usr/share/jbo ssas
JAVAP T H
La ruta en donde se instalan los archivos ejecutables Java.
Valor predeterminado: $JAVA_HOME/bi n
JBO SSC O NF
El modo del servidor para lanzar este servidor en stand al o ne o
d o mai n.
Valor predeterminado: stand al o ne or d o mai n dependiendo del modo
del servidor.
JBO SSSH
El script que se utilizó para iniciar en el servidor.
Valor predeterminado: $JBO SS_HO ME/bi n/$JBO SSC O NF. sh
JBO SS_SER VER _C O N
FIG
El archivo de configuración del servidor a utilizar.
Valor predeterminado: Servidores autónomos stand al o ne. xml o
d o mai n. xml o de dominio
Reportar un error
4 .6. Est ruct ura de inst alación y det alles
La plataforma de aplicaciones empresariales JBoss 6 incluye una estructura de directorio
simplificada comparada con versiones anteriores. A continuación encontrará un listado de la
estructura del directorio y una descripción de lo que el directorio contiene.
T ab la 4 .3. Arch ivo s y d irect o rio s a n ivel su p erio r
N o mb re
Pro p ó sit o
appclient/
Contiene los detalles de configuración para el
contenedor del cliente de la aplicación.
Contiene los scripts de arranque para la
plataforma de aplicaciones empresariales
JBoss 6 en Red Hat Enterprise Linux y Microsoft
Windows.
Contiene grupos OSGi, los cuales pertenecen a
la funcionalidad interna de la plataforma de
aplicaciones empresariales JBoss 6.
bin/
bundles/
19
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
N o mb re
Pro p ó sit o
docs/
Archivos de licencia, archivos, esquemas y
ejemplos.
Los archivos de configuración, el contenido de
la implementación y las áreas de escritura
utilizadas cuando la plataforma de
aplicaciones empresariales ejecuta como un
dominio administrado.
Los módulos que la plataforma de aplicaciones
empresariales JBoss 6 carga de manera
dinámica cuando los servicios los requieren.
Los archivos de configuración, el contenido de
implementación y las áreas de escritura
utilizadas cuando la plataforma de
aplicaciones empresariales JBoss 6 ejecuta
como servidor autónomo.
Tiene contenido que la aplicación web de
bienvenida utiliza, la cual está disponible en el
puerto 8080 de una instalación
predeterminada.
El mecanismo bootstrap que carga los módulos.
domain/
modules/
standalone/
welcome-content/
jbo ss-mo d ul es. jar
T ab la 4 .4 . D irect o rio s d en t ro d el d irect o rio d o mai n/
N o mb re
Pro p ó sit o
configuration/
Los archivos de configuración para el dominio
administrado. Estos archivos se modifican por
medio de la consola de administración y el CLI
de administración y no se debe modificar
directamente.
Información sobre los servicios implementados.
Los servicios se implementan usando la
consola de administración y el CLI de
administración en lugar de un escaner de
implementación. Por lo tanto no ponga archivos
en este directorio manualmente.
Contiene los archivos de registro del tiempo de
ejecución para el host y los controladores de
procesos, los cuales ejecutan en la instancia
local.
Contiene los directorios d ata/, l o g / y tmp/
equivalentes para cada instancia del servidor
en un dominio, el cual contiene datos similares
a los mismos directorios dentro del nivel
superior del directorio d o mai n/.
Contiene datos temporales tales como archivos
que pertenecen al mecanismo de clave
compartida que el CLI de administración utiliza
para autenticar a los usuarios locales en el
dominio administrado.
data/
log/
servers/
tmp/
T ab la 4 .5. D irect o rio s d en t ro d el d irect o rio stand al o ne/
20
⁠Capít ulo 4 . Inst alación de la plat aforma de aplicaciones empresariales JBoss 6
N o mb re
Pro p ó sit o
configuration/
Los archivos de configuración para el servidor
autónomo. Estos archivos se modifican por
medio de la consola de administración y el CLI
de administración y no se debe modificar
directamente.
Información sobre los servicios implementados.
El servidor autónomo incluye un escaner de
implementación de manera que pueda poner los
archivadores en este directorio a implementarse.
Sin embargo, el enfoque que se recomienda es
administrar las implementaciones usando la
consola de administración o CLI de
administración.
Bibliotecas externas, las cuales pertenecen al
modo del servidor autónomo. Vacío por defecto.
Contiene datos temporales tales como los
archivos que pertenecen al mecanismo de clave
compartida que el CLI de administración utiliza
para autenticar a los usuarios locales en el
servidor.
deployments/
lib/
tmp/
Reportar un error
21
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
Capítulo 5. Upgrading JBoss Enterprise Application Platform 6
5.1. Act ualiz ación de la inst alación ZIP de la plat aforma de
aplicaciones empresariales JBoss 6
R esu men
La actualización de la plataforma de aplicaciones empresariales JBoss 6.0.1 requiere realizar una
copia de seguridad de la instalación 6.0.0 ya existente. Este tema aborda la actualización de la
instalación Z IP.
Prereq u isit o s
Asegúrese de que el sistema operativo base esté actualizado.
D etermine los archivos que han sido modificados desde que se instaló EAP 6.0.0.
Realice una copia de seguridad de los archivos de configuración modificados, las
implementaciones y todos los datos del usuario.
Sección 2.3, “ D escarga de la plataforma de aplicaciones empresariales JBoss 6 ” .
Aviso
Para los dominios administrados primero se debe actualizar la instancia del controlador host
maestro (o controlador de dominio) antes de actualizar cada controlador host.
Pro ced imien t o 5.1. Act u aliz ació n a la p lat af o rma d e ap licacio n es emp resariales JB o ss
6 .0.1
1. Mueva el archivador zip 6.0.1 a la ubicación deseada. Se recomienda que sea una
ubicación diferente a la de la instalación de la plataforma de aplicaciones empresariales
JBoss 6.0.0.
Importante
Si desea instalar la plataforma de aplicación empresariales JBoss 6.0.1 en el mismo
directorio que 6.0.0, necesitará mover la instalación existente antes de proceder. Esto
previene la pérdida de los archivos de configuración modificados, las
implementaciones y actualizaciones de 6.0.0 a 6.0.1.
2. D escomprima el archivador. Este paso instala una instancia limpia de la plataforma de
aplicaciones empresariales JBoss 6.0.1.
3. Copie los directorios EAP_HOME/d o mai n/ y EAP_HOME/stand al o ne/ de la instalación
6.0.0 a los directorios 6.0.1.
4. Revise los cambios realizados al directorio bi n de la instalación 6.0.0 y realice las
modificaciones equivalentes al directorio 6.0.1.
22
⁠Capít ulo 5. Upgrading JBoss Ent erprise Applicat ion Plat form 6
Aviso
Los archivos en el directorio bi n 6.0.1 no deben ser sobreescritos por los archivos de
6.0.0. Los cambios se deben realizar manualmente.
5. Revise los archivos modificados que quedan de la instalación 6.0.0 y mueva estos cambios
a la instalación 6.0.1. Estos archivos pueden incluir:
El directorio wel co me-co ntent.
Módulos personalizados en el diretcorio mo d ul es.
Paquetes personalizados en el directorio bund l es.
R esu lt ad o
La instalación zip de la plataforma de aplicaciones empresariales JBoss 6 se actualizó
exitosamente al lanzamiento 6.0.1.
Reportar un error
5.2. Act ualiz ación de la inst alación RPM de la plat aforma de
aplicaciones empresariales JBoss 6
R esu men
La actualización de la plataforma de aplicaciones empresariales JBoss 6.0.1 requiere realizar una
copia de seguridad de la instalación 6.0.0 ya existente. Este tema aborda la actualización de la
instalación por medio de Red Hat Network (RHN).
Prereq u isit o s
Asegúrese de que el sistema operativo base esté actualizado.
Asegúrese de que el canal RHN jbo ss-eap6 esté habilitado.
Realice una copia de seguridad de los archivos de configuración modificados, las
implementaciones y todos los datos del usuario.
Aviso
Para los dominios administrados primero se debe actualizar la instancia del controlador host
maestro (o controlador de dominio) antes de actualizar cada controlador host.
Pro ced imien t o 5.2. Act u aliz ació n a la p lat af o rma d e ap licacio n es emp resariales JB o ss
6 .0.1
1. Ejecute el siguiente comando en una terminal para actualizar la instalación:
[user@ host] yum update
23
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
2. Fusione manualmente cada archivo *. rpmnew creado que contenga cambios en los
archivos de configuración de producción.
R esu lt ad o
La plataforma de aplicaciones empresariales JBoss 6 se actualizó exitosamente al lanzamiento
6.0.1.
Reportar un error
24
⁠Capít ulo 6 . Ejecución de la plat aforma de aplicaciones empresariales JBoss 6 como un servicio
Capítulo 6. Ejecución de la plataforma de aplicaciones
empresariales JBoss 6 como un servicio
6.1. Ejecut e la plat aforma de aplicaciones empresariales JBoss 6
como un servicio del sist ema operat ivo
La plataforma de aplicaciones empresariales JBoss 6 se puede configurar para que ejecute como
un servicio, permitiéndole iniciar un dominio administrado o una configuración del servidor
autónomo en el tiempo de ejecución del sistema y permitiéndole a la instancia del servidor el
continuar ejecutando cuando termine la sesión de su sistema local.
Sección 6.2, “ Instalación de la plataforma de aplicaciones empresariales JBoss como un
servicio en Red Hat Enterprise Linux”
Sección 6.3, “ Instalación de la plataforma de aplicaciones empresariales JBoss 6 como un
servicio en Microsoft Windows”
Reportar un error
6.2. Inst alación de la plat aforma de aplicaciones empresariales JBoss
como un servicio en Red Hat Ent erprise Linux
R esu men
Use el siguiente procedimiento para instalar la plataforma de aplicaciones empresariales JBoss 6
como un servicio en Red Hat Enterprise Linux
Prereq u isit o s
Necesita acceso de administrador para poder completar esta tarea.
Pro ced imien t o 6 .1. T area
1. C o p ie el scrip t d e arran q u e en el d irect o rio /etc/i ni t. d /
El script de arranque y un archivo de configuración asociado se encuentran en el directorio
EAP_HOME/bi n/i ni t. d /. Copie cada uno de estos archivos en el directorio
/etc/i ni t. d /.
[user@ ho st i ni t. d ]$ sud o cp jbo ss-as-stand al o ne. sh jbo ss-as. co nf
/etc/i ni t. d
2. Ag reg u e el scrip t d e arran q u e co mo servicio .
Agregue el nuevo servicio jbo ss-as-stand al o ne. sh a la lista de servicios iniciados
automáticamente usando el comando de administración del servicio chkco nfi g .
[user@ ho st i ni t. d ]$ sud o chkco nfi g --ad d jbo ss-as-stand al o ne. sh
3. Mo d if iq u e las o p cio n es d el scrip t .
Si desea modifique el archivo jbo ss-as. co nf para personalizar las opciones de arranque
25
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
para la plataforma de aplicaciones empresariales JBoss y la MVJ. Use los comentarios en el
archivo como guía. Se recomienda establecer la variable JBO SS_HO ME en este archivo para
apuntar al directorio en donde extrajo la plataforma de aplicaciones empresariales JBoss 6.
No agregue una barra oblicua (/) al final del nombre del directorio.
4. Mo d if iq u e el scrip t mismo .
Puede que sea necesario el modificar el script de arranque mismo. Realiza ciertas
suposisciones sobre el nombre de su archivo de arranque y la ubicación de su instancia de
la plataforma de aplicaciones empresariales JBoss. Personalice el script poniendo atención
especial a las siguientes variables, las cuales necesitará personalizar para iniciar la
plataforma de aplicaciones empresariales JBoss 6 como un dominio administrado.
JBO SS_HO ME - la ubicación en donde se extrae la plataforma de aplicaciones
empresariales JBoss 6
JBO SS_USER - el usuario con la habilidad de ejecutar la plataforma de aplicaciones
empresariales JBoss. Este debe ser un usuario no-privilegiado ya que no se requieren
privilegios de superusuario.
JBO SS_C O NFIG - el nombre del archivo de configuración utilizado para iniciar la
plataforma de aplicaciones empresariales JBoss 6 tal como d o mai n. xml o
stand al o ne. xml
JBO SS_SC R IP T - el script utilizado para iniciar la plataforma de aplicaciones
empresariales JBoss 6 tal como d o mai n. sh o stand al o ne. sh
5. In icie el servicio .
Si desea, inicie el nuevo servicio usando la sintaxis estándar para iniciar los servicios de
Red Hat Enterprise Linux.
[user@ ho st bi n]$ sud o servi ce jbo ss-as-stand al o ne. sh start
R esu lt ad o
La plataforma de aplicaciones empresariales JBoss 6 inicia de manera automática cuando Red Hat
Enterprise Linux llega a su nivel de ejecución predeterminado y se detiene automáticamente cuando
el sistema operativo lleva acabo su rutina de apagado.
Reportar un error
6.3. Inst alación de la plat aforma de aplicaciones empresariales JBoss
6 como un servicio en Microsoft Windows
R esu men
Esta tarea instala la plataforma de aplicaciones empresariales JBoss 6 como un servicio en
Microsoft Windows
Prereq u isit o s
Necesita acceso de administrador para poder completar esta tarea.
Pro ced imien t o 6 .2. T area
26
⁠Capít ulo 6 . Ejecución de la plat aforma de aplicaciones empresariales JBoss 6 como un servicio
1. D escarg ar el p aq u et e d e f u n cio n alid ad es n at ivas p ara su arq u it ect u ra.
Los paquetes de 32-bits, 64-bits y 64-bits Itanium están disponibles en el portal del cliente de
Red Hat en https://access.redhat.com. Para mayor información sobre la descarga de software
del portal del cliente de Red Hat consulte JBoss Enterprise Application Platform 6 Installation
Guide disponible aquí:
https://access.redhat.com/knowledge/docs/JBoss_Enterprise_Application_Platform/.
2. D esco mp rima el arch ivad o r d escarg ad o .
D escomprima el archivador en una nueva carpeta.
R esu lt ad o : Se crea el arch ivo mo d ul es\nati ve\bi n\.
La carpeta mo d ul es\nati ve\bi n\ contiene los archivos que necesita instalar en la
plataforma de aplicaciones empresariales JBoss 6 como servicio. Estos servicios son parte
de Procrun, el cual es una serie de scripts de envoltura que Apache Commons proporciona.
Para aprender un poco más sobre Procrun y su sintaxis, consulte el siguiente enlace:
http://commons.apache.org/daemon/procrun.html.
3. Ejecu t e mo d ul es\sbi n\prunsrv. exe.
prunsrv. exe i nstal l path_to_startup_script
R esu lt ad o
El servicio se instala. La plataforma de aplicaciones empresariales JBoss 6 está listada en el
applet de servicios servi ces. msc.
4. Ad min ist ració n d e su servicio .
Use el ejecutable mo d ul es\bi n\prunmg r. exe para administrar, modificar, agregar o
borrar servicios. Se soportan las siguientes opciones de la línea de comandos:
ejecutar
servicio
iniciar
detener
actualizar
instalar
borrar
pausar [segundos]
versión
ayuda
L sintaxis general es:
prunmgr.exe commandservice_name
27
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
R esu lt ad o
Puede utilizar el comando net servi ce en la línea de comandos o el applet servi ces. msc para
detener, iniciar y administrar el arranque automático de la plataforma de aplicaciones empresariales
JBoss 6 en el servidor de Microsoft Windows.
Reportar un error
28
⁠Capít ulo 7 . Inicio con la plat aforma de aplicaciones empresariales JBoss 6
Capítulo 7. Inicio con la plataforma de aplicaciones
empresariales JBoss 6
7.1. Agregar el usuario inicial para las int erfaces de administ ración
Visió n G en eral
Las interfaces de administración en la plataforma de aplicaciones empresariales JBoss 6 están
aseguradas por defecto y no hay un usuario predeterminado. Esta es una precaución de seguridad
con el fin de prevenir violaciones de seguridad de sistemas remotos debido a simples errores de
configuración. El acceso local que no es HTTP se protege por medio de un mecanismo SASL con
una negociación entre el cliente y el servidor cada vez que el cliente se conecta la primera vez desde
el host local.
Esta tarea describe la manera de crear el usuario administrativo inicial, el cual puede utilizar la
consola de administración basada en la web y las instancias remotas del CLI de administración
para configurar y administrar la plataforma de aplicaciones empresariales JBoss 6 desde sistemas
remotos. Para obtener mayor información sobre la configuración predeterminada de la seguridad
consulte Sección 7.8, “ Configuración predeterminada de seguridad del usuario” .
Nota
La comunicación HTTP con la plataforma de aplicaciones empresariales JBoss 6 se
considera como acceso remoto incluso si el tráfico se origina en el host local. Por lo tanto,
debe crear por lo menos un usuario on el fin de poder utilizar la consola de administración.
Si trata de acceder la consola de administración antes de agregar un usuario recibirá un
error ya que no se implementa hasta que se agrega el usuario.
Pro ced imien t o 7.1. T area
1. In vo q u e el scrip t ad d -user. sh o ad d -user. bat.
Cambie al directorio EAP_HOME/bi n/. Invoque el script apropiado para su sistema
operativo.
R ed H at En t erp rise Lin u x
[user@ ho st bi n]$ ./add-user.sh
Servid o r d e Micro so f t Win d o ws
C : \bi n>
add-user.bat
2. Seleccio n e el ag reg ar u n u su ario d e ad min ist ració n .
Seleccione la opción a para agregar un usuario de administración. Este usuario se agrega
al Manag ementR eal m y está autorizado para realizar operaciones de administración
utilizando la consola de administración basada en la red o el CLI de administración basado
en la línea de comandos. La otra opción, b, agrega un usuario al Appl i cati o nR eal m y no
propociona permisos particulares. Ese dominio se proporciona para utilización con
aplicaciones.
29
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
3. Seleccio n e el d o min io p ara el u su ario .
El siguiente punto se refiere al dominio en donde se agregará el usuario. Para un usuario
con permisos para administrar la plataforma de aplicaciones empresariales JBoss 6,
seleccione el predeterminado, el cual es Manag ementR eal m.
4. In g rese el n o mb re d e u su ario y la co n t raseñ a.
Cuando se le pida, ingrese el dominio de seguridad, el nombre de usuario y la contraseña.
Al presionar ENT ER selecciona el dominio predeterminado del Manag ementR eal m, el cual le
permite al usuario el administrar la plataforma de aplicaciones empresariales JBoss 6
usando las interfaces de administración. D ebe agregar por lo menos un usuario a este
dominio. Se le pide que confirme la información. Si le parece todo bien escriba yes .
5. Seleccio n e si el u su ario rep resen t a u n a in st an cia d el servid o r d e la p lat af o rma
d e ap licacio n es emp resariales JB o ss 6 .
Además de los administradores, el otro tipo de usuario que ocasionalmente es necesario
agregar a la plataforma de aplicaciones empresariales JBoss 6 en el Manag ementR eal m es
un usuario representando otra instancia de la plataforma de aplicaciones empresariales
JBoss 6, la cual debe tener la habilidad de autenticar con el fin de unirse a un clúster como
miembro. A continuación se le permite que designe a su usuario agregado para este
propósito. Si selecciona yes, se le proporcionará un valor secret que representa la
contraseña del usuario, lo cual sería necesario agregar a un archivo diferente. Para esta
tarea en específico seleccione no .
6. In g rese lo s u su ario s ad icio n ales.
Si desea puede ingresar usuarios adicionales repitiendo el procedimiento. También puede
agregarlos en cualquier momento en un sistema en ejecución. En lugar de seleccionar el
dominio de seguridad predeterminado, puede agregar usuarios a otros dominios para afinar
sus autorizaciones.
7. C ree u su ario s d e man era n o in t eract iva.
Puede crear usuarios de manera no interactiva pasando cada parámetro en la línea de
comandos. Este enfoque no se recomienda en sistemas compartidos ya que las contraseñas
serán visibles en los archivos de registro y del historial. La sintaxis para el comando usando
el dominio de administración es:
[user@ ho st bi n]$ ./add-user.sh username password
Para utilizar el dominio de la aplicación use el parámetro -a.
[user@ ho st bi n]$ ./add-user.sh -a username password
R esu lt ad o
Cualquier usuario que agregue se activa dentro de los dominios de seguridad que haya
especificado. Los usuarios activos dentro del dominio Manag ementR eal m pueden administrar la
plataforma de aplicaciones empresariales JBoss 6 desde sistemas remotos.
Reportar un error
7.2. Iniciar la plat aforma de aplicaciones empresariales JBoss 6
30
⁠Capít ulo 7 . Inicio con la plat aforma de aplicaciones empresariales JBoss 6
T area
Inicie la plataforma de aplicaciones empresariales JBoss 6 de una de las siguientes maneras:
Sección 7.3, “ Inicie la plataforma de aplicaciones empresariales JBoss 6 como un dominio
administrado”
Sección 7.4, “ Inicie la plataforma de aplicaciones empresariales JBoss 6 como un servidor
autónomo”
Sección 6.1, “ Ejecute la plataforma de aplicaciones empresariales JBoss 6 como un servicio del
sistema operativo”
Reportar un error
7.3. Inicie la plat aforma de aplicaciones empresariales JBoss 6 como
un dominio administ rado
R ed H at En t erp rise Lin u x.
Ejecute el comando: EAP_HOME/bi n/d o mai n. sh
Servid o r Micro so f t Win d o ws.
Ejecute el comando: EAP_HOME\bi n\d o mai n. bat
O p cio n al: Pase lo s p arámet ro s ad icio n ales p ara el scrip t d e arran q u e
Para ver una lista de los parámetros que puede pasarle al script
de arranque use el parámetro -h.
R esu lt ad o
La instancia del dominio administrado de la plataforma de aplicaciones empresariales JBoss 6
inicia.
Reportar un error
7.4 . Inicie la plat aforma de aplicaciones empresariales JBoss 6 como
un servidor aut ónomo
R ed H at En t erp rise Lin u x.
Ejecute el comando: EAP_HOME/bi n/stand al o ne. sh
Servid o r Micro so f t Win d o ws.
Ejecute el comando: EAP_HOME\bi n\stand al o ne. bat
O p cio n al: Esp ecif iq u e lo s p arámet ro s ad icio n ales.
31
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
Para imprimir una lista de los parámetros adicionales que puede
pasarle a los scripts de arranque use el parámetro -h.
R esu lt ad o
La instancia del servidor autónomo de la plataforma de aplicaciones empresariales JBoss 6 inicia.
Reportar un error
7.5. Probar la inst alación
Prerreq u isit o s d e la t area
Sección 7.2, “ Iniciar la plataforma de aplicaciones empresariales JBoss 6”
Los puertos de red necesarios se deben abrir. Consulte Sección 7.6, “ Puertos de red que la
plataforma de aplicaciones empresariales JBoss 6 utiliza” y Sección 7.7, “ Configuración de los
cortafuegos de red para que funcionen con la plataforma de aplicaciones empresariales JBoss
6” .
1. B u scar men sajes d e erro r en lo s arch ivo s d e reg ist ro .
D espués de inicar el servidor revise los archivos de registro en EAP_HOME/d o mai n/l o g / o
EAP_HOME/stand al o ne/l o g /.
R esu lt ad o :
Si el servidor inició apropiadamente entonces no abrá errores y verá una salida similar a la
siguiente:
Ejemp lo 7.1. Ejemp lo d e u n in icio exit o so
10:20:37,007 INFO [org.jboss.as] (Controller Boot Thread)
JBAS015874: JBoss EAP 6.0.0.GA (AS 7.1.2.Final-redhat-1) started
in 17942ms - Started 134 of 214 services (79 services are passive
or on-demand)
En un dominio administrado podrá ver un mensaje similar para cada servidor ejecutado
localmente.
2. N aveg ar a la co n so la d e ad min ist ració n .
Si la instalación funcionó apropiadamente y su servidor está ejecutando entonces debe
poder acceder a la consola de administración apuntando su navegador web a una
dirección similar a http: //YOUR_SERVER: 9 9 9 0 /, reemplazando YOUR_SERVER con un
valor válido.
R esu lt ad o :
Aparecerá la página inicial de la consola de administración.
R esu lt ad o :
32
⁠Capít ulo 7 . Inicio con la plat aforma de aplicaciones empresariales JBoss 6
La consola de administración es un servicio implementable. Si puede llegar a esta después de
iniciar el servidor entonces su instalación está funcionando apropiadamente y puede implementar
servicios.
Reportar un error
7.6. Puert os de red que la plat aforma de aplicaciones empresariales
JBoss 6 ut iliz a
Los puertos que la configuración predeterminada de la plataforma de aplicaciones empresariales
JBoss 6 utiliza dependen de varios factores:
Si utiliza un dominio administrado o una configuración de servidor autónomo.
Si sus grupos de servidores utilizan un grupo de enlace de sockets predeterminado o un grupo
personalizado.
Los requerimientos de sus implementaciones individuales.
Compensación de puertos numéricos
Se puede configurar una compensación de puerto numérico con el fin de aliviar conflictos
entre puertos cuando ejecuta múltiples servidores en el mismo servidor físico. Si su servidor
usa una compensación de puerto numérico entonces agregue la compensación al número de
puerto predeterminado para el grupo de enlace de sockets de su grupo de servidores. Por
ejemplo, si el puerto HTTP del grupo de enlace de sockets es 8080 y su servidor usa una
compensación de puerto de 100 entonces su puerto HTTP es 8180.
A menos de que se establezca lo contrario, los puertos utilizan el protocolo TCP.
G ru p o s d e en lace d e so cket s p red et ermin ad o s
ful l -ha-so ckets
ful l -so ckets
ha-so ckets
stand ard -so ckets
T ab la 7.1. R ef eren cia d e lo s en laces d e so cket p red et ermin ad o s
N o mb re
Pu ert o
ajp
8009
Pu ert o
mu lt ica
st
D escrip ció n
so cket s
ha
co mp let
os
so cket s
co mp let
os
so cket
ha
so cket
est án d
ar
Protocolo Apache
JServ. Utilizado
para balanceo de
carga y clústers
HTTP.
Si
Si
Si
Si
33
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
N o mb re
Pu ert o
http
8080
https
8443
jaco rb
3528
jaco rb
-ssl
jg ro up
sd i ag no
sti cs
3529
7500
45700
jg ro up
smpi ng
jg ro up
s-tcp
7600
jg ro up
s-tcpfd
jg ro up
s-ud p
57600
jg ro up
s-ud pfd
messag
i ng
messag
i ng g ro up
54200
34
Pu ert o
mu lt ica
st
55200
5445
45688
D escrip ció n
so cket s
ha
co mp let
os
so cket s
co mp let
os
so cket
ha
so cket
est án d
ar
El puerto
predeterminado
para las
aplicaciones web
implementadas.
Conexión SSL
encriptada entre las
aplicaciones web
implementadas y los
clientes.
Servicios CORBA
para transacciones
JTS y otros
servicios
dependientes ORB.
Servicios CORBA
SSL encriptados.
Multicast. Utilizado
para el
descubrimiento de
compañeros en
clústers HA.
Multicast. Utilizado
para descubrir la
membresía inicial en
un clúster HA.
D escubrimiento de
compañeros unicast
en clústers HA
usando TCP.
Utilizado para la
detección de fallos
HA a través de TCP.
D escubrimiento de
compañeros unicast
en clústers HA
usando UD P.
Utilizado para la
detección de fallos
HA a través de UD P.
Servicio JMS.
Si
Si
Si
Si
Si
Si
Si
Si
Si
Si
No
No
Si
Si
No
No
Si
No
Si
No
Si
No
Si
No
Si
No
Si
No
Si
No
Si
No
Si
No
Si
No
Si
No
Si
No
Si
Si
No
No
Referenciado por
los grupos de
descubrimiento y
HornetQ JMS
broadcast.
Si
Si
No
No
⁠Capít ulo 7 . Inicio con la plat aforma de aplicaciones empresariales JBoss 6
N o mb re
Pu ert o
messag
i ng thro ug
hput
mo d _cl
uster
5455
o sg i http
8090
remo ti
ng
4447
Pu ert o
mu lt ica
st
23364
txn4712
reco ver
yenvi ro
nment
txn4713
statusmanag e
r
D escrip ció n
so cket s
ha
co mp let
os
so cket s
co mp let
os
so cket
ha
so cket
est án d
ar
Utilizando por JMS
Remoting.
Si
Si
No
No
Puerto multicast
para la
comunicación entre
la plataforma de
aplicaciones
empresariales
JBoss y el
balanceador de
carga HTTP.
Utilizado por
componentes
internos, los cuales
utilizan el
subsistema OSGi.
Utilizado para la
invocación remota
EJB.
El administrador de
recuperación de
transacciones JTA.
Si
No
Si
No
Si
Si
Si
Si
Si
Si
Si
Si
Si
Si
Si
Si
El administrador de
transacciones JTS/
JTA.
Si
Si
Si
Si
Pu ert o s d e ad min ist ració n
Además de los grupos de enlace de sockest cada controlador host abre dos puertos más para
administración:
9990 - El puerto de la consola de administración web
9999 - El puerto que la consola de administración y la API de administración utilizan
Reportar un error
7.7. Configuración de los cort afuegos de red para que funcionen con la
plat aforma de aplicaciones empresariales JBoss 6
Visió n G en eral
La mayoría de los entornos de producción usan cortafuegos como parte de una estrategia general
de seguridad de red. Si necesita que múltiples instancias del servidor se comuniquen entre ellas o
con servicios externos tal como servicdores de red o bases de datos entonces su cortafuegos tiene
35
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
que tener esto en consideración. Un cortafuegos bien administrado solo abre los puertos que son
necesarios para operar y limita el acceso a puertos con direcciones IP específicas, subredes y
protocolos de red.
Está fuera del ámbito de esta documentación el abordar una discusión detallada sobre cortafuegos.
Prereq u isit o s
D etermine los puertos que necesita abrir. Consulte Sección 7.6, “ Puertos de red que la
plataforma de aplicaciones empresariales JBoss 6 utiliza” para determinar la lista de puertos
para su situación.
Necesita comprender su software de cortafuegos. Este procedimiento usa el comando systemco nfi g -fi rewal l en Red Hat Enterprise Linux 6. El servidor de Microsoft Windows incluye un
cortafuegos y varias soluciones de cortafuegos de terceros disponibles para cada platforma.
Su p o sicio n es
Este procedimiento configura un cortafuegos en un entorno con las siguientes suposiciones:
El sistema operativo es Red Hat Enterprise Linux 6.
La plataforma de aplicaciones empresariales JBoss 6 ejecuta en el host 10 . 1. 1. 2.
Opcionalmente, el servidor tiene su propio cortafuegos.
El servidor del cortafuegos de red ejecuta en el host 10 . 1. 1. 1 en la interfaz eth0 y tiene una
interfaz externa eth1.
Quiere que el tráfico en el puerto 5445 (un puerto utilizado por JMS) seA reenviado a la
plataforma de aplicaciones empresariales JBoss 6. No se debe permitir que otro tráfico pase por
el cortafuegos de red.
Pro ced imien t o 7.2. T area
1. In icie sesió n en la co n so la d e ad min ist ració n .
Inicie sesión en la consola de administración. Por defecto ejecuta en
http://localhost:9990/console/.
2. D o min io ad min ist rad o : d et ermin a el g ru p o d e en lace d e so cket s q u e su g ru p o d e
servid o res u t iliz a.
Cada grupo de servidores usa un grupo de enlace de sockets, el cual es una colexión de
enlaces de socket. Un enlace de sockets es un nombre y valor del nombre del puerto y
número.
Para determinar el grupo de enlace de sockets que su servidor agrupa, haga clic en la
etiqueta Server G ro ups en la parte superior derecha de la pantalla. Luego haga clic en el
nombre de su grupo de servidores en la tabla Avai l abl e server g ro up
co nfi g urati o ns. El área Server attri butes al final de la pantalla se llena con el perfil
y grupo de enlace de sockets que el grupo de servidores utiliza.
3. D et ermin ar lo s en laces d e so cket q u e el g ru p o d e en laces d e so cket u t iliz a.
Haga clic en la etiqueta P ro fi l es en la parte superior derecha de la consola de
administración. En la parte izquierda de la pantalla se presenta una serie de menús. El
encabezado del menú inferior es G eneral C o nfi g urati o n. Haga clic en So cket
Bi nd i ng G ro ups debajo de este título. Aparecerá la pantalla So cket Bi nd i ng
36
⁠Capít ulo 7 . Inicio con la plat aforma de aplicaciones empresariales JBoss 6
D ecl arati o ns. Inicialmente se preesnta el grupo stand ard -so ckets. Puede seleccionar
un grupo diferente seleccionándolo del menú desplegable en el lado derecho.
Nota
Si utiliza un servidor autónomo entonces tiene solo un grupo de enlace de sockets.
Se presenta la lista de los nombres de los sockets, seis valores por página. Puede pasar las
páginas utilizando la flecha de navegación debajo de la tabla
4. D et ermin e lo s p u ert o s q u e n ecesit a ab rir.
D ependiendo de la función del puerto en particular y las necesidades de su entorno, es
posible que sea necesario que algunos de los puertos sean accesibles a través de su
cortafuegos. Si no está seguro del propósito de un enlace de socket consulte Sección 7.6,
“ Puertos de red que la plataforma de aplicaciones empresariales JBoss 6 utiliza” donde verá
una lista de los enlaces de socket predeterminados y sus propósitos.
5. C o n f ig u re su co rt af u eg o s p ara q u e reen víe el t ráf ico a la p lat af o rma d e
ap licacio n es emp resariales JB o ss 6 .
Realice estos pasos para configurar su cortafuegos de red para permitir el tráfico en el
puerto deseado.
a. Inicie sesión en su máquina de cortafuegos y acceda una línea de comandos como
usuario root.
b. Emita el comando system-co nfi g -fi rewal l para lanzar la funcionalidad de
configuración del cortafuegos. D ependiendo de la manera en que inició la sesión en
su sistema de cortafuegos se lanza el GUI o la funcionalidad de la línea de
comandos. Esta tarea asume que inició sesión por medio de SSH y utilizando la
interfaz de la línea de comandos.
c. Use la tecla T AB en su teclado para navegar al botón C usto mi ze y presione la tecla
ENT ER . Aparecerá la ventana T rusted Servi ces.
d. No cambie ningún valor sino utilice la tecla T AB para navegar al botón Fo rward y
presione ENT ER para avanzar a la siguiente pantalla. Aparece la pantalla O ther
P o rts.
e. Use la tecla T AB para navegar al botón <Ad d > y presione la tecla ENT ER . Aparecerá
la ventana P o rt and P ro to co l .
f. Ingrese 54 4 5 en el campo P o rt / P o rt R ang ey luego use la tecla T AB para llegar
al campo del P ro to co l e introduzca tcp. Use la tecla T AB para navegar al botón
O K y presione ENT ER .
g. Use la tecla T AB para navegar al botón Fo rward hasta que llegue a la pantalla
P o rt Fo rward i ng .
h. Use la tecla T AB para navegar al botón <Ad d > y presione la tecla ENT ER .
i. Llene los siguientes valores para establecer el reenvío de puerto para el puerto 5445.
Interfaz fuente: eth1
Protocolo: tcp
37
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
Puerto / Rango del puerto: 5445
D irección IP de destino: 10.1.1.2
Puerto / Rango del puerto: 5445
Use la tecla T AB para navegar al botón O K y presione ENT ER .
j. Use la tecla T AB para navegar al botón C l o se y presione ENT ER .
k. Use la tecla T AB para navegar al botón O K y presione ENT ER . Para aplicar los
cambios, lea la advertencia y haga clic en Y es.
6. C o n f ig u ració n d e u n co rt af u eg o s en su h o st d e la p lat af o rma d e ap licacio n es
emp resariales JB o ss 6 .
Algunas organizaciones deciden configurar un cortafuegos en el servidor de la plataforma
de aplicaciones empresariales JBoss 6 y cierran todos los puertos que no son necesarios
para su operación. Consulte Sección 7.6, “ Puertos de red que la plataforma de aplicaciones
empresariales JBoss 6 utiliza” y determine los puertos a abrir y luego cierre el resto. La
configuración predeterminada de Red Hat Enterprise Linux 6 cierra todos los puertos excepto
el 22 (utilizado para Secure Shell (SSH) y 5353 (utilizado para multicast D NS). Mientras que
está configurando los puertos asegúrese de tener acceso físico a su servidor de manera que
no se quede por fuera de manera inadvertida.
R esu lt ad o
Su cortafuegos está configurado para reenviar el tráfico a su servidor de LA plataforma de
aplicaciones empresariales JBoss interna de la manera en que especificó en su configuración de
cortafuegos. Si decide habilitar un cortafuegos en su servidor entonces todos los puertos se cierran
a excepción de los que se necesitan para ejecutar sus aplicaciones.
Reportar un error
7.8. Configuración predet erminada de seguridad del usuario
In t ro d u cció n
Todas las interfaces de administración en la plataforma de aplicaciones empresariales JBoss 6
están aseguradas por defecto. Esta seguridad tiene dos formas diferentes:
Las interfaces locales se aseguran por medio de un contrato SASL entre los clientes locales y el
servidor al cual se conectan. Este mecanismo de seguridad se basa en la habilidad del cliente de
acceder al sistema de archivos locales. Esto se debe a que el acceso al sistema de archivos local
le permitiría al cliente el agregar un usuario o de otra manera cambiar la configuración para
impedir otros mecanismos de seguridad. Esto se adhiere al principio de que si se logra acceso
físico al sistema de archivos entonces otros mecanismos de seguridad son superfluos. El
mecanismo tiene lugar en cuatro pasos:
Nota
El acceso HTTP se considera como remoto incluso si se conecta al host local usando
HTTP.
38
⁠Capít ulo 7 . Inicio con la plat aforma de aplicaciones empresariales JBoss 6
El cliente envía un mensaje al servidor, el cual incluye una petición para autenticarse con
el mecanismo local SASL.
El servidor genera un token único, lo escribe en un archivo único y le envía un mensaje al
cliente con la ruta completa del archivo.
El cliente lee el token del archivo y lo envía al servidor, verificando que tiene acceso local
al sistema de archivos.
El servidor verifica el token y luego borra el archivo.
Los clientes remotos, incluyendo los clientes HTTP locales, usan la seguridad basada en
dominios. El dominio predeterminado con los permisos para configurar la plataforma de
aplicaciones empresariales JBoss 6 de manera remota usando las interfaces de administración
es Manag ementR eal m. Se proporciona un script, el cual le permite agregar usuarios a este
dominio (o los dominios que cree). Consulte el capítulo de inicio del manual de instalación de la
plataforma de aplicaciones empresariales JBoss 6. Para cada usuario, el nombre de usuario,
una contraseña encriptada y el dominio se almacenan en un archivo. El archivo se encuentra en
una ubicación diferente si la plataforma de aplicaciones empresariales está configurada como
un dominio administrado o un servidor autónomo.
D o min io ad min ist rad o
EAP_HOME/d o mai n/co nfi g urati o n/mg mt-users. pro perti es
Servid o r au t ó n o mo
EAP_HOME/stand al o ne/co nfi g urati o n/mg mt-users. pro perti es
Aunque el contenido de mg mt-users. pro perti es se enmascara, el archivo se debe tratar con
mucho cuidado. Se recomienda que el modo del archivo se establezca como 6 0 0 , el cual da
acceso tan solo de lectura y escritura por parte del dueño del archivo.
Reportar un error
39
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
Capítulo 8. Desinstalación de la plataforma de aplicaciones
empresariales JBoss 6
8.1. Desinst alación de la plat aforma de aplicaciones empresariales
JBoss 6
R esu men d e la t area
Los pasos exactos para desinstalar el servidor de aplicaciones empresariales JBoss 6 dependen de
la manera en que se instaló.
Sección 8.2, “ D esinstalar la plataforma de aplicaciones empresariales JBoss 6 desde una
instalación Z ip”
Sección 8.3, “ D esinstalar la plataforma de aplicaciones empresariales JBoss 6 desde una
instalación gráfica”
Sección 8.4, “ D esinstalación de la plataforma de aplicaciones empresariales JBoss 6 desde una
instalación RPM”
Reportar un error
8.2. Desinst alar la plat aforma de aplicaciones empresariales JBoss 6
desde una inst alación Zip
1. In icie sesió n en el servid o r.
Inicie sesión en su servidor como usuario con derechos de escritura en el directorio de
instalación de la plataforma de aplicaciones empresariales JBoss 6.
2. B o rre el d irect o rio d e in st alació n .
La plataforma de aplicaciones empresariales JBoss 6 instala un sólo directorio cuando usa
el método de instalación Z ip. Borre el directorio de instalación para desinstalar la plataforma
de aplicaciones empresariales JBoss 6.
3. O p cio n al: b o rre cu alq u ier scrip t d e in icializ ació n q u e h aya cread o .
Si creó scripts de inicialización u otros scripts que dependían de que la plataforma de
aplicaciones empresariales JBoss 6 estuviese instalada en su computador entonces
bórrelos.
4. O p cio n al: Micro so f t Win d o ws: B o rre la p lat af o rma d e ap licacio n es emp resariales
JB o ss 6 d e su s servicio s.
Para borrar el servicio de la plataforma de aplicaciones empresariales JBoss 6 ejecute el
siguiente comando como usuario administrativo: sc d el ete "JBEAP 6 SVC ".
R esu lt ad o :
La plataforma de aplicaciones empresariales JBoss 6 se desinstala de su servidor.
Reportar un error
40
⁠Capít ulo 8 . Desinst alación de la plat aforma de aplicaciones empresariales JBoss 6
8.3. Desinst alar la plat aforma de aplicaciones empresariales JBoss 6
desde una inst alación gráfica
1. N aveg u e al d irect o rio EAP_HOME/Uni nstal l er/ en el servid o r.
D urante la instalación de la plataforma de aplicaciones empresariales JBoss 6 se creó un
directorio llamado EAP_HOME/Uni nstal l er/. Este directorio contiene un archivo llamado
uni nstal l er. jar.
2. Ejecu t e el co man d o java -jar uni nstal l er. jar.
Este comando desinstala la plataforma de aplicaciones empresariales JBoss 6.
R esu lt ad o :
La plataforma de aplicaciones empresariales JBoss 6 se desinstala de su servidor.
Reportar un error
8.4 . Desinst alación de la plat aforma de aplicaciones empresariales
JBoss 6 desde una inst alación RPM
1. In icie sesió n en el servid o r.
Inicie sesión en el servidor en donde la plataforma de aplicaciones empresariales JBoss 6
está instalada y gane acceso como administrador.
2. O p cio n al: C ree u n a list a d e arch ivo s y d irect o rio s cread o s p o r la in st alació n
R PM.
Para crear una lista de archivos y directorios creados por la instalación RPM, ejecute el
comando rpm -q l jbo ss-eap6 > /tmp/jbeap6 . txt. La razón para este paso es que
al remover el RPM es posible que no se borren todos estos archivos y directorios de su
sistema. Es posible que necesite borrar algunos de ellos a mano.
3. B o rre el p aq u et e co n el co man d o yum.
Use el comando YUM g ro upremo ve para borrar el grupo jbo ss-eap6 .
yum g ro upremo ve jbo ss-eap6
4. O p cio n al: C h eq u ee y b o rre lo s arch ivo s o d irect o rio s q u e el co man d o yum
g ro upremo ve n o b o rró .
Chequee la lista de archivos y directorios creados por el comando rpm -q l anterior. Borre
los que no se eliminaron de manera automática.
R esu lt ad o
La plataforma de aplicaciones empresariales JBoss 6 se desinstala de su servidor.
Reportar un error
41
Plat aforma de aplicaciones empresariales JBoss 6 G uía de Inst alación
Paquetes RPM de la plataforma de aplicaciones empresariales
JBoss 6
A.1. List a de paquet es RPM y dependencias
La plataforma de aplicaciones empresariales JBoss 6 se instala en Red Hat Enterprise Linux 6
usando el grupo de paquetes YUM JBo ss EAP 6 . Ese grupo está compuesto de los siguientes
paquetes.
jbo ssas-appcl i ent
jbo ssas-bund l es
jbo ssas-co re
jbo ssas-d o mai n
jbo ssas-ho rnetq -nati ve
jbo ssas-jbo ssweb-nati ve
jbo ssas-mo d ul es-eap
jbo ssas-pro d uct-eap
jbo ssas-stand al o ne
jbo ssas-wel co me-co ntent-eap
Reportar un error
42
Hist orial de revisiones
Historial de revisiones
R evisió n 2.0.0- 1
Mo n O ct 13 2014
Built from Content Specification: 11862, Revision: 507567
C S B u ild er R o b o t
43