Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

Guía de inicio

Plataforma de aplicaciones empresariales JBoss 6.4

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

Resumen

Este libro proporciona los pasos básicos para poder iniciar con JBoss EAP 6.

Capítulo 1. Introducción

1.1. Plataforma 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.

1.2. Acerca del portal del cliente 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;
  • Descargar 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.

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 Developer Program, consulte http://www.jboss.org/developer-program/termsandconditions.

1.4. Acerca de Full Red Hat JBoss Commercial Program

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”.

1.5. Cómo encontrar 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.

Capítulo 2. Prerrequisitos

2.1. Prerrequisitos de instalación de JBoss EAP 6

Resumen

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

Prerrequisitos comunes

  • 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.

Prerrequisitos de ZIP/instalador

  • Debe otorgar privilegios de administración para el directorio de instalación.
  • Asegúrese de que el JDK escogido ya se haya extraído o instalado. Consulte la documentación de JDK 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 unzip.

Capítulo 3. Descargar e instalar el producto

3.1. Visión general de la instalació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. Despué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 ZIP.
Siga las instrucciones según su método de instalación preferido.

3.2. Descargar e instalar JBoss EAP mediante el programa de instalación gráfico

3.2.1. Descargar JBoss EAP 6 Installation Program

Resumen

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.

Procedimiento 3.1. Descargue JBoss EAP Installation Program desde el Portal del cliente en Full Red Hat JBoss Commercial Program

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

Siga este procedimiento si está participando en Red Hat JBoss Developer Program. Para obtener más información sobre este programa, consulte la Sección 1.3, “Acerca de 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.
Resultado

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

3.2.2. Ejecutar el programa de instalació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/.

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
  3. Siga las instrucciones en la tabla a continuación.

Tabla 3.1. Pantallas del programa de instalación de JBoss EAP

Nombre de la pantalla
Aparece
Descripción
Siempre
Seleccione el idioma deseado para el programa de instalación y haga clic en OK.
Siempre
EULA para RED HAT JBOSS MIDDLEWARE.
Seleccione "I accept the terms of this license agreement" y haga clic en Next.
Siempre
Seleccione la ruta de instalación para JBoss EAP y haga clic en Next. Se le solicitará que cree el nuevo directorio o si ya existe que remplace el directorio nombrado.
Siempre
Seleccione los paquetes a instalar. No se pueden desactivar l os paquetes requeridos.
Siempre
Cree un usuario administrativo y asigne una contraseña. Luego haga clic en Next.
Siempre
Instale los ejemplos de inicio rápido. Si desea instalarlos, seleccione Yes y elija la ruta de instalación. Luego haga clic en Next.
Si decide instalar los ejemplos de inicio rápido
Mantenga las selecciones predeterminadas para configurar de forma automática los parámetros predeterminados de Maven y usar el repositorio Maven alojado públicamente. Luego haga clic en Next.
Siempre
Guarde las vinculaciones de puerto predeterminadas, luego haga clic en Next.
Siempre
Seleccione la opción preferida sobre la finalización del proceso de instalación. Luego haga clic en Next.
Siempre
Elija No para evitar la configuración de niveles de registro. Luego haga clic en Next.
Siempre
Seleccione Perform default configuration y haga clic en Next para continuar.
Siempre
Revise sus elecciones y haga clic en Next.
Siempre
Cuando el progreso de la instalación se complete, haga clic en Next.
Siempre
Cuando el procesamiento termine, haga clic en Next.
Siempre
Acepte el predeterminado y haga clic en Next.
Siempre
Haga clic en Done.
La instalación está completa.
Resultado

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

3.3. Descargue e instale JBoss EAP mediante el ZIP

3.3.1. Descargar JBoss EAP 6 (instalación Zip)

Resumen

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.

Procedimiento 3.4. Descargue los archivos Zip desde el Portal del cliente en Full Red Hat JBoss Commercial Program

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

Siga este procedimiento si esta participando en Red Hat JBoss Developer Program. Para obtener más información sobre este programa, consulte la Sección 1.3, “Acerca de 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.
Resultado

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

3.3.2. Instalación de JBoss EAP 6 (instalación ZIP)

Resumen

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

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.
Resultado

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

3.4. Descargar los ejemplos de código Quickstart

3.4.1. Descarga de los inicios rápidos

