Plataforma de aplicaciones

empresariales JBoss 6.4

Guía de inicio

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

Hat

Nidhi Chaudhary Lucas Costi Russell Dickenson

Sande Gilda Vikram Goyal Eamon Logue
Darrin Mison Scott Mumford David Ryan
Misty Stanley-Jones Keerat Verma Tom Wells
Plataforma de aplicaciones empresariales JBoss 6.4 Guía de inicio

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

Hat

Nidhi Chaudhary

Lucas Co sti

Russell Dickenso n

Sande Gilda

Vikram Go yal

Eamo n Lo gue

Darrin Miso n

Sco tt Mumfo rd

David Ryan

Misty Stanley-Jo nes

Keerat Verma

To m Wells
Legal Notice
Co pyright © 20 15 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.

Resumen
Este libro pro po rcio na lo s paso s básico s para po der iniciar co n JBo ss EAP 6 .
 T able of Cont ent s

T able of Contents
⁠P
. .refacio
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. . . . . . . . . .
⁠1. Co nvenc io nes d el d o 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? 5
⁠2 .2. Nec es itamo s s us c o mentario s 6

⁠C
. .apít . . . ulo
...1. .. .Int
. . roducción
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7. . . . . . . . . .
⁠1.1. Platafo rma d e ap lic ac io nes emp res ariales JBo s s 6 d e Red Hat 7
⁠1.2. Ac erc a d el p o rtal d el c liente d e Red Hat 7
⁠1.3. Ac erc a d e Red Hat JBo s s Develo p er Pro g ram 7
⁠1.4. Ac erc a d e Full Red Hat JBo s s Co mmerc ial Pro g ram 7
⁠1.5. Có mo enc o ntrar más info rmac ió n 8

⁠C
. .apít
. . . ulo
...2. .. .Prerrequisit
. . . . . . . . . .os
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9. . . . . . . . . .
⁠2 .1. Prerreq uis ito s d e ins talac ió n d e JBo s s EAP 6 9

⁠C
. .apít
. . . ulo
. . . 3.
. . Descargar
. . . . . . . . . .e. inst
. . . .alar
. . . el
. . product
. . . . . . . .o. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. 0. . . . . . . . . .
⁠3 .1. Vis ió n g eneral d e la ins talac ió n JBo s s EAP 10
⁠3 .2. Des c arg ar e ins talar JBo s s EAP med iante el p ro g rama d e ins talac ió n g ráfic o 10
⁠3 .2.1. Des c arg ar JBo s s EAP 6 Ins tallatio n Pro g ram 10
⁠3 .2.2. Ejec utar el p ro g rama d e ins talac ió n d e JBo s s EAP 11
⁠3 .3. Des c arg ue e ins tale JBo s s EAP med iante el ZIP 13
⁠3 .3.1. Des c arg ar JBo s s EAP 6 (ins talac ió n Zip ) 13
⁠3 .3.2. Ins talac ió n d e JBo s s EAP 6 (ins talac ió n ZIP) 14
⁠3 .4. Des c arg ar lo s ejemp lo s d e c ó d ig o Q uic ks tart 14
⁠3 .4.1. Des c arg a d e lo s inic io s ráp id o s 14

⁠C
. .apít
. . . ulo
...4. .. .Inst
. . . rucciones
. . . . . . . . . posinst
. . . . . . . alación
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. 6. . . . . . . . . .
⁠4 .1. Co nfig urar el ento rno d e d es arro llo 16
⁠4 .1.1. Vis ió n g eneral d e la ins talac ió n d e Red Hat JBo s s Develo p er Stud io 16
⁠4 .1.2. Des c arg ar Red Hat JBo s s Develo p er Stud io 16
⁠4 .1.3. Ins talar Red Hat JBo s s Develo p er Stud io 16
⁠4 .1.4. Inic iar Red Hat JBo s s Develo p er Stud io 17
⁠4 .1.5. Ag reg ar JBo s s EAP Server med iante Define New Server 17
⁠4 .2. Co nfig urar Maven 23
⁠4 .2.1. Ac erc a d e Maven 23
⁠4 .2.2. Co nfig urar lo s p arámetro s Maven 23
⁠4 .2.3. Co nfig urar Maven p ara Red Hat JBo s s Develo p er Stud io 24
⁠4 .2.3.1. Co nfig urar Maven p ara us ar c o n Red Hat JBo s s Develo p er Stud io 24
⁠4 .2.4. Co nfig urar Maven p ara línea d e c o mand o s 27
⁠4 .2.4.1. Des c arg a e ins talac ió n d e Maven 27
⁠4 .2.4.2. Co nfig urar lo s p arámetro s Maven p ara us ar c o n la línea d e c o mand o s 28

⁠C
. .apít
. . . ulo
. . . 5.
. . Ensáyelo
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
...........
⁠5 .1. Ejec ute lo s Q uic ks tarts 32
⁠5 .1.1. Ejec ute lo s Q uic ks tarts en Red Hat JBo s s Develo p er Stud io 32
⁠5 .1.2. Ejec utar lo s Q uic ks tarts us and o una línea d e c o mand o s 39

⁠A
. .péndice
. . . . . . . A.
. .T
. .omas
. . . . .de
. . pant
. . . . .alla
. . . del
. . . programa
. . . . . . . . . de
. . .inst
. . . alación
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4. 0. . . . . . . . . .
⁠A .1. Selec c ió n d el id io ma 40
⁠A .2. Ac uerd o d e lic enc ia d el us uario final 40

1
G uía de inicio

⁠A .2. Ac uerd o d e lic enc ia d el us uario final 40

⁠A .3. Ruta d e ins talac ió n 41
⁠A .4. Selec c ió n d e p aq uetes a ins talar 42
⁠A .5. Creac ió n d el us uario ad minis trativo 43
⁠A .6 . Ins talac ió n d e inic io ráp id o 44
⁠A .7. Co nfig urac ió n d el rep o s ito rio Maven 45
⁠A .8 . Co nfig urac ió n d e enlac e d e s o c kets 46
⁠A .9 . Inic io d el s ervid o r 47
⁠A .10 . Co nfig urac ió n d e lo s niveles d e reg is tro 48
⁠A .11. Co nfig urac ió n d el ento rno d el tiemp o d e ejec uc ió n 49
⁠A .12. Revis ió n d e lo s c o mp o nentes d e ins talac ió n 50
⁠A .13. Pro g res o d e la ins talac ió n 51
⁠A .14. Pro c es amiento d e la ins talac ió n c o mp letad o 52
⁠A .15. Creac ió n d e atajo s 53
⁠A .16 . G enerac ió n d el s c rip t d e ins talac ió n 54

⁠A
. .péndice
. . . . . . . B.
. . Hist
. . . . orial
. . . . de
. . . revisiones
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
...........

2
 ⁠P refacio

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 circunstancias en que se aplican son las siguientes:

Neg ri ta mo no espaci ad o

Utilizado para resaltar la entrada del sistema, incluidos 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.

Las combinaciones de teclas se pueden distinguir de las individuales con el signo más, que conecta
cada parte de la combinación de teclas. 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 grupo de tres teclas pulsadas simultáneamente.

Se presenta en Neg ri ta-mo no espaci ad o cuando se refiere al código fuente, los nombres de las
clases, los métodos, las funciones, los nombres de variables y valores de retorno mencionados
dentro de un párrafo . 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

D enota palabras o frases encontradas en un sistema, incluidos nombres de aplicaciones, 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 R ató 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
G uía de inicio

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 en 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 instalado, utilice el comando rpm -q paquete.

