Code source wiki de Guide d'installation Windows

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>>doc:howtos:howtos.server.Domain_management.WebHome]].
23 )))
24
25 (% class="wikigeneratedid" id="HIntroduction" %)
26 L'installation de DigDash Enterprise sur Windows peut se faire de deux façons :
27
28 * lancement manuel
29 * lancement automatique en tant que service Windows
30
31 Ce document décrit comment installer DigDash sur Windows dans ces deux modes.
32
33 Pour l'installation sur Linux, se reporter au document [[Guide d'Installation Linux>>doc:Digdash.deployment.installation.install_guide_linux.WebHome]].
34
35 Pour une mise à jour d'une installation existante, se reporter au document [[Guide de mise à jour>>doc:Digdash.deployment.installation.upgrade_dde.WebHome]].
36
37 = Installation =
38
39 * Décompressez les fichiers contenus dans le fichier **digdash_enterprise_2021R1_numpatch_64.zip** vers le répertoire de votre choix sur votre ordinateur.
40 * Renommez le dossier contenant l'installation.
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 L'ensemble des fichiers serveurs de DigDash Enterprise est à présent installé sur votre ordinateur.
46
47 = Paramètres Tomcat =
48
49 Certains paramétrages usuels tels que l'allocation de mémoire et les ports réseaux nécessaires sont susceptibles d'être modifiés dès l'installation.
50
51 Ce paragraphe décrit comment modifier trois des paramètres les plus importants au moment de l'installation : l'allocation de mémoire à tomcat, les ports réseau utilisés et le nom du service Windows (si une installation en tant que service Windows est prévue).
52
53 Une liste plus complète de paramètres système se trouve dans le document [[Réglages avancés des paramètres système>>doc:Digdash.deployment.configuration.advanced_system_guide.WebHome]].
54
55 == Mémoire allouée à Tomcat ==
56
57 1. Ouvrez le répertoire <**DD Install>\configure** puis éditez le fichier **setenv.bat**
58 1. Modifiez les valeurs des variables **JVMMS** et **JVMMX** définies en début du fichier. Par exemple : **set JVMMS=4096** et **set JVMMX=4096** pour augmenter la mémoire allouée à Tomcat à 4Go.
59
60 == Ports réseau Tomcat ==
61
62 Si un des ports nécessaires à Tomcat est déjà utilisé par un autre processus, alors il ne se lancera pas. Il est nécessaire de vérifier la disponibilité des ports et si besoin de reconfigurer Tomcat.
63 Par défaut les 3 ports suivants sont configurés : 8005, 8080 et 8009. Pour les modifier :
64
65 1. Ouvrez le répertoire **<DD Install>/apache-tomcat/conf** puis éditer le fichier **server.xml**
66 1. Cherchez et remplacez les valeurs des ports **8005**,** 8080 **et **8009 **par des numéros de port disponibles sur le système.
67
68 == Nom du service Windows Tomcat ==
69
70 Dans certains cas il est intéressant de modifier le nom du service Windows qui sera créé lors de l'installation en tant que service (chapitre suivant), par exemple si un service du même nom existe déjà.
71
72 1. Ouvrez le répertoire **<DD Install>\configure** puis éditez le fichier **servers_install_service.bat**
73 1. Cherchez et modifiez la valeur de la variable **SERVICE_NAME** au début du fichier.
74 Par exemple :**set SERVICE_NAME=Tomcat_DEV**
75
76 = Paramètres DigDash =
77
78 Avant le 1er démarrage du serveur, il est vivement conseillé de s'assurer que certains paramètres sont compatibles avec votre environnement.
79
80 == Emplacement du dossier de vos données ==
81
82 DigDash Enterprise stocke les informations de configuration, les modèles de données, les graphiques, 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>**.
83
84 Par exemple sous Windows, ce dossier est :
85 C:\Users\<utilisateur>\AppData\Roaming\Enterprise Server\ddenterpriseapi
86
87 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).
88 Cette modification est aussi intéressante pour des raisons d'organisation, de scripting, etc.
89
90 Il existe plusieurs moyen de modifier ce chemin.
91
92 === Dossier commun à tous les domaines ===
93
94 Fichier modifié : **digdash.properties**
95
96 Ceci est le moyen le plus simple et efficace. Toutes les applications de DigDash Enterprise en profiteront (un seul paramétrage).
97 L'autre méthode n'est à utiliser qu'en cas de besoin spécifique.
98
99 La variable **digdash.appdata** permet de spécifier l'unique dossier des données.
100 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 :
101
102 (% class="box infomessage" %)
103 (((
104 digdash.appdata=C:/appdata
105 )))
106
107 (% class="box warningmessage" %)
108 (((
109 Attention à n'utiliser que des slash "/", ou deux anti-slash "~\~\".
110 )))
111
112 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 application :
113 **<digdash.appdata>/Enterprise Server/<domaine>**
114 **<digdash.appdata>/Enterprise Administrator**
115 **<digdash.appdata>/ldapdigdash**
116
117 **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.
118
119 **Inconvénient** : Cette configuration est globale au Tomcat de DigDash Enterprise, donc tous les domaines DigDash Enterprise de ce serveur sont concernés.
120 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.
121
122 === Dossier différent pour chaque domaine ===
123
124 Fichier modifié : **digdash.properties**
125
126 La variable **<domaine>.AppDataPath** définie dans ce fichier a le même comportement que la variable globale décrite ci-dessus.
127 La différence est que ce paramétrage est spécifique à un domaine DigDash Enterprise.
128
129 Pour définir un dossier des données spécifique à un domaine, modifiez le paramètre AppDataPath préfixé du nom du domaine.
130 Si vous avez un domaine ddenterpriseapi_dev, le paramètre sera :
131
132 ddenterpriseapi_dev.AppDataPath=C:/appdata_dev
133
134 **Avantages** :
135
136 * Configuration locale à un domaine
137 * Fichier externe au WAR
138
139 **Inconvénient** : Configuration à faire pour chaque domaine.
140
141 = Démarrage et arrêt manuel de DigDash Enterprise =
142
143 Lorsque DigDash Enterprise n'est pas installé en tant que service Windows.
144
145 == Démarrage de DigDash Enterprise ==
146
147 Ouvrez le répertoire d'installation de DigDash Entreprise, puis double cliquez sur le fichier **start_tomcat.bat**.
148
149 Le premier démarrage du serveur peut prendre plusieurs minutes car les applications web se déploient.
150
151 == Arrêt de DigDash Enterprise ==
152
153 Ouvrez le répertoire d'installation de DigDash Entreprise, puis double cliquez sur le fichier **stop_tomcat.bat**.
154
155 = Installation en tant que service Windows =
156
157 L'installation en tant que service doit être faite avec un utilisateur ayant des droits d'administration Windows sur cette machine.
158
159 (% class="box warningmessage" %)
160 (((
161 Assurez-vous d'avoir vérifié et modifié les paramètres importants mentionnés dans le chapitre précédent __//avant//__ d'installer le service.
162 Si vous modifiez des paramètres vous devrez installer de nouveau le service (via le script **servers_install_service.bat**)
163 )))
164
165 == Installation ==
166
167 * Démarrez l'invite de commande avec les droits d'administration :
168 ** Faites un clic droit sur le racourcis de l'invite de commande et sélectionnez « Exécuter en tant qu'administrateur »
169 * Positionnez-vous dans le répertoire **<DD Install>\configure** puis entrez la commande **servers_install_service.bat** sur Windows 64 bits.
170 Le service « Tomcat 9» est installé (ou un autre nom que vous auriez spécifié).
171 * Le service est installé en lancement manuel par défaut. Pour modifier ce comportement il faut lancer le gestionnaire de services Windows, et changer les propriétés du nouveau service.
172 Pensez aussi à vérifier au même endroit que l'utilisateur exécutant le service est bien configuré.
173
174 == Démarrage ==
175
176 L'application **Services** de Windows permet de gérer tous les services installés.
177 Dans cette liste faites un clic-droit sur votre service ("Tomcat 9" par défaut), puis cliquez sur **Démarrer**.
178 Une fois le serveur démarré la page d'accueil sera accessible (http:~/~/localhost:8080 par défaut).