Code source wiki de Guide d'Installation Linux

Modifié par jhurst le 2022/11/14 09:18
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 * **Web Studio** : studio.war
19 * **Page d'accueil et Desktop Studio** : 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 Pour déployer plusieurs domaines suivez [[ce lien>>path:/xwiki/wiki/howtos/view/howtos/server/Domain_management/]].
23 )))
24
25 L'installation de DigDash Enterprise sur Linux peut se faire de deux façons :
26
27 * Utiliser le serveur d'application Tomcat livré dans l'archive d'installation DigDash Enterprise
28 * Utiliser votre propre serveur Tomcat ou serveur d'application compatible JEE.
29
30 Ce document décrit comment utiliser le serveur Tomcat livré en standard, ainsi que l'installation d'un autre Tomcat.
31
32 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]].
33
34 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]].
35
36 = Tomcat STANDARD DigDash =
37
38 == Décompression ==
39
40 * Décompressez le fichier **digdash_enterprise_2021R1_numpatch.zip** dans le répertoire de votre choix, de préférence **/user/share/digdash_enterprise**.
41 ** 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.
42 * Vérifiez que votre dossier d'installation contient le fichier **version.txt**.
43 ** C'est lui qui indiquera de manière certaine la version du produit (sans avoir à démarrer le serveur).
44
45 == Propriétaire et droits ==
46
47 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 :
48
49 {{code language="bash" cssClass="notranslate"}}
50 USER@domain:~# chown –R USER /usr/share/digdash_enterprise
51 USER@domain:~# chmod –R 755 /usr/share/digdash_enterprise
52 {{/code}}
53
54 == Fichier de configuration digdash.properties ==
55
56 Le fichier **digdash.properties** présent dans le répertoire d'installation vous permet de configurer tout l'environnement.
57
58 Pour qu'il soit utilisé correctement par DigDash Enterprise copiez le dans le dossier **/etc/digdash**.
59
60 (% class="box" %)
61 (((
62 Attention aux droits d'accès, procédez comme à l'étape précédente.
63 )))
64
65 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.WebHome||anchor="HExternalisationdesparamE8tresdansleA0fichierdigdash.properties" target="_blank"]].
66
67 == Emplacement du dossier de vos données ==
68
69 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>**.
70
71 Par exemple sous Windows, ce dossier est :
72 C:\Users\<utilisateur>\AppData\Roaming\Enterprise Server\ddenterpriseapi
73
74 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).
75 Cette modification est aussi intéressante pour des raisons d'organisation, de scripting, etc.
76
77 Il existe plusieurs moyen de modifier ce chemin.
78
79 === Dossier commun à tous les domaines ===
80
81 Fichier modifié : **digdash.properties**
82
83 Ceci est le moyen le plus simple et efficace. Tous les domaines de DigDash Enterprise en profiterons (un seul paramétrage pour toutes).
84 L'autre méthode n'est à utiliser qu'en cas de besoin spécifique.
85
86 La variable **digdash.appdata** permet de spécifier l'unique dossier des données.
87 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 :
88
89 digdash.appdata=/var/lib/digdash/appdata
90
91 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 :**
92 <digdash.appdata>/Enterprise Server/<domaine>**
93 **<digdash.appdata>/Enterprise Administrator**
94 **<digdash.appdata>/ldapdigdash**
95
96 **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.
97
98 **Inconvénient** : Cette configuration est globale au Tomcat de DigDash Enterprise, donc tous les domaine DigDash Enterprise de ce serveur sont concernés.
99 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.
100
101 === Dossier différent pour chaque domaine ===
102
103 Fichier modifié : **digdash.properties**
104
105 La variable **<domaine>.AppDataPath** définie dans ce fichier a le même comportement que la variable globale décrite ci-dessus.
106 La différence est que ce paramétrage est spécifique à un domaine DigDash Enterprise.
107
108 Pour définir un dossier des données spécifique à un domaine, modifiez le paramètre AppDataPath préfixé du nom du domaine.
109 Si vous avez un domaine ddenterpriseapi_dev, le paramètre sera :
110
111 ddenterpriseapi_dev.AppDataPath=/var/lib/digdash/appdata_dev
112
113 **Avantages** :
114
115 * Configuration locale à un domaine
116 * Fichier externe au WAR
117
118 **Inconvénient** : Configuration à faire pour chaque domaine.
119
120 == Lancer Tomcat ==
121
122 Avec votre utilisateur <USER> exécutez la commande de lancement de Tomcat :
123
124 {{code language="bash" cssClass="notranslate"}}
125 USER@domain:~# cd /usr/share/digdash_enterprise_20xxxx/apache-tomcat/bin/
126 USER@domain:~# sh startup.sh
127 {{/code}}
128
129 = Votre propre serveur Tomcat en tant que service =
130
131 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.
132
133 1. Installez **Tomcat**
134 1. Téléchargez et décompressez la build de DigDash.
135 1. Exécutez la commande suivante en tant que root : {{code language="bash" cssClass="notranslate"}}mkdir /etc/digdash{{/code}}
136 1. Dans le dossier **/etc/digdash** :
137 11. Copiez le fichier **digdash.properties**
138 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}}
139
140 (% start="5" %)
141 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**).
142 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}}).
143 1. (((
144 En tant que root exécutez les commandes suivantes :
145
146 {{code language="bash" cssClass="notranslate"}}
147 cd /var/lib
148 mkdir digdash
149 chown tomcat9:tomcat9 digdash
150 cd /var/log
151 mkdir digdash
152 chown tomcat9:tomcat9 digdash
153 {{/code}}
154 )))
155 1. Dans le fichier **/etc/digdash/digdash.properties** :
156 1*. Activez le paramètre **log4j.appender.R.File** pour chaque application (supprimez le **#** en début de ligne).
157 1*. La valeur par défaut permt d'avoir un seul fichier de log : **/var/log/digdash/ddenterpriseapi.log**
158 Vous pouvez le modifier pour avoir, si besoin spécifique, un fichier par application.
159 Par exemple il est intéressant de séparer les logs de l'application studio (studio.war)
160 **studio.log4j.appender.R.File=/var/log/digdash/studio.log**
161 1. Redémarrez Tomcat (via {{code language="bash" cssClass="notranslate"}}service tomcat9 restart{{/code}})
162
163 == Dépannage ==
164
165 === "Permission denied" ou "Read-only system" ===
166
167 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.
168
169 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]]
170
171 Pour résoudre ces problèmes :
172
173 1. Trouvez le fichier {{code language="bash" cssClass="notranslate"}}tomcat9.service{{/code}}
174 1. Ouvrez ce fichier en tant que root
175 1. Assurez vous que le champ **ProtectSystem** existe
176 1. Ajoutez **ReadWritePaths=/var/lib/digdash** et **ReadWritePaths=/var/log/digdash** s'ils n'y sont pas déjà
177 1. Sauvegardez le fichier
178 1. Executez la commande suivante en tant que root pour recharger le fichier service : {{code language="bash" cssClass="notranslate"}}systemctl daemon-reload{{/code}}
179 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}})