Éste entregará el resultado siguiente: paquete-versión-lanzamiento.

Observe las palabras resaltadas en itálicas arriba: 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 diferencian 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 Desktop documentation drafts mss photos stuff svn

books_tests Desktop1 downloads images notes scripts 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
 ⁠P refacio

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);

out:
mutex_unlock(& kvm->lock);
return r;
}

1.3. Not as y advert encias

Finalmente, utilizamos tres estilos visuales para resaltar 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
G uía de inicio

Si tiene 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 conocimiento, 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 la documentación de otro producto.

Red Hat también alberga una lista grande de correos electrónicos para discusiones sobre software y
tecnología de Red Hat. Encontrará 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 o si considera que hay alguna forma de mejorarlo, nos gustaría
escuchar sus sugerencias. Por favor complete un reporte en Bugzilla: http://bugzilla.redhat.com/
para el producto Plataforma de aplicaciones empresariales JBoss

Cuando envíe un reporte de error no olvide mencionar el identificador' del manual:

Getting_Started_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

Capítulo 1. Introducción

1.1. Plat aforma de aplicaciones empresariales JBoss 6 de Red Hat

Red Hat JBoss Enterprise Application Platform 6 (JBoss EAP 6) es una plataforma middleware
construida con base en estándares libres, que cumple con las especificaciones de Java empresarial
edición 6. Integra JBoss Application Server 7 con clústeres de alta disponibilidad, mensajería, caché
distribuido y otras tecnologías.

JBoss EAP 6 incluye una nueva estructura modular, la cual permite la habilitación de servicios solo
cuando se requieran, mejorando así, la velocidad de arranque.

La consola de administración y la interfaz de línea de comandos de administración hacen

innecesario la modificación de archivos de configuración XML y agregan la habilidad para utilizar
scripts y automatizar tareas.

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

Reportar un error

1.2. Acerca del port al del client e de Red Hat

El Portal del cliente de Red Hat es la plataforma centralizada para los recursos de suscripción de Red
Hat. Use el Portal del cliente de Red Hat para lo siguiente:

Administrar y mantener contratos de soporte y derechos de Red Hat;

D escargar software soportado oficialmente.

Acceder la documentación de productos y la base de conocimiento de Red Hat.

Contactar a los servicios de soporte global.

Registrar errores de productos de Red Hat.

El Portal del cliente está disponible aquí: https://access.redhat.com.

Reportar un error

1.3. Acerca de Red Hat JBoss Developer Program

Red Hat JBoss Developer Program (" The Program" ) le permite desarrollar, de forma gratuita, algunas
Red Hat Subscriptions para fines de desarrollo. Las Red Hat Subscriptions que se ofrecen en este
programa no reciben soporte y por lo general, no se abordan en caso de vulnerabilidades de
seguridad. Unicamente, pueden utilizarse para propósitos de desarrollo y no se destinan para fines
tales como en entornos de producción o para acceder actualizaciones sin una o varias Red Hat
Subscription(s) activas. Para obtener más información sobre Red Hat JBoss D eveloper Program,
consulte http://www.jboss.org/developer-program/termsandconditions.

Reportar un error

1.4 . Acerca de Full Red Hat JBoss Commercial Program

7
G uía de inicio

Full Red Hat JBoss Commercial Program le permite implementar para entornos de producción.
Proporciona privilegios adicionales para actualizaciones de software y parches, servicios de
soporte y acceso a Red Hat Knowledgebase. Para participar en el programa, debe crear una cuenta
en el Portal del cliente en https://access.redhat.com/. Para conocer más sobre este programa,
consulte la Sección 1.2, “ Acerca del portal del cliente de Red Hat” .

Reportar un error

1.5. Cómo encont rar más información

Esta guía tiene como objeto hacer que usted pueda estar listo y ejecutando Red Hat JBoss
Enterprise Application Platform tan rápido como sea posible. Si desea más información, los
paquetes de documentación completa para JBoss EAP están disponibles en el Portal del cliente en
https://access.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform.

Reportar un error

8
 ⁠Capít ulo 2 . Prerrequisit os

Capítulo 2. Prerrequisitos

2.1. Prerrequisit os de inst alación de JBoss EAP 6

R esu men

JBoss EAP está disponible en Red Hat JBoss Developer Program o en Full Red Hat JBoss Commercial
Program. Para más información sobre Red Hat JBoss Developer Program, consulte Sección 1.3,
“ Acerca de Red Hat JBoss D eveloper Program” . Para obtener más información sobre Full Red Hat
JBoss Commercial Program, consulte Sección 1.4, “ Acerca de Full Red Hat JBoss Commercial
Program” . Los pasos a continuación describen los prerrequisitos para ambos programas.

Prerreq u isit o s co mu n es

Revise las configuraciones soportadas y verifique si su sistema sea compatible:

https://access.redhat.com/site/articles/111663.

Si establece una cuenta en Red Hat Customer Portal y está participando en Full Red Hat JBoss
Commercial Program, asegúrese de que su sistema esté al día con las actualizaciones y erratas de
Red Hat.

Prerreq u isit o s d e Z IP/in st alad o r

D ebe otorgar privilegios de administración para el directorio de instalación.

Asegúrese de que el JD K escogido ya se haya extraído o instalado. Consulte la documentación

de JD K para obtener más información sobre cómo proceder.

En un servidor Microsoft Windows, asegúrese de que se hayan configurado las variables de

entorno JAVA_HOME y PATH, de lo contrario los atajos no funcionarán.

En Hewlett-Packard HP-UX, asegúrese de que se haya instalado una funcionalidad unzi p.

Reportar un error

9
G uía de inicio

Capítulo 3. Descargar e instalar el producto

3.1. Visión general de la inst alación JBoss EAP

Esta guía proporciona instrucciones para el proceso de instalación más sencillo que pueda utilizar
JBoss EAP tan pronto como sea posible. Los procedimientos de instalación completos se
encuentran en la Guía de instalación para JBoss EAP. D espués de que instale JBoss EAP, puede
configurar el servidor con la ayuda de la CLI de administración o la consola de administración.
Para obtener información sobre cómo configurar JBoss EAP, consulte la Guía de configuración y
administración para JBoss EAP. Ambas guías se encuentran en el Portal del cliente en
https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/.

Puede instalar JBoss EAP en alguna de las siguientes formas:

Puede instalar JBoss EAP mediante el programa de instalación gráfico.

Puede instalar JBoss EAP mediante un archivo Z IP.

Siga las instrucciones según su método de instalación preferido.

Reportar un error

3.2. Descargar e inst alar JBoss EAP mediant e el programa de

inst alación gráfico

3.2.1. Descargar JBoss EAP 6 Inst allat ion Program

R esu men

JBoss EAP está disponible en Red Hat JBoss Developer Program o Full Red Hat JBoss Commercial
Program. Siga el procedimiento a continuación que coincida con su elección de programa.

Pro ced imien t o 3.1. D escarg u e JB o ss EAP In st allat io n Pro g ram d esd e el Po rt al d el
clien t e en Fu ll R ed H at JB o ss C o mmercial Pro g ram

Siga este procedimiento si usted está participando en Full Red Hat JBoss Commercial Program.
Para obtener más información sobre este programa, consulte la Sección 1.4, “ Acerca de Full Red Hat
JBoss Commercial Program” .

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

2. Haga clic en D o wn lo ad s.

3. Haga clic en R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm en la lista

P ro d uct D o wnl o ad s.

4. Seleccione la versión correcta de la versión de JBoss EAP del menú desplegable Versi o n.

