Guía de inicio

Procedimiento 3.1. Descargue JBoss EAP Installation Program desde el Portal del cliente en 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 Downloads.
3. Haga clic en Red Hat JBoss Enterprise Application Platform en la lista Product Downloads.
4. Seleccione la versión correcta de la versión de JBoss EAP del menú desplegable Version.
5. Busque Red Hat JBoss Enterprise Application Platform 6.x.x Installer en la lista y haga clic en la opción Download.
6. Se le ha solicitado guardar el archivo JAR en un directorio de su preferencia. Elija un directorio y guarde el archivo.

Procedimiento 3.2. Descargue JBoss EAP Installation Program desde el programa de instalación jboss.org en Red Hat JBoss Developer Program

1. Abra un navegador y acceda la siguiente URL: http://www.jboss.org/products/eap.
   • Para descargar el programa de instalación de la versión de disponibilidad general del producto, haga clic en el botón Download a la derecha de la página.
   • 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.
     1. Haga clic en el enlace Download JBoss EAP que está a la derecha de la página.
     2. Haga clic en el enlace Installer en la columna Download 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.

Procedimiento 3.3. Ejecutar el programa de instalación de JBoss 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

   Copy to Clipboard Toggle word wrap
3. Siga las instrucciones en la tabla a continuación.

Procedimiento 3.4. Descargue los archivos Zip desde el Portal del cliente en 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 Downloads.
3. Haga clic en Red Hat JBoss Enterprise Application Platform en la lista Product Downloads.
4. Seleccione la versión correcta de la versión de JBoss EAP del menú desplegable Version.
5. Busque Red Hat JBoss Enterprise Application Platform 6.x.x en la lista y haga clic en la opción Download.
6. Se le pedirá que guarde el archivo Zip en un directorio que usted elija. Elija el directorio y guarde el archivo.

Procedimiento 3.5. Descargue el archivo ZIP de jboss.org en Red Hat JBoss Developer Program

1. Abra un navegador de red y acceda esta URL: http://www.jboss.org/products/eap/
2. Haga clic en el enlace Download JBoss EAP a la izquierda de la página.
3. Haga clic en el enlace ZIP en la columna Download para obtener la versión de producto correcta.
4. Se le pedirá que guarde el archivo Zip en un directorio que usted elija. Elija el directorio y guarde el archivo.

Procedimiento 3.6. Instalación del archivo zip

1. Mueva el archivo zip a la ubicación deseada.

   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. Use una aplicación apropiada para extraer el archivador zip en la ubicación deseada.

   En un entorno Red Hat Enterprise Linux use la funcionalidad unzip 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 All.
   En un entorno Hewlett-Packard HP-UX use la funcionalidad unzip para extraer el contenido del archivador zip.

Procedimiento 3.7. Descargue los Quickstarts en 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 Downloads.
3. Haga clic en Red Hat JBoss Enterprise Application Platform en la lista Descarga de productos.
4. Seleccione la versión correcta de la versión de JBoss EAP del menú desplegable Version.
5. Primero, busque Red Hat JBoss Enterprise Application Platform 6.x.xQuickstarts en la lista y luego, haga clic en la opción Download.
6. Se le pedirá que guarde el archivo Zip en un directorio que usted elija. Elija el directorio y guarde el archivo.
7. Descomprima el archivo en el directorio elegido.

Procedimiento 3.8. Descargue los Quickstarts en Red Hat JBoss Developer Program

1. Abra un navegador de red y acceda esta URL: http://www.jboss.org/products/eap/
2. Haga clic en el enlace Download JBoss EAP a la izquierda de la página para desplegar información de descarga del producto.
3. En Download JBoss EAP, haga clic en el enlace Quickstarts para descargar un archivador Zip que contenga los ejemplos.
4. Se le pedirá que guarde el archivo Zip en un directorio que usted elija. Elija el directorio y guarde el archivo.
5. Descomprima el archivo en el directorio elegido.

1. Ir a https://www.jboss.org/products/devstudio.html.
2. Hacer clic en el botón Download. Se le solicitará guardar el archivo ZIP al directorio de su elección.

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

   Copy to Clipboard Toggle word wrap

   Nota

   De 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 of this license agreement 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 Ok para crear la carpeta.
6. Seleccione una MVJ o deje la MVJ predeterminada seleccionada y haga clic en Next.
7. Red Hat JBoss Developer Studio incluye Red Hat JBoss Enterprise Application Platform. Si ya estaba instalada, elija No. De lo contrario, elija Yes para instalar y configurarlos para usarlo con Red Hat JBoss Developer 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 Developer Studio, y haga clic en el botón Next.
11. Haga clic en Done.

Procedimiento 4.1. Comando para reiniciar Red Hat JBoss Developer Studio

1. Abra una terminal y navegue al directorio de instalación Red Hat JBoss Developer Studio
2. Ejecute el siguiente comando para iniciar Red Hat JBoss Developer Studio:
   Para Linux:

   [localhost]$ ./jbdevstudio

   Copy to Clipboard Toggle word wrap
   Para Microsoft Windows:

   C:\JBDS_INSTALL_DIRECTORY > jbdevstudio.bat

   Copy to Clipboard Toggle word wrap

