Red Hat Training

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

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

2.4.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
java.ext.dirs Chemins de répertoires d'extension de JDK.
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 journal.
jboss.server.temp.dir Le répertoire que le serveur va utiliser pour le stockage de fichiers temporaires.
jboss.server.deploy.dir Le répertoire que le serveur utilisera pour stocker le contenu déployé.
jboss.controller.temp.dir Le répertoire que le contrôleur hôte va utiliser pour le stockage de fichiers temporaires.
jboss.domain.base.dir Le répertoire de base de contenu de domaine.
jboss.domain.config.dir Le répertoire qui contient la configuration de domaine.
jboss.domain.data.dir Le répertoire que le domaine utilisera pour le stockage de fichiers de données persistantes.
jboss.domain.log.dir Le répertoire que le domaine va utiliser pour le stockage de fichier de journalisation persistant.
jboss.domain.temp.dir Le répertoire que le domaine va utiliser pour le stockage de fichier temporaire.
jboss.domain.deployment.dir Le répertoire que le serveur utilisera pour stocker le contenu déployé.
jboss.domain.servers.dir Le répertoire que le domaine va utiliser pour stocker les sorties d'instances de domaines gérés.
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. Vous pouvez alors changer le gestionnaire de journal pour utiliser my.relative.path,

Exemple 2.11. Un chemin de journalisation personnalisé

my.relative.path=/var/log