5. Busque R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm 6 . x.x Instal l er

en la lista y haga clic en la opción D o wnl o ad .

6. Se le ha solicitado guardar el archivo JAR en un directorio de su preferencia. Elija un

directorio y guarde el archivo.

10
 ⁠Capít ulo 3. Descargar e inst alar el product o

Pro ced imien t o 3.2. D escarg u e JB o ss EAP In st allat io n Pro g ram d esd e el p ro g rama d e
in st alació n jb o ss.o rg en R ed H at JB o ss D evelo p er Pro g ram

Siga este procedimiento si está participando en Red Hat JBoss D eveloper Program. Para obtener
más información sobre este programa, consulte la Sección 1.3, “ Acerca de Red Hat JBoss D eveloper
Program” .

1. Abra un navegador y acceda la siguiente URL: http://www.jboss.org/products/eap.

A. Para descargar el programa de instalación de la versión de disponibilidad general del

producto, haga clic en el botón D o wnl o ad a la derecha de la página.

B. Siga estos pasos para elegir una versión alterna, la cual incluya los últimos
lanzamientos de Alpha o Beta como también versiones anteriores del producto.

a. Haga clic en el enlace D o wnl o ad JBo ss EAP que está a la derecha de la

página.

b. Haga clic en el enlace Instal l er en la columna D o wnl o ad para la versión

correcta de productos.

2. Se le ha solicitado guardar el archivo JAR en un directorio de su preferencia. Elija un

directorio y guarde el archivo.

R esu lt ad o

El archivo JAR del programa de instalación JBoss EAP 6 ha sido descargado a la maquina de
destino.

Reportar un error

3.2.2. Ejecut ar el programa de inst alación de JBoss EAP

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

Si no está seguro de la opción, simplemente elija la predeterminada. Puede configurar con facilidad
el servidor posteriormente. Para obtener más información sobre cómo configurar el servidor JBoss
EAP, consulte la Guía de administración y configuración para Red Hat JBoss Enterprise Application
Platform 6 ubicada en el Portal del cliente en
https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/.

Pro ced imien t o 3.3. Ejecu t ar el p ro g rama d e in st alació n d e JB o ss EAP

1. Abra una terminal y navegue al directorio que contiene la JAR del programa de instalación
descargado.

2. Escriba el siguiente comando:

java -jar jboss-eap-6.x.x-installer.jar

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

T ab la 3.1. Pan t allas d el p ro g rama d e in st alació n d e JB o ss EAP

11
G uía de inicio

N o mb re d e la Ap arece D escrip ció n

p an t alla
Sección A.1, Siempre Seleccione el idioma deseado para el programa
“ Selección del idioma” de instalación y haga clic en O K.
Sección A.2, “ Acuerdo Siempre EULA para RED HAT JBOSS MID D LEWARE.
de licencia del usuario
final” Seleccione " I accept the terms of this license
agreement" y haga clic en Next.

Sección A.3, “ Ruta de Siempre Seleccione la ruta de instalación para JBoss

instalación” EAP y haga clic en Next. Se le solicitará que
cree el nuevo directorio o si ya existe que
remplace el directorio nombrado.
Sección A.4, Siempre Seleccione los paquetes a instalar. No se
“ Selección de pueden desactivar l os paquetes requeridos.
paquetes a instalar”
Sección A.5, “ Creación Siempre Cree un usuario administrativo y asigne una
del usuario contraseña. Luego haga clic en Next.
administrativo”
Sección A.6, Siempre Instale los ejemplos de inicio rápido. Si desea
“ Instalación de inicio instalarlos, seleccione Y es y elija la ruta de
rápido” instalación. Luego haga clic en Next.
Sección A.7, Si decide instalar los Mantenga las selecciones predeterminadas
“ Configuración del ejemplos de inicio para configurar de forma automática los
repositorio Maven” rápido parámetros predeterminados de Maven y usar el
repositorio Maven alojado públicamente. Luego
haga clic en Next.
Sección A.8, Siempre Guarde las vinculaciones de puerto
“ Configuración de predeterminadas, luego haga clic en Next.
enlace de sockets”
Sección A.9, “ Inicio del Siempre Seleccione la opción preferida sobre la
servidor” finalización del proceso de instalación. Luego
haga clic en Next.
Sección A.10, Siempre Elija No para evitar la configuración de niveles
“ Configuración de los de registro. Luego haga clic en Next.
niveles de registro”
Sección A.11, Siempre Seleccione P erfo rm d efaul t
“ Configuración del co nfi g urati o n y haga clic en Next para
entorno del tiempo de continuar.
ejecución”
Sección A.12, Siempre Revise sus elecciones y haga clic en Next.
“ Revisión de los
componentes de
instalación”
Sección A.13, Siempre Cuando el progreso de la instalación se
“ Progreso de la complete, haga clic en Next.
instalación”
Sección A.14, Siempre Cuando el procesamiento termine, haga clic en
“ Procesamiento de la Next.
instalación
completado”
Sección A.15, Siempre Acepte el predeterminado y haga clic en Next.
“ Creación de atajos”

12
 ⁠Capít ulo 3. Descargar e inst alar el product o

N o mb re d e la Ap arece D escrip ció n

p an t alla
Sección A.16, Siempre Haga clic en D o ne.
“ Generación del script
de instalación” La instalación está completa.

R esu lt ad o

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

Reportar un error

3.3. Descargue e inst ale JBoss EAP mediant e el ZIP

3.3.1. Descargar JBoss EAP 6 (inst alación Zip)

R esu men

JBoss EAP está disponibel en Red Hat JBoss Developer Program o en Full Red Hat JBoss Commercial
Program. Siga el siguiente procedimiento que coincida con su elección de programa.

Pro ced imien t o 3.4 . D escarg u e lo s arch ivo s Z ip d esd e el Po rt al d el clien t e en Fu ll R ed

H at JB o ss C o mmercial Pro g ram

Siga este procedimiento si esta participando en Full Red Hat JBoss Commercial Program. Para
obtener más información sobre este programa, consulte la Sección 1.4, “ Acerca de Full Red Hat
JBoss Commercial Program” .

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

2. Haga clic en D o wn lo ad s.

3. Haga clic en R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm en la lista

P ro d uct D o wnl o ad s.

4. Seleccione la versión correcta de la versión de JBoss EAP del menú desplegable Versi o n.

5. Busque R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm 6 . x.x en la lista y

haga clic en la opción D o wnl o ad .

6. Se le pedirá que guarde el archivo Z ip en un directorio que usted elija. Elija el directorio y
guarde el archivo.

Pro ced imien t o 3.5. D escarg u e el arch ivo Z IP d e jb o ss.o rg en R ed H at JB o ss D evelo p er

Pro g ram

Siga este procedimiento si esta participando en Red Hat JBoss D eveloper Program. Para obtener
más información sobre este programa, consulte la Sección 1.3, “ Acerca de Red Hat JBoss D eveloper
Program” .

1. Abra un navegador de red y acceda esta URL: http://www.jboss.org/products/eap/

2. Haga clic en el enlace D o wnl o ad JBo ss EAP a la izquierda de la página.

3. Haga clic en el enlace ZIP en la columna D o wnl o ad para obtener la versión de producto
correcta.

13
G uía de inicio

4. Se le pedirá que guarde el archivo Z ip en un directorio que usted elija. Elija el directorio y
guarde el archivo.

R esu lt ad o

El archivo JBoss EAP 6 Z IP ha sido descargado con éxito a la máquina de destino.

Reportar un error

