Red Hat Training
A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform
Guía de inicio
Para usar con Red Hat JBoss Enterprise Application Platform 7.1
Resumen
Capítulo 1. Introducción
1.1. Acerca de Red Hat JBoss Enterprise Application Platform 7
Red Hat JBoss Enterprise Application Platform 7 (JBoss EAP) es una plataforma de middleware desarrollada con estándares abiertos y conforme a la especificación de Java Enterprise Edition 7.
JBoss EAP 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 administrativa y la interfaz de línea de comandos administrativa (CLI) hacen innecesaria la modificación de archivos de configuración XML y agregan la habilidad para utilizar scripts y automatizar tareas.
JBoss EAP proporciona dos modos operativos para instancias JBoss EAP: el servidor autónomo o el dominio administrado. El servidor autónomo representa la ejecución de JBoss EAP como una instancia de servidor sencilla. El modo operativo de dominio administrado permite la administración de múltiples instancias JBoss EAP desde un punto de control único.
Además, JBoss EAP 7 incluye APIs y marcos de trabajo de desarrollo para desarrollar rápidamente aplicaciones Java EE seguras y escalables.
1.2. Acerca de la Guía de inicio
Esta guía tiene como objeto hacer que usted pueda implementar JBoss EAP tan rápido como sea posible. Cubre tareas administrativas, como instalación, administración y configuración básicas para JBoss EAP. Esta guía también ayuda a los desarrolladores a comenzar a escribir aplicaciones Java EE 7 mediante los inicios rápidos de JBoss EAP.
Para obtener más información, consulte el paquete de documentación de JBoss EAP.
Capítulo 2. Administración de JBoss EAP
2.1. Descargar e instalar JBoss EAP
En esta guía se proporcionan instrucciones básicas para descargar e instalar JBoss EAP mediante la instalación ZIP, que es independiente de la plataforma.
Para conocer detalles adicionales, consulte la Guía de instalación, que incluye instrucciones para instalar JBoss EAP mediante el instalador gráfico o los métodos de instalación de paquetes RPM.
2.1.1. Prerrequisitos de instalación
Verificar que los siguientes prerrequisitos se hayan cumplido antes de instalar JBoss EAP:
Prerrequisitos comunes
- Su sistema recibe soporte según Las configuraciones que reciben soporte de JBoss EAP 7.
- Su sistema esté actualizado con las actualizaciones y erratas emitidas de Red Hat.
Prerrequisitos de instalación ZIP
- El usuario que ejecutará JBoss EAP debe tener acceso de lectura y escritura para el directorio de instalación.
- Debe instalarse el kit de desarrollo de Java deseado.
-
Para Hewlett-Packard HP-UX, se debe instalar una herramienta
unzip
. -
Para Windows Server, se deben establecer las variables de entorno
JAVA_HOME
yPATH
.
2.1.2. Descargar JBoss EAP
El archivo ZIP de JBoss EAP está disponible en el Portal del cliente de Red Hat. La instalación del archivo ZIP es independiente de la plataforma.
- Ingrese al Portal del cliente de Red Hat.
- Haga clic en Downloads.
- Haga clic en Red Hat JBoss Enterprise Application Platform en la lista Descargas de productos
- En el menú desplegable Versión, seleccione 7.1.
- Busque Red Hat JBoss Enterprise Application Platform 7.1.0 en la lista y haga clic en el enlace Descargar.
2.1.3. Instale JBoss EAP
Una vez haya sido descargado el archivo de instalación EAP ZIP, puede ser instalado al extraer el contenido del paquete.
Si es necesario, desplace el archivo ZIP al servidor y el sitio donde JBoss EAP debe ser instalado.
NotaEl usuario que ejecutará JBoss EAP debe tener acceso de lectura y escritura para este directorio.
Extraer el archivador.
$ unzip jboss-eap-7.1.0.zip
NotaPara Windows Server, haga clic derecho en el archivo ZIP y seleccione Extract All.
El directorio creado al extraer el archivo ZIP es el directorio del nivel superior para la instalación de JBoss EAP. Este directorio se conoce como EAP_HOME
.
2.2. Iniciar y detener JBoss EAP
2.2.1. Iniciar JBoss EAP
JBoss EAP es compatible con Red Hat Enterprise Linux, Windows Server, Oracle Solaris y Hewlett-Packard HP-UX, y se ejecuta en un modo operativo de servidor autónomo o dominio administrado. El comando específico para iniciar JBoss EAP depende de la plataforma subyacente y del modo operativo deseado.
En un principio, los servidores se inician en modo suspendido y no aceptan solicitudes hasta que todos los servicios requeridos se hayan iniciado, en cuyo momento, los servidores se colocarán en estado de ejecución normal y podrán comenzar a aceptar solicitudes.
Iniciar JBoss EAP como un servidor autónomo
$ EAP_HOME/bin/standalone.sh
Para Windows Server, use el script EAP_HOME\bin\standalone.bat
.
Este script de arranque usa el archivo EAP_HOME/bin/standalone.conf
(o standalone.conf.bat
para Windows Server) para establecer algunas preferencias predeterminadas, como opciones JVM. Puede personalizar los parámetros en este archivo.
JBoss EAP usa el archivo de configuración standalone.xml
de forma predeterminada, pero puede iniciarse mediante uno diferente. Para obtener más información sobre los archivos de configuración autónomos y la forma de usarlos, consulte la sección Configuración de servidor autónoma.
Para obtener un listado de todos los argumentos de scripts de arranque y sus propósitos, use el argumento --help
o consulte la sección de argumentos o vea la sección Argumentos de tiempo de ejecución de servidor.
Inicie JBoss EAP en un dominio administrado
El controlador de dominio se debe iniciar antes que los servidores en los grupos de servidores del dominio. Utilice este script para iniciar primero el controlador de dominio y, luego, para cada controlador de host asociado.
$ EAP_HOME/bin/domain.sh
Para Windows Server, use el script EAP_HOME\bin\domain.bat
.
Este script de arranque usa el archivo EAP_HOME/bin/domain.conf
(o domain.conf.bat
para Windows Server) para establecer algunas preferencias predeterminadas, como opciones JVM. Puede personalizar los parámetros en este archivo.
JBoss EAP usa el archivo de configuración standalone.xml
de forma predeterminada, pero puede iniciarse mediante uno diferente. Para obtener más información sobre los archivos de configuración autónomos y la forma de usarlos, consulte la sección Archivos de configuración de dominio administrado.
Al configurar un dominio administrado, se deberán pasar argumentos adicionales en el script de arranque. Para obtener un listado de todos los argumentos de scripts de arranque disponibles y sus propósitos, use el argumento --help
o consulte la sección Argumentos de tiempo de ejecución del servidor.
2.2.2. Parada de JBoss EAP
La forma de parar a JBoss EAP depende de la forma como se ha iniciado.
Pare una instancia interactiva de JBoss EAP
Presione Ctrl+C
en el terminal donde se inició JBoss EAP.
Pare una instancia de segundo plano de JBoss EAP
Use la CLI administrativa para conectarse a la instancia que está en ejecución y apague el servidor.
Lance la CLI administrativa.
$ EAP_HOME/bin/jboss-cli.sh --connect
Ejecute el comando
shutdown
.shutdown
Cuando se ejecuta en un dominio administrado, debe especificar el nombre de host para el apagado mediante el argumento --host
con el comando shutdown
.
2.3. JBoss EAP Management
JBoss EAP usa una configuración simplificada con un archivo de configuración por servidor autónomo o dominio administrado. La configuración predeterminada para un servidor autónomo se almacena en el archivo EAP_HOME/standalone/configuration/standalone.xml
y la configuración predeterminada para un dominio administrado se almacena en el archivo EAP_HOME/domain/configuration/domain.xml
. Además, la configuración predeterminada para un controlador de host se almacena en el archivo EAP_HOME/domain/configuration/host.xml
.
JBoss EAP se puede configurar mediante la CLI de administración de la línea de comando, la consola de administración basada en la Web, Java API o HTTP API. Los cambios realizados a través de estas interfaces de administración persisten automáticamente y la API de administración sobrescribe los archivos de configuración XML. Los métodos preferidos son la CLI de administración y la consola de administración. No se recomienda modificar de forma manual los archivos de configuración XML.
2.3.1. Usuarios administrativos
La configuración predeterminada de JBoss EAP proporciona autenticación local, para que un usuario pueda tener acceso a la CLI de administración en el host local sin requerir autenticación.
Sin embargo, debe agregar un usuario de administración si desea acceder a la CLI de administración de manera remota o usar la consola de administración, que se considera como acceso remoto, incluso si el tráfico se origina en el host local. Si intenta acceder a la consola de administración antes de añadir un usuario de administración, recibirá un mensaje de error.
Si JBoss EAP está instalado usando el instalador gráfico, se crea un usuario de administración durante el proceso de instalación.
Esta guía abarca la administración de usuario simple para JBoss EAP mediante el script add-user
, que es una herramienta que permite añadir nuevos usuarios a los archivos de propiedades para la autenticación externa.
Para obtener opciones de autenticación y autorización más avanzadas, como LDAP o Control de acceso basado en roles (RBAC), consulte la sección Autenticación de administración principal de la guía Arquitectura de seguridad de JBoss EAP.
2.3.1.1. Cómo adicionar un usuario administrativo
Ejecute el script de la herramienta
add-user
y siga las indicaciones.$ EAP_HOME/bin/add-user.sh
NotaPara Windows Server, use el script
EAP_HOME\bin\add-user.bat
.Presione
ENTER
para seleccionar la opción predeterminadaa
para agregar un usuario de administrativo.Este usuario se agregará al ManagementRealm y se autorizará para realizar operaciones administrativas mediante la consola de administración o la CLI de administración. La otra selección (
b
) agrega un usuario a ApplicationRealm, que se utiliza para aplicaciones y no proporciona permisos particulares.Ingrese el nombre de usuario y la contraseña deseados. Se le solicitará confirmar la contraseña.
NotaLos nombres de usuario solo pueden contener los siguientes caracteres, en cualquier cantidad y orden:
- Caracteres alfanuméricos (a-z, A-Z, 0-9)
- Guiones (-), puntos (.), comas (,), arroba (@)
- Barra diagonal inversa (\)
- Signo igual (=)
De manera predeterminada, JBoss EAP admite contraseñas débiles, pero emite una advertencia.
Consulte la sección Restricciones para establecer la contraseña de la herramienta Añadir usuario de la Guía de configuración de JBoss EAP para obtener detalles sobre cómo cambiar este comportamiento predeterminado.
-
Ingrese una lista separada por comas de los grupos a los cuales pertenece el usuario. Si usted no desea que el usuario pertenezca a ninguno de ellos presione
ENTER
para dejarlo en blanco. -
Revise la información e ingrese
yes
para confirmar. Determine si este usuario representa una instancia remota de servidor JBoss EAP. Para un usuario administrativo básico, ingrese
no
.Un tipo de usuario que necesite ser agregado al ManagementRealm es un usuario que representa otra instancia de JBoss EAP, la cual debe se capaz de autenticarse para unirse como un miembro de un clúster. Si este es el caso, entonces la respuesta es
yes
para indicar que se le otorgará un valor secreto en hash que representa la contraseña, la cual deberá ser agregada a un archivo de configuración diferente.
También puede crear usuarios de modo no interactivo pasando parámetros al script add-user
. Este método no se recomienda en sistemas compartidos, ya que las contraseñas estarán visibles en archivos de registro y de historiales. Para obtener más información, consulte Cómo ejecutar la herramienta Agregar usuario de forma no interactiva.
2.3.1.2. Cómo ejecutar la herramienta Agregar usuario de forma no interactiva
Ejecute el script add-user
de forma no interactiva pasando argumentos en la línea de comandos. Como mínimo, se debe proporcionar el nombre de usuario y la contraseña.
Este enfoque no se recomienda en sistemas compartidos, ya que las contraseñas estarán visibles en archivos de registro y de historiales.
Cree un usuario que pertenezca a varios grupos
El siguiente comando agrega un usuario de administración (mgmtuser1
) con los grupos guest
y mgmtgroup
.
$ EAP_HOME/bin/add-user.sh -u 'mgmtuser1' -p 'password1!' -g 'guest,mgmtgroup'
Especifique un archivo de propiedades alternativas
De forma predeterminada, la información de usuario y grupo creada mediante el script add-user
se almacena en los archivos de propiedades localizadas en el directorio de configuración de servidor.
La información de usuario se almacena en los siguientes archivos de propiedades:
-
EAP_HOME/standalone/configuration/mgmt-users.properties
-
EAP_HOME/domain/configuration/mgmt-users.properties
La información de grupo es almacenada en los siguientes archivos de propiedades:
-
EAP_HOME/standalone/configuration/mgmt-groups.properties
-
EAP_HOME/domain/configuration/mgmt-groups.properties
Estos directorios predeterminados y nombres de archivos pueden sobrescribirse. El siguiente comando agrega un nuevo usuario especificando un nombre diferente y un sitio para los archivos de propiedades de usuario.
$ EAP_HOME/bin/add-user.sh -u 'mgmtuser2' -p 'password1!' -sc '/path/to/standaloneconfig/' -dc '/path/to/domainconfig/' -up 'newname.properties'
El nuevo usuario fue agregado a los archivos de propiedades localizados en /path/to/standaloneconfig/newname.properties
y /path/to/domainconfig/newname.properties
. Observe que estos archivos ya deben existir o de lo contrario, verá un error.
Para obtener un listado completo de los argumentos add-user
disponibles y sus propósitos, use el argumento --help
o consulte la sección Referencia de los argumentos de la herramienta add-user.
2.3.2. Interfaces de administración
2.3.2.1. CLI administrativa
La interfaz de la línea de comandos de administración (CLI) es una herramienta de administración de la línea de comandos para JBoss EAP.
Use la CLI administrativa para iniciar y detener servidores, implementar y desimplementar aplicaciones, configurar parámetros del sistema y realizar otras tareas administrativas. Las operaciones se pueden realizar en modo de lotes (batch) para permitir la ejecución de múltiples tareas como un grupo.
Varios comandos comunes de la terminal están disponibles, tales como ls
, cd
y pwd
. La CLI administrativa también soporta el tabulador de completado.
Para obtener más información sobre el uso de la CLI de administración, incluidos los comandos y operaciones, sintaxis y para ejecución en modo batch, consulte la Guía de CLI de administración de JBoss EAP.
Lance la CLI administrativa
$ EAP_HOME/bin/jboss-cli.sh
Para Windows Server, use el script EAP_HOME\bin\jboss-cli.bat
.
Conéctese a un servidor en ejecución
Conéctese
O puede lanzar la CLI de administración y conectarse en un paso mediante el comando EAP_HOME/bin/jboss-cli.sh --connect
.
Mostrar ayuda
Use el siguiente comando para obtener ayuda general.
help
Use el marcador --help
en un comando para recibir instrucciones sobre cómo usar ese comando específico. Por ejemplo, para recibir información sobre cómo usar deploy
, se ejecuta el siguiente comando.
deploy --help
Salga de la CLI administrativa
quit
Ver parámetros del sistema
El siguiente comando usa la operación read-attribute
para desplegar si la fuente de datos de ejemplo está habilitada.
/subsystem=datasources/data-source=ExampleDS:read-attribute(name=enabled) { "outcome" => "success", "result" => true }
Cuando se ejecuta en un dominio administrado, debe especificar el perfil que va a actualizar anteponiendo el comando con /profile=PROFILE_NAME
.
/profile=default/subsystem=datasources/data-source=ExampleDS:read-attribute(name=enabled)
Actualice los parámetros del sistema
El siguiente comando usa la operación write-attribute
para inhabilitar el ejemplo de fuente de datos.
/subsystem=datasources/data-source=ExampleDS:write-attribute(name=enabled,value=false)
Inicie los servidores
La CLI administrativa también puede iniciar y parar servidores cuando se ejecutan en un dominio administrado.
/host=HOST_NAME/server-config=server-one:start
2.3.2.2. Consola administrativa
La consola administrativa es una herramienta de administración basada en la red para JBoss EAP.
Use la consola administrativa para iniciar y detener servidores, implementar y desimplementar aplicaciones, afinar configuraciones del sistema y realizar modificaciones persistentes a la configuración del servidor. La consola de administración también tiene la habilidad de realizar tareas administrativas con notificaciones en vivo cuando algún cambio realizado por el usuario actual requiere que la instancia del servidor sea reiniciada o recargada.
En un dominio administrado, las instancias del servidor y los grupos del servidor en el mismo dominio, se pueden administrar centralmente desde la consola de administración del controlador de dominio.
Para una instancia JBoss EAP que se ejecute en un host local mediante el puerto de administración predeterminado, la consola administrativa, puede ser accedida a través de un navegador en http://localhost:9990/console/App.html. Deberá autenticar un usuario que tenga permisos para acceder a la consola administrativa.
La consola administrativa proporciona las siguientes pestañas para navegar y administrar su servidor autónomo JBoss EAP o el dominio administrado.
- Carpeta personal
- Aprenda cómo llevar a cabo varias tareas administrativas y de configuración. Haga el tour para familiarizarse con la consola administrativa de JBoss EAP.
- Implementaciones
- Agregue, quite y habilite implementaciones. En un dominio administrado, asigne las implementaciones a los grupos de servidores.
- Configuración
- Configure los subsistemas disponibles, los cuales proporcionan funcionalidades tales como servicios Web, mensajería o alta disponibilidad. En un dominio administrado, administre los perfiles que contienen diferentes configuraciones de subsistemas.
- Tiempo de ejecución
- Vea el tiempo de ejecución, tal como el estado de servidor, el uso de JVM y los registros de servidor. En un domino administrado, administre sus hosts, los grupos de servidor y los servidores.
- Control de Acceso
- Asigne los roles a usuarios y grupos cuando utilice el control de acceso basado en roles.
- Uso de parches
- Aplique parches a sus instancias JBoss EAP
Para realizar un recorrido de su consola de administración, haga clic en el enlace Tomar el tour en la página de inicio de la consola.
2.3.3. Archivos de configuración
2.3.3.1. Archivos de configuración de servidor autónomo
Los archivos de configuración autónomos se localizan en el directorio EAP_HOME/standalone/configuration/
. Existe un archivo para cada uno de los cuatro perfiles predefinidos (default, ha, full, full-ha, load-balancer).
Tabla 2.1. Archivos de configuración autónomos
Archivo de configuración | Propósito |
---|---|
|
Este archivo de configuración autónomo es la configuración predeterminada utilizada cuando inicia el servidor autónomo. Contiene toda la información sobre el servidor, incluidos subsistemas, redes, implementaciones, enlaces de sockets y otra información configurable. No proporciona los subsistemas necesarios para mensajería o alta disponibilidad. |
|
Este archivo de configuración autónomo incluye todos los subsistemas predeterminados y agrega los subsistemas |
|
Este archivo de configuración autónomo incluye todos los subsistemas predeterminados y agrega los subsistemas |
|
Este archivo de configuración incluye soporte para cada subsistema posible, incluidos los de mensajería y alta disponibilidad. |
|
Este archivo de configuración autónomo incluye los subsistemas mínimos necesarios para usar el equilibrador de carga frontal mod_cluster incorporado para equilibrar la carga de otras instancias de JBoss EAP. |
El servidor JBoss EAP utiliza de forma predeterminada el archivo standalone.xml
. Para iniciar JBoss EAP con una configuración diferente, use el argumento --server-config
. Por ejemplo:
$ EAP_HOME/bin/standalone.sh --server-config=standalone-full.xml
2.3.3.2. Archivos de configuración de dominio administrado
Los archivos de configuración de domino administrado se localizan en el directorio EAP_HOME/domain/configuration/
.
Tabla 2.2. Archivos de configuración de dominio administrado
Archivo de configuración | Propósito |
---|---|
|
Este es el archivo de configuración principal para un dominio administrado. Solamente el maestro de dominio lee este archivo. Este archivo contiene las configuraciones para todos los perfiles (default, ha, full, full-ha, load-balancer). |
|
Este archivo incluye información de configuración para host físico en un dominio administrado, tal como interfaces, enlaces de socket, el nombre del host y otra información específica de host. El archivo |
|
Este archivo incluye únicamente la información de configuración necesaria para ejecutar un servidor como el controlador de dominio maestro. |
|
Este archivo incluye únicamente la información de configuración necesaria para ejecutar un servidor como el controlador de host del dominio administrado. |
El servidor JBoss EAP utiliza de forma predeterminada el archivo host.xml
. Para iniciar JBoss EAP con una configuración diferente, use el argumento --host-config
. Por ejemplo:
$ EAP_HOME/bin/domain.sh --host-config=host-master.xml
2.3.3.3. Hacer copia de seguridad de los datos de configuración
Con el fin de restaurar más adelante la configuración del servidor JBoss EAP, se debería hacer una copia de seguridad de los siguientes elementos:
EAP_HOME/standalone/configuration/
- Haga una copia de seguridad de todo el directorio para guardar los datos de usuario, la configuración del servidor y los parámetros de ingreso para servidores autónomos.
EAP_HOME/domain/configuration/
- Haga una copia de seguridad de todo el directorio para guardar el usuario y los datos de perfil, el dominio, la configuración de host y los parámetros para dominios administrados.
EAP_HOME/modules/
- Haga una copia de seguridad de los módulos personalizados.
EAP_HOME/welcome-content/
- Haga una copia de seguridad del contenido de bienvenida.
EAP_HOME/bin/
- Haga una copia de seguridad de los scripts personalizados o los archivos de configuración de arranque.
2.3.3.4. Instantáneas de archivos de configuración
Para ayudar en el mantenimiento y la administración del servidor, JBoss EAP crea una versión con marca de tiempo del archivo de configuración original en el momento del arranque. Cualquier cambio de configuración adicional realizado por las operaciones de administración hará que se realice automáticamente una copia de seguridad del archivo original y que se preserve una copia de trabajo de la instancia para futura referencia o para revertir los cambios. Además, se pueden tomar instantáneas de configuración, que son copias en un momento preciso de la configuración actual del servidor. Un administrador puede guardar y cargar estas instantáneas.
Los siguientes ejemplos usan el archivo standalone.xml
, pero el mismo proceso se aplica a los archivos domain.xml
y host.xml
.
Tomar una instantánea
Use la CLI administrativa para tomar una instantánea de las configuraciones actuales.
:take-snapshot
{
"outcome" => "success",
"result" => "EAP_HOME/standalone/configuration/standalone_xml_history/snapshot/20151022-133109702standalone.xml"
}
Listar las instantáneas
Use la CLI administrativa para listar todas las instantáneas que han sido tomadas.
:list-snapshots
{
"outcome" => "success",
"result" => {
"directory" => "EAP_HOME/standalone/configuration/standalone_xml_history/snapshot",
"names" => [
"20151022-133109702standalone.xml",
"20151022-132715958standalone.xml"
]
}
}
Borre la instantánea
Use la CLI administrativa para borrar una instantánea.
:delete-snapshot(name=20151022-133109702standalone.xml)
Inicie el servidor con una instantánea
El servidor puede ser iniciado mediante una instantánea o una versión guardada automáticamente de la configuración.
-
Vaya al directorio
EAP_HOME/standalone/configuration/standalone_xml_history
e identifique la instantánea o el archivo de configuración guardado que desea cargar. Inicie el servidor y señale el archivo de configuración seleccionado. Pase la ruta del archivo relativa al directorio de configuración,
EAP_HOME/standalone/configuration/
.$ EAP_HOME/bin/standalone.sh --server-config=standalone_xml_history/snapshot/20151022-133109702standalone.xml
Cuando se ejecuta en un dominio administrado, use el argumento --host-config
en lugar de especificar el archivo de configuración.
2.3.3.5. Reemplazo de propiedad
JBoss EAP le permite usar expresiones para definir propiedades reemplazables en lugar de valores literales en la configuración. Las expresiones usan el formato ${PARAMETER:DEFAULT_VALUE}
. Si se establece el parámetro especificado, se utilizará el valor del parámetro. De lo contrario, se utilizará el valor predeterminado provisto.
Las fuentes que reciben soporte para resolver expresiones son propiedades del sistema, variables de entorno y 'vault'. Para las implementaciones únicamente, la fuente puede corresponder a propiedades enumeradas en un archivo META-INF/jboss.properties
que se encuentra en el archivo de implementación. Para tipos de implementación que admiten subimplementaciones, la resolución abarca todas las subimplementaciones si el archivo de propiedades está en la implementación externa, por ejemplo, el EAR. Si el archivo de propiedades está en la subimplementación, la resolución abarcará únicamente esa subimplementación.
El ejemplo a continuación del archivo de configuración standalone.xml
establece el valor inet-address
para la interfaz public
en 127.0.0.1
, a menos que se establezca el parámetro jboss.bind.address
.
<interface name="public"> <inet-address value="${jboss.bind.address:127.0.0.1}"/> </interface>
El parámetro jboss.bind.address
puede ser definido en el inicio de EAP como un servidor autónomo, mediante el siguiente comando:
$ EAP_HOME/bin/standalone.sh -Djboss.bind.address=IP_ADDRESS
Expresiones anidadas
Las expresiones pueden ser anidadas, lo que permite el uso más avanzado de las expresiones en lugar de valores fijos. El formato de una expresión anidada es como el de una expresión normal, pero una expresión está incorporada en la otra. Por ejemplo:
${SYSTEM_VALUE_1${SYSTEM_VALUE_2}}
Las expresiones anidadas se evalúan de forma recursiva, por lo tanto la expresión inner es la primera evaluada, luego lo será la expresión outer. Las expresiones también pueden ser recursivas, cuando una expresión resuelve a otra expresión, que es luego resuelta. Las expresiones anidadas están permitidas en cualquier parte que las expresiones estén permitidas, a excepción de los comandos de la CLI administrativa.
Un ejemplo de uso de la expresión anidada es cuando la contraseña en una definición de fuente de datos está enmascarada. La configuración para una fuente de datos podría ser la siguiente línea:
<password>${VAULT::ds_ExampleDS::password::1}</password>
El valor de ds_ExampleDS
podría ser remplazado por una propiedad de sistema (datasource_name
), mediante una expresión anidada. La configuración para la fuente de datos podría en su lugar tener la siguiente línea:
<password>${VAULT::${datasource_name}::password::1}</password>
JBoss EAP primero debe evaluar la expresión ${datasource_name}
, luego ingresarla a una expresión más grande y evaluar la expresión resultante. La ventaja de esta configuración es que el nombre de la fuente de datos se abstrae de la configuración corregida.
Remplazo de las propiedades basadas en el descriptor
La configuración de aplicaciones (como los parámetros de conexión de fuente de datos) generalmente varía entre entornos de desarrollo, prueba y producción. Algunas veces, los scripts de compilación del sistema acomodan esta variación, ya que la especificación Java EE no contiene un método para externalizar estas configuraciones. Gracias a JBoss EAP, puede usar el remplazo de propiedades basado en descriptores para administrar la configuración de modo externo.
El remplazo de la propiedad basada en descriptores, substituye las propiedades basadas en descriptores, lo que le permite suprimir los supuestos concernientes al entorno de la aplicación y la cadena de construcción. Se pueden especificar configuraciones específicas del entorno en los descriptores de implementación, en lugar de anotaciones o scripts del sistema de construcción. Usted puede proporcionar la configuración en archivos o como parámetros en la línea de comandos.
Existen varios indicadores en el subsistema ee
que controlan si se aplica el remplazo de propiedades.
El indicador jboss-descriptor-property-replacement
controla el remplazo del descriptor específico JBoss y se habilita por defecto. Cuando está activado, las propiedades pueden ser remplazadas en los siguientes descriptores de implementación:
-
jboss-ejb3.xml
-
jboss-app.xml
-
jboss-web.xml
-
*-jms.xml
-
*-ds.xml
El siguiente comando de la CLI administrativa puede utilizarse para activar o desactivar el remplazo de propiedad en descriptores específicos JBoss:
/subsystem=ee:write-attribute(name="jboss-descriptor-property-replacement",value=VALUE)
El indicador de descriptor Java EE controlado por el indicador spec-descriptor-property-replacement
está desactivado por defecto. Cuando se activa, las propiedades pueden ser remplazadas en los siguientes descriptores de implementación:
-
ejb-jar.xml
-
persistence.xml
-
application.xml
-
web.xml
El siguiente comando de la CLI administrativa puede utilizarse para activar o desactivar el remplazo de propiedad en descriptores Java EE:
/subsystem=ee:write-attribute(name="spec-descriptor-property-replacement",value=VALUE)
2.4. Configuración de red y puerto
2.4.1. Interfaces
JBoss EAP hace referencia a interfaces designadas a través de la configuración. Esta acción permite que la configuración haga referencia a las declaraciones de interfaz individuales con nombres lógicos, en lugar de requerir la información total de la interfaz en cada uso.
También facilita la configuración en un dominio administrado donde los detalles de la interfaz de red pueden variar a través de múltiples máquinas. Cada instancia de servidor puede corresponder a un grupo de nombre lógico.
Los archivos standalone.xml
, domain.xml
y host.xml
incluyen declaraciones de interfaz. Existen varios nombres de interfaz preconfigurados, según la configuración predeterminada que se utilice. La interfaz management
puede utilizarse para todos los componentes y servicios que requieren la capa de administración, incluido el extremo de administración HTTP. La interfaz public
se puede utilizar para todas las comunicaciones de red relacionadas con aplicaciones. La interfaz unsecure
se utiliza para sockets IIOP en la configuración estándar. La interfaz private
se utiliza para sockets JGroups en la configuración estándar.
2.4.1.1. Configuración de interfaz predeterminada
<interfaces> <interface name="management"> <inet-address value="${jboss.bind.address.management:127.0.0.1}"/> </interface> <interface name="public"> <inet-address value="${jboss.bind.address:127.0.0.1}"/> </interface> <interface name="private"> <inet-address value="${jboss.bind.address.private:127.0.0.1}"/> </interface> <interface name="unsecure"> <inet-address value="${jboss.bind.address.unsecure:127.0.0.1}"/> </interface> </interfaces>
JBoss EAP vincula por defecto estas interfaces a 127.0.0.1
, aunque estos valores pueden sobrescribirse en tiempo de ejecución al configurar la propiedad adecuada. Por ejemplo, inet-address
de la interfaz pública
puede configurarse al iniciar JBoss EAP como un servidor autónomo con el siguiente comando.
$ EAP_HOME/bin/standalone.sh -Djboss.bind.address=IP_ADDRESS
De modo alternativo, puede usar la opción -b
en la línea de comandos de arranque del servidor. Para obtener más información sobre las opciones de arranque del servidor, consulte Argumentos de tiempo de ejecución de servidor.
Si modifica las interfaces o los puertos de red predeterminados que usa JBoss EAP, también debe recordar cambiar los scripts que usan las interfaces o los puertos modificados, que incluyen los scripts de servicio de JBoss EAP, así como especificar la interfaz y el puerto correctos al acceder a la consola de administración o la CLI de administración.
2.4.1.2. Configuración de interfaces
Las interfaces de red se declaran al especificar el nombre lógico y los criterios de selección para la interfaz física. Los criterios de selección pueden hacer referencia a una dirección comodín o especificar un grupo de una o más características que una interfaz o dirección deben tener para ser una correspondencia válida. Para obtener un listado de todos los criterios de selección de interfaces disponibles, consulte la sección Atributos de interfaces.
Las interfaces pueden ser configuradas mediante la consola administrativa o la CLI administrativa. Abajo se presentan varios ejemplos de cómo agregar y actualizar interfaces. El comando de la CLI administrativa aparece primero, seguido de la configuración XML correspondiente.
Agregue una interfaz con un valor NIC
Agregue una nueva interfaz con un valor NIC de eth0
.
/interface=external:add(nic=eth0)
<interface name="external"> <nic name="eth0"/> </interface>
Agregue la interfaz con varios valores condicionales
Agregue una nueva interfaz que coincida con una interfaz o dirección en la subred correcta si la interfaz está activa, soporta multidifusión y no es punto a punto.
/interface=default:add(subnet-match=192.168.0.0/16,up=true,multicast=true,not={point-to-point=true})
<interface name="default"> <subnet-match value="192.168.0.0/16"/> <up/> <multicast/> <not> <point-to-point/> </not> </interface>
Actualice el atributo de interfaz
Actualice el valor inet-address
predeterminado de la interfaz public
, manteniendo la propiedad jboss.bind.address
para permitir que este valor sea configurado en tiempo de ejecución.
/interface=public:write-attribute(name=inet-address,value="${jboss.bind.address:192.168.0.0}")
<interface name="public"> <inet-address value="${jboss.bind.address:192.168.0.0}"/> </interface>
Agregue una interfaz a un servidor en un dominio administrado
/host=HOST_NAME/server-config=SERVER_NAME/interface=INTERFACE_NAME:add(inet-address=127.0.0.1)
<servers> <server name="SERVER_NAME" group="main-server-group"> <interfaces> <interface name="INTERFACE_NAME"> <inet-address value="127.0.0.1"/> </interface> </interfaces> </server> </servers>
2.4.2. Enlaces de socket
Los enlaces de socket y los grupos de enlaces de sockets le permiten definir puertos de red y su relación con las interfaces de red requeridas para la configuración de JBoss 6 EAP. Un enlace de socket es una configuración designada para un socket. Un grupo de enlaces de sockets es una colección de declaraciones de enlaces de sockets agrupadas en un nombre lógico.
Esto permite a otras secciones de la configuración referirse a los enlaces de socket por su nombre lógico, en lugar de requerir todos los detalles de la configuración del socket en cada uso.
Las declaraciones para estas configuraciones designadas se encuentran en los archivos de configuración standalone.xml
y domain.xml
. Un servidor autónomo contiene únicamente un grupo de enlaces de socket, mientras que un dominio administrado puede contener múltiples grupos. Puede crear un grupo de enlaces de sockets para cada grupo de servidor en el dominio administrado o compartir un grupo de enlaces de sockets entre múltiples grupos de servidor.
Los puertos utilizados por JBoss EAP dependen en forma predeterminada de los grupos de enlaces de sockets que se utilizan y de los requisitos de sus implementaciones individuales.
2.4.2.1. Puertos de administración
Los puertos de administración se consolidaron en JBoss EAP 7. JBoss EAP 7 usa en forma predeterminada el puerto 9990
para administración nativa, usada por la CLI de administración , y para administración HTTP, usada por la consola de administración basada en la Web. El puerto 9999
, que se usaba como el puerto de administración nativo en JBoss EAP 6, ya no se utiliza pero aún puede habilitarse si se desea.
Si HTTPS está habilitado para consola de administración, entonces se utiliza por defecto el puerto 9993
.
2.4.2.2. Enlaces de sockets predeterminados
JBoss EAP se distribuye con un grupo de enlaces de socket para cada uno de los cinco perfiles predefinidos (default, ha, full, full-ha, load-balancer).
Para obtener información más detallada sobre los enlaces de socket predeterminados, tales como puertos y descripciones predeterminados, consulte la sección Enlaces de sockets predeterminados.
Si modifica las interfaces o los puertos de red predeterminados que usa JBoss EAP, también debe recordar cambiar los scripts que usan las interfaces o los puertos modificados, que incluyen los scripts de servicio de JBoss EAP, así como especificar la interfaz y el puerto correctos al acceder a la consola de administración o la CLI de administración.
Servidor autónomo
Cuando se ejecuta como un servidor autónomo, únicamente se define un grupo de enlaces de socket por archivo de configuración. Cada archivo de configuración autónomo (standalone.xml
, standalone-ha.xml
, standalone-full.xml
, standalone-full-ha.xml
, standalone-load-balancer.xml
) define los enlaces de socket para las tecnologías utilizadas por su perfil correspondiente.
Por ejemplo, el archivo de configuración autónomo predeterminado (standalone.xml
) especifica los siguientes enlaces de sockets:
<socket-binding-group name="standard-sockets" default-interface="public" port-offset="${jboss.socket.binding.port-offset:0}"> <socket-binding name="management-http" interface="management" port="${jboss.management.http.port:9990}"/> <socket-binding name="management-https" interface="management" port="${jboss.management.https.port:9993}"/> <socket-binding name="ajp" port="${jboss.ajp.port:8009}"/> <socket-binding name="http" port="${jboss.http.port:8080}"/> <socket-binding name="https" port="${jboss.https.port:8443}"/> <socket-binding name="txn-recovery-environment" port="4712"/> <socket-binding name="txn-status-manager" port="4713"/> <outbound-socket-binding name="mail-smtp"> <remote-destination host="localhost" port="25"/> </outbound-socket-binding> </socket-binding-group>
Dominio administrado
Cuando se ejecuta en un domino administrado, todos los grupos de enlaces de socket se definen en el archivo domain.xml
. Existen cinco grupos de enlaces de sockets predefinidos:
-
standard-sockets
-
ha-sockets
-
full-sockets
-
full-ha-sockets
-
load-balancer-sockets
Cada grupo de enlaces especifica enlaces de socket para tecnologías utilizadas por su perfil correspondiente. Por ejemplo, el grupo de enlaces de sockets full-ha-sockets
define varios enlaces de sockets jgroups
, los cuales son utilizados por el perfil full-ha para alta disponibilidad.
<socket-binding-groups> <socket-binding-group name="standard-sockets" default-interface="public"> <!-- Needed for server groups using the 'default' profile --> <socket-binding name="ajp" port="${jboss.ajp.port:8009}"/> <socket-binding name="http" port="${jboss.http.port:8080}"/> <socket-binding name="https" port="${jboss.https.port:8443}"/> <socket-binding name="txn-recovery-environment" port="4712"/> <socket-binding name="txn-status-manager" port="4713"/> <outbound-socket-binding name="mail-smtp"> <remote-destination host="localhost" port="25"/> </outbound-socket-binding> </socket-binding-group> <socket-binding-group name="ha-sockets" default-interface="public"> <!-- Needed for server groups using the 'ha' profile --> ... </socket-binding-group> <socket-binding-group name="full-sockets" default-interface="public"> <!-- Needed for server groups using the 'full' profile --> ... </socket-binding-group> <socket-binding-group name="full-ha-sockets" default-interface="public"> <!-- Needed for server groups using the 'full-ha' profile --> <socket-binding name="ajp" port="${jboss.ajp.port:8009}"/> <socket-binding name="http" port="${jboss.http.port:8080}"/> <socket-binding name="https" port="${jboss.https.port:8443}"/> <socket-binding name="iiop" interface="unsecure" port="3528"/> <socket-binding name="iiop-ssl" interface="unsecure" port="3529"/> <socket-binding name="jgroups-mping" interface="private" port="0" multicast-address="${jboss.default.multicast.address:230.0.0.4}" multicast-port="45700"/> <socket-binding name="jgroups-tcp" interface="private" port="7600"/> <socket-binding name="jgroups-udp" interface="private" port="55200" multicast-address="${jboss.default.multicast.address:230.0.0.4}" multicast-port="45688"/> <socket-binding name="modcluster" port="0" multicast-address="224.0.1.105" multicast-port="23364"/> <socket-binding name="txn-recovery-environment" port="4712"/> <socket-binding name="txn-status-manager" port="4713"/> <outbound-socket-binding name="mail-smtp"> <remote-destination host="localhost" port="25"/> </outbound-socket-binding> </socket-binding-group> <socket-binding-group name="load-balancer-sockets" default-interface="public"> <!-- Needed for server groups using the 'load-balancer' profile --> ... </socket-binding-group> </socket-binding-groups>
La configuración de socket para las interfaces de administración se define en el archivo host.xml
del controlador de dominio
2.4.2.3. Configuración de enlaces de socket
Cuando defina un enlace de socket, puede configurar los atributos port
e interface
, así como parámetros multidifusión, como multicast-address
y multicast-port
. Para obtener más información sobre todos los atributos de enlaces de sockets disponibles, consulte la sección Atributos de enlaces de sockets.
Los vínculos de sockets se pueden configurar mediante la consola de administración o la CLI de administración. Los siguientes pasos lo guían en la adición de un grupo de enlaces de sockets, en la adición de un enlace de sockets y en la configuración de los parámetros de enlaces de sockets mediante la CLI de administración.
Agregue un nuevo grupo de enlace de socket. Observe que este paso no puede realizarse cuando se está ejecutando como servidor autónomo.
/socket-binding-group=new-sockets:add(default-interface=public)
Agregue el enlace de socket.
/socket-binding-group=new-sockets/socket-binding=new-socket-binding:add(port=1234)
Cambie el enlace de socket para usar una interfaz diferente a la predeterminada y establecida por el grupo de enlace de socket.
/socket-binding-group=new-sockets/socket-binding=new-socket-binding:write-attribute(name=interface,value=unsecure)
El siguiente ejemplo muestra cómo se vería la configuración XML después de completar los pasos anteriores.
<socket-binding-groups> ... <socket-binding-group name="new-sockets" default-interface="public"> <socket-binding name="new-socket-binding" interface="unsecure" port="1234"/> </socket-binding-group> </socket-binding-groups>
2.4.2.4. Port Offsets
Un valor 'port offset' es una diferencia numérica agregada a todos los valores de puertos especificados en el grupo de enlaces de sockets para dicho servidor. Permite al servidor heredar los valores de puerto definidos en su grupo de enlaces de sockets, con una diferencia para garantizar que no entre en conflicto con ningún otro servidor en el mismo host. Por ejemplo, si el puerto HTTP del grupo de enlaces de sockets es 8080
, y un servidor usa un 'port offset' de 100
, su puerto HTTP será 8180
.
El ejemplo a continuación muestra la configuración de un 'Port Offset' de 250
para un servidor en un dominio administrado mediante la CLI administrativa.
/host=master/server-config=server-two/:write-attribute(name=socket-binding-port-offset,value=250)
El desfase de puerto de CLI también pueden utilizarse para servidores en un dominio administrado y para ejecutar servidores autónomos múltiples en el mismo host.
Puede pasar en un desfase de puerto cuando inicie el servidor autónomo mediante la propiedad jboss.socket.binding.port-offset
.
$ EAP_HOME/bin/standalone.sh -Djboss.socket.binding.port-offset=100
2.4.3. Direcciones IPv6
Por defecto, JBoss EAP se configura para ejecutarse con direcciones IPv4. Los pasos a continuación muestran cómo configurar JBoss EAP para ejecutarse mediante direcciones IPv6.
Configurar la pila JVM para direcciones IPv6
Actualice la configuración de arranque para preferir direcciones IPv6.
Abra el archivo de configuración de arranque.
-
Cuando se ejecuta como un servidor autónomo, modifique el archivo
EAP_HOME/bin/standalone.conf
(ostandalone.conf.bat
para Windows Server). -
Cuando se ejecuta en un servidor administrado, modifique el archivo
EAP_HOME/bin/domain.conf
(odomain.conf.bat
para Windows Server).
-
Cuando se ejecuta como un servidor autónomo, modifique el archivo
Establezca la propiedad
java.net.preferIPv4Stack
comofalse
.-Djava.net.preferIPv4Stack=false
Agregue la propiedad
java.net.preferIPv6Addresses
y defínala comotrue
.-Djava.net.preferIPv6Addresses=true
El siguiente ejemplo muestra cómo se verían las opciones JVM en el archivo de configuración de arranque después de hacer los cambios anteriores.
# Especifique opciones para pasar a la máquina virtual Java. # if [ "x$JAVA_OPTS" = "x" ]; then JAVA_OPTS="-Xms1303m -Xmx1303m -Djava.net.preferIPv4Stack=false" JAVA_OPTS="$JAVA_OPTS -Djboss.modules.system.pkgs=$JBOSS_MODULES_SYSTEM_PKGS -Djava.awt.headless=true" JAVA_OPTS="$JAVA_OPTS -Djava.net.preferIPv6Addresses=true" else
Actualice las declaraciones de interfaz para direcciones IPv6
Los valores de la interfaz predeterminada en la configuración pueden cambiarse en direcciones IPv6. Por ejemplo, el comando de la CLI administrativa de abajo, establece la interfaz management
en la dirección loopback IPv6 (::1
).
/interface=management:write-attribute(name=inet-address,value="${jboss.bind.address.management:[::1]}")
El siguiente ejemplo muestra cómo se vería la configuración XML después de ejecutar el comando anterior.
<interfaces> <interface name="management"> <inet-address value="${jboss.bind.address.management:[::1]}"/> </interface> .... </interfaces>
Capítulo 3. Desarrollo de aplicaciones mediante JBoss EAP
3.1. Visión General
En esta guía se proporciona información sobre cómo iniciar las aplicaciones de desarrollo con la ayuda de Red Hat JBoss Developer Studio y los ejemplos de inicio rápido de JBoss EAP 7.
Red Hat JBoss Developer Studio es un entorno de desarrollo integrado basado en Eclipse (IDE) que integra plugins de desarrollo de aplicaciones JBoss. JBoss Developer Studio puede ayudarlo a desarrollar la aplicación con la disponibilidad de asistentes específicos de JBoss y la capacidad para implementar aplicaciones para servidores JBoss EAP. Se proporcionan muchos ejemplos de código de inicio rápido JBoss EAP 7 para ayudar a los usuarios a iniciar la escritura de aplicaciones mediante diferentes tecnologías diferentes de Java EE 7.
3.2. Configuración del entorno de desarrollo
Se recomienda usar JBoss Developer Studio 11.0 o posterior con JBoss EAP 7.1.
Descargue e instale JBoss Developer Studio.
Para obtener instrucciones, consulte Instalación del servidor autónomo JBoss Developer Studio usando el instalador en la Guía de instalación de JBoss Developer Studio.
Configure el servidor JBoss EAP en JBoss Developer Studio.
Para obtener instrucciones, consulte Uso de la detección del tiempo de ejecución para configurar JBoss EAP desde dentro de IDE en la guía Introducción a las herramientas de JBoss Developer Studio.
3.3. Cómo usar ejemplos de inicios rápidos
Los ejemplos de inicio rápido proporcionados con JBoss EAP son proyectos Maven.
3.3.1. Acerca de Maven
Apache Maven es una herramienta de automatización de construcción distribuida , que se utiliza 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 entre los equipos de desarrollo. Los repositorios también están disponibles de terceras partes. Para obtener más información, consulte el proyecto Apache Maven y la guía de Introducción a repositorios.
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 obtener más información sobre cómo utilizar Maven con JBoss EAP, consulte la sección Uso de Maven con JBoss EAP en la Guía de desarrollo de JBoss EAP.
3.3.2. Uso de Maven con Quickstarts
Los artefactos y dependencias necesarias para construir e implementar aplicaciones para JBoss EAP 6 se alojan en un repositorio público. Para comenzar por los inicios rápidos de JBoss EAP 7, ya no necesita configurar su archivo settings.xml
de Maven para poder usar dicho repositorio durante la creación de los inicios rápidos. Los repositorios Maven ahora están configurados en los archivos POM del proyecto de inicios rápidos. Este método de configuración se proporciona para facilitarle el inicio con Quickstarts, sin embargo, no es recomendable para proyectos de producción debido a que puede demorar la construcción.
Red Hat JBoss Developer Studio incluye Maven; por lo tanto, no es necesario descargarlo o instalarlo por separado. Se recomienda usar una versión 11.0 o posterior de JBoss Developer Studio.
Si su plan es usar la línea de comandos Maven para construir e implementar sus aplicaciones, entonces primero descargue Maven desde el proyecto Apache Maven e instálelo siguiendo las instrucciones provistas en la documentación de Maven.
3.3.3. Descargar y ejecutar los Quickstarts
3.3.3.1. Descargar los Quickstarts
JBoss EAP 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 7. Los inicios rápidos pueden ser descargados desde el Portal del cliente de Red Hat.
- Ingrese al Portal del cliente de Red Hat.
- Haga clic en Downloads.
- En la lista Product Downloads, haga clic en Red Hat JBoss Enterprise Application Platform.
- Seleccione 7.1 en el menú desplegable Version (Versión).
- Busque la entrada Red Hat JBoss Enterprise Application Platform 7.1.0 Quickstarts en la tabla y haga clic en Download (Descargar).
- Guarde el archivo ZIP para el directorio deseado.
- Extraer el archivo ZIP.
3.3.3.2. Ejecutar los Quickstarts en JBoss Developer Studio
Cuando haya cargado los inicios rápidos, se pueden importar al JBoss Developer Studio y desplegar para JBoss EAP.
Importe un Quickstart en JBoss Developer Studio
Cada inicio rápido se distribuye con un archivo POM (Modelo de objetos de proyectos) que contiene información de configuración y del proyecto. Al usar este archivo POM, puede importar fácilmente el inicio rápido en JBoss Developer Studio.
Si su carpeta de proyectos de inicios rápidos se localiza dentro del espacio de trabajo IDE cuando lo importa a JBoss Developer Studio, el IDE genera un nombre de proyecto inválido y el nombre de archivador WAR. Verifique si su carpeta de proyecto de inicios rápidos se localiza fuera del espacio de trabajo IDE antes de comenzar.
- Inicie JBoss Developer Studio.
- Seleccione File → Import.
Seleccione Maven → Existing Maven Projects, luego haga clic en Next.
Figura 3.1. Importación de proyectos existentes de Maven
Navegue al directorio de inicio rápido (por ejemplo el inicio rápido
helloworld
), y haga clic en OK. La caja de listas Projects se generará con el archivopom.xml
del proyecto de inicio rápido seleccionado.Figura 3.2. Seleccione proyectos Maven
- Haga clic en Finish.
Ejecute el inicio rápido helloworld
La ejecución del inicio rápido helloworld
es una forma fácil de verificar que el servidor JBoss EAP está configurado y está ejecutándose correctamente.
- Si aún no definió un servidor, añada el servidor JBoss EAP a JBoss Developer Studio. Consulte Uso de la detección del tiempo de ejecución para configurar JBoss EAP desde dentro de IDE en la guía Introducción a las herramientas de JBoss Developer Studio.
Haga clic en el proyecto helloworld en la pestaña Project Explorer (Explorador de proyectos) y seleccione Run As (Ejecutar como) → Run on Server (Ejecutar en el servidor).
Figura 3.3. Ejecutar como - Ejecutar en servidor
Seleccione el servidor JBoss EAP 7.1 desde la lista de servidores y haga clic en Next (Siguiente).
Figura 3.4. Ejecute en el servidor
El inicio rápido helloworld ya figura como configurado en el servidor. Haga clic en Finish (Finish) para implementar el inicio rápido.
Figura 3.5. Modifique los recursos configurados en el servidor
Verifique los resultados
-
En la pestaña Server (Servidor), el estado del servidor JBoss EAP 7.1 cambia a
Started
(Iniciado). La pestaña Console muestra mensajes que detallan el inicio del servidor JBoss EAP y la implementación de inicio rápido
helloworld
.WFLYUT0021: Registered web context: /helloworld WFLYSRV0010: Deployed "helloworld.war" (runtime-name : "helloworld.war")
-
La aplicación
helloworld
está disponible en http://localhost:8080/helloworld y muestra el textoHello World!
(¡Hola, mundo!).
-
En la pestaña Server (Servidor), el estado del servidor JBoss EAP 7.1 cambia a
Para obtener más detalles sobre el inicio rápido helloworld
, consulte Exploración del inicio rápido helloworld.
Ejecute el inicio rápido bean-validation
Algunos inicios rápidos tales como bean-validation
, no proporcionan una capa de interfaz de usuario y en su lugar, proporcionan pruebas Arquillian para demostrar la funcionalidad.
-
Importe el inicio rápido
bean-validation
a JBoss Developer Studio. - En la pestaña Servers (Servidores), haga clic derecho en el servidor y elija Start (Inicio) para iniciar el servidor JBoss EAP. Si no ve una pestaña Servers (Servidores) o aún no definió un servidor, añada el servidor JBoss EAP a JBoss Developer Studio. Consulte Uso de la detección del tiempo de ejecución para configurar JBoss EAP desde dentro de IDE en la guía Inicio de las herramientas de JBoss Developer Studio.
-
Haga clic derecho en el proyecto
bean-validation
en la pestaña Project Explorer (Explorador de proyectos) y seleccione Run As (Ejecutar como) → Maven Build. Entre lo siguiente en el campo de entrada Goals y luego haga clic en Run.
clean verify -Parq-remote
Figura 3.6. Modifique la configuración
Verifique los resultados
La pestaña Console muestra los resultados de las pruebas Arquillian
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] ------------------------------------------------------------------------
3.3.3.3. Ejecute los Inicios rápidos mediante la línea de comandos
Puede construir e implementar fácilmente los inicios rápidos desde la línea de comandos usando Maven. Si aún no tiene instalado Maven, por favor consulte el proyecto Apache Maven para descargarlo e instalarlo.
Se proporciona un archivo README.md
en el directorio raíz de los inicios rápidos que contiene información general sobre los requisitos del sistema, configuración de Maven, adición de usuarios y ejecución de los inicios rápidos.
Cada inicio rápido contiene su propio archivo README.md
que proporciona instrucciones específicas y los comandos Maven para ejecutarlo.
Ejecute el Quickstart helloworld desde la línea de comandos
-
Revise el archivo
README.md
en el directorio raíz del inicio rápido helloworld . Inicie el servidor JBoss EAP
$ EAP_HOME/bin/standalone.sh
- Navegue al directorio de inicio rápido helloworld.
Compile e implemente el inicio rápido mediante el comando de Maven provisto en el archivo
README.md
del inicio rápido.$ mvn clean install wildfly:deploy
-
La aplicación helloworld está disponible en http://localhost:8080/helloworld y muestra el texto
Hello World!
(¡Hola, mundo!).
3.4. Revisar los ejemplos de inicios rápidos
3.4.1. Exploración del inicio rápido helloworld
El inicio rápido helloworld
le muestra cómo implementar un servlet simple en JBoss EAP. La lógica empresarial está encapsulada en un servicio, el cual se ofrece como un bean de Inyección de contextos y dependencia (CDI) y se inyecta en el Servlet. El inicio rápido es un punto de partida para asegurarse de haber configurado e iniciado su servidor correctamente.
Las instrucciones detalladas para compilar e implementar este inicio rápido mediante la línea de comando se puede encontrar en el archivo README.html
en la raíz del directorio de inicio rápido helloworld
. Este tema le explica cómo usar Red Hat JBoss Developer Studio para ejecutar el inicio rápido y asume que usted ha instalado Red Hat JBoss Developer Studio, configurado Maven, e importado y ejecutado correctamente el inicio rápido helloworld
.
Prerrequisitos
- Instale JBoss Developer Studio. Para obtener instrucciones, consulte Instalación del servidor autónomo JBoss Developer Studio usando el instalador en la Guía de instalación de JBoss Developer Studio.
-
Ejecute el inicio rápido
helloworld
. Para obtener instrucciones, consulte Ejecutar los inicios rápidos en JBoss Developer Studio. -
Verifique que el inicio rápido
helloworld
se haya implementado correctamente en JBoss EAP; para ello, abra un explorador web y acceda a la aplicación en http://localhost:8080/helloworld.
Examine la estructura del directorio
El código para el inicio rápido helloworld
se puede encontrar en el directorio QUICKSTART_HOME/helloworld/
. El inicio rápido helloworld
está compuesto por un Servlet y un bean de CDI. También contiene un archivo beans.xml
en el directorio WEB-INF/
de la aplicación, cuyo número de versión es 1.1, y un bean-discovery-mode
de all
. Este archivo marcador identifica el WAR como un archivo bean y le ordena a JBoss EAP que busque beans en esta aplicación y que active la CDI.
El directorio src/main/webapp/
contiene los archivos para el inicio rápido. Todos los archivos de configuración de este ejemplo se encuentran en el directorio WEB-INF/
dentro de src/main/webapp/
, incluido el archivo beans.xml
. El directorio src/main/webapp/
también incluye un archivo index.html
, que usa una simple actualización meta para redirigir el navegador del usuario al Servlet, el cual se localiza en http://localhost:8080/helloworld/HelloWorld. El inicio rápido no requiere un archivo web.xml
.
Examine el código
La declaración del paquete y las importaciones se han excluido de este listado. El listado completo está disponible en el código fuente del inicio rápido.
Revise el código
HelloWorldServlet
.El archivo
HelloWorldServlet.java
se encuentra en el directoriosrc/main/java/org/jboss/as/quickstarts/helloworld/
. Este servlet envía la información al navegador.Ejemplo: Código de clase HelloWorldServlet
42 @SuppressWarnings("serial") 43 @WebServlet("/HelloWorld") 44 public class HelloWorldServlet extends HttpServlet { 45 46 static String PAGE_HEADER = "<html><head><title>helloworld</title></head><body>"; 47 48 static String PAGE_FOOTER = "</body></html>"; 49 50 @Inject 51 HelloService helloService; 52 53 @Override 54 protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { 55 resp.setContentType("text/html"); 56 PrintWriter writer = resp.getWriter(); 57 writer.println(PAGE_HEADER); 58 writer.println("<h1>" + helloService.createHelloMessage("World") + "</h1>"); 59 writer.println(PAGE_FOOTER); 60 writer.close(); 61 } 62 63 }
Tabla 3.1. Detalles de HelloWorldServlet
Línea Nota 43
Todo lo que debe hacer es añadir la anotación
@WebServlet
y proporcionar una asignación a una URL usada para acceder al servlet.46-48
Toda página web necesita HTML formado de manera correcta. Este inicio rápido usa cadenas estáticas para escribir la salida de pie de página y de encabezados mínimos.
50-51
Estas líneas inyectan el bean de CDI HelloService, el cual genera el propio mensaje. Mientras no alteremos la API de HelloService, este enfoque nos permite alterar la implementación de HelloService posteriormente, sin modificar la capa de vista.
58
Esta línea llama al servicio para generar el mensaje "Hello World" y escribirlo en la petición HTTP.
Revise el código
HelloService
.El archivo
HelloService.java
está localizado en el directoriosrc/main/java/org/jboss/as/quickstarts/helloworld/
. Este servicio simplemente devuelve un mensaje. No se necesita registro de XML o anotación.Ejemplo: Código de clase HelloService
public class HelloService { String createHelloMessage(String name) { return "Hello " + name + "!"; } }
3.4.2. Explore el inicio rápido de numberguess
El inicio rápido numberguess
le explica cómo crear e implementar una aplicación no persistente simple en JBoss EAP. La información se muestra usando una vista JSF y la lógica empresarial se encapsula en dos beans de CDI. En el inicio rápido numberguess
, tiene diez intentos de adivinar un número entre 1 y 100. Después de cada intento, se le indica si su tentativa fue muy alta o muy baja.
El código para el inicio rápido numberguess
se puede encontrar en el directorio QUICKSTART_HOME/numberguess/
, donde QUICKSTART_HOME
es el directorio en el que descargó y descomprimió los inicios rápidos de JBoss EAP. El inicio rápido numberguess
está compuesto por un número de beans, archivos de configuración, y vistas de Facelets (JSF), y viene empaquetado como un módulo WAR.
Las instrucciones detalladas para desarrollar e implementar este inicio rápido usando la línea de comando se pueden encontrar en el archivo README.html
en la raíz del directorio de inicio rápido numberguess
. Los siguientes ejemplos usan Red Hat JBoss Developer Studio para ejecutar el inicio rápido.
Prerrequisitos
- Instale JBoss Developer Studio. Para obtener instrucciones, consulte Instalación del servidor autónomo JBoss Developer Studio usando el instalador en la Guía de instalación de JBoss Developer Studio.
-
Ejecute el inicio rápido
numberguess
. Para obtener instrucciones, consulte Ejecutar los inicios rápidos en JBoss Developer Studio y reemplacehelloworld
connumberguess
en las instrucciones. -
Verifique que el inicio rápido
numberguess
se haya implementado correctamente en JBoss EAP abriendo un explorador web y accediendo a la aplicación en esta URL: http://localhost:8080/numberguess.
Examine los archivos de configuración
Todos los archivos de configuración para este ejemplo se localizan en el directorio QUICKSTART_HOME/numberguess/src/main/webapp/WEB-INF/
del inicio rápido.
Examine el archivo
faces-config.xml
.Este inicio rápido usa la versión JSF 2.2 del nombre del archivo
faces-config.xml
. El controlador de vista predeterminado en JSF 2.2 es una versión estandarizada de Facelets, por lo que no necesita configuración. Este archivo consiste del elemento raíz solamente y es simplemente un archivo marcador para indicar que JSF se debe habilitar en la aplicación.<faces-config version="2.2" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation=" http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-facesconfig_2_2.xsd"> </faces-config>
Examine el archivo
beans.xml
.El archivo
beans.xml
cuenta con un número de versión 1.1 y unbean-discovery-mode
deall
. Este archivo marcador identifica el WAR como un archivo bean y le ordena a JBoss EAP que busque beans en esta aplicación y que active la CDI.<beans xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation=" http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/beans_1_1.xsd" bean-discovery-mode="all"> </beans>
El inicio rápido no necesita el archivo web.xml
.
3.4.2.1. Examine el código JSF
JSF usa la extensión del archivo .xhtml
para archivos de origen, pero entrega las vistas mostradas con la extensión .jsf
. El archivo home.xhtml
se localiza en el directorio src/main/webapp/
.
Ejemplo: Código de origen JSF
19<html xmlns="http://www.w3.org/1999/xhtml" 20 xmlns:ui="http://java.sun.com/jsf/facelets" 21 xmlns:h="http://java.sun.com/jsf/html" 22 xmlns:f="http://java.sun.com/jsf/core"> 23 24 <head> 25 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> 26 <title>Numberguess</title> 27 </head> 28 29 <body> 30 <div id="content"> 31 <h1>Guess a number...</h1> 32 <h:form id="numberGuess"> 33 34 <!-- Feedback for the user on their guess --> 35 <div style="color: red"> 36 <h:messages id="messages" globalOnly="false" /> 37 <h:outputText id="Higher" value="Higher!" 38 rendered="#{game.number gt game.guess and game.guess ne 0}" /> 39 <h:outputText id="Lower" value="Lower!" 40 rendered="#{game.number lt game.guess and game.guess ne 0}" /> 41 </div> 42 43 <!-- Instructions for the user --> 44 <div> 45 I'm thinking of a number between <span 46 id="numberGuess:smallest">#{game.smallest}</span> and <span 47 id="numberGuess:biggest">#{game.biggest}</span>. You have 48 #{game.remainingGuesses} guesses remaining. 49 </div> 50 51 <!-- Input box for the users guess, plus a button to submit, and reset --> 52 <!-- These are bound using EL to our CDI beans --> 53 <div> 54 Your guess: 55 <h:inputText id="inputGuess" value="#{game.guess}" 56 required="true" size="3" 57 disabled="#{game.number eq game.guess}" 58 validator="#{game.validateNumberRange}" /> 59 <h:commandButton id="guessButton" value="Guess" 60 action="#{game.check}" 61 disabled="#{game.number eq game.guess}" /> 62 </div> 63 <div> 64 <h:commandButton id="restartButton" value="Reset" 65 action="#{game.reset}" immediate="true" /> 66 </div> 67 </h:form> 68 69 </div> 70 71 <br style="clear: both" /> 72 73 </body> 74</html>
Los siguientes números de línea corresponden a los que se ven al visualizar el archivo en JBoss Developer Studio.
Tabla 3.2. Detalles de JSF
Línea | Nota |
---|---|
36-40 |
Estos son los mensajes que se pueden enviar al usuario: "Higher!" y "Lower!" |
45-48 |
Cuando el usuario empieza a adivinar, el rango de números se empieza a volver más pequeño. Esta oración cambia para asegurarse de que sepan el rango válido de números a adivinar. |
55-58 |
Este campo de entrada está enlazado a una propiedad bean usando una expresión de valor. |
58 |
Un enlace validador se utiliza para asegurarse de que el usuario no ingrese de manera accidental un número por fuera del rango de adivinanza. Si el validador no está presente entonces puede que el usuario use un intento por fuera de los límites de la adivinanza. |
59-61 |
Debe haber una manera de que el usuario envíe su intento al servidor. Aquí enlazamos a un método de acción al bean. |
3.4.2.2. Examine los archivos de clases
Todos los archivos de origen del inicio rápido numberguess
se pueden encontrar en el directorio QUICKSTART_HOME/numberguess/src/main/java/org/jboss/as/quickstarts/numberguess/
. La declaración del paquete y las importaciones se han excluido de este listado. El listado completo está disponible en el código fuente del inicio rápido.
Revise el Código del calificador
Random.java
.Se utiliza un calificador para eliminar la ambigüedad entre dos beans, cuando ambos son eligibles para inyección según su tipo. Para obtener más información sobre los calificadores, consulte Usar un calificador para resolver una inyección ambigua en la Guía de desarrollo de JBoss EAP. El calificador
@Random
se usa para inyectar un número aleatorio.@Target({ TYPE, METHOD, PARAMETER, FIELD }) @Retention(RUNTIME) @Documented @Qualifier public @interface Random { }
Revise el Código del calificador
MaxNumber.java
.El
calificador
@MaxNumber
se usa para inyectar la cantidad máxima permitida.@Target({ TYPE, METHOD, PARAMETER, FIELD }) @Retention(RUNTIME) @Documented @Qualifier public @interface MaxNumber { }
Revise el Código
Generator.java
.La clase
Generator
crea el número aleatorio a través de un método de productor, exponiendo el máximo número posible a través de este. Esta clase tiene el alcance de la aplicación, por lo que no obtiene un número aleatorio diferente cada vez.@SuppressWarnings("serial") @ApplicationScoped public class Generator implements Serializable { private java.util.Random random = new java.util.Random(System.currentTimeMillis()); private int maxNumber = 100; java.util.Random getRandom() { return random; } @Produces @Random int next() { // a number between 1 and 100 return getRandom().nextInt(maxNumber - 1) + 1; } @Produces @MaxNumber int getMaxNumber() { return maxNumber; } }
Revise el Código
Game.java
.La clase
Game
con alcance de la sesión es el principal punto de entrada de la aplicación. Es responsable de configurar o reconfigurar el juego, capturar y validar los intentos del usuario, y proporcionar una retroalimentación al usuario mediante unFacesMessage
. Usa el método de ciclo de vida posterior al desarrollo para iniciar el juego, obteniendo un número aleatorio del bean@Random Instance<Integer>
.Observe la anotación
@Named
en la clase. Esta anotación solo es requerida cuando desea que el bean sea accesible a una vista JSF mediante el lenguaje de expresión (Expression Language, EL), en este caso,#{game}
.@SuppressWarnings("serial") @Named @SessionScoped public class Game implements Serializable { /** * The number that the user needs to guess */ private int number; /** * The users latest guess */ private int guess; /** * The smallest number guessed so far (so we can track the valid guess range). */ private int smallest; /** * The largest number guessed so far */ private int biggest; /** * The number of guesses remaining */ private int remainingGuesses; /** * The maximum number we should ask them to guess */ @Inject @MaxNumber private int maxNumber; /** * The random number to guess */ @Inject @Random Instance<Integer> randomNumber; public Game() { } public int getNumber() { return number; } public int getGuess() { return guess; } public void setGuess(int guess) { this.guess = guess; } public int getSmallest() { return smallest; } public int getBiggest() { return biggest; } public int getRemainingGuesses() { return remainingGuesses; } /** * Check whether the current guess is correct, and update the biggest/smallest guesses as needed. Give feedback to the user * if they are correct. */ public void check() { if (guess > number) { biggest = guess - 1; } else if (guess < number) { smallest = guess + 1; } else if (guess == number) { FacesContext.getCurrentInstance().addMessage(null, new FacesMessage("Correct!")); } remainingGuesses--; } /** * Reset the game, by putting all values back to their defaults, and getting a new random number. We also call this method * when the user starts playing for the first time using {@linkplain PostConstruct @PostConstruct} to set the initial * values. */ @PostConstruct public void reset() { this.smallest = 0; this.guess = 0; this.remainingGuesses = 10; this.biggest = maxNumber; this.number = randomNumber.get(); } /** * A JSF validation method which checks whether the guess is valid. It might not be valid because there are no guesses left, * or because the guess is not in range. * */ public void validateNumberRange(FacesContext context, UIComponent toValidate, Object value) { if (remainingGuesses <= 0) { FacesMessage message = new FacesMessage("No guesses left!"); context.addMessage(toValidate.getClientId(context), message); ((UIInput) toValidate).setValid(false); return; } int input = (Integer) value; if (input < smallest || input > biggest) { ((UIInput) toValidate).setValid(false); FacesMessage message = new FacesMessage("Invalid guess"); context.addMessage(toValidate.getClientId(context), message); } } }
Apéndice A. Material de referencia
A.1. Argumentos de tiempo de ejecución del servidor
El script de arranque del servidor de aplicaciones acepta argumentos y cambia en tiempo de ejecución. Esto permite al servidor iniciarse en configuraciones alternativas a aquellas definidas en los archivos de configuración standalone.xml
, domain.xml
y host.xml
Las configuraciones alternativas podrían incluir el inicio del servidor con un set de enlace de socket alternativo o una configuración secundaria.
La lista de los parámetros disponibles puede accederse al pasar la opción de ayuda -h
o --help
en el inicio.
Tabla A.1. Opciones y argumentos de ejecución
Argumento u opción | Modo operativo | Descripción |
---|---|---|
--admin-only |
Autónomo |
Definir el tipo de ejecución del servidor como |
--admin-only |
Dominio |
Configure el tipo de ejecución del controlador host como |
-b=<value>, -b <value> |
Autónomo, dominio |
Establecer la propiedad |
-b<interface>=<value> |
Autónomo, dominio |
Establecer la propiedad |
--backup |
Dominio |
Mantenga una copia de la configuración de dominio persistente incluso si este host no es el controlador de dominios. |
-c=<config>, -c <config> |
Autónomo |
Nombre del archivo de configuración del servidor que se va a utilizar. El predeterminado es |
-c=<config>, -c <config> |
Dominio |
Nombre del archivo de configuración del servidor a utilizar. El predeterminado es |
--cached-dc |
Dominio |
Si el host no es el controlador de dominios y no puede contactar el controlador de dominios en el arranque, inicie utilizando una copia en caché local de la configuración del dominio. |
--debug [<port>] |
Autónomo |
Active el modo de depuración con un argumento opcional para especificar el puerto. Solo funciona si el script de lanzamiento lo soporta. |
-D<name>[=<value>] |
Autónomo, dominio |
Establecer una propiedad del sistema. |
--domain-config=<config> |
Dominio |
Nombre del archivo de configuración del servidor a utilizar. El predeterminado es |
-h, --help |
Autónomo, dominio |
Presente el mensaje de ayuda y salga. |
--host-config=<config> |
Dominio |
Nombre del archivo de configuración host a utilizar. El valor predeterminado es |
--interprocess-hc-address=<address> |
Dominio |
Dirección en la que el controlador host debe escuchar la comunicación del controlador de procesos. |
--interprocess-hc-port=<port> |
Dominio |
Puerto en el que el controlador host debe escuchar la comunicación del controlador de procesos. |
--master-address=<address> |
Dominio |
Establezca la propiedad del sistema |
--master-port=<port> |
Dominio |
Establezca la propiedad del sistema |
--read-only-server-config=<config> |
Autónomo |
Nombre del archivo de configuración del servidor a utilizar. Difiere de |
--read-only-domain-config=<config> |
Dominio |
Nombre del archivo de configuración de dominio a utilizar. Difiere de |
--read-only-host-config=<config> |
Dominio |
Nombre del archivo de configuración host a utilizar. Difiere de |
-P=<url>, -P <url>, --properties=<url> |
Autónomo, dominio |
Cargar las propiedades del sistema desde la URL dada. |
--pc-address=<address> |
Dominio |
Dirección en la que el controlador de procesos escucha la comunicación de los procesos que controla. |
--pc-port=<port> |
Dominio |
Puerto en el que el controlador de procesos escucha la comunicación de los procesos que controla. |
-S<name>[=<value>] |
Autónomo |
Establecer una propiedad de seguridad. |
-secmgr |
Autónomo, dominio |
Ejecuta el servidor con un gestor de seguridad instalado. |
--server-config=<config> |
Autónomo |
Nombre del archivo de configuración del servidor que se va a utilizar. El predeterminado es |
--start-mode=<mode> |
Autónomo |
Establezca el modo de inicio del servidor. Esta opción no se puede usar junto con
|
-u=<value>, -u <value> |
Autónomo, dominio |
Establecer la propiedad |
-v, -V, --version |
Autónomo, dominio |
Presenta la versión del servidor de aplicaciones y sale. |
Los archivos de configuración que se distribuyen con JBoss EAP se configuran para manejar el comportamiento de los switches (por ej., -b
y -u
). Si usted cambia los archivos de configuración para que no utilicen más la propiedad de sistemas controlada por el switch, no afectará en nada añadirlo al comando de lanzamiento.
A.2. Argumentos de la herramienta Add-User
La siguiente tabla describe los argumentos disponibles para el script add-user.sh
o add-user.bat
, una herramienta para agregar nuevos usuarios al archivo de propiedades para una autenticación fuera de lo común.
Tabla A.2. Argumentos para el comando Add-User
Argumento de línea de comandos | Descripción |
---|---|
-a |
Cree un usuario en el dominio de aplicaciones. Si se omite, se creará de forma predeterminada un usuario en el domino de administración. |
-dc <value> |
El directorio de configuración de dominio que contendrá los archivos de propiedades. Si se omite, el directorio predeterminado es |
-sc <value> |
Un directorio de configuración de servidor autónomo alternativo que contendrá los archivos de propiedades. Si se omite, el directorio predeterminado es |
-up, --user-properties <value> |
El nombre del archivo alternativo de propiedades de usuario. Puede ser una ruta absoluta o puede ser un nombre de archivo utilizado junto con el argumento |
-g, --group <value> |
Una lista de grupos separada por comas para asignar este usuario. |
-gp, --group-properties <value> |
El nombre del archivo alternativo de propiedades del grupo. Puede ser una ruta absoluta o un nombre de archivo utilizado junto con el argumento |
-p, --password <value> |
La contraseña del usuario |
-u, --user <value> |
El nombre del usuario. Los nombres de usuarios solo pueden contener los siguientes caracteres, en cualquier cantidad y orden:
|
-r, --realm <value> |
El nombre del dominio utilizado para proteger las interfaces de administración. Si se omiten, el valor predeterminado será: |
-s, --silent |
Ejecute el script |
-e, --enable |
Habilite el usuario. |
-d, --disable |
Inhabilite el usuario |
-cw, --confirm-warning |
Confirma las advertencia automáticamente en modo interactivo. |
-h, --help |
Mostrar la información de uso para el script |
-ds, --display-secret |
Imprima el valor secreto en modo no interactivo |
A.3. Atributos de interfaz
Los nombres de atributos en esta tabla se enumeran como aparecen en el modelo de administración, por ejemplo, al usar la CLI de administración. Consulte el archivo de definición del esquema localizado en EAP_HOME/docs/schema/wildfly-config_5_0.xsd
para ver los elementos como aparecen en el XML, ya que puede haber diferencias en relación con el modelo de administración.
Tabla A.3. Valores y atributos de la interfaz
Elemento interfaz | Descripción |
---|---|
any |
Elemento vacío que indica que parte del criterio de la selección para una interfaz debe ser que cumpla con alguno de los criterios anidados, no necesariamente con todos. |
any-address |
Elemento vacío que indica que los sockets que hacen uso de esta interfaz se deben enlazar a una dirección comodín. Se utilizará la dirección comodín IPv6 ( |
inet-address |
Una dirección IP en IPv6 o IPv4 con una notación decimal con punto o un nombre de host que pueda ser resuelto como una dirección IP. |
link-local-address |
Elemento vacío que indica que parte del criterio de selección para una interfaz debe ser si una dirección está asociada con su enlace local. |
loopback |
Elemento vacío que indica que parte del criterio de selección para una interfaz debe ser si es una interfaz loopback. |
loopback-address |
Una dirección loopback que puede que no esté configurada en la interfaz loopback de la máquina. Difiere de tipo de inet-address, ya que el valor especificado será utilizado, incluso si no se puede encontrar un NIC que tenga la dirección IP asociada. |
multicast |
Elemento vacío que indica que parte del criterio de selección para una interfaz debe ser si soporta multicast o no. |
Nombre |
El nombre de la interfaz. |
nic |
El nombre de una interfaz de red (por ejemplo, eth0, eth1, lo). |
nic-match |
Una expresión regular frente a la cual los nombres de las interfaces de red disponibles en la máquina pueden coincidir para encontrar una interfaz aceptable. |
not |
Elemento vacío que indica que parte del criterio de selección para una interfaz debe ser que no cumpla con ninguno de los criterios establecidos. |
point-to-point |
Elemento vacío que indica que parte del criterio de selección para una interfaz debe ser si es una interfaz punto-a-punto. |
public-address |
Elemento vacío que indica que parte del criterio de selección para una interfaz debe ser si tiene una dirección enrutable públicamente o no. |
site-local-address |
Elemento vacío que indica que parte del criterio de selección para una interfaz debe ser si una dirección está asociada con su sitio local. |
subnet-match |
Una dirección IP de red y el número de bits en el prefijo de red de la dirección, escrito en notación con barras, por ejemplo, |
up |
Elemento vacío que indica que parte del criterio de selección para una interfaz debe ser si está funcionando o no. |
Virtual |
Elemento vacío que indica que parte del criterio de selección para una interfaz debe ser si es una interfaz virtual o no. |
A.4. Atributos de enlaces de sockets
Los nombres de atributos en esta tabla se enumeran como aparecen en el modelo de administración, por ejemplo, al usar la CLI de administración. Consulte el archivo de definición del esquema localizado en EAP_HOME/docs/schema/wildfly-config_5_0.xsd
para ver los elementos como aparecen en el XML, ya que puede haber diferencias en relación con el modelo de administración.
Tabla A.4. Atributos de enlaces de sockets
Atributo | Descripción |
---|---|
client-mappings |
Especifica la asignación de clientes para este enlace de socket. Un cliente que se conecte a este socket debe usar la dirección de destino especificada en el mapa que corresponda con su interfaz de salida deseada. Así permite que las topologías de red avanzadas, usen la traducción de dirección de redes o tengan enlaces en múltiples interfaces de red para funcionar. Cada mapeo debe ser evaluado en orden declarado con la primera correspondencia utilizada para determinar el destino. |
fixed-port |
Si el valor del puerto debería permanecer fijo incluso cuando las diferencias numéricas son aplicadas a los demás sockets en el grupo de sockets. |
interface |
Nombre de la interfaz a la cual se debe vincular el socket, o para los sockets multidifusión, la interfaz en la cual se debe escuchar. Esta debe ser una de las interfaces declaradas. Si no está definido, se utilizará el valor del atributo |
multicast-address |
Dirección multidifusión en la cual el socket debería recibir el tráfico de multidifusión. Si no se especifica, el socket no será configurado para recibir multidifusión. |
multicast-port |
Puerto en el cual el socket debe recibir tráfico multidifusión. Se debe configurar si |
Nombre |
El nombre del socket. Los servicios que necesiten acceder a la información de configuración de socket la encontrarán por el nombre. Este atributo es obligatorio. |
port |
El número de puerto al cual el socket debería enlazarse. Observe que este valor puede sobrescribirse si los servidores aplican un port-offset para incrementar o disminuir todos los valores de puerto. |
A.5. Enlaces de sockets predeterminados
En las tablas siguientes se muestran los enlaces de sockets predeterminados para cada grupo de enlaces de sockets.
Tabla A.5. standard-sockets
Enlace de sockets | Puerto | Descripción |
---|---|---|
ajp |
8009 |
Protocolo Apache JServ. Utilizado para balanceo de carga y clústers HTTP. |
http |
8080 |
El puerto predeterminado para las aplicaciones web implementadas. |
https |
8443 |
Conexión SSL encriptada entre las aplicaciones web implementadas y los clientes. |
management-http |
9990 |
Utilizado para comunicación HTTP con la capa de administración. |
management-https |
9993 |
Utilizado para la comunicación HTTPS con la capa de administración. |
txn-recovery-environment |
4712 |
El administrador de recuperación de transacciones JTA. |
txn-status-manager |
4713 |
El administrador de transacciones JTA / JTS. |
Tabla A.6. ha-sockets
Enlace de sockets | Puerto | Puerto multidifusión | Descripción |
---|---|---|---|
ajp |
8009 |
Protocolo Apache JServ. Utilizado para balanceo de carga y clústers HTTP. | |
http |
8080 |
El puerto predeterminado para las aplicaciones web implementadas. | |
https |
8443 |
Conexión SSL encriptada entre las aplicaciones web implementadas y los clientes. | |
jgroups-mping |
45700 |
Multidifusión. Utilizado para descubrir la membresía inicial en un clúster HA. | |
jgroups-tcp |
7600 |
Descubrimiento de pares unidifusión en clústeres HA mediante TCP. | |
jgroups-udp |
55200 |
45688 |
Descubrimiento de pares multidifusión en clústeres HA mediante UDP. |
management-http |
9990 |
Utilizado para comunicación HTTP con la capa de administración. | |
management-https |
9993 |
Utilizado para la comunicación HTTPS con la capa de administración. | |
modcluster |
23364 |
Puerto multicast para la comunicación entre JBoss EAP y el balanceador de carga HTTP. | |
txn-recovery-environment |
4712 |
El administrador de recuperación de transacciones JTA. | |
txn-status-manager |
4713 |
El administrador de transacciones JTA / JTS. |
Tabla A.7. full-sockets
Enlace de sockets | Puerto | Descripción |
---|---|---|
ajp |
8009 |
Protocolo Apache JServ. Utilizado para balanceo de carga y clústers HTTP. |
http |
8080 |
El puerto predeterminado para las aplicaciones web implementadas. |
https |
8443 |
Conexión SSL encriptada entre las aplicaciones web implementadas y los clientes. |
iiop |
3528 |
Servicios CORBA para transacciones JTS y otros servicios dependientes ORB. |
iiop-ssl |
3529 |
Servicios CORBA SSL encriptados. |
management-http |
9990 |
Utilizado para comunicación HTTP con la capa de administración. |
management-https |
9993 |
Utilizado para la comunicación HTTPS con la capa de administración. |
txn-recovery-environment |
4712 |
El administrador de recuperación de transacciones JTA. |
txn-status-manager |
4713 |
El administrador de transacciones JTA / JTS. |
Tabla A.8. full-ha-sockets
Name | Puerto | Puerto multidifusión | Descripción |
---|---|---|---|
ajp |
8009 |
Protocolo Apache JServ. Utilizado para balanceo de carga y clústers HTTP. | |
http |
8080 |
El puerto predeterminado para las aplicaciones web implementadas. | |
https |
8443 |
Conexión SSL encriptada entre las aplicaciones web implementadas y los clientes. | |
iiop |
3528 |
Servicios CORBA para transacciones JTS y otros servicios dependientes ORB. | |
iiop-ssl |
3529 |
Servicios CORBA SSL encriptados. | |
jgroups-mping |
45700 |
Multidifusión. Utilizado para descubrir la membresía inicial en un clúster HA. | |
jgroups-tcp |
7600 |
Descubrimiento de pares unidifusión en clústeres HA mediante TCP. | |
jgroups-udp |
55200 |
45688 |
Descubrimiento de pares multidifusión en clústeres HA mediante UDP. |
management-http |
9990 |
Utilizado para comunicación HTTP con la capa de administración. | |
management-https |
9993 |
Utilizado para la comunicación HTTPS con la capa de administración. | |
modcluster |
23364 |
Puerto multicast para la comunicación entre JBoss EAP y el balanceador de carga HTTP. | |
txn-recovery-environment |
4712 |
El administrador de recuperación de transacciones JTA. | |
txn-status-manager |
4713 |
El administrador de transacciones JTA / JTS. |
Tabla A.9. load-balancer-sockets
Name | Puerto | Puerto multidifusión | Descripción |
---|---|---|---|
http |
8080 |
El puerto predeterminado para las aplicaciones web implementadas. | |
https |
8443 |
Conexión SSL encriptada entre las aplicaciones web implementadas y los clientes. | |
management-http |
9990 |
Utilizado para comunicación HTTP con la capa de administración. | |
management-https |
9993 |
Utilizado para la comunicación HTTPS con la capa de administración. | |
mcmp-management |
8090 |
El puerto para la conexión del Protocolo de administración Mod-Cluster (MCMP) para transmitir los eventos de ciclo de vida. | |
modcluster |
23364 |
Puerto multicast para la comunicación entre JBoss EAP y el balanceador de carga HTTP. |
Revised on 2018-01-11 05:29:29 EST