Last modified by Aurelie Bertrand on 2024/11/25 11:18

From version 5.1
edited by Aurelie Bertrand
on 2024/07/10 16:38
Change comment: There is no comment for this version
To version 20.1
edited by Aurelie Bertrand
on 2024/08/20 14:52
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -Guide d'installation Linux
1 +Installation guide for Linux
Content
... ... @@ -111,7 +111,7 @@
111 111  ==== Reverse Proxy Valve ====
112 112  
113 113  {{code language="shell"}}
114 -# Add this valve in the Host element towards the end of the file
114 +# Add this valve in the Host element near the end of the file
115 115  <Valve className="org.apache.catalina.valves.RemoteIpValve"
116 116   internalProxies="127\.0\.[0-1]\.1"
117 117   remoteIpHeader="X-Forwarded-For"
... ... @@ -140,11 +140,11 @@
140 140  ==== Log Valve ====
141 141  
142 142  {{code language="shell"}}
143 -# Add this valve in the Host element towards the end of the file
143 +# Add this valve in the Host element near the end of the file
144 144  <Valve className="org.apache.catalina.valves.ErrorReportValve" showReport="false" showServerInfo="false" ></Valve>
145 145  {{/code}}
146 146  
147 -==== Limit the localhost_access_log file (optional) ====
147 +==== Limiting the localhost_access_log file (optional) ====
148 148  
149 149  To limit the size of the localhost_access_log file, add the //maxDays// parameter to the Access Log Valve and give it the value of the desired number of days.
150 150  
... ... @@ -156,7 +156,7 @@
156 156  
157 157  {{/code}}
158 158  
159 -=== Editing context.xml ===
159 +=== Editing the context.xml file ===
160 160  
161 161  (% class="wikigeneratedid" id="HEmplacement:2Fetc2Ftomcat92Fcontext.xml" %)
162 162  Location: /etc/tomcat9/context.xml
... ... @@ -201,7 +201,7 @@
201 201  sudo systemctl restart tomcat9.service
202 202  {{/code}}
203 203  
204 -=== Enabling automatic start service on startup ===
204 +=== Enabling automatic service start on startup ===
205 205  
206 206  {{code language="shell"}}
207 207  sudo systemctl enable tomcat9
... ... @@ -286,462 +286,322 @@
286 286  
287 287  = OpenDJ{{id name="OpenDJ"/}} =
288 288  
289 -(% style="line-height:1.2" %)
290 290  == Installation ==
291 291  
292 -1. Start by getting the latest version of the **opendj-4.x.x_all.deb **file from the website [[https:~~/~~/github.com/OpenIdentityPlatform/OpenDJ/releases>>url:https://github.com/OpenIdentityPlatform/OpenDJ/releases]]  :(((
293 -|(% style="background-color:black" %)(% style="color:#ffffff" %)wget https:~/~/github.com/OpenIdentityPlatform/OpenDJ/releases/download/4.x.x/opendj-4.x.x_all.deb
294 -)))
295 -1. Run the installation : (((
296 -|(% style="background-color:black" %)(% style="color:#ffffff" %)sudo dpkg -i opendj_4.x.x_all.deb
297 -)))
291 +1. Start by getting the latest version of the **opendj-4.x.x_all.deb **file from the website [[https:~~/~~/github.com/OpenIdentityPlatform/OpenDJ/releases>>url:https://github.com/OpenIdentityPlatform/OpenDJ/releases]] :
298 298  
293 +{{code language="shell"}}
294 +wget https://github.com/OpenIdentityPlatform/OpenDJ/releases/download/4.x.x/opendj-4.x.x_all.deb
295 +{{/code}}
296 +
297 +(% start="2" %)
298 +1. Run the installation :
299 +
300 +{{code language="shell"}}
301 +sudo dpkg -i opendj_4.x.x_all.deb
302 +{{/code}}
303 +
299 299  (((
300 300  (% style="color:inherit; font-family:inherit; font-size:26px" %)Initial setup
301 301  )))
302 302  
303 -Launch the settings utility to follow the steps:
308 +To simplify OpenDJ configuration, we are going to create a ‘setupOpenDJ.props’ file containing the options available to respond to the OpenDJ ‘setup’ utility (this avoids the configuration interface).
309 +The contents of this file are detailed below:
304 304  
311 +(% class="box warningmessage" %)
305 305  (((
306 -|(% style="background-color:black" %)(% style="color:#ecf0f1" %)sudo /opt/opendj/setup
313 +❗Don't forget to replace the parameters with your own. For example, replace the password with the one you want (here ‘adminOpenDJ1’).
307 307  )))
308 308  
309 -(% style="line-height:1.38" %)
310 -(% style="border:none; color:#000000; display:inline-block; font-family:Arial,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; height:49px; overflow:hidden; text-decoration:none; white-space:pre-wrap; width:602px" %)[[image:1.png]](%%)
311 -[Enter]
312 -
316 +{{code language="shell"}}
317 +#
318 +# Sample properties file to set up OpenDJ directory server
319 +# See OpenDJ Setup command man for more options
320 +#
321 +rootUserDN =cn=Directory Manager
322 +rootUserPassword =adminOpenDJ1
323 +hostname =localhost.localdomain
324 +ldapPort =389
325 +adminConnectorPort =4444
326 +backendType =je
327 +baseDN =dc=digdash,dc=com
328 +addBaseEntry =true
329 +ldapsPort =636
330 +enableStartTLS =false
331 +generateSelfSignedCertificate =true
332 +start =true
333 +#sampleData =2000
334 +{{/code}}
313 313  
314 -[[image:2.png]]
336 +After saving the file, run the following command line:
315 315  
316 -(% style="line-height:1.38" %)
317 -adminOpenDJ1
318 -
338 +{{code language="shell"}}
339 +sudo /opt/opendj/setup --cli --propertiesFilePath setupOpenDJ.props --acceptLicense --no-prompt
340 +{{/code}}
319 319  
320 -[[image:3.png]]
342 +(% style="line-height:1.38; text-indent:-14.173228346456689pt; margin-top:13px; margin-bottom:13px; padding:0pt 0pt 0pt 14.173228346456689pt" %)
343 +== Additional setup ==
321 321  
322 -(% style="line-height:1.38" %)
323 -[Enter]
324 -
345 +1. Go to the OpenDJ installation directory:
325 325  
326 -[[image:4.png]]
347 +{{code language="shell"}}
348 +cd /opt/opendj/bin/
349 +{{/code}}
327 327  
328 -389
329 -
330 -
331 -[[image:5.png]]
332 -
333 -4444
334 -
335 -
336 -[[image:6.png]]
337 -
338 -[Enter]
339 -
340 -
341 -[[image:7.png]]
342 -
343 -(% style="line-height:1.38" %)
344 -[Enter]
345 -
346 -
347 -[[image:8.png]]
348 -
349 -dc=digdash,dc=com
350 -
351 -[[image:9.png]]
352 -
353 -2
354 -
355 -
356 -(% style="border:none; color:#000000; display:inline-block; font-family:Arial,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; height:42px; overflow:hidden; text-decoration:none; white-space:pre-wrap; width:445px" %)[[image:https://lh7-us.googleusercontent.com/gs7BVYjtXGYivvccymzaxjIwiLn_ld-xJryFXxP8_aqZekStBkjWRjqRG-isbpEk97CVrMOFCsyCy-uzdIoltTdVWhurhNF_ycRAHaBeARw25JvamLrGFXuc-TIL7h6NQEb5iwhIMZIJOblCKog-n5c||height="42" width="445"]](%%)
357 -oui
358 -
359 -
360 -[[image:11.png]]
361 -
362 -(% style="line-height:1.38" %)
363 -[Enter]
364 -
365 -
366 -[[image:12.png]]
367 -
368 -[Enter]
369 -
370 -
371 -[[image:13.png]]
372 -
373 -[Enter]
374 -
375 -
376 -[[image:14.png]]
377 -
378 -[Enter]
379 -
380 -
381 -[[image:15.png]]
382 -
383 -(% style="line-height:1.38" %)
384 -[Enter]
385 -
386 -(% style="line-height:1.38; text-indent:-14.173228346456689pt; margin-top:13px; margin-bottom:13px; padding:0pt 0pt 0pt 14.173228346456689pt" %)
387 -== Additional settings ==
388 -
389 -1. Go to the OpenDJ installation directory:(((
390 -|(% style="background-color:black" %)(% style="color:#ffffff" %)cd /opt/opendj/bin/
391 -)))
351 +(% start="2" %)
392 392  1. (((
393 -LDIF files can be downloaded by clicking the following link [[LDIF_OpenDJ>>attach:LDIF_OpenDJ.zip]].
353 +LDIF files can be downloaded by clicking on the following link [[LDIF_OpenDJ>>attach:/xwiki/wiki/dd2024r1/download/Digdash/deployment/installation/install_guide_ubuntu/WebHome/LDIF_OpenDJ.zip?rev=1.1]].
394 394  )))
395 -1. Create the organizations using the “neworganization.ldif” file below:(((
396 -|(% style="background-color:black" %)(% style="color:#ffffff" %)/opt/opendj/bin/ldapmodify ~-~-port 389 ~-~-bindDN(%%) (% style="color:#2ecc71" %)"cn=Directory Manager" (% style="color:#ffffff" %)~-~-bindPassword adminOpenDJ1 neworganisation.ldif
355 +1. Create organisations using the ‘neworganisation.ldif’ file below :
397 397  
398 -|(% style="background-color:black" %)(((
399 -(% style="line-height:1.38" %)
400 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//dn: ou=default,dc=digdash,dc=com//
357 +{{code language="shell"}}
358 +sudo /opt/opendj/bin/ldapmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" neworganisation.ldif
359 +{{/code}}
401 401  
402 -(% style="line-height:1.38" %)
403 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//objectClass: organizationalUnit//
361 +{{code}}
362 +dn: ou=default,dc=digdash,dc=com
404 404  
405 -(% style="line-height:1.38" %)
406 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//ou: default//
407 -)))
408 -)))
364 +objectClass: organizationalUnit
409 409  
366 +ou: default
367 +{{/code}}
368 +
410 410  (% start="4" %)
411 -1. To create a password checker:
412 -1*. Use the dsconfig.bat command, then log in with the Directory Manager credentials and accept the certificates.
413 -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 : (((
414 -|(% style="background-color:black" %)(% style="color:#ffffff" %)1:abcdefghijklmnopqrstuvwxyz
415 -1:ABCDEFGHIJKLMNOPQRSTUVWXYZ
416 -1:0123456789
417 -1:!"#$%&'()*+,-./:;\<=>?@[]^_`{~|}~~
370 +1. Set the password checker "Custom Character-set Password Validator":
418 418  
419 -➡ The result should look like this :
420 -(% style="border:none; color:#000000; display:inline-block; font-family:Consolas,sans-serif; font-size:10pt; font-style:italic; font-variant:normal; font-weight:400; height:114px; overflow:hidden; text-decoration:none; white-space:pre-wrap; width:454px" %)//[[image:Resultats.png]]//
421 -)))
372 +{{code language="shell"}}
373 +sudo /opt/opendj/bin/dsconfig create-password-validator --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" --validator-name "Custom Character-set Password Validator" --set character-set:1:abcdefghijklmnopqrstuvwxyz --set character-set:1:ABCDEFGHIJKLMNOPQRSTUVWXYZ --set character-set:1:0123456789 --set "character-set:1:\!\"#$%&'()*+,-./:;<=>?@[]^_\`{|}~" --set enabled:true --type character-set --no-prompt --trustAll --set allow-unclassified-characters:true
374 +{{/code}}
422 422  
423 -(((
424 -
425 -)))
426 -
427 427  (% start="5" %)
428 -1. For the second password checker, we can use a command line because it does not contain special characters: (((
429 -|(% style="background-color:black" %)(% style="color:#ffffff" %)/opt/opendj/bin/dsconfig create-password-validator ~-~-bindDN "cn=Directory Manager" ~-~-bindPassword adminOpenDJ1  ~-~-validator-name "Custom length Password Validator" ~-~-set min-password-length:12 ~-~-set enabled:true ~-~-type length-based ~-~-no-prompt
430 -)))
377 +1. Set the second password checker "Custom length Password Validator":
431 431  
379 +{{code language="shell"}}
380 +sudo /opt/opendj/bin/dsconfig create-password-validator --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1"  --validator-name "Custom length Password Validator" --set min-password-length:12 --set enabled:true --type length-based --no-prompt
381 +{{/code}}
382 +
432 432  (% start="6" %)
433 -1. Apply both password checkers:(((
434 -|(% style="background-color:black" %)(% style="color:#ffffff" %)/opt/opendj/bin/dsconfig set-password-policy-prop ~-~-bindDN "cn=Directory Manager" ~-~-bindPassword adminOpenDJ1 ~-~-policy-name "Default Password Policy" ~-~-set password-validator:"Custom Character-set Password Validator" ~-~-set password-validator:"Custom length Password Validator" ~-~-no-prompt
435 -)))
384 +1. Apply the two password checkers :
436 436  
386 +{{code language="shell"}}
387 +sudo /opt/opendj/bin/dsconfig set-password-policy-prop --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" --policy-name "Default Password Policy" --set password-validator:"Custom Character-set Password Validator" --set password-validator:"Custom length Password Validator" --no-prompt
388 +{{/code}}
389 +
437 437  (% start="7" %)
438 -1. Set the password policy for users using the “ppolicy.ldif” file below:(((
439 -|(% style="background-color:black" %)(% style="color:#ffffff" %)/opt/opendj/bin/ldapmodify ~-~-port 389 ~-~-bindDN "cn=Directory Manager" ~-~-bindPassword adminOpenDJ1 ppolicy.ldif
391 +1. Set the password policy for users using the ‘ppolicy.ldif’ file below:
440 440  
441 -|(% style="background-color:black" %)(((
442 -(% style="line-height:1.38" %)
443 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//dn: cn=ppolicy,ou=default,dc=digdash,dc=com//
393 +{{code language="shell"}}
394 +sudo /opt/opendj/bin/ldapmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" ppolicy.ldif
395 +{{/code}}
444 444  
445 -(% style="line-height:1.38" %)
446 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//objectClass: top//
397 +{{code}}
398 +dn: cn=ppolicy,ou=default,dc=digdash,dc=com
399 +objectClass: top
400 +objectClass: subentry
401 +objectClass: pwdPolicy
402 +cn: ppolicy
403 +pwdAttribute: userPassword
404 +pwdAllowUserChange: TRUE
405 +pwdCheckQuality: 1
406 +pwdExpireWarning: 600
407 +pwdFailureCountInterval: 30
408 +pwdGraceAuthNLimit: 5
409 +pwdInHistory: 5
410 +pwdLockout: TRUE
411 +pwdLockoutDuration: 900
412 +pwdMaxAge: 0
413 +pwdMaxFailure: 5
414 +pwdMinAge: 0
415 +pwdMustChange: FALSE
416 +pwdSafeModify: FALSE
417 +subtreeSpecification: {base "ou=users", specificationFilter "!(uid=admin)" }
418 +{{/code}}
447 447  
448 -(% style="line-height:1.38" %)
449 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//objectClass: subentry//
450 -
451 -(% style="line-height:1.38" %)
452 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//objectClass: pwdPolicy//
453 -
454 -(% style="line-height:1.38" %)
455 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//cn: ppolicy//
456 -
457 -(% style="line-height:1.38" %)
458 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdAttribute: userPassword//
459 -
460 -(% style="line-height:1.38" %)
461 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdAllowUserChange: TRUE//
462 -
463 -(% style="line-height:1.38" %)
464 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdCheckQuality: 1//
465 -
466 -(% style="line-height:1.38" %)
467 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdExpireWarning: 600//
468 -
469 -(% style="line-height:1.38" %)
470 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdFailureCountInterval: 30//
471 -
472 -(% style="line-height:1.38" %)
473 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdGraceAuthNLimit: 5//
474 -
475 -(% style="line-height:1.38" %)
476 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdInHistory: 5//
477 -
478 -(% style="line-height:1.38" %)
479 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdLockout: TRUE//
480 -
481 -(% style="line-height:1.38" %)
482 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdLockoutDuration: 900//
483 -
484 -(% style="line-height:1.38" %)
485 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdMaxAge: 0//
486 -
487 -(% style="line-height:1.38" %)
488 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdMaxFailure: 5//
489 -
490 -(% style="line-height:1.38" %)
491 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdMinAge: 0//
492 -
493 -(% style="line-height:1.38" %)
494 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdMustChange: FALSE//
495 -
496 -(% style="line-height:1.38" %)
497 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdSafeModify: FALSE//
498 -
499 -(% style="line-height:1.38" %)
500 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//subtreeSpecification: {base "ou=users", specificationFilter "!(uid=admin)" }//
501 -)))
502 -)))
503 -
504 504  (% start="8" %)
505 -1. Set a second password policy for the admin using the “ppolicy-admin.ldif” file below:(((
506 -|(% style="background-color:black" %)(% style="color:#ffffff" %)/opt/opendj/bin/ldapmodify ~-~-port 389 ~-~-bindDN "cn=Directory Manager" ~-~-bindPassword adminOpenDJ1 ppolicy-admin.ldif
421 +1. Set a second password policy for admin using the ‘ppolicy-admin.ldif’ file below:
507 507  
508 -|(% style="background-color:black" %)(((
509 -(% style="line-height:1.38" %)
510 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//dn: cn=ppolicy-admin,ou=default,dc=digdash,dc=com//
423 +{{code language="shell"}}
424 +sudo /opt/opendj/bin/ldapmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" ppolicy-admin.ldif
425 +{{/code}}
511 511  
512 -(% style="line-height:1.38" %)
513 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//objectClass: top//
427 +{{code}}
428 +dn: cn=ppolicy-admin,ou=default,dc=digdash,dc=com
429 +objectClass: top
430 +objectClass: subentry
431 +objectClass: pwdPolicy
432 +cn: ppolicy-admin
433 +pwdAttribute: userPassword
434 +pwdAllowUserChange: TRUE
435 +pwdCheckQuality: 1
436 +pwdFailureCountInterval: 30
437 +pwdGraceAuthNLimit: 5
438 +pwdInHistory: 5
439 +pwdLockout: FALSE
440 +pwdMaxAge: 0
441 +pwdMinAge: 0
442 +pwdMustChange: FALSE
443 +pwdSafeModify: FALSE
444 +subtreeSpecification: {base "ou=users", specificationFilter "(uid=admin)" }
445 +{{/code}}
514 514  
515 -(% style="line-height:1.38" %)
516 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//objectClass: subentry//
447 +(% start="9" %)
448 +1. Change password policy to allow pre-encoded passwords (useful for restores in Digdash):
517 517  
518 -(% style="line-height:1.38" %)
519 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//objectClass: pwdPolicy//
450 +{{code language="shell"}}
451 +sudo /opt/opendj/bin/dsconfig 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
452 +{{/code}}
520 520  
521 -(% style="line-height:1.38" %)
522 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//cn: ppolicy-admin//
454 +(% start="10" %)
455 +1. Create an admin user for Digdash using the “create_user_admin.ldif” file below:
523 523  
524 -(% style="line-height:1.38" %)
525 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdAttribute: userPassword//
457 +{{code language="shell"}}
458 +sudo /opt/opendj/bin/ldapmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" create_user_admin.ldif
459 +{{/code}}
526 526  
527 -(% style="line-height:1.38" %)
528 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdAllowUserChange: TRUE//
461 +{{code}}
462 +dn: uid=admin,ou=default,dc=digdash,dc=com
463 +objectClass: shadowAccount
464 +objectClass: inetOrgPerson
465 +cn: Admin Domain Default
466 +sn: Default
467 +uid: admin_default
468 +{{/code}}
529 529  
530 -(% style="line-height:1.38" %)
531 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdCheckQuality: 1//
532 -
533 -(% style="line-height:1.38" %)
534 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdFailureCountInterval: 30//
535 -
536 -(% style="line-height:1.38" %)
537 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdGraceAuthNLimit: 5//
538 -
539 -(% style="line-height:1.38" %)
540 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdInHistory: 5//
541 -
542 -(% style="line-height:1.38" %)
543 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdLockout: FALSE//
544 -
545 -(% style="line-height:1.38" %)
546 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdMaxAge: 0//
547 -
548 -(% style="line-height:1.38" %)
549 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdMinAge: 0//
550 -
551 -(% style="line-height:1.38" %)
552 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdMustChange: FALSE//
553 -
554 -(% style="line-height:1.38" %)
555 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdSafeModify: FALSE//
556 -
557 -(% style="line-height:1.38" %)
558 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//subtreeSpecification: {base "ou=users", specificationFilter "(uid=admin)" }//
559 -)))
560 -)))
561 -1. Change the password policy to allow pre-encoded passwords (useful for restores in digdash) :(((
562 -|(% style="background-color:black" %)(% style="color:#ecf0f1" %)/opt/opendj/bin/dsconfig 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
563 -)))
564 -1. Create an admin user for digdash via the “create_user_admin.ldif” file below(((
565 -|(% style="background-color:black" %)(% style="color:#ecf0f1" %)/opt/opendj/bin/ldapmodify (% style="color:#ffffff" %)~-~-port 389 (% style="color:#ecf0f1" %)~-~-bindDN "cn=Directory Manager" ~-~-bindPassword adminOpenDJ1 create_user_admin.ldif
566 -
567 -|(% style="background-color:black" %)(((
568 -(% style="line-height:1.38" %)
569 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//dn: uid=admin,ou=default,dc=digdash,dc=com//
570 -
571 -(% style="line-height:1.38" %)
572 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//objectClass: shadowAccount//
573 -
574 -(% style="line-height:1.38" %)
575 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//objectClass: inetOrgPerson//
576 -
577 -(% style="line-height:1.38" %)
578 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//cn: Admin Domain Default//
579 -
580 -(% style="line-height:1.38" %)
581 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//sn: Default//
582 -
583 -(% style="line-height:1.38" %)
584 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//uid: admin_default//
585 -)))
586 -)))
587 -
588 588  (% start="11" %)
589 -1. Assign the admin user the necessary rights using the “add_admin_right.ldif” and “add_admin_right2.ldif” files below:(((
590 -|(% style="background-color:black" %)(% style="color:#ecf0f1" %)/opt/opendj/bin/ldapmodify (% style="color:#ffffff" %)~-~-port 389 (% style="color:#ecf0f1" %)~-~-bindDN "cn=Directory Manager" ~-~-bindPassword adminOpenDJ1 add_admin_right.ldif
471 +1. Assign the admin user the necessary rights using the “add_admin_right.ldif” and “add_admin_right2.ldif” files below:
591 591  
592 -|(% style="background-color:black" %)(((
593 -(% style="color:#ffffff" %)dn: ou=default,dc=digdash,dc=com
473 +{{code language="shell"}}
474 +sudo /opt/opendj/bin/ldapmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" add_admin_right.ldif
475 +{{/code}}
594 594  
595 -(% style="color:#ffffff" %)changetype: modify
477 +{{code}}
478 +dn: ou=default,dc=digdash,dc=com
479 +changetype: modify
480 +add: aci
481 +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");)
482 +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");)
483 +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");)
484 +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");)
485 +aci: (target ="ldap:///ou=default,dc=digdash,dc=com")(targetattr = "*")(version 3.0; acl "allow read on * for anonymous"; allow(read) (userdn = "ldap:///all");)
486 +{{/code}}
596 596  
597 -(% style="color:#ffffff" %)add: aci
488 +{{code language="shell"}}
489 +sudo /opt/opendj/bin/ldapmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" add_admin_right2.ldif
490 +{{/code}}
598 598  
599 -(% style="color:#ffffff" %)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"){{{;)}}}
492 +{{code}}
493 +dn: uid=admin,ou=default,dc=digdash,dc=com
494 +changetype: modify
495 +add: ds-privilege-name
496 +ds-privilege-name: config-read
497 +ds-privilege-name: password-reset
498 +{{/code}}
600 600  
601 -(% style="color:#ffffff" %)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"){{{;)}}}
500 +(% start="12" %)
501 +1. Generate an administrator password and remember it for later:
602 602  
503 +{{code language="shell"}}
504 +sudo /opt/opendj/bin/ldappasswordmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" --authzID "u:admin"
505 +{{/code}}
603 603  
604 -(% style="color:#ffffff" %)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"){{{;)}}}
507 +(% class="box infomessage" %)
508 +(((
509 +💡 If you want to set your own password for the admin user, you need to use a variation of the previous command:
605 605  
606 -
607 -(% style="color:#ffffff" %)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"){{{;)}}}
608 -
609 -(% style="color:#ffffff" %)aci: (target ="ldap:~/~//ou=default,dc=digdash,dc=com")(targetattr = "*")(version 3.0; acl "allow read on * for anonymous"; allow(read) (userdn = "ldap:~/~//all"){{{;)}}}
511 +{{code language="shell"}}
512 +sudo /opt/opendj/bin/ldappasswordmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" --authzID "u:admin" --newPassword "mdpAdmin"
513 +{{/code}}
610 610  )))
611 611  
612 -|(% style="background-color:black" %)(% style="color:#ffffff" %)/opt/opendj/bin/ldapmodify ~-~-port 389 ~-~-bindDN "cn=Directory Manager" ~-~-bindPassword adminOpenDJ1 add_admin_right2.ldif
613 -
614 -|(% style="background-color:black" %)(((
615 -(% style="line-height:1.38" %)
616 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//dn: uid=admin,ou=default,dc=digdash,dc=com//
617 -
618 -(% style="line-height:1.38" %)
619 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//changetype: modify//
620 -
621 -(% style="line-height:1.38" %)
622 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//add: ds-privilege-name//
623 -
624 -(% style="line-height:1.38" %)
625 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//ds-privilege-name: config-read//
626 -
627 -(% style="line-height:1.38" %)
628 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//ds-privilege-name: password-reset//
629 -)))
630 -)))
631 -
632 -(% start="12" %)
633 -1. Generate a password for the administrator and remember it for later:(((
634 -|(% style="background-color:black" %)(% style="background-color:#000000; color:#ecf0f1" %)/opt/opendj/bin/ldappasswordmodify (% style="color:#ffffff" %)~-~-port 389 (% style="background-color:#000000; color:#ecf0f1" %)~-~-bindDN "cn=Directory Manager" ~-~-bindPassword adminOpenDJ1 ~-~-authzID "u:admin"
635 -)))
636 -
637 637  (% style="line-height:1.38; text-indent:-14.173228346456689pt; margin-top:13px; margin-bottom:13px; padding:0pt 0pt 0pt 14.173228346456689pt" %)
638 638  == Enabling automatic service start on startup ==
639 639  
519 +1. Create the opendj.service file:
640 640  
641 -1. Create the opendj.service file:(((
642 -|(% style="background-color:black" %)(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)sudo vi /etc/systemd/system/opendj.service
643 -)))
521 +{{code language="shell"}}
522 +sudo vi /etc/systemd/system/opendj.service
523 +{{/code}}
644 644  
645 645  (% start="2" %)
646 -1. Paste the following lines there:(((
647 -|(% style="background-color:black" %)(((
648 -(% style="line-height:1.38" %)
649 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)[Unit]
526 +1. And paste the following lines:
650 650  
651 -(% style="line-height:1.38" %)
652 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)Description=OpenDJ Server Daemon
528 +{{code}}
529 +[Unit]
653 653  
654 -(% style="line-height:1.38" %)
655 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)Wants=network-online.target
531 +Description=OpenDJ Server Daemon
656 656  
657 -(% style="line-height:1.38" %)
658 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)After=network-online.target
533 +Wants=network-online.target
659 659  
660 -(% style="line-height:1.38" %)
661 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)Conflicts=shutdown.target
535 +After=network-online.target
662 662  
663 -(% style="background-color:#000000" %) (% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)[Service]
537 +Conflicts=shutdown.target
664 664  
665 -(% style="line-height:1.38" %)
666 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)Type=simple
539 + [Service]
667 667  
668 -(% style="line-height:1.38" %)
669 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)Restart=no
541 +Type=simple
670 670  
671 -(% style="line-height:1.38" %)
672 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)TimeoutSec=5min
543 +Restart=no
673 673  
674 -(% style="line-height:1.38" %)
675 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)IgnoreSIGPIPE=no
545 +TimeoutSec=5min
676 676  
677 -(% style="line-height:1.38" %)
678 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)KillMode=process
547 +IgnoreSIGPIPE=no
679 679  
680 -(% style="line-height:1.38" %)
681 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)GuessMainPID=no
549 +KillMode=process
682 682  
683 -(% style="line-height:1.38" %)
684 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)RemainAfterExit=yes
551 +GuessMainPID=no
685 685  
686 -(% style="line-height:1.38" %)
687 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)ExecStart=/opt/opendj/bin/start-ds ~-~-quiet
553 +RemainAfterExit=yes
688 688  
689 -(% style="line-height:1.38" %)
690 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)ExecStop=/opt/opendj/bin/stop-ds ~-~-quiet
555 +ExecStart=/opt/opendj/bin/start-ds --quiet
691 691  
692 -(% style="background-color:#000000" %) (% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)[Install]
557 +ExecStop=/opt/opendj/bin/stop-ds --quiet
693 693  
694 -(% style="line-height:1.38" %)
695 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)WantedBy=multi-user.target
696 -)))
697 -)))
559 + [Install]
698 698  
561 +WantedBy=multi-user.target
562 +{{/code}}
563 +
699 699  (% start="3" %)
700 -1. Then type the following commands(((
701 -|(% style="background-color:black" %)(((
702 -(% style="line-height:1.38" %)
703 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)systemctl daemon-reload
565 +1. Then type the following commands:
704 704  
705 -(% style="line-height:1.38" %)
706 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)systemctl enable ~-~-now opendj
567 +{{code language="shell"}}
568 +systemctl daemon-reload
707 707  
708 -(% style="line-height:1.38" %)
709 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,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" %)systemctl status opendj
710 -)))
711 -)))
570 +systemctl enable --now opendj
712 712  
713 -== Fonction utile ==
572 +systemctl status opendj
573 +{{/code}}
714 714  
715 -L'opération ci-dessous ne fait pas partie de l'installation.
716 -Il peut néanmoins être utile de la connaître pour une utilisation ultérieure.
575 +== Useful option ==
717 717  
718 -=== Étendre la limite pour les recherches LDAP ===
577 +The operation below is not part of the installation.
578 +However, it may be useful to know it for later use.
719 719  
720 -Étendre la limite de recherche du LDAP à plus de 1000 utilisateurs avec le fichier “extend_search_limit.ldif” ci-dessous
580 +=== Extending the limit for LDAP searches ===
721 721  
722 -|(% style="background-color:black" %)(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)///opt/opendj/bin/ldapmodify //(% style="color:#ffffff" %)~-~-port 389 (% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)//~-~-bindDN "cn=Directory Manager" ~-~-bindPassword adminOpenDJ1 extend_search_limit.ldif//
582 +It is possible to extend the LDAP search limit to more than 1000 users with the extend_search_limit.ldif” file below.
723 723  
724 -|(% style="background-color:black" %)(((
725 -(% style="line-height:1.38" %)
726 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//dn: uid=admin,ou=default,dc=digdash,dc=com//
584 +{{code language="shell"}}
585 +sudo /opt/opendj/bin/ldapmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" extend_search_limit.ldif
586 +{{/code}}
727 727  
728 -(% style="line-height:1.38" %)
729 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//changetype: modify//
588 +{{code}}
589 +dn: uid=admin,ou=default,dc=digdash,dc=com
590 +changetype: modify
591 +add: ds-rlim-size-limit
592 +ds-rlim-size-limit: 10000
593 +{{/code}}
730 730  
731 -(% style="line-height:1.38" %)
732 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//add: ds-rlim-size-limit//
595 +(% class="wikigeneratedid" id="H" style="line-height: 1.2;" %)
733 733  
734 -(% style="line-height:1.38" %)
735 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//ds-rlim-size-limit: 10000//
736 -)))
737 737  
738 -= MariaDB (Préconisé){{id name="DB_ubuntu"/}} =
598 += MariaDB (Recommended){{id name="DB_ubuntu"/}} =
739 739  
740 -La base de données MariaDB va servir à stocker les éléments suivants : Commentaires, données d'audit et formulaires de saisies.
600 +The MariaDB database will be used to store the following elements: comments, audit data and data entry.
741 741  
742 -Cette base est plus pérenne qu'une base H2 c'est pourquoi nous préconisons son utilisation. Si vous possédez déjà une base de données sur laquelle Digdash peut écrire et lire alors passez à l'étape de configuration.
602 +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.
743 743  
744 -Cela fonctionne aussi avec Mysql ou Postgresql.
604 +Mysql and Postgresql are also compatible.
745 745  
746 746  == Installation ==
747 747  
... ... @@ -750,28 +750,28 @@
750 750  {{/code}}
751 751  
752 752  {{code language="shell"}}
753 -#Démarrage de mariadb
613 +#start mariadb
754 754  sudo systemctl start mariadb
755 -#Arrêt de mariadb
615 +#Stop mariadb
756 756  sudo systemctl stop mariadb
757 -#Reload pour prise en compte de modification de configuration
617 +#Reload to take into account the configuration changes
758 758  sudo systemctl reload mariadb
759 759  sudo systemctl force-reload mariadb
760 -#Connaître la version
620 +#Display the version
761 761  mariadb --version
762 762  
763 763  {{/code}}
764 764  
765 765  (% class="wikigeneratedid" %)
766 -Lancer mysql_secure_installation, cela va permettre de sécuriser l'installation
626 +Launch mysql_secure_installation. This will secure the installation.
767 767  
768 768  {{code language="shell"}}
769 769  sudo mysql_secure_installation
770 770  
771 -# Répondez oui à toutes les étapes
631 +# Enter yes at all steps
772 772  {{/code}}
773 773  
774 -== Activation du lancement automatique du service au démarrage ==
634 +== Enabling automatic service start on startup ==
775 775  
776 776  {{code language="shell"}}
777 777  sudo systemctl enable mariadb
... ... @@ -778,37 +778,36 @@
778 778  
779 779  {{/code}}
780 780  
781 -== Configuration côté base de données ==
641 +== Database configuration ==
782 782  
783 -Nous allons créer une base pour chaque domaine et chaque webapps (par exemple prod_ddaudit et dev_ddaudit et ainsi de suite)
643 +We will create a base for each domain and each webapps (for example prod_ddaudit and dev_ddaudit and so on)
784 784  
785 -Dans l'exemple ci dessous, nous allons considérer qu'il n'existe qu'uenvironnement 'default'.
645 +In the example below, we will consider that there is only one 'default' environment.
786 786  
787 787  {{code language="shell"}}
788 -# Lancer mariadb
648 +# Start mariadb
789 789  sudo mariadb -u root -p
790 790  
791 -# Créer toutes les bases de dones nécessaires domaine_module.
651 +# Create all necessary databases domain_module.
792 792  CREATE DATABASE default_ddaudit;
793 793  CREATE DATABASE default_comment;
794 794  CREATE DATABASE default_ddentry;
795 795  
796 -# Créer un user pour chaque base de données domaine_user_module. Le mot de passe est un nouveau mot de passe à créer.
656 +# Create a user for each database domaine_user_module. The password is a new one to create.
797 797  CREATE USER 'default_user_ddaudit'@'localhost' IDENTIFIED BY 'mynewpassword';
798 798  CREATE USER 'default_user_comment'@'localhost' IDENTIFIED BY 'mynewpassword';
799 799  CREATE USER 'default_user_ddentry'@'localhost' IDENTIFIED BY 'mynewpassword';
800 800  
801 -# Attribuer les droits aux utilisateurs sur les bonnes bases
661 +# Assign rights on the databases to the user
802 802  GRANT ALL PRIVILEGES ON default_comment.* TO 'default_user_comment'@'localhost';
803 803  GRANT ALL PRIVILEGES ON default_ddaudit.* TO 'default_user_ddaudit'@'localhost';
804 804  GRANT ALL PRIVILEGES ON default_ddentry.* TO 'default_user_ddentry'@'localhost';
805 805  {{/code}}
806 806  
667 += NGINX (Optional) =
807 807  
808 -= NGINX (Optionnel) =
669 +Nginx is used as reverse proxy.
809 809  
810 -Nous utilisons Nginx comme reverse proxy.
811 -
812 812  == Installation ==
813 813  
814 814  {{code language="shell"}}
... ... @@ -815,7 +815,7 @@
815 815  sudo apt install nginx
816 816  {{/code}}
817 817  
818 -== Activation du lancement automatique du service au démarrage ==
677 +== Enabling automatic service start on startup ==
819 819  
820 820  {{code language="shell"}}
821 821  sudo systemctl enable nginx
... ... @@ -823,18 +823,19 @@
823 823  
824 824  == Configuration ==
825 825  
826 -Créer le fichier de configuration portant le nom de votre machine ou de votre environnement. Dans cet exemple, on utilise 001-digdash.
685 +Create the configuration file with the name of your machine or environment. In this example, we use 001-digdash.
827 827  
828 -Dans le dossier /etc/nginx :
687 +In the /etc/nginx folder:
829 829  
830 830  {{code language="shell"}}
831 -# Créer le fichier de conf
690 +# Create the conf file
832 832  sudo vi /etc/nginx/sites-available/001-digdash.conf
833 833  {{/code}}
834 834  
835 835  {{code language="shell"}}
836 -# Ajouter le contenu suivant à l'intérieur.
837 -# Remplacer .mondomaine.com pour server et les chemins Certificate(s) and private key, par vos informations.
695 +# Add the following content inside.
696 +# Replace .mydomain.com for server and paths
697 +Certificate(s) and private key, par vos informations.
838 838  upstream backend_tomcat{
839 839   least_conn;
840 840   server localhost:8080 fail_timeout=0;
... ... @@ -882,13 +882,13 @@
882 882  }
883 883  {{/code}}
884 884  
885 -Puis créer un lien symbolique dans site enabled
745 +Then create a symbolic link in sites-enabled
886 886  
887 887  {{code language="shell"}}
888 888  sudo ln -s  /etc/nginx/sites-available/001-digdash.conf /etc/nginx/sites-enabled/001-digdash.conf
889 889  {{/code}}
890 890  
891 -Créer le fichier digdash_ssl_params contenant la politique de securité.
751 +Create the digdash_ssl_params file containing the security policy:
892 892  
893 893  {{code language="shell"}}
894 894  sudo vi digdash_ssl_params
... ... @@ -917,11 +917,11 @@
917 917  add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains; preload' always;
918 918  {{/code}}
919 919  
920 -= (% id="cke_bm_868S" style="display:none" %) (%%)Configuration DigDash après installation =
780 += (% id="cke_bm_868S" style="display:none" %) (%%)Configuring DigDash after installation =
921 921  
922 -== Lancement de Digdash ==
782 +== Starting Digdash ==
923 923  
924 -1. Redémarrer le service Tomcat.
784 +1. Restart Tomcat service.
925 925  
926 926  {{code language="shell"}}
927 927  sudo service tomcat9 restart
... ... @@ -928,81 +928,81 @@
928 928  {{/code}}
929 929  
930 930  (% start="2" %)
931 -1. Vérifier le déploiement des war dans le dossier d’installation home/digdash/webapps/default.
932 -1. Accéder à DigDash sur ladresse suivante : [[__http:~~/~~/localhost:8080/adminconsole__>>url:http://localhost:8080/adminconsole]].
933 -Le login / mot de passe sera admin / admin.
791 +1. Check the war deployment in the installation folder home/digdash/webapps/default.
792 +1. Access DigDash homepage at the following address : [[http:~~/~~/localhost:8080/adminconsole>>url:http://localhost:8080/adminconsole]]
793 +The login/password is admin/admin.
934 934  
935 -[[image:Homepage2023R2.png||alt="Page_accueil"]]
795 +== Connecting Digdash to the installed OpenDJ server ==
936 936  
937 -== Branchement de Digdash au serveur OpenDJ installé ==
797 +Open [[http:~~/~~/localhost:8080/adminconsole/>>url:http://localhost:8080/adminconsole/]], **Configuration -> Server settings -> Servers -> LDAP Server**.
938 938  
939 - Aller dans **Configuration -> Paramètres serveur-> Serveurs -> LDAP**.
799 +* Port:  389
800 +* User: uid=admin, ou=default,dc=digdash,dc=com
801 +* Password: OpenDJ admin password
940 940  
941 -* Port :  389
942 -* Utilisateur : uid=admin, ou=default,dc=digdash,dc=com
943 -* Mot de passe : mot de passe admin de OpenDJ
803 +[[image:LDAPserver_ok.png||alt="LDAP server"]]
944 944  
945 -[[image:1675171192455-197.png]]
805 +Then click the **LDAP Queries** button and enter "**ou=default**" in the **Domain Tree** field for all the fields to be automatically filled as below.
946 946  
947 -Cliquer ensuite sur **Requêtes LDAP**, et entrer "**ou=default**" dans le champ **Arbre du domaine** pour que les champs soient automatiquement renseignés comme ci-dessous.
807 +[[image:LDAPqueries_ok.png||alt="LDAP queries"]]
948 948  
949 -[[image:1675171204379-473.png]]
809 +== Changing the supervisor password and creating the LDAP account ==
950 950  
951 -== Modification du mot de passe superviseur et création du compte LDAP ==
811 +=== Changing the supervisor password ===
952 952  
953 -=== Modification du mot de passe superviseur ===
813 +Open **Configuration  -> Server settings > Servers -> Enterprise Server **and enter a new password in the **Supervisor Password** field.
954 954  
955 -Aller dans **Configuration  -> Paramètres serveur > Serveurs -> Serveur Enterprise** et entrer un nouveau mot de passe dans le champ **Mot de passe du Superviseur**.
815 +[[image:EnterpriseServer.png||alt="Supervisor password"]]
956 956  
957 -[[image:Serveur_enterprise.png||alt="Serveur enterprise"]]
817 +=== Creating the LDAP account ===
958 958  
959 -=== Création du compte LDAP ===
819 +1. Open **Configuration -> User management -> Users**.
820 +1. Create a new admin user and assign him all roles and authorizations groups.
821 +1. In the **Password** field, enter the new supervisor password defined above.
960 960  
961 -1. Aller dans **Configuration -> Gestion des utilisateurs -> Utilisateurs**.
962 -1. Créer un nouvel utilisateur admin et lui attribuer tous les rôles et groupes d'autorisation.
963 -1. Dans le champ **Mot de passe**, entrer le nouveau mot de passe du superviseur défini ci-dessus.
823 +[[image:User_password.png||alt="User password"]]
964 964  
965 -[[image:MdP_LDAP.png||alt="Compte LDAP"]]
825 +== Database configuration ==
966 966  
967 -== Configuration des bases de données ==
827 +=== Audit data database ===
968 968  
969 -=== Base de données Données d'audit ===
829 +Open **Configuration -> Server settings -> Databases -> Audit data **and enter the URL, user and password.
970 970  
971 -(% class="wikigeneratedid" id="HAllerdansConfiguration-3EParamE8tresserveur-3ECommentairesetrenseignericil2019URL2Cl2019utilisateuretlemotdepasse." style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %)
972 -Aller dans **Configuration -> Paramètres serveur -> Base de données -> Données d'audit** et renseigner ici l’URL, l’utilisateur et le mot de passe.
973 -
974 -(% class="wikigeneratedid" style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %)
975 975  **URL **: //jdbc:mariadb:~/~/localhost:3306/default_ddaudit//
976 976  
977 -Cette solution permet de sécuriser l’accès à la base de données d'audit.
833 +This solution makes it possible to secure access to the audit database.
978 978  
979 -[[image:Données_audit.png||alt="Données_audit"]]
835 +[[image:Audit_data.png||alt="Audit data"]]
980 980  
981 -=== Base de données Commentaires ===
837 +=== Comments database ===
982 982  
983 -(% class="wikigeneratedid" id="HAllerdansConfiguration-3EParamE8tresserveur-3ECommentairesetrenseignericil2019URL2Cl2019utilisateuretlemotdepasse." style="line-height: 1.2; margin-top: 13px; margin-bottom: 13px; text-align: justify;" %)
984 -Aller dans **Configuration -> Paramètres serveur -> Base de données -> Commentaires** et renseigner ici l’URL, l’utilisateur et le mot de passe.
839 +Open **Configuration -> Server settings -> Databases -> Audit data **and enter the URL, user and password.
985 985  
986 -(% class="wikigeneratedid" style="line-height: 1.2; margin-top: 13px; margin-bottom: 13px; text-align: justify;" %)
987 -**URL** ~:// jdbc:mariadb:~/~/localhost:3306/default_comment//
841 +**URL** ~:// jdbc:mariadb:~/~/localhost:3306/default_comment//
988 988  
989 -Cette solution permet de sécuriser l’accès à la base de données de commentaires.
843 +This solution makes it possible to secure access to the comment database.
990 990  
991 -[[image:Commentaires.png||alt="Commentaires"]]
845 +[[image:Comments.png||alt="Comments"]]
992 992  
993 993  (% style="line-height: 1.2; text-indent: 0.153543pt; text-align: justify;" %)
994 -=== Base de données Saisie de données ===
848 +=== Data entry database ===
995 995  
996 -(% class="wikigeneratedid" id="HAllerdansConfiguration-3EParamE8tresserveur-3ECommentairesetrenseignericil2019URL2Cl2019utilisateuretlemotdepasse." style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %)
997 -Aller dans **Configuration -> Paramètres serveur -> Base de données -> Saisie des données**.
850 +Open **Configuration -> Server settings -> Databases -> Data entry **and enter the URL, user and password.
998 998  
999 -(% class="wikigeneratedid" style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %)
1000 -Cocher la case **Activer la saisir de données** et sélectionner une base de données dans la liste déroulante.
852 +Select the **Enable data entry** checkbox and select a database in the drop-down list below.
1001 1001  
1002 1002  (% class="wikigeneratedid" style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %)
1003 -[[image:1698407220646-676.png||alt="Saisie données"]]
855 +[[image:Data_entry.png]]
1004 1004  
1005 1005  (% class="wikigeneratedid" style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %)
1006 -Il faut, au préalable, avoir créé une connexion à la base de données depuis le **Gestionnaire des connexions aux de données** dans le Studio. Consultez la page [[Gestionnaire des connexions aux bases de données>>doc:dev:Digdash.user_guide.studio.managers.dbconnections.WebHome]] pour plus de détails. 
1007 -Entrer default.user.ddentry pour l'utilisateur et le mot de passe défini à l'étape précédente. 
1008 -Le nom défini dans le champ **Nom de connexion **est celui qui apparaîtra dans la liste déroulante de sélection de la base de données.
858 +You must first have created a connection to the database from the Data connection manager in the Studio.
859 +Enter default.user.ddentry for the user and password defined in the previous step.
860 +The name defined in the **Login Name** field is the one that will appear in the database selection drop-down list.
861 +
862 +== DigDash Services ==
863 +
864 +Open the Server status page : [[__http:~~/~~/localhost:8080/ddenterpriseapi/serverstatus?adminDomain=adminconsole&serverDomain=ddenterpriseapi__>>url:http://localhost:8080/ddenterpriseapi/serverstatus?adminDomain=adminconsole&serverDomain=ddenterpriseapi]]
865 +
866 +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.
867 +
868 +[[image:Server_status.png||alt="Server status"]]