2.3. Chemins d'accès aux systèmes de fichiers

2.3.1. Chemins d'accès aux systèmes de fichiers

JBoss EAP 6 utilise des noms logiques pour les chemins de systèmes de fichiers. Les fichiers de configuration domain.xml, host.xml et standalone.xml incluent tous une section où les chemins d'accès peuvent être déclarés. D'autres sections de la configuration peuvent ensuite référencer ces chemins par leur nom logique, évitant la déclaration du chemin d'accès absolu pour chaque instance. Cela bénéficie aux efforts de configuration et d'administration car cela permet à des configurations hôtes spécifiques de résoudre des noms logiques universels.
Par exemple, la configuration du sous-système de logging comprend une référence au chemin jboss.server.log.dir qui pointe vers le répertoire log du serveur.

Exemple 2.10. Exemple de chemin d'accès relatif du répertoire de logging

<file relative-to="jboss.server.log.dir" path="server.log"/>
JBoss EAP 6 fournit un nombre de chemins d'accès standards automatiquement sans que l'utilisateur n'ait besoin de les configurer dans un fichier de configuration.

Tableau 2.2. Chemins d'accès standard

Valeur Description
jboss.home.dir Le répertoire root de la distribution JBoss EAP 6.
user.home Le répertoire d'accueil de l'utilisateur.
user.dir Le répertoire de travail actuel de l'utilisateur
java.home Le répertoire d'installation de Java
jboss.server.base.dir Le répertoire root d'une instance de serveur individuel.
jboss.server.data.dir Le répertoire que le serveur va utiliser pour le stockage de fichiers de données persistantes.
jboss.server.config.dir Le répertoire qui contient la configuration du serveur.
jboss.server.log.dir Le répertoire que le serveur va utiliser pour le stockage de fichier de journalisation.
jboss.server.temp.dir Le répertoire que le serveur va utiliser pour le stockage de fichiers temporaires.
jboss.controller.temp.dir Le répertoire que le contrôleur hôte va utiliser pour le stockage de fichiers temporaires.
Substituer un chemin par un autre

Si vous exécutez en serveur autonome, vous pourrez substituer les chemins jboss.server.base.dir, jboss.server.log.dir, ou jboss.server.config.dir d'une ou de deux manières.

  1. Vous pouvez passer des arguments par ligne de commande quand vous démarrez le serveur. Ainsi : 
    bin/standalone.sh -Djboss.server.log.dir=/var/log
  2. Vous pouvez modifier la variable JAVA_OPTS dans le fichier de configuration du serveur. Ouvrir le fichier EAP_HOME/bin/standalone.conf et ajouter la ligne suivante à la fin du fichier : 
    JAVA_OPTS="$JAVA_OPTS Djboss.server.log.dir=/var/log"
La substitution de fichiers n'est pas prise en charge pour les serveurs exécutant dans un domaine géré.

Ajouter un chemin personnalisé

Vous pouvez également créer votre propre chemin personnalisé. Par exemple, vous pouvez définir un chemin relatif à utiliser pour la journalisation : 

my.relative.path=/var/log
Vous pouvez alors modifier le log handler pour qu'il utilise my.relative.path,

Rapporter un bogue