Resumen

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. De 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.

Procedimiento 3.7. Descargue los Quickstarts en Full Red Hat JBoss Commercial Program

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

Siga este procedimiento si esta participando en Red Hat JBoss Developer Program. Para obtener más información sobre este programa, consulte Sección 1.3, “Acerca de 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.

Capítulo 4. Instrucciones posinstalación

4.1. Configurar el entorno de desarrollo

4.1.1. Visión general de la instalación de Red Hat JBoss Developer Studio

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

4.1.2. Descargar Red Hat JBoss Developer Studio

  1. Hacer clic en el botón Download. Se le solicitará guardar el archivo ZIP al directorio de su elección.

4.1.3. Instalar Red Hat JBoss Developer Studio

  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

    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.

4.1.4. Iniciar Red Hat JBoss Developer Studio

Para iniciar Red Hat JBoss Developer 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 Developer Studio mediante la línea de comandos.

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
    Para Microsoft Windows:
    C:\JBDS_INSTALL_DIRECTORY > jbdevstudio.bat

4.1.5. Agregar JBoss EAP Server mediante Define New Server

Estas instrucciones presumen que es su primera introducción a Red Hat JBoss Developer 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 Define New Server.

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 WindowShow ViewOther....
    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 NewServer.
    Agregue un nuevo servidor - No hay servidores disponibles

    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.
    Definir el nuevo servidor

    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.
    Crear un nuevo adaptador de servidor

    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.
    Agregar un nuevo entorno de tiempo de ejecución de servidor

    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.
    Modificar recursos para el nuevo servidor JBoss

    Figura 4.5. Modificar recursos para el nuevo servidor JBoss

Resultado

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

El servidor aparece en la lista de servidores

Figura 4.6. El servidor aparece en la lista de servidores

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/.

4.2.2. Configurar los parámetros Maven

Los artefactos y dependencias necesarias para construir e implementar aplicaciones para JBoss EAP 6 se alojan en un repositorio público. Debe 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 Developer Studio o la línea de comandos Maven para construir e implementar sus aplicaciones.
Red Hat JBoss Developer Studio incluye Maven, por lo tanto no es necesario descargar e instalar por separado. Si su plan es usar Red Hat JBoss Developer 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 Developer 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, “Descarga 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”

4.2.3. Configurar Maven para Red Hat JBoss Developer Studio

4.2.3.1. Configurar Maven para usar con Red Hat JBoss Developer Studio

Los artefactos y dependencias necesarias para construir e implementar aplicaciones para Red Hat JBoss Enterprise Application Platform se alojan en un repositorio público. Debe 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 Developer 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 Developer 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 Developer Studio.

Procedimiento 4.3. Configurar Maven en Red Hat JBoss Developer Studio

  1. Haga clic en WindowPreferences, expanda JBoss Tools y seleccione JBoss Maven Integration.
    Click Window→Preferences, expand JBoss Tools and select JBoss Maven Integration.

    Figura 4.7. Panel de JBoss Maven Integration en la ventana de preferencias

  2. Haga clic en Configure Maven Repositories.
  3. Haga clic en Add Repository para configurar el repositorio JBoss GA Tech Preview Maven. Complete el cuadro de diálogo Add Maven Repository así:
    1. Establezca los valores de Profile ID, Repository ID, y Repository Name a jboss-ga-repository.
    2. Establezca el valor de Repository URL a http://maven.repository.redhat.com/techpreview/all.
    3. Haga clic en la casilla de verificación Active by default para habilitar el repositorio Maven.
    4. Haga clic en OK
    Enter Maven profile and repository values.

    Figura 4.8. Agregue el repositorio Maven - JBoss Tech Preview

  4. Haga clic en Add Repository para configurar el repositorio JBoss Early Access Maven. Complete el cuadro de diálogo Add Maven Repository así:
    1. Establezca los valores de Profile ID, Repository ID, y Repository Name a jboss-ga-repository.
    2. Establezca el valor Repository URL a http://maven.repository.redhat.com/earlyaccess/all/.
    3. Haga clic en la casilla de verificación Active by default para habilitar el repositorio Maven.
    4. Haga clic en OK
    Enter Maven profile and repository values.

    Figura 4.9. Agregar repositorio Maven - JBoss Early Access

  5. Revisar los repositorios y hacer clic en Finish.
    Review Maven profile and repository values.

    Figura 4.10. Revisar los repositorios Maven

  6. Aparecerá el siguiente mensaje "Are you sure you want to update the file 'MAVEN_HOME/settings.xml'?". Haga clic en Yes para actualizar los parámetros. Haga clic en OK para cerrar el cuadro de diálogo.
    El repositorio JBoss EAP Maven ahora está configurado para usar con Red Hat JBoss Developer Studio.

