Modifier l'emplacement des fichiers de base de données DDAudit

Modifié par Aurelie Bertrand le 2024/05/27 08:59

Par défaut, les fichiers de la base de données DDAudit sont stockés dans le répertoire de travail de Tomcat. Dans quelques configurations ce chemin peut ne pas être le répertoire d'installation de DigDash Enterprise.

Par exemple, sur Linux le répertoire de travail de Tomcat peut être le dossier d'installation de Tomcat (ex: /var/lib/tomcatX), et les droits d'utilisateurs peuvent empêcher le serveur d'écrire et/ou de modifier des fichiers dans ce répertoire. Dans ce cas DDAudit ne fonctionnera pas.

Un autre exemple est sous Windows, lorsque Tomcat est démarré en tant que service, les fichiers de base de données DDAudit peuvent se trouver dans le répertoire Windows/system32.

Voir le chapitre "Externalisation des paramètres dans un fichier properties" pour effectuer la manipulation suivante.

Vous pouvez changer l'emplacement des fichiers de base de données DDAudit selon la procédure suivante :

  1. Arrêter le serveur DigDash Enterprise
  2. Ouvrir en édition le fichier <Répertoire d'installation de DigDash Enterprise>/digdash.properties.
    • Changer la valeur du paramètre audit.db.url
      de jdbc:h2:DDAudit_${server.DomainName};AUTO_SERVER=TRUE
      en jdbc:h2:file:/home/audit/DDAudit_${server.DomainName};AUTO_SERVER=TRUE (attention au « file: » inséré en début d’URL)
  3. Vérifier que le dossier spécifié existe et déplacer tous les fichiers existants DDAudit*.db vers le nouvel emplacement
  4. Démarrer le serveur DigDash Enterprise

Note : Les paramètres audit.db.url, audit.db.user, audit.db.password et audit.db.tcpServer peuvent également être spécifiés sous la forme de paramètres de lancement de la JVM, par exemple en ajoutant dans la variable JAVA_OPTS (setenv.bat, setenv.sh…) ou dans catalina.properties :
JAVA_OPTS=[…] -Daudit.db.url=jdbc:h2:file:/home/DDAudit;AUTO_SERVER=TRUE [...]

Une alternative est de changer la valeur du paramètre h2.baseDir, qui change globalement le comportement des bases H2 (DDAudit, mais aussi DDComments) :

  1. Arrêter le serveur DigDash Enterprise
  2. Chercher et éditer le fichier catalina.properties sur le serveur (ex : <DDE Install>/apache-tomcat/conf/catalina.properties sur une installation Windows)
  3. Ajouter la ligne suivante : h2.baseDir=/le/nouveau/chemin

Note : Ce chemin doit obligatoirement être un chemin absolu.

  1. Vérifier que ce dossier existe et déplacer tous les fichiers existants DDAudit*.db vers le nouvel emplacement
  2. Démarrer le serveur DigDash Enterprise.