Procedimiento 4.2. Agregar el servidor

1. Abra la pestaña Servers. Si no hay una pestaña Servers agréguela al panel así:
   1. Haga clic en Window → Show View → Other....
   2. Seleccione Servers desde la carpeta Server ya haga clic en OK.
2. Haga clic en No servers are available. Click this link to create a new server... o, si prefiere, haga clic derecho dentro del panel de servidor en blanco y seleccione New → Server.
   

   Figura 4.1. Agregue un nuevo servidor - No hay servidores disponibles

3. Expanda JBoss Enterprise Middleware y elija JBoss Enterprise Application Platform 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 runtime environment con la nueva definición de tiempo de ejecución.
   

   Figura 4.2. Definir el nuevo servidor

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

   Figura 4.3. Crear un nuevo adaptador de servidor

5. Ingrese un nombre, por ejemplo, "JBoss EAP 6.4 Runtime". En Home Directory, haga clic en Browse y navegue al sitio de instalación JBoss EAP. Luego haga clic en Next.
   

   Figura 4.4. Agregar un nuevo entorno de tiempo de ejecución de servidor

   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 full, debe definir un nuevo servidor y agregar un Server Runtime Environment que especifique standalone-full.xml para el Configuration file. Asegúrese de entregar al nuevo servidor un nombre descriptivo.
6. Configure los proyectos existentes para el nuevo servidor. Debido a que usted no tiene proyectos en este momento, haga clic en Finish.
   

   Figura 4.5. Modificar recursos para el nuevo servidor JBoss

Procedimiento 5.1. Importar los inicios rápidos en Red Hat JBoss Developer Studio

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 Developer Studio.

3. Desde el menú seleccione File → Import.

4. En la lista de selección escoja Maven → Existing Maven Projects y luego haga clic en Next.
   

   Figura 5.1. Importación de proyectos Maven existentes

5. Navegue hasta el directorio del inicio rápido que quiera probar; por ejemplo, el inicio rápido helloworld y haga clic en OK. La casilla Projects se poblará con el archivo pom.xml del proyecto del inicio rápido seleccionado.
   

   Figura 5.2. Seleccione proyectos Maven

6. Haga clic en Finish.

Procedimiento 5.2. Construya e implemente el inicio rápido helloworld

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 Define New Server”. Si piensa implementar un inicio rápido que requiera el perfil full 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 jboss-helloworld de la pestaña Project Explorer y seleccione Run As. Se le presentará una lista de opciones. Seleccione Run on Server.
   

   Figura 5.3. Run As - Ejecutar en el servidor

3. Seleccione JBoss EAP 6.1+ Runtime Server de la lista de servidores y haga clic en Next.
   

   Figura 5.4. Ejecutar en el servidor

4. La siguiente pantalla muestra los recursos que están configurados en el servidor. El inicio rápido jboss-helloworld está configurado para usted. Haga clic en Finish para implementar el inicio rápido.
   

   Figura 5.5. Modificar recursos configurados en el servidor

5. Revisar los resultados

   • En la pestaña Server, el estatus de JBoss EAP 6.x Runtime Server cambia a [Started, Republish] .
   • La pestaña del servidor Console muestra mensajes que describen el inicio del servidor JBoss EAP 6.x y la implementación del inicio rápido helloworld.
   • Una pestaña helloworld aparece mostrando la URL http://localhost:8080/jboss-helloworld/HelloWorld y el texto "Hello World!".
   • Los siguientes mensajes en la Console confirman la implementación del archivo jboss-helloworld.war:

     JBAS018210: Register web context: /jboss-helloworld
     JBAS018559: Deployed "jboss-helloworld.war" (runtime-name : "jboss-helloworld.war")
     

     Copy to Clipboard Toggle word wrap

     El contexto de red registrado se agrega al final de http://localhost:8080 para proporcionar la URL utilizada para acceder la aplicación implementada.
6. Para verificar si el inicio rápido helloworld 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

Procedimiento 5.3. Ejecute las pruebas Arquillian de inicio rápido bean-validation

1. Siga el procedimiento de arriba para importar el inicio rápido bean-validation a Red Hat JBoss Developer Studio.
2. En la pestaña Servers, haga clic derecho en el servidor y elija Start 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 Define New Server”.
3. Haga clic derecho en el proyecto jboss-bean-validation de la pestaña Project Explorer y seleccione Run As. Se le presentará una lista de opciones. Seleccione Maven Build.
4. En el campo de salida Goals del dialogo Edit Configuration, escriba: clean test -Parq-jbossas-remote
   Luego haga clic en Run.
   

   Figura 5.6. Modifique la configuración

5. Revisar los resultados
   La pestaña del servidor Console muestra mensajes que describen el inicio y la salida de las pruebas Arquillian de inicio rápido bean-validation.

   -------------------------------------------------------
    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
   
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   

   Copy to Clipboard Toggle word wrap

Procedimiento 5.4. Construir e implementar los Quickstarts usando una línea de comandos

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 README.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 Prerequisites. 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 helloworld.
   Un inicio rápido helloworld 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 README en la raíz del inicio rápido helloworld. 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 README.html localizado en la carpeta raíz del inicio rápido para ejecutar el ejemplo.