Guide d'Installation Linux

Modifié par jhurst le 2021/10/29 13:25


 Java est requis pour pouvoir lancer DigDash. Actuellement, la version 17 de java n'est pas supportée et ne fonctionnera pas. Nous recommandons d'utiliser java 11 (les versions 12 à 16 n'étant pas des versions LTS) pour le moment.

L'installation de DigDash Enterprise sur Linux peut se faire de deux façons :

  • Utiliser le serveur d'application Tomcat livré dans l'archive d'installation DigDash Enterprise
  • Utiliser votre propre serveur Tomcat ou serveur d'application compatible JEE.

Ce document décrit comment utiliser le serveur Tomcat livré en standard, ainsi que l'installation d'un autre Tomcat.

Pour l'installation sur Windows, se reporter au document Guide d'installation de DigDash Enterprise sur Windows.

Pour une mise à jour d'une installation existante, se reporter au document Guide de mise à jour DigDash Enterprise.

Utiliser le Tomcat STANDARD DigDash

Décompression

Décompressez le fichier digdash_enterprise_20xxxx.zip dans le répertoire de votre choix, de préférence /user/share/digdash_enterprise_20xxxx.

Propriétaire et droits

Donnez à l’utilisateur <USER> de votre choix la propriété ainsi que les permissions de lecture et écriture dans le répertoire /usr/share/digdash_enterprise_20xxxx à l’aide de la commande :

USER@domain:~# chown –R USER /usr/share/digdash_enterprise_20xxxx
USER@domain:~# chmod –R 755 /usr/share/digdash_enterprise_20xxxx

Lancer Tomcat

Avec votre utilisateur <USER> exécutez la commande de lancement de Tomcat :

USER@domain:~# cd /usr/share/digdash_enterprise_20xxxx/apache-tomcat/bin/
USER@domain:~# sh startup.sh

Installer DigDash en tant que service en utilisant votre propre serveur Tomcat

Dû aux options de sécurité et du mode d'exécution de Tomcat dans les différents services Tomcat des distributions de Linux, il faut s'assurer que l'utilisateur utilisé pour exécuter Tomcat ait les droits suffisants pour créer les fichiers dont DigDash a besoin.

  1. Installez Tomcat
  2. Téléchargez et décompressez la build de DigDash.
  3. Exécutez la commande suivante en tant que root : mkdir /etc/digdash
  4. Dans le dossier /etc/digdash :
    1. Créez les fichiers ddenterpriseapi.properties, studio.properties et digdash_dashboard.properties tous avec le même contenu : AppDataPath=/var/lib/digdash/appdata.
    2. Créez le fichier adswrapper.properties avec le contenu : ads.instance.name=/var/lib/digdash/ldapdigdash.
  5. Copiez les fichiers WAR situés dans le dossier apache-tomcat/webapps de la build de DigDash vers le dossier webapps de Tomcat (probablement /var/lib/tomcat8/webapps).
  6. Tomcat devrait extraire les WARs automatiquement. Si ce n'est pas le cas, redémarrez Tomcat (via service tomcat8 restart).
  7. En tant que root exécutez les commandes suivantes :

    cd /var/lib
    mkdir digdash
    chown tomcat8:tomcat8 digdash
    cd /var/log
    mkdir digdash
    chown tomcat8:tomcat8 digdash
  8. Dans le dossier /var/lib/tomcat8/webapps/ddenterpriseapi/WEB-INF :
    1. Ouvrez le fichier classes/log4j.properties puis changez le champ log4j.appender.R.File pour qu'il ait la valeur /var/log/digdash/ddenterpriseapi.log.
  9. Dans le dossier /var/lib/tomcat8/webapps/digdash_dashboard/WEB-INF :
    1. Ouvrez le fichier classes/log4j.properties puis changez le champ log4j.appender.R.File pour qu'il ait la valeur /var/log/digdash/ddenterpriseapi.log.
  10. Dans le dossier /var/lib/tomcat8/webapps/adswrapper/WEB-INF :
    1. Ouvrez le fichier classes/log4j.properties puis changez le champ log4j.appender.R.File pour qu'il ait la valeur /var/log/digdash/ddenterpriseapi.log.
  11. Dans le dossier /var/lib/tomcat8/webapps/studio/WEB-INF :
    1. Ouvrez le fichier classes/log4j.properties puis changez le champ log4j.appender.R.File pour qu'il ait la valeur /var/log/digdash/studio.log.
  12. Redémarrez Tomcat (via service tomcat8 restart)

Dépannage

"Permission denied" ou "Read-only system"

Si vous avez le message "permission denied", "read-only system" dans les logs ou des problèmes similaires après l'installation de DigDash et que vous utilisez un service systemd pour démarrer Tomcat (le type de service par défaut sur la plupart des distributions de Linux), il se peut que ça soit à cause de certains paramètres de sécurité dans le fichier service.

Pour plus d'informations (site en anglais) : https://www.freedesktop.org/software/systemd/man/systemd.exec.html#Sandboxing

Pour résoudre ces problèmes :

  1. Trouvez le fichier tomcat8.service
  2. Ouvrez ce fichier en tant que root
  3. Assurez vous que le champ ProtectSystem existe
  4. Ajoutez ReadWritePaths=/var/lib/digdash et ReadWritePaths=/var/log/digdash s'ils n'y sont pas déjà
  5. Sauvegardez le fichier
  6. Executez la commande suivante en tant que root pour recharger le fichier service : systemctl daemon-reload
  7. Redémarrez Tomcat (via service tomcat8 restart ou systemctl restart tomcat8.service)

Déployer le studio standalone (facultatif)

Cette procédure s’applique depuis la version 2019R1 incluse.

  • Arrêtez le serveur
  • Ouvrez une console et naviguez jusqu’au dossier digdash_enterprise_20XXXX
  • Donnez toutes les autorisations à tous les fichiers : chmod -R 755 .
  • Naviguez jusqu’au sous-dossier add-ons/studio_standalone
  • Exécutez la ou les scripts suivantes selon votre besoin :
    • ./deploy_studio_linux.sh
    • ./deploy_studio_macos.sh
    • ./deploy_studio_windows.sh

Ces commandes vont créer des fichiers war dans le dossier apache-tomcat/webapps :

  • studio_linux.war
  • studio_macos.war
  • studio_windows_64bits.war

Si vous utilisez votre propre Tomcat :

  1. Déplacez ces war dans votre dossier webapps.
  2. Redémarrez le serveur.

La page d’accueil contient maintenant des liens pour télécharger les versions du Studio déployées précédemment.