Red Hat Training

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

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 operativoDescripción

--admin-only

Autónomo

Definir el tipo de ejecución del servidor como ADMIN_ONLY. Esto lo hará abrir las interfaces administrativas y aceptar las peticiones de administración, pero no podrá iniciar otros servicios de tiempo de ejecución ni aceptar peticiones de usuarios finales. Observe que, en cambio, se recomienda usar --start-mode=admin-only.

--admin-only

Dominio

Configure el tipo de ejecución del controlador host como ADMIN_ONLY para que abra interfaces administrativas y acepte peticiones de administración, pero no podrá iniciar servidores o, si este controlador host es el maestro del dominio, aceptar conexiones entrantes de controladores hosts esclavos.

-b=<value>, -b <value>

Autónomo, dominio

Establecer la propiedad jboss.bind.address del sistema, que se utiliza para configurar la dirección de enlace para la interfaz pública. Si no se especifica un valor, se establecerá de forma predeterminada en 127.0.0.1. Consulte la entrada -b<interface>=<value> para configurar la dirección de enlace para otras interfaces.

-b<interface>=<value>

Autónomo, dominio

Establecer la propiedad jboss.bind.address.<interface> del sistema con el valor proporcionado. Por ejemplo, -bmanagement=IP_ADDRESS

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

-c=<config>, -c <config>

Dominio

Nombre del archivo de configuración del servidor a utilizar. El predeterminado es domain.xml.

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

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

--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 jboss.domain.master.address con el valor dado. En una configuración predeterminada del controlador host esclavo, esto se utiliza para configurar la dirección del controlador host maestro.

--master-port=<port>

Dominio

Establezca la propiedad del sistema jboss.domain.master.port con el valor dado. En una configuración predeterminada del controlador host esclavo, esto se utiliza para configurar el puerto utilizado para la comunicación de administración nativa por parte del controlador host maestro.

--read-only-server-config=<config>

Autónomo

Nombre del archivo de configuración del servidor a utilizar. Difiere de --server-config y -c en que el archivo original nunca se sobrescribe.

--read-only-domain-config=<config>

Dominio

Nombre del archivo de configuración de dominio a utilizar. Difiere de --domain-config y -c en que el archivo inicial nunca se sobrescribe.

--read-only-host-config=<config>

Dominio

Nombre del archivo de configuración host a utilizar. Difiere de --host-config en que el archivo inicial nunca se sobrescribe.

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

--start-mode=<mode>

Autónomo

Establezca el modo de inicio del servidor. Esta opción no se puede usar junto con --admin-only. Los valores válidos son:

  • normal: El servidor se iniciará normalmente.
  • admin-only: El servidor solo abrirá interfaces administrativas y aceptará solicitudes de administración, pero no ejecutará otros servicios de tiempo de ejecución ni aceptará solicitudes de usuario final.
  • suspend: El servidor se iniciará en modo suspendido y no atenderá solicitudes hasta que se haya reanudado.

-u=<value>, -u <value>

Autónomo, dominio

Establecer la propiedad jboss.default.multicast.address del sistema, que se utiliza en la configuración de la dirección multidifusión de los elementos de vinculación de sockets en los archivos de configuración. Si no se especifica ningún valor, se establecerá de forma predeterminada en 230.0.0.4.

-v, -V, --version

Autónomo, dominio

Presenta la versión del servidor de aplicaciones y sale.

Aviso

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 comandosDescripció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 EAP_HOME/domain/configuration/.

-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 EAP_HOME/standalone/configuration/.

-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 -sc o -dc que especifica el directorio de configuración alternativo.

-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 -sc o -dc que especifica el directorio de configuración alternativo.

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

  • Caracteres alfanuméricos (a-z, A-Z, 0-9)
  • Guiones (-), puntos (.), comas (,), arroba (@)
  • Barra diagonal inversa (\)
  • Signo igual (=)

-r, --realm <value>

El nombre del dominio utilizado para proteger las interfaces de administración. Si se omiten, el valor predeterminado será: ManagementRealm.

-s, --silent

Ejecute el script add-user sin salida a la consola.

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

-ds, --display-secret

Imprima el valor secreto en modo no interactivo

A.3. Atributos de interfaz

Nota

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 interfazDescripció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 (::) a menos que la propiedad del sistema java.net.preferIPv4Stack esté configurada como verdadera, en cuyo caso se utilizará la dirección comodín IPv4 (0.0.0.0). Si un socket está enlazado a una dirección IPv6 anylocal en una máquina con doble pila, podrá aceptar tráfico IPv6 e IPv4; si está enlazado a una dirección IPv4 anylocal (mapeada para IPv4), solamente podrá aceptar tráfico IPv4.

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, 192.168.0.0/16.

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

Nota

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

AtributoDescripció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 default-interface del grupo de enlaces de sockets vinculado.

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 multicast-address está configurado.

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 socketsPuertoDescripció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 socketsPuertoPuerto multidifusiónDescripció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 socketsPuertoDescripció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

NamePuertoPuerto multidifusiónDescripció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

NamePuertoPuerto multidifusiónDescripció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