3.3.2. Inst alación de JBoss EAP 6 (inst alación ZIP)

R esu men

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

Pro ced imien t o 3.6 . In st alació n d el arch ivo z ip

1. Mu eva el arch ivo z ip a la u b icació n d esead a.

Mueva el archivo zip al servidor y directorio en donde instalará JBoss EAP 6. El usuario que
va a detener e iniciar el servidor debe tener acceso de lectura y escritura en este directorio.

2. U se u n a ap licació n ap ro p iad a p ara ext raer el arch ivad o r z ip en la u b icació n

d esead a.

En un entorno Red Hat Enterprise Linux use la funcionalidad unzi p para extraer el
contenido del archivador zip.

En un entorno Microsoft Windows haga clic con el botón derecho del ratón en el archivo y
seleccione Extract Al l .

En un entorno Hewlett-Packard HP-UX use la funcionalidad unzi p para extraer el contenido

del archivador zip.

R esu lt ad o

JBoss EAP 6 se ha instalado correctamente. El directorio creado por el archivador Z IP que realiza la
extracción es el directorio superior para el servidor. Se conoce como EAP_HOME/.

Reportar un error

3.4 . Descargar los ejemplos de código Quickst art

3.4 .1. Descarga de los inicios rápidos

R esu men

JBoss EAP 6 viene junto con una serie completa de ejemplos de inicio rápido diseñados para
ayudar a los usuarios a empezar a escribir aplicaciones usando la tecnología de Java EE 6.

Si eligió instalar los ejemplos más rápidos cuando instaló JBoss EAP, puede omitir este paso. D e lo
contrario, descárguelos en Red Hat JBoss Developer Program o en Full Red Hat JBoss Commercial
Program. Siga el siguiente procedimiento que coincida con su elección de programa.

Pro ced imien t o 3.7. D escarg u e lo s Q u ickst art s en Fu ll R ed H at JB o ss C o mmercial

Pro g ram

14
 ⁠Capít ulo 3. Descargar e inst alar el product o

Siga este procedimiento si esta participando en Full Red Hat JBoss Commercial Program. Para
obtener más información sobre este programa, consulte Sección 1.4, “ Acerca de Full Red Hat JBoss
Commercial Program” .

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

2. Haga clic en D o wn lo ad s.

3. Haga clic en R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm en la lista

D escarg a d e pro d ucto s.

4. Seleccione la versión correcta de la versión de JBoss EAP del menú desplegable Versi o n.

5. Primero, busque R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm

6 . x.xQ ui ckstarts en la lista y luego, haga clic en la opción D o wnl o ad .

6. Se le pedirá que guarde el archivo Z ip en un directorio que usted elija. Elija el directorio y
guarde el archivo.

7. D escomprima el archivo en el directorio elegido.

Pro ced imien t o 3.8. D escarg u e lo s Q u ickst art s en R ed H at JB o ss D evelo p er Pro g ram

Siga este procedimiento si esta participando en Red Hat JBoss D eveloper Program. Para obtener
más información sobre este programa, consulte Sección 1.3, “ Acerca de Red Hat JBoss D eveloper
Program” .

1. Abra un navegador de red y acceda esta URL: http://www.jboss.org/products/eap/

2. Haga clic en el enlace D o wnl o ad JBo ss EAP a la izquierda de la página para desplegar
información de descarga del producto.

3. En D o wnl o ad JBo ss EAP , haga clic en el enlace Q ui ckstarts para descargar un

archivador Z ip que contenga los ejemplos.

4. Se le pedirá que guarde el archivo Z ip en un directorio que usted elija. Elija el directorio y
guarde el archivo.

5. D escomprima el archivo en el directorio elegido.

Reportar un error

15
G uía de inicio

Capítulo 4. Instrucciones posinstalación

4 .1. Configurar el ent orno de desarrollo

4 .1.1. Visión general de la inst alación de Red Hat JBoss Developer St udio

Esta guía proporciona instrucciones para Red Hat JBoss D eveloper Studio. Si desea obtener los
procedimientos de instalación completos, consulte la Guía de instalación para Red Hat JBoss
D eveloper Studio en https://access.redhat.com/site/documentation/en-
US/Red_Hat_JBoss_D eveloper_Studio/.

Reportar un error

4 .1.2. Descargar Red Hat JBoss Developer St udio

1. Ir a https://www.jboss.org/products/devstudio.html.

2. Hacer clic en el botón D o wnl o ad . Se le solicitará guardar el archivo Z IP al directorio de su

elección.

Reportar un error

4 .1.3. Inst alar Red Hat JBoss Developer St udio

1. Abra una terminal y navegue a un directorio que contenga el archivo . jar descargado.

2. Ejecute el siguiente comando para lanzar el programa de instalación GUI:

java -jar jbdevstudio-build_version.jar

Nota

D e modo alternativo, puede hacer clic en el archivo . jar para lanzar el programa de
instalación.

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

4. Seleccione I accept the terms o f thi s l i cense ag reement y haga clic en Next.

5. Ajuste la ruta de instalación y haga clic en Next.

Nota

Si la carpeta de la ruta de instalación no existe entonces aparecerá una ventana.

Haga clic en O k para crear la carpeta.

6. Seleccione una MVJ o deje la MVJ predeterminada seleccionada y haga clic en Next.

16
 ⁠Capít ulo 4 . Inst rucciones posinst alación

7. Red Hat JBoss D eveloper Studio incluye Red Hat JBoss Enterprise Application Platform. Si
ya estaba instalada, elija No . D e lo contrario, elija Y es para instalar y configurarlos para
usarlo con Red Hat JBoss D eveloper Studio.

8. Revise los detalles de instalación y haga clic en Next.

9. Haga clic en Next cuando el proceso de instalación esté completo.

10. Configure los atajos de escritorio para Red Hat JBoss D eveloper Studio, y haga clic en el
botón Next.

11. Haga clic en D o ne.

Reportar un error

4 .1.4 . Iniciar Red Hat JBoss Developer St udio

Para iniciar Red Hat JBoss D eveloper Studio, haga doble clic en el atajo de escritorio creado
durante la instalación o puede iniciarlos en la línea de comandos. Este tema describe cómo iniciar
Red Hat JBoss D eveloper Studio mediante la línea de comandos.

Pro ced imien t o 4 .1. C o man d o p ara rein iciar R ed H at JB o ss D evelo p er St u d io

1. Abra una terminal y navegue al directorio de instalación Red Hat JBoss D eveloper Studio

2. Ejecute el siguiente comando para iniciar Red Hat JBoss D eveloper Studio:

Para Linux:

[localhost]$ ./jbdevstudio

Para Microsoft Windows:

C:\JBDS_INSTALL_DIRECTORY > jbdevstudio.bat

Reportar un error

4 .1.5. Agregar JBoss EAP Server mediant e Define New Server

Estas instrucciones presumen que es su primera introducción a Red Hat JBoss D eveloper Studio y
que usted no ha agregado ningún servidor Red Hat JBoss Enterprise Application Platform. El
procedimiento a continuación agrega el servidor JBoss EAP mediante el asistente D efi ne New
Server.

Pro ced imien t o 4 .2. Ag reg ar el servid o r

1. Abra la pestaña Servers. Si no hay una pestaña Servers agréguela al panel así:

a. Haga clic en Win d o w → Sh o w View → O t h er....

b. Seleccione Servers desde la carpeta Server ya haga clic en O K.

2. Haga clic en No servers are avai l abl e. C l i ck thi s l i nk to create a new

