Propriétés système dans WildFly

Cette page récapitule les propriétés système les plus courantes.

Il est possible de lire la liste complète des propriétés système depuis jboss-cli :app-name:

/core-service=platform-mbean/type=runtime:read-attribute(name=system-properties)

Standalone

Les propriétés système sont passées au démarrage de WildFly en les mettant dans la variable d’environnement JAVA_OPTS. Le fichier standalone.conf est l’endroit idéal pour ça.

jboss.server.default.config

Fichier de configuration principal

  JAVA_OPTS="$JAVA_OPTS -Djboss.server.default.config=standalone-ha.xml"

La valeur par défaut est ${jboss.server.config.dir}/standalone.xml

Répertoires

  • jboss.home.dir

  • jboss.server.base.dir : ${jboss.home.dir}/standalone

  • jboss.server.config.dir : ${jboss.server.base.dir}/configuration

  • jboss.server.data.dir : ${jboss.server.base.dir}/data

  • jboss.server.log.dir : ${jboss.server.base.dir}/log

  • jboss.server.temp.dir : ${jboss.server.base.dir}/tmp

jboss.bind.address

Adresse IP sur laquelle l’interface publique de WildFly doit se brancher ; concerne l’accès aux applications

  JAVA_OPTS="$JAVA_OPTS -Djboss.bind.address=0.0.0.0"

La valeur par défaut est 127.0.0.1, ce qui signifie que WildFly n’est accessible qu’en local. En mettant 0.0.0.0, WildFly est accessible en local et à distance, via toutes les interfaces réseau du serveur.

Autres adresses IP :

  • jboss.bind.address.management : pour les accès de management

  • jboss.bind.address.unsecure : les accès IIOP

jboss.socket.binding.port-offset

Décalage des ports d’écoute par rapport aux valeurs indiquées dans le fichier de configuration

  JAVA_OPTS="$JAVA_OPTS -Djboss.socket.binding.port-offset=100"

La valeur par défaut est 0.

Certains ports ont leur propre variable :

  • jboss.http.port

  • jboss.https.port

  • jboss.ajp.port

  • jboss.management.http.port

  • jboss.management.https.port

jboss.node.name

Nom de l’instance JBoss dans un cluster

  JAVA_OPTS="$JAVA_OPTS -Djboss.node.name=node0"

La valeur par défaut est le hostname fourni par le système d’exploitation.

Cette propriété sert aussi de valeur par défaut à l'`instance-id`, utilisé pour l’affinité de session (en remplacement de jvmRoute).

Domain

Fichiers de configuration

Fichier host :

JAVA_OPTS="$JAVA_OPTS -Djboss.host.default.config=host-slave.xml"

La variante courte est --host-config.

Fichier domain :

JAVA_OPTS="$JAVA_OPTS -Djboss.domain.default.config=domain-bis.xml"

Répertoires

  • jboss.home.dir

  • jboss.domain.base.dir : ${jboss.home.dir}/domain

  • jboss.domain.config.dir : ${jboss.server.base.dir}/configuration

  • jboss.domain.data.dir : ${jboss.server.base.dir}/data

  • jboss.domain.log.dir : ${jboss.server.base.dir}/log

  • jboss.domain.temp.dir : ${jboss.server.base.dir}/tmp

Références