Capítulo 2. Administración de JBoss EAP

Igualmente, puede crear usuarios de modo no interactivo pasando parámetros al script add-user. Este método no es recomendable 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.

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.

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:

La información de grupo es almacenada en los siguientes archivos de propiedades:

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.

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 administrativa, incluidos los comandos y operaciones, sintaxis y para ejecución en modo batch, consulte la Guía de CLI administrativa JBoss EAP.

Lance la CLI administrativa

$ EAP_HOME/bin/jboss-cli.sh

Conéctese a un servidor en ejecución

Conéctese

O puede lanzar la CLI administrativa 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 siguiente comando para obtener ayuda sobre un comando específico.

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
}

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

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.

Los archivos de configuración autónomos se localizen en el directorio EAP_HOME/standalone/configuration. Existe un archivo para cada uno de los cuatro perfiles predefinidos (default, ha, full, full-ha).

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

Los archivos de configuración de domino administrado ser localizan en el directorio EAP_HOME/domain/configuration.

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

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:

Para ayudar en el mantenimiento y administración de la instancia del servidor, el servidor de aplicaciones crea una versión con marca de tiempo del arranque. Cualquier cambio de configuración adicional realizado por las operaciones de administración harán que automáticamente se realice una copia de seguridad del archivo original y que se preserve una copia de trabajo de la instancia para futura referencia o para deshacer los cambios. Además se pueden tomar instantáneas, que son copias en un momento preciso de la configuración de servidor actual. Estas instantáneas pueden guardadas y cargadas por un administrador.

Los siguientes ejemplos usan el archivo standalone.xml, pero el mismo proceso 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.

JBoss EAP le permite usar expresiones para definir propiedades remplazables en lugar de valores literales en la configuración. Las expresiones usan el formato ${PARAMETER:DEFAULT_VALUE}. Si se establece el parámetro, entonces se utilizará el valor del parámetro. De lo contrario, se utilizará el valor provisto.

Las fuentes que reciben soporte para resolver expresiones son propiedades de sistema, variables de entorno y 'vault'. Para las implementaciones únicamente, la fuente puede corresponder a las propiedades enumeradas en el archivo META-INF/jboss.properties que se encuentra en el archivador de implementación. Para tipos de implementación que soportan subimplementaciones, la resolución abarca todas las subimplementaciones si el archivo de propiedades está en la implementación externa. (p.ej., el EAR). Si el archivo de propiedades está en la subimplementación, entonces la resolución abarcará únicamente la subimplementación.

El ejemplo del archivo de configuración standalone.xml establece inet-address para la interfaz pública a 127.0.0.1 a menos que el parámetro jboss.bind.address sea definido.

<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 (p.ej., los parámetros de conexión de fuente de datos) típicamente varía entre desarrollo, prueba y entornos de producción. Algunas veces los scripts del sistema de construcción acomodan esta variación, ya que la especificación Java EE no contiene un método para exteriorizar estas configuraciones. Gracias a JBoss EAP, ahora puede usar el remplazo de propiedad 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 el remplazo de la propiedad se aplica.

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:

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:

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)

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

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=master/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>

Los puertos de administración se consolidaron en JBoss EAP 7. JBoss EAP 7 usa por defecto el puerto 9990 para administración nativa (CLI administrativa) y administración HTTP (consola administrativa basada en red). El puerto 9999, el cual se usaba como 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.

JBoss EAP se distribuye con un grupo de enlaces de socket para cada uno de los cuatro perfiles predefinidos (default, ha, full, full-ha).

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.

Servidor autónomo

Al ejecutar como servidor autónomo, únicamente el grupo de enlaces de socket se define por archivo de configuración. Cada archivo de configuración (standalone.xml, standalone-ha.xml, standalone-full.xml, standalone-full-ha.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 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

Durante la ejecución en un domino administrado, todos los grupos de enlaces de socket se definen en el archivo domain.xml. Hay cuatro grupos de enlaces de sockets predefinidos:

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-tcp-fd" interface="private" port="57600"/>
        <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="jgroups-udp-fd" interface="private" port="54200"/>
        <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-groups>

Cuando defina un enlace de socket, configure los atributos port e interface, al igual que los parámetros multidifusión tales como multicast-address y multicast-port. Para obtener más información sobre los atributos de enlaces de sockets, consulte la sección Atributos de enlaces de sockets.

Los vínculos de sockets pueden ser configurados mediante la consola administrativa o CLI administrativa. 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 administrativa.

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>

Un 'port offset' es una diferencia numérica agregada a todos los valores de puertos especificados en el grupo de enlace de socket 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 enlace de socket es 8080, y un servidor usa un 'Port Offset' de 100, entonces 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