Wiki source code of Guide d'installation Windows

Last modified by Aurelie Bertrand on 2026/08/18 17:05
Show last authors
1 This guide provides installation and configuration instructions for Windows.
2
3 ----
4
5 {{ddtoc/}}
6
7 ----
8
9
10 (% class="box infomessage" %)
11 (((
12 __Vocabulary__
13
14 In all documentation pages, "**applications**" refer to .war files present in the DigDash Enterprise server (digdash_enterprise_202XRX_pXXXXXXXX_64\apache-tomcat\webapps):
15
16 * **Server**: ddenterpriseapi.war
17 * **Dashboard**: digdash_dashboard.war
18 * **Web Studio**: studio.war
19 * **Homepage**: adminconsole.war
20
21 This set of applications constitutes a domain. Depending on the needs, this domain can be duplicated, for example, to have a development context and another production context.
22 )))
23
24 This document describes how to install DigDash on Windows.
25
26 To install DigDash on Linux, please refer to the [[Installation guide for Linux>>doc:Digdash.deployment.installation.Ubuntu24.WebHome]].
27
28 To update an existing installation, please refer to the [[Upgrade Guide>>doc:Digdash.deployment.installation.upgrade_dde.WebHome]].
29
30 = Terminology =
31
32 (% id="H1.1.Acronymes" %)
33 == Acronyms ==
34
35 (((
36 (% border="1" cellspacing="0" style="border-collapse:collapse; border:none; width:1004px" %)
37 |=(% style="background-color: grey; border-width: 1px; border-style: solid; padding: 7px; vertical-align: middle; width: 257px; border-color: grey;" %)(((
38 (% style="line-height:1.2; margin-left:-5px; text-align:center" %)
39 (% style="color:#f8f7f7; font-family:~"Open Sans~",sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)Acronym
40 )))|=(% style="background-color: grey; border-style: solid; border-width: 1px; padding: 7px; vertical-align: middle; width: 746px; border-color: grey;" %)(((
41 (% style="line-height:1.2; margin-left:-5px; margin-right:-8px; text-align:center" %)
42 (% style="color:#f8f7f7; font-family:~"Open Sans~",sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)**Meaning**
43 )))
44 |Digdash|(((
45 <DD Install> : folder ( example : digdash_enterprise_2022R2_p20230103_64) used for Digdash installation
46
47 [[image:1674038202679-522.png]]
48 )))
49 |(((
50 OS
51 )))|(((
52 Operating System ( Windows, Ubuntu etc..)  (about 20G)
53 )))
54 |(((
55 Data drive
56 )))|(((
57 E: In this documentation
58
59 Partition or disk different from the system (size depends on the project)
60 )))
61 |(((
62 ROOT drive
63 )))|(((
64 C: In this documentation
65
66 Partition or disk that hosts OS data
67 )))
68 |(((
69 Logs drive
70 )))|(((
71 L: Dans cette documentation
72
73 Partition or disk which hosts the Log files (allocate a size of 5 G) ideally dedicated
74 )))
75 )))
76
77 = Installation procedure =
78
79 == List of modules outside of DigDash ==
80
81 All servers must have at least the following installations:
82
83 * File system
84 * Microsoft JDK 17, 21 or 25
85 * Tomcat 10
86 * DigDash WebApps
87
88 List of production components:
89
90 * Replace ADSWRAPPER with OpenDJ (For production environments)
91 * Replace H2 with a Database: PostGres or MariaDB
92
93 List of optional components:
94
95 * Reverse Proxy: Apache for Windows
96
97 = Supported versions =
98
99 The following versions are supported :
100
101 * Tomcat 10 : last patch
102 * OpenDJ (recommended) : version 4.8.0 and later
103 * MariaDB : OS version or last patch of last LTS version
104 * Apache2 : last patch
105
106 (% style="line-height:1.2; text-align:justify; margin-bottom:4px" %)
107 = Installations =
108
109 (% id="H3.1.SystE8medefichier" %)
110 == Creating a file system ==
111
112 1. Create a “logs” directory at the root of the desired directory (L):
113 1*. logs: hosts the log files of applications running on the server locally
114 1. Create a “digdash” directory at the root of E.
115 1. In the digdash directory, create 4 directories:
116 1*. tools: hosts the tools delivered by DigDash which can interact with it (import tool, backup tools)
117 1*. webapps: DigDash application modules: (studio, adminconsole, dashboard, ddenterpriseapi)
118 1*. ldapdigdash: hosts LDAP configuration and data
119 1*. appdata: hosts DigDash data
120 1. In each directory created in the previous steps, create a default directory.
121 1. Copy the digdash.properties file to the root of the digdash directory of E:
122
123 [[image:1674039152023-715.png||data-xwiki-image-style-alignment="center"]]
124
125
126 === Editing the digdash.properties file ===
127
128 * Open the digdash.properties file and add the following lines: :
129
130 {{code language="shell"}}
131 # Add these lines at the beginning of the file
132
133 # Log files location
134 ddenterpriseapi.ddlog4j.properties.file=E:/digdash/log4j2_api.properties
135 studio.ddlog4j.properties.file=E:/digdash/log4j2_studio.properties
136 digdash_dashboard.ddlog4j.properties.file=E:/digdash/log4j2_dash.properties
137
138 # Appadata location
139 ddenterpriseapi.AppDataPath=E:/digdash/appdata/default
140 digdash_dashboard.AppDataPath=E:/digdash/appdata/default
141 studio.AppDataPath=E:/digdash/appdata/default
142 adswrapper.ads.instance.name=E:/digdash/appdata/default/ldapdigdash
143
144 adminconsole.adminconsole_domain=adminconsole
145 adminconsole.webstudio_domain=studio
146 adminconsole.server_domain_list=ddenterpriseapi
147 adminconsole.dashboard_domain=digdash_dashboard
148
149 studio.DOMAIN=ddenterpriseapi
150 studio.FORCEDOMAIN=true
151 studio.SERVERURL=http://localhost:8080
152 studio.FORCESERVERURL=true
153 studio.adminconsole_domain=adminconsole
154
155 digdash_dashboard.DOMAIN=ddenterpriseapi
156 digdash_dashboard.FORCEDOMAIN=true
157 digdash_dashboard.SERVERURL=http://localhost:8080
158 digdash_dashboard.FORCESERVERURL=true
159 digdash_dashboard.adminconsole_domain=adminconsole
160
161 # IODS scripts location
162 studio.iods_exe_path=path/to/IODS/scripts
163 ddenterpriseapi.iods_exe_path=path/to/IODS/scripts
164
165 # Nodejs export
166 ddenterpriseapi.DDAPIFORNODEJSURL=http://localhost:8080
167 ddenterpriseapi.NODEJSURL=http://localhost:4000 #Valeur aléatoire entre 4000 et 3000 différent pour chaque environnement hébergé sur le même Tomcat
168
169 ########### Nettoyage automatique des fichiers programmé
170 ########### Scheduled automatic file cleaning
171 ddenterpriseapi.startCleaner=true
172
173 ########### Nettoyage des fichiers inutilisés  au démarrage du serveur
174 ########### Clean up unused files on server startup
175 ddenterpriseapi.cleanOnStart=false
176
177 ########### Sauvegarde automatique programmée
178 ########### Scheduled automatic backup
179 ddenterpriseapi.autoBackup=true
180 ddenterpriseapi.autoBackupKeepDays=20
181 digdash_dashboard.CANCHANGEPASSWORD=true
182
183
184
185 ########### Redirect address after logout
186
187 #ddenterpriseapi.urlLogout=http://localhost:8080
188 {{/code}}
189
190 (((
191 === Creating log files at the root of the digdash directory :E ===
192 )))
193
194 ==== log4j2_api.properties ====
195
196 (% style="font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Create the log4j2_api.properties file at the root of the directory.
197
198 (% style="font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Copy the following code:
199
200 {{code language="shell"}}
201 status = warn
202
203 # Log files location
204 property.basePath = L:/logs
205 # webapp name
206 property.webAppName = ddenterpriseapi
207 # short webapp name
208 property.shortWebAppName = ddapi
209
210 # Definition of logger.app
211 logger.app.name = com.digdash
212 # Web application log level: trace, debug, info, warn, error, fatal
213 logger.app.level = debug
214 logger.app.additivity = false
215
216 # Definition of appender RollingFile
217 appender.rolling.type = RollingFile
218 appender.rolling.name = RollingFile
219 appender.rolling.fileName = ${basePath}/${webAppName}.log
220 appender.rolling.filePattern = ${basePath}/${webAppName}-%i.log.gz
221 appender.rolling.layout.type = PatternLayout
222 appender.rolling.layout.pattern = %d %-5p [${shortWebAppName}] [%t] (%F:%L) - %m%n
223 appender.rolling.policies.type = Policies
224 appender.rolling.policies.size.type = SizeBasedTriggeringPolicy
225 appender.rolling.policies.size.size = 200MB
226 appender.rolling.strategy.type = DefaultRolloverStrategy
227 appender.rolling.strategy.max = 15
228
229 # Linking logger.app to RollingFile appender
230 logger.app.appenderRef.rolling.ref = RollingFile
231 {{/code}}
232
233 (((
234 ==== log4j2_dash.properties ====
235 )))
236
237 (% style="font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Create the log4j2_dash.properties file at the root of the directory.
238
239 (% style="font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Copy the following code:
240
241 {{code language="shell"}}
242 status = warn
243
244 # Log files location
245 property.basePath = L:/logs
246 # webapp name
247 property.webAppName = dashboard
248 # short webapp name
249 property.shortWebAppName = dash
250
251 # Definition of logger.app
252 logger.app.name = com.digdash
253 # Webapplication log level : trace, debug, info, warn, error, fatal
254 logger.app.level = debug
255 logger.app.additivity = false
256
257 # Definition of appender RollingFile
258 appender.rolling.type = RollingFile
259 appender.rolling.name = RollingFile
260 appender.rolling.fileName = ${basePath}/${webAppName}.log
261 appender.rolling.filePattern = ${basePath}/${webAppName}-%i.log.gz
262 appender.rolling.layout.type = PatternLayout
263 appender.rolling.layout.pattern = %d %-5p [${shortWebAppName}] [%t] (%F:%L) - %m%n
264 appender.rolling.policies.type = Policies
265 appender.rolling.policies.size.type = SizeBasedTriggeringPolicy
266 appender.rolling.policies.size.size = 200MB
267 appender.rolling.strategy.type = DefaultRolloverStrategy
268 appender.rolling.strategy.max = 15
269
270 # Linking logger.app to appender RollingFile
271 logger.app.appenderRef.rolling.ref = RollingFile
272 {{/code}}
273
274 ==== log4j2_studio.properties ====
275
276 (% style="font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Create the log4j2_studio.properties file at the root of the directory.
277
278 (% style="font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Copy the following code:
279
280 {{code language="shell"}}
281 status = warn
282
283 # Log files location
284 property.basePath = L:/logs
285 # webapp name
286 property.webAppName = studio
287 # short webapp name
288 property.shortWebAppName = studio
289
290 # Definition of logger.app
291 logger.app.name = com.digdash
292 # Webapplication log level : trace, debug, info, warn, error, fatal
293 logger.app.level = debug
294 logger.app.additivity = false
295
296 # Definition of appender RollingFile
297 appender.rolling.type = RollingFile
298 appender.rolling.name = RollingFile
299 appender.rolling.fileName = ${basePath}/${webAppName}.log
300 appender.rolling.filePattern = ${basePath}/${webAppName}-%i.log.gz
301 appender.rolling.layout.type = PatternLayout
302 appender.rolling.layout.pattern = %d %-5p [${shortWebAppName}] [%t] (%F:%L) - %m%n
303 appender.rolling.policies.type = Policies
304 appender.rolling.policies.size.type = SizeBasedTriggeringPolicy
305 appender.rolling.policies.size.size = 200MB
306 appender.rolling.strategy.type = DefaultRolloverStrategy
307 appender.rolling.strategy.max = 15
308
309 # Linking logger.app to appender RollingFile
310 logger.app.appenderRef.rolling.ref = RollingFile
311 {{/code}}
312
313 == Deploying WebApps ==
314
315 Place the following (contained in the <DD Install>\apache-tomcat\webapps directory) in the E:/digdash/webapps/default folder:
316
317 * adminconsole.war
318 * ddenterpriseapi.war
319 * digdash_dashboard.war
320 * studio.war
321 * ROOT/ folder
322
323 == Installing Microsoft JDK (optional if already installed) ==
324
325 (% class="box warningmessage" %)
326 (((
327 Java is required to launch DigDash. Only **JDK 17** is supported.
328 )))
329
330 1. Download Microsoft JDK : [[https:~~/~~/docs.microsoft.com/fr-fr/java/openjdk/download>>url:https://docs.microsoft.com/fr-fr/java/openjdk/download]] or use the binary available in the installation Zip partenaire_installation_initial.zip.
331 1. Start the installation.
332
333 (% class="box infomessage" %)
334 (((
335 To check the installation was successful, go to the command prompt and type:
336 java -version.                                                                                              
337 )))
338
339 == Installing Tomcat {{id name="Tomcat_windows"/}} ==
340
341 Please consult the following page :
342
343 * [[Installing Tomcat 10>>doc:.install_guide_tomcat10.WebHome]]
344
345 (((
346 == Installing OpenDJ (recommended){{id name="OpenDJ"/}} ==
347
348 === Initial setup ===
349
350 1. Download the OpenDJ installation file (**opendj-4.x.x.msi**) from: [[__https:~~/~~/github.com/OpenIdentityPlatform/OpenDJ/releases__>>url:https://github.com/OpenIdentityPlatform/OpenDJ/releases]]
351 1. Start the installation by double-clicking the **opendj-4.x.x.msi** file.
352 1. Keep the default location for the installtion directory : (C:/Program Files (x86)/opendj).
353 1. Open the installation directory C:/Program Files (x86)/opendj) and run the “setup.bat” as administrator.
354 1. Complete the **Server settings **and make sure to save the password entered.
355 [[image:Server Settings.png||alt="Server settings"]]
356
357 1. In the **Topology Options **tab, leave the default option **This will be a stand alone server**.
358 [[image:Topology Options.png||alt="Topology options"]]
359
360 1. Fill in the **Directory Data** and select **Only Create Base Entry (dc=digdash,dc=com)**.
361 [[image:Directory Data.png||alt="Directory Data"]]
362
363 1. In the **Review** tab, check the entered values ​​and select the **Run the server as a Windows Service **checkbox.
364 **[[image:Review.png||alt="Review"]]**
365
366 1. Click **Finish**.
367 [[image:Finished.png||alt="Finished"]]
368
369 When the installation is finished, check if the service is started. Then launch an administrator terminal for additional settings.
370
371 === Additional settings ===
372
373 1. Open the OpenDJ installation directory.
374
375 {{code language="cmd"}}
376 cd C:\Program Files (x86)\OpenDJ\bat
377 {{/code}}
378
379 (% start="2" %)
380 1. LDIF files can be downloaded by clicking on the following link : [[LDIF_OpenDJ>>attach:LDIF_OpenDJ.zip]].
381 1. Create the organizations using the “neworganization.ldif” file below
382
383 {{code language="c"}}
384 ldapmodify.bat --port 389 --bindDN "cn=Directory Manager" --bindPassword adminOpenDJ1 "C:\Users\digdash\Downloads\neworganisation.ldif"
385 {{/code}}
386
387 {{code language="c"}}
388 dn: ou=default,dc=digdash,dc=com
389
390 objectClass: organizationalUnit
391
392 ou: default
393 {{/code}}
394
395 (% start="4" %)
396 1. To create a password checker:
397 1*. Use the dsconfig.bat command, then log in with the Directory Manager credentials and accept the certificates.
398 1*. Go to menu 29 then select “create a new Password Validator” > select “Character Set Password Validator” > enter “Custom Character Set Password Validator” > “true” > “true” > then configure 4 character-set as follows:
399
400 {{code language="shell"}}
401 1:abcdefghijklmnopqrstuvwxyz
402 1:ABCDEFGHIJKLMNOPQRSTUVWXYZ
403 1:0123456789
404 1:!"#$%&'()*+,-./:;\<=>?@[]^_`{|}~
405 {{/code}}
406
407 ➡ The result should look like this:
408 [[image:Résultat.png]]
409 Once the configuration is complete, “finish” and exit “dsconfig”.
410
411 (% start="5" %)
412 1. Apply the passwaord checker :
413
414 {{code language="c"}}
415 dsconfig set-password-policy-prop --bindDN "cn=Directory Manager" --bindPassword adminOpenDJ1 --policy-name "Default Password Policy" --set password-validator:"Custom Character-set Password Validator" --no-prompt
416 {{/code}}
417
418 (% start="6" %)
419 1. Set the password policy for users using the “ppolicy.ldif” file below :
420
421 {{code language="c"}}
422 ldapmodify.bat --port 389 --bindDN "cn=Directory Manager" --bindPassword adminOpenDJ1 "C:\Users\digdash\Downloads\ppolicy.ldif"
423 {{/code}}
424
425 {{code language="c"}}
426 dn: cn=ppolicy,ou=default,dc=digdash,dc=com
427 objectClass: top
428 objectClass: subentry
429 objectClass: pwdPolicy
430 cn: ppolicy
431 pwdAttribute: userPassword
432 pwdAllowUserChange: TRUE
433 pwdCheckQuality: 1
434 pwdExpireWarning: 600
435 pwdFailureCountInterval: 30
436 pwdGraceAuthNLimit: 5
437 pwdInHistory: 5
438 pwdLockout: TRUE
439 pwdLockoutDuration: 900
440 pwdMaxAge: 0
441 pwdMaxFailure: 5
442 pwdMinAge: 0
443 pwdMustChange: FALSE
444 pwdSafeModify: FALSE
445 subtreeSpecification: {base "ou=users", specificationFilter "!(uid=admin)" }
446 {{/code}}
447
448 (% start="7" %)
449 1. Set a second password policy for the admin using the “ppolicy-admin.ldif” file below
450
451 {{code language="c"}}
452 ldapmodify.bat --port 389 --bindDN "cn=Directory Manager" --bindPassword adminOpenDJ1 "C:\Users\digdash\Downloads\ppolicy-admin.ldif"
453 {{/code}}
454
455 {{code}}
456 dn: cn=ppolicy-admin,ou=default,dc=digdash,dc=com
457 objectClass: top
458 objectClass: subentry
459 objectClass: pwdPolicy
460 cn: ppolicy-admin
461 pwdAttribute: userPassword
462 pwdAllowUserChange: TRUE
463 pwdCheckQuality: 1
464 pwdFailureCountInterval: 30
465 pwdGraceAuthNLimit: 5
466 pwdInHistory: 5
467 pwdLockout: FALSE
468 pwdMaxAge: 0
469 pwdMinAge: 0
470 pwdMustChange: FALSE
471 pwdSafeModify: FALSE
472 subtreeSpecification: {base "ou=users", specificationFilter "(uid=admin)" }
473 {{/code}}
474
475 (% start="8" %)
476 1. Change the password policy to allow pre-encoded passwords (useful for restores in digdash).
477
478 {{code language="c"}}
479 dsconfig.bat set-password-policy-prop --policy-name "Default Password Policy" --set allow-pre-encoded-passwords:true --hostname localhost --trustAll --bindDN "cn=directory manager" --bindPassword adminOpenDJ1 --no-prompt
480 {{/code}}
481
482 (% start="9" %)
483 1. Create an admin user for digdash via the “create_user_admin.ldif” file below:
484
485 {{code language="c"}}
486 ldapmodify.bat --port 389 --bindDN "cn=Directory Manager" --bindPassword adminOpenDJ1 "C:\Users\digdash\Downloads\create_user_admin.ldif"
487 {{/code}}
488
489 {{code language="c"}}
490 dn: uid=admin,ou=default,dc=digdash,dc=com
491 objectClass: shadowAccount
492 objectClass: inetOrgPerson
493 cn: Admin Domain Default
494 sn: Default
495 uid: admin_default
496 {{/code}}
497
498 (% start="10" %)
499 1. Assign the admin user the necessary rights using the “add_admin_right.ldif” and “add_admin_right2.ldif” files below:
500
501 {{code language="c"}}
502 ldapmodify.bat --port 389 --bindDN "cn=Directory Manager" --bindPassword adminOpenDJ1 "C:\Users\digdash\Downloads\add_admin_right.ldif"
503 {{/code}}
504
505 {{code language="c"}}
506 dn: ou=default,dc=digdash,dc=com
507 changetype: modify
508 add: aci
509 aci: (target ="ldap:///ou=default,dc=digdash,dc=com")(targetattr = "userpassword || shadowlastchange")(version 3.0; acl "allow write on userpassword and shadowlastchange for admin"; allow(write) (userdn = "ldap:///uid=admin,ou=default,dc=digdash,dc=com");)
510 aci: (target ="ldap:///ou=default,dc=digdash,dc=com")(targetattr = "userpassword || shadowlastchange")(version 3.0; acl "allow read,write on userpassword and shadowlastchange for auth users"; allow(read) (userdn = "ldap:///all");)
511 aci: (target ="ldap:///ou=default,dc=digdash,dc=com")(targetattr = "userpassword || shadowlastchange")(version 3.0; acl "allow read on userpassword and shadowlastchange for anonymous"; allow(selfwrite) (userdn = "ldap:///anyone");)
512 aci: (target ="ldap:///ou=default,dc=digdash,dc=com")(targetattr = "*")(version 3.0; acl "allow write on * for admin"; allow(all) (userdn = "ldap:///uid=admin,ou=default,dc=digdash,dc=com");)
513 aci: (target ="ldap:///ou=default,dc=digdash,dc=com")(targetattr = "*")(version 3.0; acl "allow read on * for anonymous"; allow(read) (userdn = "ldap:///all");)
514 {{/code}}
515
516 {{code language="c"}}
517 ldapmodify.bat --port 389 --bindDN "cn=Directory Manager" --bindPassword adminOpenDJ1 "C:\Users\digdash\Downloads\add_admin_right2.ldif"
518 {{/code}}
519
520 {{code language="c"}}
521 dn: uid=admin,ou=default,dc=digdash,dc=com
522 changetype: modify
523 add: ds-privilege-name
524 ds-privilege-name: config-read
525 ds-privilege-name: password-reset
526 ds-privilege-name: unindexed-search
527 {{/code}}
528
529 (% start="11" %)
530 1. Generate an administrator password and remember it for later:
531
532 {{code language="shell"}}
533 sudo /opt/opendj/bin/ldappasswordmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" --authzID "uid=admin,ou=default,dc=digdash,dc=com"
534 {{/code}}
535
536 (% class="box infomessage" %)
537 (((
538 💡 If you want to set your own password for the admin user, you need to use a variation of the previous command:
539
540 {{code language="shell"}}
541 sudo /opt/opendj/bin/ldappasswordmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" --authzID "uid=admin,ou=default,dc=digdash,dc=com" --newPassword "mdpAdmin"
542 {{/code}}
543 )))
544
545 === Useful option ===
546
547 (% class="wikigeneratedid" %)
548 The operation below is not part of the installation.
549 However, it may be useful to know it for later use.
550
551 ==== Extending the limit for LDAP searches ====
552
553 It is possible to extend the LDAP search limit to more than 1000 users with the “extend_search_limit.ldif” file below.
554
555 {{code language="c"}}
556 ldapmodify.bat --port 389 --bindDN "cn=Directory Manager" --bindPassword adminOpenDJ1 "C:\Users\digdash\Downloads\extend_search_limit.ldif"
557 {{/code}}
558
559 {{code language="c"}}
560 dn: uid=admin,ou=default,dc=digdash,dc=com
561 changetype: modify
562 add: ds-rlim-size-limit
563 ds-rlim-size-limit: 10000
564 {{/code}}
565
566 == Installing MariaDB{{id name="DB_windows"/}} ==
567
568 The MariaDB database will be used to store the following elements: comments, audit data and data entry.
569
570 This database is more durable than an H2 database, that is why we recommend its use. If you already have a database that Digdash can write to and read from then proceed to the configuration step.
571
572 PostgreSQL and MySQL are also compatible.
573
574 (% style="font-size:20px; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; text-wrap:wrap" %)Running the installer
575
576 1. Access the website [[(% style="-webkit-text-decoration-skip:none; color:#1155cc; font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration-skip-ink:none; text-decoration:underline; white-space:pre-wrap" %)__https:~~/~~/mariadb.com/downloads/__>>url:https://mariadb.com/downloads/||style="text-decoration:none"]](%%) and download the latest version of the software for OS: MS Windows (64-bit).
577 [[image:MariaDB.png]]
578
579 1. (% style="font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Run the .msi file to start the installation and click **Next**.(%%)
580 [[image:MariaDB2.png]]
581
582 1. (% style="font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Choose the database root password:
583 [[image:MariaSettings.png]](%%)
584
585 1. (% style="font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Click **Next** and install MariaDB.(%%)
586 [[image:MariaDB4.png]]
587
588 1. Check the security of the C:/Program Files/MariaDB 10.10 folder to only give the following rights to users: Read and execute; List folder contents; Read.
589 [[image:MariaDB5b_en.png]]
590
591 === Database configuration ===
592
593 1. (% style="font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Open command prompt as administrator and launch MariaDB.
594
595 {{code language="c"}}
596 cd "C:/Program Files/MariaDB 10.9/bin"
597 mariadb.exe -u root -p
598 {{/code}}
599
600 [[image:MariaDB6.png||queryString="width=704&height=215" height="215" width="704"]]
601
602 (% start="2" %)
603 1. (% style="font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Create the necessary databases domain_module (domain examples: default, dev, prod)
604
605 {{code language="shell"}}
606 CREATE DATABASE default_ddaudit;
607 CREATE DATABASE default_comment;
608 CREATE DATABASE default_ddentry;
609 {{/code}}
610
611 (% class="wikigeneratedid" %)
612 [[image:MariaDB7.png]]
613
614 === Creating users and assigning rights ===
615
616 1. (% style="font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Create a user for each database domaine_user_module:
617
618 {{code language="shell"}}
619 #The password “mynewpassword” must be changed
620
621 CREATE USER 'default_user_ddaudit'@'localhost' IDENTIFIED BY 'mynewpassword';
622 CREATE USER 'default_user_comment'@'localhost' IDENTIFIED BY 'mynewpassword';
623 CREATE USER 'default_user_ddentry'@'localhost' IDENTIFIED BY 'mynewpassword';
624 {{/code}}
625
626 (% start="2" %)
627 1. (% style="font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Assign rights to the user on databases:
628
629 {{code language="shell"}}
630 GRANT ALL PRIVILEGES ON default_comment.* TO 'default_user_comment'@'localhost';
631 GRANT ALL PRIVILEGES ON default_ddaudit.* TO 'default_user_ddaudit'@'localhost';
632 GRANT ALL PRIVILEGES ON default_ddentry.* TO 'default_user_ddentry'@'localhost';
633 {{/code}}
634
635 === MariaDB Update ===
636
637 For a minor update (for example, 10.10.1 to 10.10.2), you have to :
638
639 1. Read the release note of the new version to ensure that there is no need to worry about the data.
640 1. Download the new version (example: 10.10.2) and run it : the update should be done automatically.
641 1. Restart MariaDB server.
642
643 (% style="line-height: 1.2; margin-bottom: 4px;" %)
644 = Configuring DigDash after installation =
645
646 (((
647 == Starting Digdash ==
648
649 1. Restart the Tomcat Service.
650 1. Open the Tomcat installation directory: \Apache Software Foundation\Tomcat 10.1\bin\Tomcat10w.exe
651 1. Then double click the Tomcat10w.exe file, click Stop and Start.
652 1. Check the war deployment in the installation folder E:/digdash/webapps/default.
653 [[image:Vérif_déploiement_war.png||alt="Déploiement war"]]
654 )))
655
656 (% start="4" %)
657 1. Access DigDash homepage at the following address : [[http:~~/~~/localhost:8080/adminconsole>>url:http://localhost:8080/adminconsole]]
658 The login/password is admin/admin.
659
660 == Connecting Digdash to the installed OpenDJ server ==
661
662 (% style="line-height:1.2; text-indent:0.15354330708661657pt; text-align:justify" %)
663 Open [[http:~~/~~/localhost:8080/adminconsole/>>http://localhost:8080/adminconsole/]], **Configuration -> Server settings -> Servers -> LDAP Server**.
664
665 * Port:  389
666 * User: uid=admin, ou=default,dc=digdash,dc=com
667 * Password: OpenDJ admin password
668
669 [[image:LDAP_server_EN.png||height="407" width="1104"]]
670
671 (% style="line-height:1.2; text-indent:0.15354330708661657pt; text-align:justify" %)
672 Then click the **LDAP Queries** button and fill in the fields as below:
673
674 (% style="line-height:1.2; text-indent:0.15354330708661657pt; text-align:justify" %)
675 [[image:LDAP_queries_EN.png||alt="LDAP queries" height="702" width="1105"]]
676
677
678 (% id="cke_bm_3931S" style="display:none" %)
679
680 == Changing the supervisor password and creating the LDAP account ==
681
682 === Changing the supervisor password ===
683
684 Open **Configuration  -> Server settings > Servers -> Enterprise Server **and enter a new password in the **Supervisor Password** field.
685
686 [[image:Admin_password_EN.png||alt="Password" height="537" width="1105"]]
687
688
689 === Creating the LDAP account ===
690
691 1. Open **Configuration -> User management -> Users**.
692 1. Create a new admin user and assign him all roles and authorizations groups.
693 1. In the **Password** field, enter the new supervisor password defined above.
694
695 [[image:Admin_password_user_EN.png||alt="User password" height="542" width="1104"]]
696
697 == Database configuration ==
698
699 === Audit data database ===
700
701 Open **Configuration -> Server settings -> Databases -> Audit data **and enter the URL, user and password.
702
703 **URL **: //jdbc:mariadb:~/~/localhost:3306/default_ddaudit//
704
705 This solution makes it possible to secure access to the audit database.
706 [[image:Audit_DB_EN.png||height="391" width="1240"]]
707
708 === Comments database ===
709
710 Open **Configuration -> Server settings -> Databases -> Audit data **and enter the URL, user and password.
711
712 **URL** ~:// jdbc:mariadb:~/~/localhost:3306/default_comment//
713
714 This solution makes it possible to secure access to the comment database.
715
716 [[image:Comments_DB_EN.png]]
717
718 === Data entry database ===
719
720 Open **Configuration -> Server settings -> Databases -> Data entry **and enter the URL, user and password.
721
722 Select the **Enable data entry** checkbox and select a database in the drop-down list below.
723
724 [[image:DataEntry_DB_EN.png]]
725
726 You must first have created a connection to the database from the Data connection manager in the Studio.
727 Enter default.user.ddentry for the user and password defined in the previous step.
728 The name defined in the **Login Name** field is the one that will appear in the database selection drop-down list.
729
730 (% style="line-height: 1.2; margin-bottom: 4px;" %)
731 == DigDash Services ==
732
733 (% class="wikigeneratedid" style="line-height: 1.2; margin-bottom: 4px;" %)
734 Open the Server status page : [[__http:~~/~~/localhost:8080/ddenterpriseapi/serverstatus?adminDomain=adminconsole&serverDomain=ddenterpriseapi__>>url:http://localhost:8080/ddenterpriseapi/serverstatus?adminDomain=adminconsole&serverDomain=ddenterpriseapi||style="text-align: justify; text-indent: 0.153543pt; background-color: rgb(255, 255, 255); font-size: 14px;"]].
735
736 Check that the DigDash services are activated and that the maximum memory is well adapted to the capacity of the server, you must leave at least 4 GB for the system.
737
738 [[image:Server_status_EN.png]]
739 )))