server. . . o, si prefiere, haga clic derecho dentro del panel de servidor en blanco y
seleccione N ew → Server.

17
G uía de inicio

Fig u ra 4 .1. Ag reg u e u n n u evo servid o r - N o h ay servid o res d isp o n ib les

3. Expanda JBo ss Enterpri se Mi d d l eware y elija JB o ss En t erp rise Ap p licat io n

Plat f o rm 6 .1+ . Ingrese un nombre de servidor, por ejemplo, " JBoss Enterprise Application
Platform 6.4" , luego haga clic en Next para crear el tiempo de ejecución de JBoss y defina el
servidor. La próxima vez que defina un nuevo servidor, este cuadro de diálogo mostrará una
selección Server runti me envi ro nment con la nueva definición de tiempo de ejecución.

18
 ⁠Capít ulo 4 . Inst rucciones posinst alación

Fig u ra 4 .2. D ef in ir el n u evo servid o r

4. Cree un adaptador de servidor para administrar el inicio y la parada del servidor. Guarde los
predeterminados y haga clic en Next.

19
G uía de inicio

Fig u ra 4 .3. C rear u n n u evo ad ap t ad o r d e servid o r

5. Ingrese un nombre, por ejemplo, " JBoss EAP 6.4 Runtime" . En Ho me D i recto ry, haga clic
en Bro wse y navegue al sitio de instalación JBoss EAP. Luego haga clic en Next.

20
 ⁠Capít ulo 4 . Inst rucciones posinst alación

Fig u ra 4 .4 . Ag reg ar u n n u evo en t o rn o d e t iemp o d e ejecu ció n d e servid o r

Nota

Algunos inicios rápidos requieren que usted ejecute el servidor con un perfil diferente
o argumentos adicionales. Para desplegar un inicio rápido que requiera el perfil
ful l , debe definir un nuevo servidor y agregar un Server R unti me Envi ro nment
que especifique stand al o ne-ful l . xml para el C o nfi g urati o n fi l e.
Asegúrese de entregar al nuevo servidor un nombre descriptivo.

6. Configure los proyectos existentes para el nuevo servidor. D ebido a que usted no tiene
proyectos en este momento, haga clic en Fi ni sh.

21
G uía de inicio

Fig u ra 4 .5. Mo d if icar recu rso s p ara el n u evo servid o r JB o ss

R esu lt ad o

JBoss EAP Runtime Server aparece en la lista en la pestaña Servers.

22
 ⁠Capít ulo 4 . Inst rucciones posinst alación

Fig u ra 4 .6 . El servid o r ap arece en la list a d e servid o res

Reportar un error

4 .2. Configurar Maven

4 .2.1. Acerca de Maven

Apache Maven es una herramienta distribuida de automatización de construcción utilizada en el

desarrollo de aplicaciones Java para crear, administrar y construir proyectos software. Maven usa
archivos de configuración estándares llamados Modelo de objetos de proyecto ( conocidos como
POM, por sus siglas en inglés) para definir proyectos y administrar el proceso de construcción. Los
POM describen las dependencias de componentes y módulos, el orden de construcción y los
destinos para el empacado del proyecto resultante y la salida mediante un archivo XML. Esto
asegura que el proyecto sea construido de una manera correcta y uniforme.

Maven logra esto con la ayuda de un repositorio. Un repositorio almacena bibliotecas,

complementos y otros artefactos de la construcción. El repositorio público predeterminado es el
Maven 2 Central Repository, aunque los repositorios pueden ser privados e internos dentro de una
compañía con una meta para compartir artefactos comunes dentro de los equipos de desarrollo. Los
repositorios también están disponibles de terceras partes. JBoss EAP incluye el repositorio Maven,
el cual contiene requerimientos que los desarrolladores de Java EE suelen emplear para construir
aplicaciones en JBoss EAP.

Para más información sobre Maven, consulte Welcome to Apache Maven.

Para más información sobre los repositorios Maven, consulte Apache Maven Project - Introduction
to Repositories.

Para obtener más información sobre cómo usar Maven en JBoss EAP, consulte el capítulo titulado
Maven Guide en la Guía de desarrollo para Red Hat JBoss Enterprise Application Platform que se
encuentra en el Portal del cliente en
https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/.

Reportar un error

4 .2.2. Configurar los parámet ros Maven

Los artefactos y dependencias necesarias para construir e implementar aplicaciones para JBoss
EAP 6 se alojan en un repositorio público. D ebe indicarle a Maven que use este repositorio cuando
construya sus aplicaciones. La forma de hacerlo depende de si su plan es usar Red Hat JBoss
D eveloper Studio o la línea de comandos Maven para construir e implementar sus aplicaciones.

23
G uía de inicio

Red Hat JBoss D eveloper Studio incluye Maven, por lo tanto no es necesario descargar e instalar
por separado. Si su plan es usar Red Hat JBoss D eveloper Studio para construir e implementar sus
aplicaciones, use las siguientes instrucciones para configurar los parámetros de Maven:
Sección 4.2.3.1, “ Configurar Maven para usar con Red Hat JBoss D eveloper Studio”

Si su plan es usar la línea de comandos Maven para construir e implementar sus aplicaciones,
primero debe descargar e instalar Maven usando las instrucciones aquí: Sección 4.2.4.1, “ D escarga
e instalación de Maven” . Then follow these instructions to configure the Maven settings:
Sección 4.2.4.2, “ Configurar los parámetros Maven para usar con la línea de comandos”

Reportar un error

4 .2.3. Configurar Maven para Red Hat JBoss Developer St udio

4 .2 .3.1 . Co nfigurar Mave n para usar co n Re d Hat JBo ss De ve lo pe r St udio

Los artefactos y dependencias necesarias para construir e implementar aplicaciones para Red Hat
JBoss Enterprise Application Platform se alojan en un repositorio público. D ebe dirigir Maven para
usar el repositorio cuando construya sus aplicaciones. Este tema cubre los pasos para configurar
Maven si su plan es construir e implementar aplicaciones mediante Red Hat JBoss D eveloper
Studio.

Si su plan es usar la línea de comandos Maven para construir e implementar aplicaciones, puede
ignorar este tema. En su lugar, siga las instrucciones aquí: Sección 4.2.4.2, “ Configurar los
parámetros Maven para usar con la línea de comandos” .

Maven se distribuye con Red Hat JBoss D eveloper Studio, por lo tanto no es necesario instalarlo
por separado. Sin embargo, debe configurar Maven para que pueda usar el asistente Java EE Web
Project para implementaciones JBoss EAP. El procedimiento a continuación demuestra cómo
configurar Maven para que se pueda usar con JBoss EAP, al editar el archivo de configuración
Maven desde Red Hat JBoss D eveloper Studio.

Pro ced imien t o 4 .3. C o n f ig u rar Maven en R ed H at JB o ss D evelo p er St u d io

1. Haga clic en Win d o w→Pref eren ces, expanda JBo ss T o o l s y seleccione JBo ss Maven
Integ rati o n.

24
 ⁠Capít ulo 4 . Inst rucciones posinst alación

Fig u ra 4 .7. Pan el d e JB o ss Maven In t eg rat io n en la ven t an a d e p ref eren cias

2. Haga clic en C o nfi g ure Maven R epo si to ri es.

3. Haga clic en Ad d R epo si to ry para configurar el repositorio JBoss GA Tech Preview

Maven. Complete el cuadro de diálogo Ad d Maven R epo si to ry así:

a. Establezca los valores de P ro fi l e ID , R epo si to ry ID , y R epo si to ry Name a

jbo ss-g a-repo si to ry.

