Code source wiki de Guide d'Installation Linux

Modifié par Aurelie Bertrand le 2024/04/18 15:16
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 (% class="box infomessage" %)
11 (((
12 __Vocabulaire__
13
14 Dans toutes les pages de documentation, les "**applications**" font références aux fichiers **.war **présents dans le serveur DigDash Enterprise :
15
16 * **Serveur** : ddenterpriseapi.war
17 * **Tableau de bord** : digdash_dashboard.war
18 * **Studio** : studio.war
19 * **Page d'accueil **: adminconsole.war
20
21 Cet ensemble d'applications constitue un domaine. Selon les besoins ce domaine peut être dupliqué pour par exemple disposer d'un contexte de développement et un autre de production.
22 )))
23
24 L'installation de DigDash Enterprise sur Linux peut se faire de deux façons :
25
26 * Utiliser le serveur d'application Tomcat livré dans l'archive d'installation DigDash Enterprise
27 * Utiliser votre propre serveur Tomcat ou serveur d'application compatible JEE.
28
29 Ce document décrit comment utiliser le serveur Tomcat livré en standard, ainsi que l'installation d'un autre Tomcat.
30
31 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]].
32
33 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]].
34
35 = Tomcat STANDARD DigDash =
36
37 == Décompression ==
38
39 * Décompressez le fichier **digdash_enterprise_2023R1_numpatch.zip** dans le répertoire de votre choix, de préférence **/usr/share/digdash_enterprise**.
40 ** L'idéal est un nom sans version, pour ne pas induire en erreur sur le contenu de l'installation lors des mises à jour à venir.
41 * Vérifiez que votre dossier d'installation contient le fichier **version.txt**.
42 ** C'est lui qui indiquera de manière certaine la version du produit (sans avoir à démarrer le serveur).
43
44 == Propriétaire et droits ==
45
46 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 :
47
48 {{code language="bash" cssClass="notranslate"}}
49 USER@domain:~# chown –R USER /usr/share/digdash_enterprise
50 USER@domain:~# chmod –R 755 /usr/share/digdash_enterprise
51 {{/code}}
52
53 == Fichier de configuration digdash.properties ==
54
55 Le fichier **digdash.properties** présent dans le répertoire d'installation vous permet de configurer tout l'environnement.
56
57 Pour qu'il soit utilisé correctement par DigDash Enterprise copiez le dans le dossier **/etc/digdash**.
58
59 (% class="box" %)
60 (((
61 Attention aux droits d'accès, procédez comme à l'étape précédente.
62 )))
63
64 Vous pouvez alors modifier le fichier digdash.properties pour personnaliser votre environnement. Vous pouvez aussi modifier son emplacement. Voir le chapitre [[Externalisation des paramètres dans le fichier digdash.properties>>doc:Digdash.deployment.configuration.advanced_system_guide.other_advanced_parameters.WebHome||anchor="HExternalisationdesparamE8tresdansleA0fichierdigdash.properties" target="_blank"]].
65
66 == Emplacement du dossier de vos données ==
67
68 DigDash Enterprise stocke les informations de configuration, les modèles de données, les portefeuilles d'information, les cubes, l'historique des flux et d'autres fichiers de travail dans le **dossier de l'utilisateur du système d'exploitation**, dans un sous dossier **Application Data/Enterprise Server/<domaine>**.
69
70 Par exemple sous Windows, ce dossier est :
71 C:\Users\<utilisateur>\AppData\Roaming\Enterprise Server\ddenterpriseapi
72
73 Il est important de modifier ce dossier pour en garantir l'accessibilité (droits en lecture/écriture/exécution) et pour maitriser l'espace de stockage (ce dossier peut être volumineux).
74 Cette modification est aussi intéressante pour des raisons d'organisation, de scripting, etc.
75
76 Il existe plusieurs moyen de modifier ce chemin.
77
78 === Dossier commun à tous les domaines ===
79
80 Fichier modifié : **digdash.properties**
81
82 Ceci est le moyen le plus simple et efficace. Tous les domaines de DigDash Enterprise en profiterons (un seul paramétrage pour toutes).
83 L'autre méthode n'est à utiliser qu'en cas de besoin spécifique.
84
85 La variable **digdash.appdata** permet de spécifier l'unique dossier des données.
86 Dans le fichier **<DDE Install>/digdash.properties** décommentez la ligne #digdash.appdata=c:/data en supprimant le caractère # en début de ligne :
87
88 digdash.appdata=/var/lib/digdash/appdata
89
90 Si ce dossier n'existe pas, DigDash Enterprise le crée. Les données ne seront pas stockées directement dans ce dossier, mais dans des sous dossier pour chaque domaine :**
91 <digdash.appdata>/Enterprise Server/<domaine>**
92 **<digdash.appdata>/Enterprise Administrator**
93 **<digdash.appdata>/ldapdigdash**
94
95 **Avantage** : La configuration se faisant au niveau du fichier **digdash.properties**, elle ne sera pas écrasée lors de la mise à jour de DigDash Enterprise par déploiement de nouveaux fichiers WAR.
96
97 **Inconvénient** : Cette configuration est globale au Tomcat de DigDash Enterprise, donc tous les domaine DigDash Enterprise de ce serveur sont concernés.
98 Cependant les données des différents domaines DigDash Enterprise déployés dans ce Tomcat ont bien leur sous-dossier propre, il n'y a aucun risque d'écrasement des données.
99
100 === Dossier différent pour chaque domaine ===
101
102 Fichier modifié : **digdash.properties**
103
104 La variable **<domaine>.AppDataPath** définie dans ce fichier a le même comportement que la variable globale décrite ci-dessus.
105 La différence est que ce paramétrage est spécifique à un domaine DigDash Enterprise.
106
107 Pour définir un dossier des données spécifique à un domaine, modifiez le paramètre AppDataPath préfixé du nom du domaine.
108 Si vous avez un domaine ddenterpriseapi_dev, le paramètre sera :
109
110 ddenterpriseapi_dev.AppDataPath=/var/lib/digdash/appdata_dev
111
112 **Avantages** :
113
114 * Configuration locale à un domaine
115 * Fichier externe au WAR
116
117 **Inconvénient** : Configuration à faire pour chaque domaine.
118
119 == Lancer Tomcat ==
120
121 Avec votre utilisateur <USER> exécutez la commande de lancement de Tomcat :
122
123 {{code language="bash" cssClass="notranslate"}}
124 USER@domain:~# cd /usr/share/digdash_enterprise_20xxxx/apache-tomcat/bin/
125 USER@domain:~# sh startup.sh
126 {{/code}}
127
128 = Votre propre serveur Tomcat en tant que service =
129
130 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.
131
132 1. Installez **Tomcat**
133 1. Téléchargez et décompressez la build de DigDash.
134 1. Exécutez la commande suivante en tant que root : {{code language="bash" cssClass="notranslate"}}mkdir /etc/digdash{{/code}}
135 1. Dans le dossier **/etc/digdash** :
136 11. Copiez le fichier **digdash.properties**
137 11. Supprimez le **#** précédent le paramètre digdash.appdata, attribuez lui la valeur {{code language="ini" cssClass="notranslate"}}digdash.appdata=/var/lib/digdash/appdata{{/code}}
138
139 (% start="5" %)
140 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/tomcat9/webapps**).
141 1. Tomcat devrait extraire les WARs automatiquement. Si ce n'est pas le cas, redémarrez Tomcat (via {{code language="bash" cssClass="notranslate"}}service tomcat9 restart{{/code}}).
142 1. (((
143 En tant que root exécutez les commandes suivantes :
144
145 {{code language="bash" cssClass="notranslate"}}
146 cd /var/lib
147 mkdir digdash
148 chown tomcat9:tomcat9 digdash
149 cd /var/log
150 mkdir digdash
151 chown tomcat9:tomcat9 digdash
152 {{/code}}
153 )))
154 1. Dans le fichier **/etc/digdash/digdash.properties** :
155 1*. Activez le paramètre **log4j.appender.R.File** pour chaque application (supprimez le **#** en début de ligne).
156 1*. La valeur par défaut permt d'avoir un seul fichier de log : **/var/log/digdash/ddenterpriseapi.log**
157 Vous pouvez le modifier pour avoir, si besoin spécifique, un fichier par application.
158 Par exemple il est intéressant de séparer les logs de l'application studio (studio.war)
159 **studio.log4j.appender.R.File=/var/log/digdash/studio.log**
160 1. Redémarrez Tomcat (via {{code language="bash" cssClass="notranslate"}}service tomcat9 restart{{/code}})
161
162 == Dépannage ==
163
164 === "Permission denied" ou "Read-only system" ===
165
166 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.
167
168 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]]
169
170 Pour résoudre ces problèmes :
171
172 1. Trouvez le fichier {{code language="bash" cssClass="notranslate"}}tomcat9.service{{/code}}
173 1. Ouvrez ce fichier en tant que root
174 1. Assurez vous que le champ **ProtectSystem** existe
175 1. Ajoutez **ReadWritePaths=/var/lib/digdash** et **ReadWritePaths=/var/log/digdash** s'ils n'y sont pas déjà
176 1. Sauvegardez le fichier
177 1. Executez la commande suivante en tant que root pour recharger le fichier service : {{code language="bash" cssClass="notranslate"}}systemctl daemon-reload{{/code}}
178 1. Redémarrez Tomcat (via {{code language="bash" cssClass="notranslate"}}service tomcat9 restart{{/code}} ou {{code language="bash" cssClass="notranslate"}}systemctl restart tomcat9.service{{/code}})