4.2.4. Configurar Maven para línea de comandos

4.2.4.1. Descarga e instalación de Maven

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 Developer Studio para crear e implementar sus aplicaciones, puede ignorar este procedimiento, puesto que Maven se distribuye con Red Hat JBoss Developer Studio.
  1. Vaya a Apache Maven Project - Download Maven y descargue la última distribución para su sistema operativo.
  2. Vea la documentación de Maven para obtener mayor información sobre cómo descargar e instalar Apache Maven para su sistema operativo.

4.2.4.2. Configurar los parámetros Maven para usar con la línea de comandos

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 Developer 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 Developer Studio”.
Hay 2 formas de configurar los parámetros para usar con Maven en la línea de comandos
  • Puede copiar el archivo preconfigurado settings.xml que se distribuya con inicios rápidos.
  • Modifique de forma manual el archivo Maven settings.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.
Prerrequisitos

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

Procedimiento 4.4. Configuración de Maven usando los parámetros enviados con los ejemplos del Quickstart

Red Hat JBoss Enterprise Application Platform Quickstarts se distribuye con un archivo settings.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 settings.xml existente .
    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: \Documents and Settings\USER_NAME\.m2\ o \Users\USER_NAME\.m2\
    2. Si ya tiene un archivo USER_HOME/.m2/settings.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, “Descarga de los inicios rápidos”.
  3. Copie el archivo QUICKSTART_HOME/settings.xml en el directorio USER_HOME/.m2/.
  4. Si modifica el archivo settings.xml mientras Red Hat JBoss Developer Studio está ejecutándose, siga el procedimiento de abajo titulado Refresh the Red Hat JBoss Developer Studio User Settings.

Procedimiento 4.5. Modifique y configure de forma manual los parámetros Maven para usar el repositorio JBoss EAP Maven en línea.

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 \Documents and Settings\USER_NAME\.m2\ o \Users\USER_NAME\.m2\
  2. Si no encuentra un archivo settings.xml copie el archivo settings.xml del directorio USER_HOME/.m2/conf/ al directorio USER_HOME/.m2/.
  3. Copie el siguiente XML en el elemento <profiles> 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>
            <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 <activeProfiles> del archivo settings.xml.
    <activeProfile>jboss-ga-repository</activeProfile>
    <activeProfile>jboss-earlyaccess-repository</activeProfile>
    
  4. Si modifica el archivo settings.xml mientras Red Hat JBoss Developer Studio está ejecutándose, siga el procedimiento de abajo titulado Refresh the Red Hat JBoss Developer Studio User Settings.

Procedimiento 4.6. Refresque los parámetros del usuario de JBoss Developer Studio

Si modifica el archivo settings.xml mientras que Red Hat JBoss Developer Studio esté en ejecución, debe refrescar los parámetros de usuario.
  1. Del menú, seleccione WindowPreferences.
  2. En la ventana Preferences, expanda Maven y seleccione User Settings.
  3. Haga clic en el botón Update Settings para refrescar los parámetros del usuario de Maven en Red Hat JBoss Developer Studio.
    Actualizar los parámetros de usuario de Maven

    Figura 4.11. Actualizar los parámetros de usuario de 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/repository/ de Linux, o en el subdirectorio %SystemDrive%\Users\USERNAME\.m2\repository\ de Windows.

Capítulo 5. Ensáyelo

5.1. Ejecute los Quickstarts

5.1.1. Ejecute los Quickstarts en Red Hat JBoss Developer Studio

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

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

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

Importante

