Changes for page Guide d'installation Linux

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

From 4.3 to 5.1 From 18.1 to 19.1

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 18.1

edited by Aurelie Bertrand
on 2024/08/20 09:13

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Title

@@ -1,1 +1,1 @@
--Guide d'installation Linux
++Installation guide for Linux

Content

@@ -111,7 +111,7 @@
  ==== Reverse Proxy Valve ====
  {{code language="shell"}}
--# Add this valve in the Host element towards the end of the file
++# Add this valve in the Host element near the end of the file
  <Valve className="org.apache.catalina.valves.RemoteIpValve"
                  internalProxies="127\.0\.[0-1]\.1"
                  remoteIpHeader="X-Forwarded-For"
@@ -140,11 +140,11 @@
  ==== Log Valve ====
  {{code language="shell"}}
--# Add this valve in the Host element towards the end of the file
++# Add this valve in the Host element near the end of the file
  <Valve className="org.apache.catalina.valves.ErrorReportValve" showReport="false" showServerInfo="false" ></Valve>
  {{/code}}
--==== Limit the localhost_access_log file (optional) ====
++==== Limiting the localhost_access_log file (optional) ====
  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.
@@ -156,7 +156,7 @@
  {{/code}}
--=== Editing context.xml ===
++=== Editing the context.xml file ===
  (% class="wikigeneratedid" id="HEmplacement:2Fetc2Ftomcat92Fcontext.xml" %)
  Location: /etc/tomcat9/context.xml
@@ -201,7 +201,7 @@
  sudo systemctl restart tomcat9.service
  {{/code}}
--=== Enabling automatic start service on startup ===
++=== Enabling automatic service start on startup ===
  {{code language="shell"}}
  sudo systemctl enable tomcat9
@@ -710,14 +710,14 @@
  )))
  )))
--== Fonction utile ==
++== Useful option ==
--L'opération ci-dessous ne fait pas partie de l'installation.
--Il peut néanmoins être utile de la connaître pour une utilisation ultérieure.
++The operation below is not part of the installation.
++However, it may be useful to know it for later use.
--=== Étendre la limite pour les recherches LDAP ===
++=== Extending the limit for LDAP searches ===
--Étendre la limite de recherche du LDAP à plus de 1000 utilisateurs avec le fichier “extend_search_limit.ldif” ci-dessous
++It is possible to extend the LDAP search limit to more than 1000 users with the “extend_search_limit.ldif” file below.
  |(% 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//
@@ -735,13 +735,13 @@
  (% 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//
  )))
--= MariaDB (Préconisé){{id name="DB_ubuntu"/}} =
++= MariaDB (Recommended){{id name="DB_ubuntu"/}} =
--La base de données MariaDB va servir à stocker les éléments suivants : Commentaires, données d'audit et formulaires de saisies.
++The MariaDB database will be used to store the following elements: comments, audit data and data entry.
--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.
++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.
--Cela fonctionne aussi avec Mysql ou Postgresql.
++Mysql and Postgresql are also compatible.
  == Installation ==
@@ -750,28 +750,28 @@
  {{/code}}
  {{code language="shell"}}
--#Démarrage de mariadb
++#start mariadb
  sudo systemctl start mariadb
--#Arrêt de mariadb
++#Stop mariadb
  sudo systemctl stop mariadb
--#Reload pour prise en compte de modification de configuration
++#Reload to take into account the configuration changes
  sudo systemctl reload mariadb
  sudo systemctl force-reload mariadb
--#Connaître la version
++#Display the version
  mariadb --version
  {{/code}}
  (% class="wikigeneratedid" %)
--Lancer mysql_secure_installation, cela va permettre de sécuriser l'installation
++Launch mysql_secure_installation. This will secure the installation.
  {{code language="shell"}}
  sudo mysql_secure_installation
--# Répondez oui à toutes les étapes
++# Enter yes at all steps
  {{/code}}
--== Activation du lancement automatique du service au démarrage ==
++== Enabling automatic service start on startup ==
  {{code language="shell"}}
  sudo systemctl enable mariadb
@@ -778,37 +778,36 @@
  {{/code}}
--== Configuration côté base de données ==
++== Database configuration ==
--Nous allons créer une base pour chaque domaine et chaque webapps (par exemple prod_ddaudit et dev_ddaudit et ainsi de suite)
++We will create a base for each domain and each webapps (for example prod_ddaudit and dev_ddaudit and so on)
--Dans l'exemple ci dessous, nous allons considérer qu'il n'existe qu'un environnement 'default'.
++In the example below, we will consider that there is only one 'default' environment.
  {{code language="shell"}}
--# Lancer mariadb
++# Start mariadb
  sudo mariadb -u root -p
--# Créer toutes les bases de données nécessaires domaine_module.
++# Create all necessary databases domain_module.
  CREATE DATABASE default_ddaudit;
  CREATE DATABASE default_comment;
  CREATE DATABASE default_ddentry;
