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
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.
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.
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
. .péndice
. . . . . . . B.
. . Hist
. . . . orial
. . . . de
. . . revisiones
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
...........
2
P refacio
Prefacio
Este manual utiliza varias convenciones para resaltar algunas palabras y frases y llamar la
atención sobre ciertas partes específicas de información.
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:
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:
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:
N eg rit a p ro p o rcio n al
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).
3
G uía de inicio
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.
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.
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:
Los mensajes de salida de la terminal o fragmentos de código fuente se diferencian visualmente del
texto circundante.
4
P refacio
mutex_lock(& kvm->lock);
kvm_deassign_device(kvm, match);
kvm_free_assigned_device(kvm, match);
out:
mutex_unlock(& kvm->lock);
return r;
}
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
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á:
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.
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
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
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.
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
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:
Reportar un error
Reportar un error
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
Reportar un error
8
Capít ulo 2 . Prerrequisit os
Capítulo 2. Prerrequisitos
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
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.
Reportar un error
9
G uía de inicio
Reportar un error
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” .
2. Haga clic en D o wn lo ad s.
4. Seleccione la versión correcta de la versión de JBoss EAP del menú desplegable Versi o n.
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” .
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.
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
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/.
1. Abra una terminal y navegue al directorio que contiene la JAR del programa de instalación
descargado.
11
G uía de inicio
12
Capít ulo 3. Descargar e inst alar el product o
R esu lt ad o
Reportar un error
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.
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” .
2. Haga clic en D o wn lo ad s.
4. Seleccione la versión correcta de la versión de JBoss EAP del menú desplegable Versi o n.
6. Se le pedirá que guarde el archivo Z ip en un directorio que usted elija. Elija el directorio y
guarde el archivo.
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” .
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
Reportar un error
R esu men
Este tema aborda los pasos para instalar JBoss EAP 6 mediante el archivo zip descargado.
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.
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 .
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
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.
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” .
2. Haga clic en D o wn lo ad s.
4. Seleccione la versión correcta de la versión de JBoss EAP del menú desplegable Versi o n.
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.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” .
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.
4. Se le pedirá que guarde el archivo Z ip en un directorio que usted elija. Elija el directorio y
guarde el archivo.
Reportar un error
15
G uía de inicio
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
1. Ir a https://www.jboss.org/products/devstudio.html.
Reportar un error
1. Abra una terminal y navegue a un directorio que contenga el archivo . jar descargado.
Nota
D e modo alternativo, puede hacer clic en el archivo . jar para lanzar el programa de
instalación.
4. Seleccione I accept the terms o f thi s l i cense ag reement y haga clic en Next.
Nota
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.
10. Configure los atajos de escritorio para Red Hat JBoss D eveloper Studio, y haga clic en el
botón Next.
Reportar un error
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.
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
Reportar un error
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.
1. Abra la pestaña Servers. Si no hay una pestaña Servers agréguela al panel así:
17
G uía de inicio
18
Capít ulo 4 . Inst rucciones posinst alación
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
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
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
R esu lt ad o
22
Capít ulo 4 . Inst rucciones posinst alación
Reportar un error
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
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
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.
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
d. Haga clic en O K
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í:
25
G uía de inicio
d. Haga clic en O K
26
Capít ulo 4 . Inst rucciones posinst alación
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
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
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.
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”
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 .
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” .
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.
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.
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/.
<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.
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.
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
Importante
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.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.
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
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” .
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
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
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
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
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.
36
Capít ulo 5. Ensáyelo
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.
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
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” .
37
G uía de inicio
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 :
38
Capít ulo 5. Ensáyelo
[INFO] ------------------------------------------------------------
------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------
------------
Reportar un error
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.
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.
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
Reportar un error
40
Apéndice A. T omas de pant alla del programa de inst alación
Reportar un error
41
G uía de inicio
Reportar un error
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
Reportar un error
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
44
Apéndice A. T omas de pant alla del programa de inst alación
Reportar un error
45
G uía de inicio
Reportar un error
46
Apéndice A. T omas de pant alla del programa de inst alación
Reportar un error
47
G uía de inicio
Reportar un error
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
49
G uía de inicio
Reportar un error
50
Apéndice A. T omas de pant alla del programa de inst alación
Reportar un error
51
G uía de inicio
Reportar un error
52
Apéndice A. T omas de pant alla del programa de inst alación
Reportar un error
53
G uía de inicio
Reportar un error
54
Apéndice A. T omas de pant alla del programa de inst alación
Reportar un error
55
G uía de inicio
56