b. Establezca el valor de R epo si to ry UR L a

http: //maven. repo si to ry. red hat. co m/techprevi ew/al l .

c. Haga clic en la casilla de verificación Acti ve by d efaul t para habilitar el

repositorio Maven.

d. Haga clic en O K

Fig u ra 4 .8. Ag reg u e el rep o sit o rio Maven - JB o ss T ech Preview

4. Haga clic en Ad d R epo si to ry para configurar el repositorio JBoss Early Access Maven.
Complete el cuadro de diálogo Ad d Maven R epo si to ry así:

a. Establezca los valores de P ro fi l e ID , R epo si to ry ID , y R epo si to ry Name a

jbo ss-g a-repo si to ry.

25
G uía de inicio

b. Establezca el valor R epo si to ry UR L a

http: //maven. repo si to ry. red hat. co m/earl yaccess/al l /.

c. Haga clic en la casilla de verificación Acti ve by d efaul t para habilitar el

repositorio Maven.

d. Haga clic en O K

Fig u ra 4 .9 . Ag reg ar rep o sit o rio Maven - JB o ss Early Access

5. Revisar los repositorios y hacer clic en Fi ni sh.

26
 ⁠Capít ulo 4 . Inst rucciones posinst alación

Fig u ra 4 .10. R evisar lo s rep o sit o rio s Maven

6. Aparecerá el siguiente mensaje " Are you sure you want to update the file
'MAVEN_HOME/settings.xml'?" . Haga clic en Y es para actualizar los parámetros. Haga clic
en O K para cerrar el cuadro de diálogo.

El repositorio JBoss EAP Maven ahora está configurado para usar con Red Hat JBoss
D eveloper Studio.

Reportar un error

4 .2.4 . Configurar Maven para línea de comandos

4 .2 .4 .1 . De scarga e inst alació n de Mave n

Si su plan es usar la línea de comandos Maven para construir e implementar sus aplicaciones para
JBoss EAP, debe descargar e instalar Maven. Si piensa usar Red Hat JBoss D eveloper Studio para
crear e implementar sus aplicaciones, puede ignorar este procedimiento, puesto que Maven se
distribuye con Red Hat JBoss D eveloper Studio.

1. Vaya a Apache Maven Project - D ownload Maven y descargue la última distribución para su
sistema operativo.

27
G uía de inicio

2. Vea la documentación de Maven para obtener mayor información sobre cómo descargar e
instalar Apache Maven para su sistema operativo.

Reportar un error

4 .2 .4 .2 . Co nfigurar lo s parám e t ro s Mave n para usar co n la líne a de co m ando s

Los artefactos y dependencias necesarias para construir e implementar aplicaciones para JBoss
EAP 6 se alojan en un repositorio público. Si va a usar Red Hat JBoss D eveloper Studio para
construir e implementar aplicaciones, puede omitir este tema. En su lugar, siga las instrucciones
aquí: Sección 4.2.3.1, “ Configurar Maven para usar con Red Hat JBoss D eveloper Studio” .

Hay 2 formas de configurar los parámetros para usar con Maven en la línea de comandos

Puede copiar el archivo preconfigurado setti ng s. xml que se distribuya con inicios rápidos.

Modifique de forma manual el archivo Maven setti ng s. xml .

Este tema describe ambos métodos. Si ha descargado los inicios rápidos, el primer procedimiento es
la forma más sencilla de configurar los parámetros.

Prerreq u isit o s

D ebe instalar Maven antes de configurar los parámetros. Para obtener más información, consulte la:
Sección 4.2.4.1, “ D escarga e instalación de Maven”

Pro ced imien t o 4 .4 . C o n f ig u ració n d e Maven u san d o lo s p arámet ro s en viad o s co n lo s

ejemp lo s d el Q u ickst art

Red Hat JBoss Enterprise Application Platform Quickstarts se distribuye con un archivo
setti ng s. xml que está configurado para usar en línea el repositorio JBoss EAP Maven. Si ha
descargado los inicios rápidos, es la forma más fácil de configurar los parámetros.

1. Este procedimiento sobrescribe el archivo de configuración Maven existente así que debe
realizar una copia de seguridad del archivo Maven setti ng s. xml existente .

a. Ubique el directorio de instalación Maven para su sistema operativo. Usualmente se

instala en el directorio USER_HOME/. m2/.

Para Linux o Mac este es: ~ /. m2/

Para Windows es: \D o cuments and Setti ng s\USER_NAME\. m2\ o

\Users\USER_NAME\. m2\

b. Si ya tiene un archivo USER_HOME/. m2/setti ng s. xml renómbrelo o haga una

copia de seguridad para que lo pueda restablecer después.

2. Si aún no ha descargado inicios rápidos, siga las instrucciones aquí: Sección 3.4.1,
“ D escarga de los inicios rápidos” .

3. Copie el archivo QUICKSTART_HOME/setti ng s. xml en el directorio USER_HOME/. m2/.

4. Si modifica el archivo setti ng s. xml mientras Red Hat JBoss D eveloper Studio está
ejecutándose, siga el procedimiento de abajo titulado Refresh the Red Hat JBoss Developer
Studio User Settings.

Pro ced imien t o 4 .5. Mo d if iq u e y co n f ig u re d e f o rma man u al lo s p arámet ro s Maven p ara

u sar el rep o sit o rio JB o ss EAP Maven en lín ea.

28
 ⁠Capít ulo 4 . Inst rucciones posinst alación

Usted puede agregar en forma manual los perfiles JBoss EAP a un archivo de parámetros Maven.

1. Ubique el directorio de instalación Maven para su sistema operativo. Usualmente se instala

en el directorio USER_HOME/. m2/.

Para Linux o Mac este es ~ /. m2/

Para Windows es \D o cuments and Setti ng s\USER_NAME\. m2\ o

\Users\USER_NAME\. m2\

2. Si no encuentra un archivo setti ng s. xml copie el archivo setti ng s. xml del directorio
USER_HOME/. m2/co nf/ al directorio USER_HOME/. m2/.

3. Copie el siguiente XML en el elemento <pro fi l es> del archivo.

<!-- Configure the JBoss GA Maven repository -->

<profile>
<id>jboss-ga-repository</id>
<repositories>
<repository>
<id>jboss-ga-repository</id>

<url>http://maven.repository.redhat.com/techpreview/all</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>jboss-ga-plugin-repository</id>

<url>http://maven.repository.redhat.com/techpreview/all</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>
</profile>
<!-- Configure the JBoss Early Access Maven repository -->
<profile>
<id>jboss-earlyaccess-repository</id>
<repositories>
<repository>
<id>jboss-earlyaccess-repository</id>

<url>http://maven.repository.redhat.com/earlyaccess/all/</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>

29
G uía de inicio

<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>jboss-earlyaccess-plugin-repository</id>

<url>http://maven.repository.redhat.com/earlyaccess/all/</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>
</profile>

Copie el siguiente XML en el elemento <acti veP ro fi l es> del archivo setti ng s. xml .

<activeProfile>jboss-ga-repository</activeProfile>
<activeProfile>jboss-earlyaccess-repository</activeProfile>

4. Si modifica el archivo setti ng s. xml mientras Red Hat JBoss D eveloper Studio está
ejecutándose, siga el procedimiento de abajo titulado Refresh the Red Hat JBoss Developer
Studio User Settings.

Pro ced imien t o 4 .6 . R ef resq u e lo s p arámet ro s d el u su ario d e JB o ss D evelo p er St u d io