--# 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.
++# Create a user for each database domaine_user_module. The password is a new one to create.
  CREATE USER 'default_user_ddaudit'@'localhost' IDENTIFIED BY 'mynewpassword';
  CREATE USER 'default_user_comment'@'localhost' IDENTIFIED BY 'mynewpassword';
  CREATE USER 'default_user_ddentry'@'localhost' IDENTIFIED BY 'mynewpassword';
--# Attribuer les droits aux utilisateurs sur les bonnes bases
++# Assign rights on the databases to the user
  GRANT ALL PRIVILEGES ON default_comment.* TO 'default_user_comment'@'localhost';
  GRANT ALL PRIVILEGES ON default_ddaudit.* TO 'default_user_ddaudit'@'localhost';
  GRANT ALL PRIVILEGES ON default_ddentry.* TO 'default_user_ddentry'@'localhost';
  {{/code}}
++= NGINX (Optional) =
--= NGINX (Optionnel) =
++Nginx is used as reverse proxy.
--Nous utilisons Nginx comme reverse proxy.
--
  == Installation ==
  {{code language="shell"}}
@@ -815,7 +815,7 @@
  sudo apt install nginx
  {{/code}}
--== Activation du lancement automatique du service au démarrage ==
++== Enabling automatic service start on startup ==
  {{code language="shell"}}
  sudo systemctl enable nginx
@@ -823,18 +823,19 @@
  == Configuration ==
--Créer le fichier de configuration portant le nom de votre machine ou de votre environnement. Dans cet exemple, on utilise 001-digdash.
++Create the configuration file with the name of your machine or environment. In this example, we use 001-digdash.
--Dans le dossier /etc/nginx :
++In the /etc/nginx folder:
  {{code language="shell"}}
--# Créer le fichier de conf
++# Create the conf file
  sudo vi /etc/nginx/sites-available/001-digdash.conf
  {{/code}}
  {{code language="shell"}}
--# Ajouter le contenu suivant à l'intérieur.
--# Remplacer .mondomaine.com pour server et les chemins Certificate(s) and private key, par vos informations.
++# Add the following content inside.
++# Replace .mydomain.com for server and paths
++Certificate(s) and private key, par vos informations.
  upstream backend_tomcat{
      least_conn;
      server localhost:8080 fail_timeout=0;
@@ -882,13 +882,13 @@
  }
  {{/code}}
--Puis créer un lien symbolique dans site enabled
++Then create a symbolic link in sites-enabled
  {{code language="shell"}}
  sudo ln -s  /etc/nginx/sites-available/001-digdash.conf /etc/nginx/sites-enabled/001-digdash.conf
  {{/code}}
--Créer le fichier digdash_ssl_params contenant la politique de securité.
++Create the digdash_ssl_params file containing the security policy:
  {{code language="shell"}}
  sudo vi digdash_ssl_params
@@ -917,11 +917,11 @@
  add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains; preload' always;
  {{/code}}
--= (% id="cke_bm_868S" style="display:none" %) (%%)Configuration DigDash après installation =
++= (% id="cke_bm_868S" style="display:none" %) (%%)Configuring DigDash after installation =
--== Lancement de Digdash ==
++== Starting Digdash ==
--1. Redémarrer le service Tomcat.
++1. Restart Tomcat service.
  {{code language="shell"}}
  sudo service tomcat9 restart
@@ -928,81 +928,81 @@
  {{/code}}
  (% start="2" %)