Si su carpeta de proyectos de inicios rápidos se localiza dentro del espacio de trabajo IDE cuando lo importa a Red Hat JBoss Developer Studio, el IDE 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 IDE antes de comenzar.
  1. Iniciar Red Hat JBoss Developer Studio.
  2. Desde el menú seleccione FileImport.
  3. En la lista de selección escoja MavenExisting Maven Projects y luego haga clic en Next.
    Importación de proyectos Maven existentes

    Figura 5.1. Importación de proyectos Maven existentes

  4. 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.
    Seleccione proyectos Maven

    Figura 5.2. Seleccione proyectos Maven

  5. Haga clic en Finish.

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

El inicio rápido helloworld 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 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.
    Run As - Ejecutar en el servidor

    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.
    Ejecutar en el servidor

    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.
    Modificar recursos configurados en el servidor

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

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-validation 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-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.
    Modifique la configuración

    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] ------------------------------------------------------------------------
    

5.1.2. Ejecutar los Quickstarts usando una línea de comandos

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

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. 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.
  2. 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.
  3. 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.

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

A.1. Selección del idioma

Choose the desired language for the installation program.

Figura A.1. Selección del idioma del programa de instalación de JBoss EAP

A.2. Acuerdo de licencia del usuario final

Agree to the End User License Agreement to continue.

Figura A.2. Acuerdo de licencia del usuario final del programa de instalación de JBoss EAP

A.3. Ruta de instalación

Define the installation path for the JBoss EAP instance.

Figura A.3. Ruta de instalación del programa del instalador JBoss EAP

A.4. Selección de paquetes a instalar

Seleccione o desactive los paquetes a instalar. No se pueden desactivar los paquetes requeridos.
Paquetes de selección del programa de instalación de JBoss EAP a instalar

Figura A.4. Paquetes de selección del programa de instalación de JBoss EAP a instalar

A.5. Creación del usuario administrativo

Create an administrative user.

Figura A.5. Creación del usuario administrativo del programa de instalación de JBoss EAP

A.6. Instalación de inicio rápido

Install the JBoss EAP quickstarts.

Figura A.6. Configuración del inicio rápido del programa del instalador de JBoss EAP

A.7. Configuración del repositorio Maven

Configuración del repositorio Maven del programa de instalación de JBoss EAP

Figura A.7. Configuración del repositorio Maven del programa de instalación de JBoss EAP

A.8. Configuración de enlace de sockets

Determine si debe utilizar los enlaces predeterminados o si debe configurar enlaces personalizados.
Use the default bindings for standalone and domain mode.

Figura A.8. Enlaces de socket predeterminados del programa de instalación de JBoss EAP

A.9. Inicio del servidor

Select the startup option desired on completion of the installation process.

Figura A.9. Iniciar el servidor del programa de instalación de JBoss EAP

A.10. Configuración de los niveles de registro

Choose No to skip configuration of logging level.

Figura A.10. Cómo evitar los niveles de registro de JBoss EAP Installation Program

A.11. Configuración del entorno del tiempo de ejecución

Entorno del tiempo de ejecución de la configuración del programa de la instalación de JBoss EAP - Predeterminado

Figura A.11. Entorno del tiempo de ejecución de la configuración del programa de la instalación de JBoss EAP - Predeterminado

A.12. Revisión de los componentes de instalación

Review the list of selected components. Click the Next to continue or Previous to go back and make changes.

Figura A.12. Componentes seleccionados para la revisión del programa de instalación de JBoss EAP

A.13. Progreso de la instalación

When the installation progress completes, click Next.

Figura A.13. Progreso de la instalación de los componentes del programa de instalación de JBoss EAP

A.14. Procesamiento de la instalación completado

Procesamiento del programa de instalación JBoss EAP completado

Figura A.14. Procesamiento del programa de instalación JBoss EAP completado

A.15. Creación de atajos

Choose whether to create shortcuts and how to configure them. Then click Next.

Figura A.15. Crear atajos del instalador JBoss EAP

A.16. Generación del script de instalación

Choose whether to generate an installation script containing the selected install options. Then click Done to finish.

Figura A.16. Script de instalación genera el programa de instalación de JBoss EAP

Apéndice B. Historial de revisiones

Historial de revisiones
Revisión 6.4.0-10.1Fri Aug 28 2015Gladys Guerrero Lozano
Traducción de versión 6.4
Revisión 6.4.0-10Tuesday April 14 2015Lucas Costi
Red Hat JBoss Enterprise Application Platform 6.4.0.GA

Aviso Legal

Copyright © 2015 Red Hat, Inc..
This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.