Si modifica el archivo setti ng s. xml mientras que Red Hat JBoss D eveloper Studio esté en
ejecución, debe refrescar los parámetros de usuario.

1. D el menú, seleccione Win d o w → Pref eren ces.

2. En la ventana P references, expanda Maven y seleccione User Setti ng s.

3. Haga clic en el botón Upd ate Setti ng s para refrescar los parámetros del usuario de
Maven en Red Hat JBoss D eveloper Studio.

30
 ⁠Capít ulo 4 . Inst rucciones posinst alación

Fig u ra 4 .11. Act u aliz ar lo s p arámet ro s d e u su ario d e Maven

Importante

Si su repositorio Maven contiene artefactos desactualizados, podría encontrar alguno de los

siguientes mensajes de errores de Maven cuando construya o implemente el proyecto:

Missing artifact ARTIFACT_NAME

[ERROR] No se pudo ejecutar la meta sobre el proyecto PROJECT_NAME; No se pudieron
resolver dependencias para PROJECT_NAME

Para resolver este problema, borre la versión en caché de su repositorio local para forzar la
descarga más reciente de artefactos Maven. El repositorio en caché se sitúa en su
subdirectorio ~ /. m2/repo si to ry/ de Linux, o en el subdirectorio
%SystemDrive%\Users\USERNAME\. m2\repo si to ry\ de Windows.

Reportar un error

31
G uía de inicio

Capítulo 5. Ensáyelo

5.1. Ejecut e los Quickst art s

5.1.1. Ejecut e los Quickst art s en Red Hat JBoss Developer St udio

Esta sección describe cómo usar Red Hat JBoss D eveloper Studio para implementar los inicios
rápidos y ejecutar las pruebas Arquillian.

Pro ced imien t o 5.1. Imp o rt ar lo s in icio s ráp id o s en R ed H at JB o ss D evelo p er St u d io

Cada inicio rápido se distribuye con un archivo POM que contiene información sobre el proyecto y
configuración para el inicio rápido. Al usar este archivo POM, usted puede importar con facilidad el
inicio rápido en Red Hat JBoss D eveloper Studio.

Importante

Si su carpeta de proyectos de inicios rápidos se localiza dentro del espacio de trabajo ID E

cuando lo importa a Red Hat JBoss D eveloper Studio, el ID E genera un nombre de proyecto
inválido y el nombre de archivo WAR. Verifique si su carpeta de proyecto de inicios rápidos se
localiza fuera del espacio de trabajo ID E antes de comenzar.

1. Si aún no lo ha hecho entonces, Sección 4.2.4.2, “ Configurar los parámetros Maven para
usar con la línea de comandos” .

2. Iniciar Red Hat JBoss D eveloper Studio.

3. D esde el menú seleccione File → Imp o rt .

4. En la lista de selección escoja Maven → Exist in g Maven Pro ject s y luego haga clic en
Next.

32
 ⁠Capít ulo 5. Ensáyelo

Fig u ra 5.1. Imp o rt ació n d e p ro yect o s Maven exist en t es

5. Navegue hasta el directorio del inicio rápido que quiera probar; por ejemplo, el inicio rápido
hel l o wo rl d y haga clic en O K. La casilla P ro jects se poblará con el archivo po m. xml
del proyecto del inicio rápido seleccionado.

33
G uía de inicio

Fig u ra 5.2. Seleccio n e p ro yect o s Maven

6. Haga clic en Fi ni sh.

Pro ced imien t o 5.2. C o n st ru ya e imp lemen t e el in icio ráp id o hel l o wo rl d

El inicio rápido hel l o wo rl d es uno de los inicios rápidos más simples y es una buena manera de
verificar que el servidor JBoss está configurado y ejecutando de manera correcta.

1. Si no ve una pestaña Servers o no tiene aún definido un servidor, siga las siguientes
instrucciones aquí: Sección 4.1.5, “ Agregar JBoss EAP Server mediante D efine New Server” .
Si piensa implementar un inicio rápido que requiera el perfil ful l o argumentos de inicio
adicionales, asegúrese de crear el entorno de tiempo de ejecución de servidor como se
anota en las instrucciones de inicios rápidos.

2. Haga clic derecho en el proyecto jbo ss-hel l o wo rl d de la pestaña P ro ject Expl o rer
y seleccione R u n As. Se le presentará una lista de opciones. Seleccione R u n o n Server.

34
 ⁠Capít ulo 5. Ensáyelo

Fig u ra 5.3. R u n As - Ejecu t ar en el servid o r

3. Seleccione JBo ss EAP 6 . 1+ R unti me Server de la lista de servidores y haga clic en

Next.

Fig u ra 5.4 . Ejecu t ar en el servid o r

4. La siguiente pantalla muestra los recursos que están configurados en el servidor. El inicio
rápido jbo ss-hel l o wo rl d está configurado para usted. Haga clic en Fi ni sh para
implementar el inicio rápido.

35
G uía de inicio

Fig u ra 5.5. Mo d if icar recu rso s co n f ig u rad o s en el servid o r

5. Revisar los resultados

En la pestaña Server, el estatus de JBoss EAP 6.x Runtime Server cambia a [Started ,
R epubl i sh] .

La pestaña del servidor C o nso l e muestra mensajes que describen el inicio del servidor
JBoss EAP 6.x y la implementación del inicio rápido helloworld.

Una pestaña hel l o wo rl d aparece mostrando la URL http://localhost:8080/jboss-

helloworld/HelloWorld y el texto " Hello World!" .

Los siguientes mensajes en la C o nso l e confirman la implementación del archivo

jbo ss-hel l o wo rl d . war:

36
 ⁠Capít ulo 5. Ensáyelo

JBAS018210: Register web context: /jboss-helloworld

JBAS018559: Deployed "jboss-helloworld.war" (runtime-name :
"jboss-helloworld.war")

El contexto de red registrado se agrega al final de http: //l o cal ho st: 80 80 para
proporcionar la URL utilizada para acceder la aplicación implementada.

6. Para verificar si el inicio rápido hel l o wo rl d se ha implementado correctamente para el

servidor JBoss, abra un navegador web y acceda la aplicación en esta URL:
http://localhost:8080/jboss-helloworld

Pro ced imien t o 5.3. Ejecu t e las p ru eb as Arq u illian d e in icio ráp id o bean-val i d ati o n

Algunos inicios rápidos no proporcionan una capa de interfaz de usuario y en su lugar,

proporcionan pruebas Arquillian para demostrar ejemplos de código. El inicio rápido bean-
val i d ati o n es un ejemplo de un inicio rápido que proporciona pruebas Arquillian.

1. Siga el procedimiento de arriba para importar el inicio rápido bean-val i d ati o n a Red Hat
JBoss D eveloper Studio.

2. En la pestaña Servers, haga clic derecho en el servidor y elija St art para iniciar el servidor
JBoss EAP. Si no ve una pestaña Servers o si aún no ha definido un servidor, siga las
instrucciones aquí: Sección 4.1.5, “ Agregar JBoss EAP Server mediante D efine New Server” .

3. Haga clic derecho en el proyecto jbo ss-bean-val i d ati o n de la pestaña P ro ject

Expl o rer y seleccione R u n As. Se le presentará una lista de opciones. Seleccione Maven
B u ild .

4. En el campo de salida G o al s del dialogo Ed i t C o nfi g urati o n, escriba: cl ean test -

P arq -jbo ssas-remo te

Luego haga clic en R un.

37
G uía de inicio

Fig u ra 5.6 . Mo d if iq u e la co n f ig u ració n

5. Revisar los resultados