--1. Vérifier le déploiement des war dans le dossier d’installation home/digdash/webapps/default.
--1. Accéder à DigDash sur l’adresse suivante : [[__http:~~/~~/localhost:8080/adminconsole__>>url:http://localhost:8080/adminconsole]].
--Le login / mot de passe sera admin / admin.
++1. Check the war deployment in the installation folder home/digdash/webapps/default.
++1. Access DigDash homepage at the following address : [[http:~~/~~/localhost:8080/adminconsole>>url:http://localhost:8080/adminconsole]]
++The login/password is admin/admin.
--[[image:Homepage2023R2.png||alt="Page_accueil"]]
++== Connecting Digdash to the installed OpenDJ server ==
--== Branchement de Digdash au serveur OpenDJ installé ==
++Open [[http:~~/~~/localhost:8080/adminconsole/>>url:http://localhost:8080/adminconsole/]], **Configuration -> Server settings -> Servers -> LDAP Server**.
-- Aller dans **Configuration -> Paramètres serveur-> Serveurs -> LDAP**.
++* Port:  389
++* User: uid=admin, ou=default,dc=digdash,dc=com
++* Password: OpenDJ admin password
--* Port :  389
--* Utilisateur : uid=admin, ou=default,dc=digdash,dc=com
--* Mot de passe : mot de passe admin de OpenDJ
++[[image:LDAPserver_ok.png||alt="LDAP server"]]
--[[image:1675171192455-197.png]]
++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.
--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.
++[[image:LDAPqueries_ok.png||alt="LDAP queries"]]
--[[image:1675171204379-473.png]]
++== Changing the supervisor password and creating the LDAP account ==
--== Modification du mot de passe superviseur et création du compte LDAP ==
++=== Changing the supervisor password ===
--=== Modification du mot de passe superviseur ===
++Open **Configuration  -> Server settings > Servers -> Enterprise Server **and enter a new password in the **Supervisor Password** field.
--Aller dans **Configuration  -> Paramètres serveur > Serveurs -> Serveur Enterprise** et entrer un nouveau mot de passe dans le champ **Mot de passe du Superviseur**.
++[[image:EnterpriseServer.png||alt="Supervisor password"]]
--[[image:Serveur_enterprise.png||alt="Serveur enterprise"]]
++=== Creating the LDAP account ===
--=== Création du compte LDAP ===
++1. Open **Configuration -> User management -> Users**.
++1. Create a new admin user and assign him all roles and authorizations groups.
++1. In the **Password** field, enter the new supervisor password defined above.
--1. Aller dans **Configuration -> Gestion des utilisateurs -> Utilisateurs**.
--1. Créer un nouvel utilisateur admin et lui attribuer tous les rôles et groupes d'autorisation.
--1. Dans le champ **Mot de passe**, entrer le nouveau mot de passe du superviseur défini ci-dessus.
++[[image:User_password.png||alt="User password"]]
--[[image:MdP_LDAP.png||alt="Compte LDAP"]]
++== Database configuration ==
--== Configuration des bases de données ==
++=== Audit data database ===
--=== Base de données Données d'audit ===
++Open **Configuration -> Server settings -> Databases -> Audit data **and enter the URL, user and password.
--(% class="wikigeneratedid" id="HAllerdansConfiguration-3EParamE8tresserveur-3ECommentairesetrenseignericil2019URL2Cl2019utilisateuretlemotdepasse." style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %)
--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.
--
--(% class="wikigeneratedid" style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %)
  **URL **: //jdbc:mariadb:~/~/localhost:3306/default_ddaudit//
--Cette solution permet de sécuriser l’accès à la base de données d'audit.
++This solution makes it possible to secure access to the audit database.
--[[image:Données_audit.png||alt="Données_audit"]]
++[[image:Audit_data.png||alt="Audit data"]]
--=== Base de données Commentaires ===
++=== Comments database ===
--(% class="wikigeneratedid" id="HAllerdansConfiguration-3EParamE8tresserveur-3ECommentairesetrenseignericil2019URL2Cl2019utilisateuretlemotdepasse." style="line-height: 1.2; margin-top: 13px; margin-bottom: 13px; text-align: justify;" %)
--Aller dans **Configuration -> Paramètres serveur -> Base de données -> Commentaires** et renseigner ici l’URL, l’utilisateur et le mot de passe.
++Open **Configuration -> Server settings -> Databases -> Audit data **and enter the URL, user and password.
--(% class="wikigeneratedid" style="line-height: 1.2; margin-top: 13px; margin-bottom: 13px; text-align: justify;" %)
--**URL** ~:// jdbc:mariadb:~/~/localhost:3306/default_comment//
++**URL** ~:// jdbc:mariadb:~/~/localhost:3306/default_comment//
--Cette solution permet de sécuriser l’accès à la base de données de commentaires.
++This solution makes it possible to secure access to the comment database.
--[[image:Commentaires.png||alt="Commentaires"]]
++[[image:Comments.png||alt="Comments"]]
  (% style="line-height: 1.2; text-indent: 0.153543pt; text-align: justify;" %)
--=== Base de données Saisie de données ===
++=== Data entry database ===
--(% class="wikigeneratedid" id="HAllerdansConfiguration-3EParamE8tresserveur-3ECommentairesetrenseignericil2019URL2Cl2019utilisateuretlemotdepasse." style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %)
--Aller dans **Configuration -> Paramètres serveur -> Base de données -> Saisie des données**.
++Open **Configuration -> Server settings -> Databases -> Data entry **and enter the URL, user and password.
--(% class="wikigeneratedid" style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %)
--Cocher la case **Activer la saisir de données** et sélectionner une base de données dans la liste déroulante.
++Select the **Enable data entry** checkbox and select a database in the drop-down list below.
  (% class="wikigeneratedid" style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %)
--[[image:1698407220646-676.png||alt="Saisie données"]]
++[[image:Data_entry.png]]
  (% class="wikigeneratedid" style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %)
--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.
--Entrer default.user.ddentry pour l'utilisateur et le mot de passe défini à l'étape précédente.
--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.
++You must first have created a connection to the database from the Data connection manager in the Studio.
++Enter default.user.ddentry for the user and password defined in the previous step.
++The name defined in the **Login Name** field is the one that will appear in the database selection drop-down list.
++
++== DigDash Services ==
++
++Open the Server status page : [[__http:~~/~~/localhost:8080/ddenterpriseapi/serverstatus?adminDomain=adminconsole&serverDomain=ddenterpriseapi__>>url:http://localhost:8080/ddenterpriseapi/serverstatus?adminDomain=adminconsole&serverDomain=ddenterpriseapi]]
++
++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.
++
++[[image:Server_status.png||alt="Server status"]]

Changes for page Guide d'installation Linux

Summary

Details

Sommaire