Code source wiki de Guide d'Installation Linux

Modifié par jhurst le 2021/10/29 13:25
Afficher les derniers auteurs
1 {{ddtoc/}}
2
3 ----
4
5 (% class="box warningmessage" %)
6 (((
7 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.
8 )))
9
10 L'installation de DigDash Enterprise sur Linux peut se faire de deux façons :
11
12 * Utiliser le serveur d'application Tomcat livré dans l'archive d'installation DigDash Enterprise
13 * Utiliser votre propre serveur Tomcat ou serveur d'application compatible JEE.
14
15 Ce document décrit comment utiliser le serveur Tomcat livré en standard, ainsi que l'installation d'un autre Tomcat.
16
17 Pour l'installation sur Windows, se reporter au document [[Guide d'installation de DigDash Enterprise sur Windows>>doc:Digdash.deployment.installation.install_guide_windows.WebHome]].
18
19 Pour une mise à jour d'une installation existante, se reporter au document [[Guide de mise à jour DigDash Enterprise>>doc:Digdash.deployment.installation.upgrade_dde.WebHome]].
20
21 = Utiliser le Tomcat STANDARD DigDash =
22
23 == Décompression ==
24
25 Décompressez le fichier **digdash_enterprise_20xxxx.zip** dans le répertoire de votre choix, de préférence **/user/share/digdash_enterprise_20xxxx**.
26
27 == Propriétaire et droits ==
28
29 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 :
30
31 {{code language="bash"}}
32 USER@domain:~# chown –R USER /usr/share/digdash_enterprise_20xxxx
33 USER@domain:~# chmod –R 755 /usr/share/digdash_enterprise_20xxxx
34 {{/code}}
35
36 == Lancer Tomcat ==
37
38 Avec votre utilisateur <USER> exécutez la commande de lancement de Tomcat :
39
40 {{code language="bash"}}
41 USER@domain:~# cd /usr/share/digdash_enterprise_20xxxx/apache-tomcat/bin/
42 USER@domain:~# sh startup.sh
43 {{/code}}
44
45 = Installer DigDash en tant que service en utilisant votre propre serveur Tomcat =
46
47 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.
48
49 1. Installez **Tomcat**
50 1. Téléchargez et décompressez la build de DigDash.
51 1. Exécutez la commande suivante en tant que root : {{code language="bash"}}mkdir /etc/digdash{{/code}}
52 1. Dans le dossier **/etc/digdash** :
53 11. Créez les fichiers **ddenterpriseapi.properties**, **studio.properties** et **digdash_dashboard.properties** tous avec le même contenu : {{code language="ini"}}AppDataPath=/var/lib/digdash/appdata{{/code}}.
54 11. Créez le fichier **adswrapper.properties** avec le contenu : {{code language="ini"}}ads.instance.name=/var/lib/digdash/ldapdigdash{{/code}}.
55 1. 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**).
56 1. Tomcat devrait extraire les WARs automatiquement. Si ce n'est pas le cas, redémarrez Tomcat (via {{code language="bash"}}service tomcat8 restart{{/code}}).
57 1. (((
58 En tant que root exécutez les commandes suivantes :
59
60 {{code language="bash"}}
61 cd /var/lib
62 mkdir digdash
63 chown tomcat8:tomcat8 digdash
64 cd /var/log
65 mkdir digdash
66 chown tomcat8:tomcat8 digdash
67 {{/code}}
68 )))
69 1. Dans le dossier **/var/lib/tomcat8/webapps/ddenterpriseapi/WEB-INF** :
70 11. 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**.
71 1. Dans le dossier **/var/lib/tomcat8/webapps/digdash_dashboard/WEB-INF** :
72 11. 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**.
73 1. Dans le dossier **/var/lib/tomcat8/webapps/adswrapper/WEB-INF** :
74 11. 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**.
75 1. Dans le dossier **/var/lib/tomcat8/webapps/studio/WEB-INF** :
76 11. 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**.
77 1. Redémarrez Tomcat (via {{code language="bash"}}service tomcat8 restart{{/code}})
78
79 == Dépannage ==
80
81 === "Permission denied" ou "Read-only system" ===
82
83 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.
84
85 Pour plus d'informations (site en anglais) : [[https:~~/~~/www.freedesktop.org/software/systemd/man/systemd.exec.html#Sandboxing>>https://www.freedesktop.org/software/systemd/man/systemd.exec.html#Sandboxing]]
86
87 Pour résoudre ces problèmes :
88
89 1. Trouvez le fichier {{code language="bash"}}tomcat8.service{{/code}}
90 1. Ouvrez ce fichier en tant que root
91 1. Assurez vous que le champ **ProtectSystem** existe
92 1. Ajoutez **ReadWritePaths=/var/lib/digdash** et **ReadWritePaths=/var/log/digdash** s'ils n'y sont pas déjà
93 1. Sauvegardez le fichier
94 1. Executez la commande suivante en tant que root pour recharger le fichier service : {{code language="bash"}}systemctl daemon-reload{{/code}}
95 1. Redémarrez Tomcat (via {{code language="bash"}}service tomcat8 restart{{/code}} ou {{code language="bash"}}systemctl restart tomcat8.service{{/code}})
96
97 = Déployer le studio standalone (facultatif) =
98
99 //Cette procédure s’applique depuis la version 2019R1 incluse.//
100
101 * Arrêtez le serveur
102 * Ouvrez une console et naviguez jusqu’au dossier **digdash_enterprise_20XXXX**
103 * Donnez toutes les autorisations à tous les fichiers : **chmod -R 755 .**
104 * Naviguez jusqu’au sous-dossier **add-ons/studio_standalone**
105 * Exécutez la ou les scripts suivantes selon votre besoin :
106 ** ./deploy_studio_linux.sh
107 ** ./deploy_studio_macos.sh
108 ** ./deploy_studio_windows.sh
109
110 Ces commandes vont créer des fichiers **war** dans le dossier **apache-tomcat/webapps :**
111
112 * studio_linux.war
113 * studio_macos.war
114 * studio_windows_64bits.war
115
116 Si vous utilisez votre propre Tomcat :
117
118 1. Déplacez ces war dans votre dossier webapps.
119 1. Redémarrez le serveur.
120
121 La page d’accueil contient maintenant des liens pour télécharger les versions du Studio déployées précédemment.