La pestaña del servidor C o nso l e muestra mensajes que describen el inicio y la salida de
las pruebas Arquillian de inicio rápido bean-val i d ati o n.

-------------------------------------------------------
T E S T S
-------------------------------------------------------
Running
org.jboss.as.quickstarts.bean_validation.test.MemberValidationTest
Tests run: 5, Failures: 0, Errors: 0, Skipped: 0, Time elapsed:
2.189 sec

Results :

Tests run: 5, Failures: 0, Errors: 0, Skipped: 0

38
 ⁠Capít ulo 5. Ensáyelo

[INFO] ------------------------------------------------------------
------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------
------------

Reportar un error

5.1.2. Ejecut ar los Quickst art s usando una línea de comandos

Pro ced imien t o 5.4 . C o n st ru ir e imp lemen t ar lo s Q u ickst art s u san d o u n a lín ea d e
co man d o s

Puede construir e implementar fácilmente los inicios rápidos usando una línea de comandos. Tenga
en cuenta que al utilizar una línea de comandos, usted es el responsable de iniciar el servidor
JBoss si se requiere.

1. Si aún no lo ha hecho, entonces vaya a Sección 4.2.4.2, “ Configurar los parámetros Maven
para usar con la línea de comandos” .

2. Revise el archivo R EAD ME. html en el directorio root de los inicios rápidos.

Este archivo contiene información general sobre los requerimientos del sistema, cómo
configurar Maven, cómo agregar usuarios y cómo ejecutar los inicios rápidos. Asegúrese de
leerlo antes de empezar.

También contiene una tabla que enumera los inicios rápidos disponibles. La tabla lista cada
nombre de inicio rápido y la tecnología que demuestra. Brinda una corta descripción de
cada inicio rápido y el nivel de experiencia requerido para configurarlo. Para obtener
información detallada sobre un inicio rápido haga clic en su nombre.

Algunos inicios rápidos están diseñados para mejorar o extender otros inicios rápidos.
Estos están resaltados en la columna de P rereq ui si tes. Si un inicio rápido enumera
prerrequisitos, entonces deberá instalarlos antes de utilizar los inicios rápidos.

Algunos inicios rápidos requieren la instalación y configuración de componentes

opcionales. No instale estos componentes a menos de que el inicio rápido los requiera.

3. Ejecute el inicio rápido hel l o wo rl d .

Un inicio rápido hel l o wo rl d es uno de los inicios más sencillos y es una buena forma de
verificar que el servidor JBoss esté configurado y ejecutándose de manera correcta. Abra el
archivo R EAD ME en la raíz del inicio rápido hel l o wo rl d . Contiene instrucciones
detalladas sobre cómo construir e implementar el inicio rápido y acceder a la aplicación en
ejecución.

4. Ejecute los otros inicios rápidos.

Siga las instrucciones en el archivo R EAD ME. html localizado en la carpeta raíz del inicio
rápido para ejecutar el ejemplo.

Reportar un error

39
G uía de inicio

Apéndice A. Tomas de pantalla del programa de instalación

A.1. Selección del idioma

Fig u ra A.1. Selecció n d el id io ma d el p ro g rama d e in st alació n d e JB o ss EAP

Reportar un error

A.2. Acuerdo de licencia del usuario final

40
 ⁠Apéndice A. T omas de pant alla del programa de inst alación

Fig u ra A.2. Acu erd o d e licen cia d el u su ario f in al d el p ro g rama d e in st alació n d e JB o ss

EAP

Reportar un error

A.3. Rut a de inst alación

41
G uía de inicio

Fig u ra A.3. R u t a d e in st alació n d el p ro g rama d el in st alad o r JB o ss EAP

Reportar un error

A.4 . Selección de paquet es a inst alar

Seleccione o desactive los paquetes a instalar. No se pueden desactivar los paquetes requeridos.

42
 ⁠Apéndice A. T omas de pant alla del programa de inst alación

Fig u ra A.4 . Paq u et es d e selecció n d el p ro g rama d e in st alació n d e JB o ss EAP a in st alar

Reportar un error

A.5. Creación del usuario administ rat ivo

43
G uía de inicio

Fig u ra A.5. C reació n d el u su ario ad min ist rat ivo d el p ro g rama d e in st alació n d e JB o ss
EAP

Reportar un error

A.6. Inst alación de inicio rápido

44
 ⁠Apéndice A. T omas de pant alla del programa de inst alación

Fig u ra A.6 . C o n f ig u ració n d el in icio ráp id o d el p ro g rama d el in st alad o r d e JB o ss EAP

Reportar un error

A.7. Configuración del reposit orio Maven

45
G uía de inicio

Fig u ra A.7. C o n f ig u ració n d el rep o sit o rio Maven d el p ro g rama d e in st alació n d e JB o ss

EAP

Reportar un error

A.8. Configuración de enlace de socket s

D etermine si debe utilizar los enlaces predeterminados o si debe configurar enlaces personalizados.

46
 ⁠Apéndice A. T omas de pant alla del programa de inst alación

Fig u ra A.8. En laces d e so cket p red et ermin ad o s d el p ro g rama d e in st alació n d e JB o ss

EAP

Reportar un error

A.9. Inicio del servidor

47
G uía de inicio

Fig u ra A.9 . In iciar el servid o r d el p ro g rama d e in st alació n d e JB o ss EAP

Reportar un error

A.10. Configuración de los niveles de regist ro

48
 ⁠Apéndice A. T omas de pant alla del programa de inst alación

Fig u ra A.10. C ó mo evit ar lo s n iveles d e reg ist ro d e JB o ss EAP In st allat io n Pro g ram

Reportar un error

A.11. Configuración del ent orno del t iempo de ejecución

49
G uía de inicio

Fig u ra A.11. En t o rn o d el t iemp o d e ejecu ció n d e la co n f ig u ració n d el p ro g rama d e la

in st alació n d e JB o ss EAP - Pred et ermin ad o

Reportar un error

A.12. Revisión de los component es de inst alación

50
 ⁠Apéndice A. T omas de pant alla del programa de inst alación

Fig u ra A.12. C o mp o n en t es seleccio n ad o s p ara la revisió n d el p ro g rama d e in st alació n

d e JB o ss EAP

Reportar un error

A.13. Progreso de la inst alación

51
G uía de inicio

Fig u ra A.13. Pro g reso d e la in st alació n d e lo s co mp o n en t es d el p ro g rama d e

in st alació n d e JB o ss EAP

Reportar un error

A.14 . Procesamient o de la inst alación complet ado

52
 ⁠Apéndice A. T omas de pant alla del programa de inst alación

Fig u ra A.14 . Pro cesamien t o d el p ro g rama d e in st alació n JB o ss EAP co mp let ad o

Reportar un error

A.15. Creación de at ajos

53
G uía de inicio

Fig u ra A.15. C rear at ajo s d el in st alad o r JB o ss EAP

Reportar un error

A.16. Generación del script de inst alación

54
 ⁠Apéndice A. T omas de pant alla del programa de inst alación

Fig u ra A.16 . Scrip t d e in st alació n g en era el p ro g rama d e in st alació n d e JB o ss EAP

Reportar un error

55
G uía de inicio

Apéndice B. Historial de revisiones

R evisió n 6 .4 .0- 10.1 Fri Au g 28 2015 G lad ys G u errero Lo z an o
Traducción de versión 6.4

R evisió n 6 .4 .0- 10 T u esd ay Ap ril 14 2015 Lu cas C o st i

Red Hat JBoss Enterprise Application Platform 6.4.0.GA

56