Code source wiki de Guide d'Installation Linux

Modifié par jhurst le 2021/10/29 13:24
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 == Indiquez où ce trouve le fichier de configuration ==
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 envionnement.
66 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"]].
67
68 == Emplacement du dossier de vos données ==
69
70 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>**.
71
72 Par exemple sous Windows, ce dossier est :
73 C:\Users\<utilisateur>\AppData\Roaming\Enterprise Server\ddenterpriseapi
74
75 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).
76 Cette modification est aussi intéressante pour des raisons d'organisation, de scripting, etc.
77
78 Il existe plusieurs moyen de modifier ce chemin.
79
80 === Dossier commun à tous les domaines ===
81
82 Fichier modifié : **digdash.properties**
83
84 Ceci est le moyen le plus simple et efficace. Tous les domaines de DigDash Enterprise en profiterons (un seul paramétrage pour toutes).
85 L'autre méthode n'est à utiliser qu'en cas de besoin spécifique.
86
87 La variable **digdash.appdata** permet de spécifier l'unique dossier des données.
88 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 :
89
90 digdash.appdata=/var/lib/digdash/appdata
91
92 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 :**
93 <digdash.appdata>/Enterprise Server/<domaine>**
94 **<digdash.appdata>/Enterprise Administrator**
95 **<digdash.appdata>/ldapdigdash**
96
97 **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.
98
99 **Inconvénient** : Cette configuration est globale au Tomcat de DigDash Enterprise, donc tous les domaine DigDash Enterprise de ce serveur sont concernés.
100 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.
101
102 === Dossier différent pour chaque domaine ===
103
104 Fichier modifié : **digdash.properties**
105
106 La variable **<domaine>.AppDataPath** définie dans ce fichier a le même comportement que la variable globale décrite ci-dessus.
107 La différence est que ce paramétrage est spécifique à un domaine DigDash Enterprise.
108
109 Pour définir un dossier des données spécifique à un domaine, modifiez le paramètre AppDataPath préfixé du nom du domaine.
110 Si vous avez un domaine ddenterpriseapi_dev, le paramètre sera :
111
112 ddenterpriseapi_dev.AppDataPath=/var/lib/digdash/appdata_dev
113
114 **Avantages** :
115
116 * Configuration locale à un domaine
117 * Fichier externe au WAR
118
119 **Inconvénient** : Configuration à faire pour chaque domaine.
120
121 == Lancer Tomcat ==
122
123 Avec votre utilisateur <USER> exécutez la commande de lancement de Tomcat :
124
125 {{code language="bash" cssClass="notranslate"}}
126 USER@domain:~# cd /usr/share/digdash_enterprise_20xxxx/apache-tomcat/bin/
127 USER@domain:~# sh startup.sh
128 {{/code}}
129
130 = Votre propre serveur Tomcat en tant que service =
131
132 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.
133
134 1. Installez **Tomcat**
135 1. Téléchargez et décompressez la build de DigDash.
136 1. Exécutez la commande suivante en tant que root : {{code language="bash" cssClass="notranslate"}}mkdir /etc/digdash{{/code}}
137 1. Dans le dossier **/etc/digdash** :
138 11. Copiez le fichier **digdash.properties**
139 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}}
140
141 (% start="5" %)
142 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**).
143 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}}).
144 1. (((
145 En tant que root exécutez les commandes suivantes :
146
147 {{code language="bash" cssClass="notranslate"}}
148 cd /var/lib
149 mkdir digdash
150 chown tomcat9:tomcat9 digdash
151 cd /var/log
152 mkdir digdash
153 chown tomcat9:tomcat9 digdash
154 {{/code}}
155 )))
156 1. Dans le fichier **/etc/digdash/digdash.properties** :
157 1*. Activez le paramètre **log4j.appender.R.File** pour chaque application (supprimez le **#** en début de ligne).
158 1*. La valeur par défaut permt d'avoir un seul fichier de log : **/var/log/digdash/ddenterpriseapi.log**
159 Vous pouvez le modifier pour avoir, si besoin spécifique, un fichier par application.
160 Par exemple il est intéressant de séparer les logs de l'application studio (studio.war)
161 **studio.log4j.appender.R.File=/var/log/digdash/studio.log**
162 1. Redémarrez Tomcat (via {{code language="bash" cssClass="notranslate"}}service tomcat9 restart{{/code}})
163
164 == Dépannage ==
165
166 === "Permission denied" ou "Read-only system" ===
167
168 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.
169
170 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]]
171
172 Pour résoudre ces problèmes :
173
174 1. Trouvez le fichier {{code language="bash" cssClass="notranslate"}}tomcat9.service{{/code}}
175 1. Ouvrez ce fichier en tant que root
176 1. Assurez vous que le champ **ProtectSystem** existe
177 1. Ajoutez **ReadWritePaths=/var/lib/digdash** et **ReadWritePaths=/var/log/digdash** s'ils n'y sont pas déjà
178 1. Sauvegardez le fichier
179 1. Executez la commande suivante en tant que root pour recharger le fichier service : {{code language="bash" cssClass="notranslate"}}systemctl daemon-reload{{/code}}
180 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}})