Tony CHEMIT pushed to branch develop at ultreiaio / ird-observe Commits: 31b929df by Tony Chemit at 2021-12-17T09:47:50+01:00 Improve server config file - See ultreiaio/ird-observe-toolkit#110 - - - - - 1b900817 by Tony Chemit at 2021-12-17T09:47:50+01:00 add RC artifacts update server doc and changelog update pom review maven scripts - - - - - 14 changed files: - + .mvn/scripts/download-changelog-extra-artifacts.sh - .mvn/scripts/publish-site.sh - CHANGELOG.md - pom.xml - server/configuration-tools/src/test/resources/fixtures-server.yml - server/configuration/src/main/resources/defaultServer.yml - + src/gitlab/milestones/7.0-RC-artifacts.json - + src/gitlab/milestones/8.0-RC-artifacts.json - + src/gitlab/milestones/9.0.0-RC-artifacts.json - src/site/markdown/administration-web.md.vm → src/site/markdown/server-configuration-application-v7.md.vm - + src/site/markdown/server-configuration-application.md.vm - src/site/markdown/install-serverPG.md → src/site/markdown/server-configuration-db.md - + src/site/markdown/server-configuration-security.md - src/site/site_fr.xml Changes: ===================================== .mvn/scripts/download-changelog-extra-artifacts.sh ===================================== @@ -0,0 +1,6 @@ +#!/usr/bin/env bash + +source $(which ultreiaio-common) + +execute_maven "-N -e gitlab:download-extra-artifacts -Dgitlab.verbose -Dplugin.version.gitlab=1.0.20-SNAPSHOT -Dgitlab.milestone=8.0-RC -Dgitlab.versions=8.0-RC-1,8.0-RC-2,8.0-RC-3,8.0-RC-4,8.0-RC-5,8.0-RC-6,8.0-RC-7,8.0.0-RC-8" "Download extract artifacts for v8.0-RC" +execute_maven "-N -e gitlab:download-extra-artifacts -Dgitlab.verbose -Dplugin.version.gitlab=1.0.20-SNAPSHOT -Dgitlab.milestone=9.0.0-RC -Dgitlab.versions=9.0.0-RC-1,9.0.0-RC-2,9.0.0-RC-3,9.0.0-RC-4,9.0.0-RC-5,9.0.0-RC-6,9.0.0-RC-7,9.0.0-RC-8,9.0.0-RC-8.1,9.0.0-RC-9,9.0.0-RC-10,9.0.0-RC-11,9.0.0-RC-12,9.0.0-RC-13,9.0.0-RC-14,9.0.0-RC-15,9.0.0-RC-16,9.0.0-RC-17,9.0.0-RC-18,9.0.0-RC-19,9.0.0-RC-20,9.0.0-RC-21,9.0.0-RC-22,9.0.0-RC-23" "Download extract artifacts for v9.0.0-RC" ===================================== .mvn/scripts/publish-site.sh ===================================== @@ -2,11 +2,6 @@ source $(which ultreiaio-common) -declare -l PROJECT -get_project_id PROJECT +execute_maven "-N -Pupdate-site-versions" "Update site versions" -create_log_dir "${PROJECT}" - -execute_maven "-N -Pupdate-site-versions" "Update site versions" "site-update-versions" - -execute_maven "scm-publish:publish-scm" "Publish site" "site-publish" +execute_maven "scm-publish:publish-scm" "Publish site" ===================================== CHANGELOG.md ===================================== The diff for this file was not included because it is too large. ===================================== pom.xml ===================================== @@ -23,7 +23,7 @@ <parent> <groupId>io.ultreia.maven</groupId> <artifactId>pom</artifactId> - <version>2021.156</version> + <version>2021.157</version> </parent> <groupId>fr.ird.observe</groupId> <artifactId>ird-observe</artifactId> @@ -156,7 +156,7 @@ <!-- build timestamp configuration --> <maven.build.timestamp.format>dd/MM/yyyy HH:mm z</maven.build.timestamp.format> <buildDate>${maven.build.timestamp}</buildDate> - <lib.version.toolkit>5.0.63</lib.version.toolkit> + <lib.version.toolkit>5.0.64-SNAPSHOT</lib.version.toolkit> <lib.version.ognl>3.1.29</lib.version.ognl> <!--can't use 1.4.197 (date has changed + blob also)--> <lib.version.h2>1.4.196</lib.version.h2> @@ -1173,6 +1173,22 @@ <name>Serveur</name> <type>war</type> </releaseArtifact> + <releaseArtifact> + <flatLayout>true</flatLayout> + <groupId>fr.ird.observe</groupId> + <artifactId>observe</artifactId> + <classifier>doc</classifier> + <name>Serveur documentation</name> + <type>zip</type> + </releaseArtifact> + <releaseArtifact> + <flatLayout>true</flatLayout> + <groupId>fr.ird.observe</groupId> + <artifactId>observe</artifactId> + <classifier>server-configuration-tools</classifier> + <name>Serveur configuration tools</name> + <type>zip</type> + </releaseArtifact> </releaseArtifacts> </configuration> </plugin> ===================================== server/configuration-tools/src/test/resources/fixtures-server.yml ===================================== @@ -1,22 +1,16 @@ roles: - &role-admin - login: admin password: passwordAdmin - &role-technicien - login: technicien password: passwordTechnicien - &role-utilisateur - login: utilisateur password: passwordUtilisateur - &role-referentiel - login: referentiel password: passwordReferentiel - &role-test - login: test password: passwordTest databases: - &db-production - name: production url: jdbc:postgresql://localhost:5432/production defaultDatabase: true roles: @@ -25,7 +19,6 @@ databases: - *role-utilisateur - *role-referentiel - &db-test - name: test url: jdbc:postgresql://localhost:5432/test roles: - *role-admin ===================================== server/configuration/src/main/resources/defaultServer.yml ===================================== @@ -1,19 +1,14 @@ roles: - &role-admin - login: admin password: a - &role-technicien - login: technicien password: a - &role-referentiel - login: referentiel password: a - &role-test - login: test password: a databases: - &db-production - name: production url: jdbc:postgresql://localhost:5432/obstuna-production defaultDatabase: true roles: @@ -21,7 +16,6 @@ databases: - *role-technicien - *role-referentiel - &db-test - name: test url: jdbc:postgresql://localhost:5432/obstuna-test roles: - *role-admin ===================================== src/gitlab/milestones/7.0-RC-artifacts.json ===================================== @@ -0,0 +1 @@ +[] \ No newline at end of file ===================================== src/gitlab/milestones/8.0-RC-artifacts.json ===================================== @@ -0,0 +1,82 @@ +[ + { + "name": "Application", + "filename": "observe-8.0.0-RC-8.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/8.0.0-RC-8/observe-8.0..." + }, + { + "name": "Serveur", + "filename": "observe-8.0.0-RC-8.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/8.0.0-RC-8/observe-8.0..." + }, + { + "name": "Application", + "filename": "observe-8.0-RC-7.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/8.0-RC-7/observe-8.0-R..." + }, + { + "name": "Serveur", + "filename": "observe-8.0-RC-7.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/8.0-RC-7/observe-8.0-R..." + }, + { + "name": "Application", + "filename": "observe-8.0-RC-6.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/8.0-RC-6/observe-8.0-R..." + }, + { + "name": "Serveur", + "filename": "observe-8.0-RC-6.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/8.0-RC-6/observe-8.0-R..." + }, + { + "name": "Application", + "filename": "observe-8.0-RC-5.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/8.0-RC-5/observe-8.0-R..." + }, + { + "name": "Serveur", + "filename": "observe-8.0-RC-5.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/8.0-RC-5/observe-8.0-R..." + }, + { + "name": "Application", + "filename": "observe-8.0-RC-4.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/8.0-RC-4/observe-8.0-R..." + }, + { + "name": "Serveur", + "filename": "observe-8.0-RC-4.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/8.0-RC-4/observe-8.0-R..." + }, + { + "name": "Application", + "filename": "observe-8.0-RC-3.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/8.0-RC-3/observe-8.0-R..." + }, + { + "name": "Serveur", + "filename": "observe-8.0-RC-3.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/8.0-RC-3/observe-8.0-R..." + }, + { + "name": "Application", + "filename": "observe-8.0-RC-2.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/8.0-RC-2/observe-8.0-R..." + }, + { + "name": "Serveur", + "filename": "observe-8.0-RC-2.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/8.0-RC-2/observe-8.0-R..." + }, + { + "name": "Application", + "filename": "observe-8.0-RC-1.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/8.0-RC-1/observe-8.0-R..." + }, + { + "name": "Serveur", + "filename": "observe-8.0-RC-1.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/8.0-RC-1/observe-8.0-R..." + } +] \ No newline at end of file ===================================== src/gitlab/milestones/9.0.0-RC-artifacts.json ===================================== @@ -0,0 +1,337 @@ +[ + { + "name": "Application", + "filename": "observe-9.0.0-RC-22.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-22/observe-9...." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-22.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-22/observe-9...." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-22-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-22/observe-9...." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-21.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-21/observe-9...." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-21.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-21/observe-9...." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-21-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-21/observe-9...." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-20.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-20/observe-9...." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-20.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-20/observe-9...." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-20-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-20/observe-9...." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-19.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-19/observe-9...." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-19.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-19/observe-9...." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-19-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-19/observe-9...." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-18.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-18/observe-9...." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-18.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-18/observe-9...." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-18-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-18/observe-9...." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-17.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-17/observe-9...." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-17.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-17/observe-9...." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-17-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-17/observe-9...." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-16.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-16/observe-9...." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-16.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-16/observe-9...." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-16-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-16/observe-9...." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-15.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-15/observe-9...." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-15.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-15/observe-9...." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-15-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-15/observe-9...." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-14.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-14/observe-9...." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-14.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-14/observe-9...." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-14-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-14/observe-9...." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-13.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-13/observe-9...." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-13.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-13/observe-9...." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-13-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-13/observe-9...." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-12.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-12/observe-9...." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-12.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-12/observe-9...." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-12-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-12/observe-9...." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-11.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-11/observe-9...." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-11.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-11/observe-9...." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-11-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-11/observe-9...." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-10.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-10/observe-9...." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-10.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-10/observe-9...." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-10-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-10/observe-9...." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-9.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-9/observe-9.0..." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-9.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-9/observe-9.0..." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-9-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-9/observe-9.0..." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-8.1.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-8.1/observe-9..." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-8.1.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-8.1/observe-9..." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-8.1-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-8.1/observe-9..." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-8.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-8/observe-9.0..." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-8.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-8/observe-9.0..." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-8-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-8/observe-9.0..." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-7.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-7/observe-9.0..." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-7.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-7/observe-9.0..." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-7-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-7/observe-9.0..." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-6.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-6/observe-9.0..." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-6.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-6/observe-9.0..." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-6-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-6/observe-9.0..." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-5.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-5/observe-9.0..." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-5.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-5/observe-9.0..." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-5-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-5/observe-9.0..." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-4.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-4/observe-9.0..." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-4.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-4/observe-9.0..." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-4-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-4/observe-9.0..." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-3.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-3/observe-9.0..." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-3.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-3/observe-9.0..." + }, + { + "name": "Serveur documentation", + "filename": "observe-9.0.0-RC-3-doc.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-3/observe-9.0..." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-2.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-2/observe-9.0..." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-2.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-2/observe-9.0..." + }, + { + "name": "Application", + "filename": "observe-9.0.0-RC-1.zip", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-1/observe-9.0..." + }, + { + "name": "Serveur", + "filename": "observe-9.0.0-RC-1.war", + "url": "https://repo1.maven.org/maven2/fr/ird/observe/observe/9.0.0-RC-1/observe-9.0..." + } +] \ No newline at end of file ===================================== src/site/markdown/administration-web.md.vm → src/site/markdown/server-configuration-application-v7.md.vm ===================================== ===================================== src/site/markdown/server-configuration-application.md.vm ===================================== @@ -0,0 +1,167 @@ +# Installation de l'application web + +L'application web est une application web classique à installer dans un conteneur web (tomcat). + +Ce document explique comment installer et configurer l'application. + +Avant de déployer l'application il faut tout d'abord préparer sa configuration. + +**Contrairement à la v7, le démarrage d'une instance de la v9 ne sera pas possible que si tout est bien configurer.** + +## Configuration de l'application web + +On distingue trois fichiers de configuration : + + 1. le fichier de configuration de l'application + 2. le fichier de configuration de la sécurité d'une instance + 3. le fichier de configuration des logs d'une instance + +## Configuration communes + +La v9 introduit la notion de configurations communes. + +Il s'agit de stoquer dans un répertoire adapté les différentes configurations utilisables pour plusieurs instances. + +On y regroupe ici que les fichiers de configuration de la sécurité d'une instance. + +## Fichier de configuration de l'application + +Comme en version 7, la configuration de l'application web est regroupé dans un seul fichier dont l'emplacement est + +``` + /etc/observe-server.conf +``` + +Ce fichier est commun à toutes les instances (que ce soit du v7 ou du v9). + +La configuration de l'application possède des valeurs par défaut pour toutes les options, si vous utiliser ces valeurs par défaut, un minimum de configuration est requise. + +Une seule option doit être modifiée : + + - **instance.security.key** : la clef à utiliser pour accéder aux services d'administration + +Consulter la [page des configurations](./ServerConfig.html) pour connaitre l'ensemble des options de cette configuration. + +## Fichiers de configuration de la sécurité d'une instance + +En v7, on utilisait deux fichiers pour définir les accès à l'application (**databases.yml** et **users.yml**). + +Ses fichiers doivent etre placé dans + +``` + /etc/observe-server/7.x/databases.yml + /etc/observe-server/7.x/users.yml +``` + +En v9, on utilise un seul fichier qui regroupe les deux fichiers de la v7 (**server.yml**). + +Son emplacement par défaut est +``` + /etc/observe-server/9.x/server.yml +``` + +### Format du fichier + +Voir [page de configuration de la sécurité](./server-security-configuration.html). + +# Répertoire de travail des instances + +Par défaut, l'application utilise le répertoire **/var/local/observe-server** pour y stoquer ses données. + +**Attention en v7 le répertoire était** : **/var/local/observeweb**. + +Pour chaque instance, on utilise le **contextPath** du *war* pour définir le répertoire de l'instance. + +Par exemple, si on a déployé l'application web sur **demo**, on aura un répertoire +``` +/var/local/observe-server/demo +``` + +composé de deux sous-répertoires **conf** et **resources**. + +Le répertoire **conf** contient les fichiers de configurations spécifiques à l'instance en plus du fichier de configuration +global : + * le fichier de définition de la sécurité déjà évoqué plus haut + * le fichier de configuration des logs + +Le répertoire **resources** contient les *logs* et **fichiers temporaires* de l'instance. + +Au démarrage de l'instance, + + 1. on crée les répertoires nécessaires + 2. on génére si besoin le fichier de configuration des logs. + 3. pour le fichier de la sécurité on procède ainsi + + * si le fichier existe, rien à faire + * si le fichier **/etc/observe-server/9.x/server.yml** existe, on crée un lien symbolique sur ce fichier + * sinon l'application génère un fichier exemple + +Par exemple si on a ces fichiers de configuration par défaut + +``` +/etc/observe-server +├── 7.x +│ ├── databases.yml +│ └── users.yml +├── 9.x +│ └── server.yml +``` +Voici le contenu de ce dossier suite à un premier démarrage : + +``` +/var/local/observe-server/demo/ +├── conf +│ ├── observe-server-log4j2.xml +│ └── server.yml -> /etc/observe-server/9.x/server.yml +└── resources + ├── log + │ └── observe-server-${project.version}.log + └── temp +``` + +## Configuration sous Windows + +Le fichier de configuration peut être placé dans le répertoire racine du tomcat. + +Attention, à bien penser à échapper les <<\>> par des <<\\>> dans les options de répertoires. + +Par exemple : + +``` + observeweb.adminApiKey=a + observeweb.baseDirectory=C:\\var\\local\\observeweb + observeweb.sessionExpirationDelay=90 +``` + +## Tester l'application + +Par défaut, l'application est déployée à l'adresse suivante : +``` + http://localhost:8080/observeweb/index.html?adminApiKey=change +``` + +Vous arrivez sur une page avec les différentes ressources disponibles de l'application. + +Si vous arrivez sur cette page, l'application est fonctionnelle. + +**Note :** + +Le fait d'ajouter le paramètre **adminapiKey** va le transmettre aux urls qui en ont besoin. + +## Configuration Apache + +Par défaut le proxy_ajp a un timeout de 5 minutes, il faut augmenter cette valeur sinon les appels dépassant ce temps +seront rejetées. + +Dans le fichier de configuration ``httpd.conf`` ajouter la ligne : (timeout de 3600 secondes = 60 minutes) +``` +ProxyTimeout 3600 +``` + +Une solution alternative meilleure (car non globale à l'instance de tomcat et surtout qui ne modifie pas les +configurations systèmes) est d'ajouter dans le host apache : + +``` + ProxyPass / ajp://localhost:8009/ timeout=3600 + ProxyPassReverse / ajp://localhost:8009/ timeout=3600 +``` \ No newline at end of file ===================================== src/site/markdown/install-serverPG.md → src/site/markdown/server-configuration-db.md ===================================== ===================================== src/site/markdown/server-configuration-security.md ===================================== @@ -0,0 +1,203 @@ +## Fichiers de configuration de la sécurité + +En v7, on utilisait deux fichiers pour définir les accès à l'application (**databases.yml** et **users.yml**). + +Ses fichiers doivent etre placé dans + +``` + /etc/observe-server/7.x/databases.yml + /etc/observe-server/7.x/users.yml +``` + +En v9, on utilise un seul fichier qui regroupe les deux fichiers de la v7 (**server.yml**). + +Son emplacement par défaut est +``` + /etc/observe-server/9.x/server.yml +``` + +Ce fichier utilise la notion de références ou *ancres* pour éviter de répéter des données, +cela permet aussi une validation syntaxique accrue. + +## Migration v7 → v9 + +Il existe un utilitaire fourni qui effectuer les migrations. + +Consulter la [section des téléchargements (fichier observe-*-server-configuration-tools.zip)](./CHANGELOG.html). + +À télécharger sur le serveur. + +### Format du fichier + +Le fichier **server.yml** est de cette forme : + +``` +roles: -- pour définir les utilisateurs des bases de données +... +databases: -- pour définir les bases de données (se sert de roles) +... +users: -- pour définir les utilisateurs de l'application (se sert de roles et databases) +``` + +### Définir un role + +Un **role** représente un compte pour accéder à une base de données. + +Sa définition est + * un login + * un mot de passe + +Le login est représenté comme une *ancre* dans le format *yaml*. + +Par convention, on préfixe toujours celui-ci par **role-**. + +#### Exemple + +Pour définir un utilisateur **admin** avec un mot de passe **a**, on écrit +```yaml +roles: + - &role-admin + password: a +``` + +### Définir une base de donnée + +Un **database** représente une base de données. + +Sa définition est + * un nom + * une url + * (optionel) est-ce la base par défaut de l'application ? + * des roles associés à cette base + +Le nom est représenté comme une *ancre* dans le format *yaml*. + +Par convention, on préfixe toujours celui-ci par **db-**. + +#### Exemple + +Pour définir une dabase de donnée **production**, on écrit +```yaml +roles: + - &role-admin + password: a +databases: + - &db-production + url: jdbc:postgresql://localhost:5432/obstuna-production + defaultDatabase: true + roles: + - *role-admin +``` + +### Définir un utilisateur + +Un **user** représente un utilisateur de l'application web. + +En v9 les utilisateurs ont été enrichis de deux nouvelles propriétés : + * **apiAccess** le type d'accès aux API dont les valeurs sont : + * **CLIENT** pour avoir accès uniquement aux API du client lourd, + * **PUBLIC** pour avoir accès uniquement aux API public, + * **ALL** pour avoir accès aux deux + * valeur par défaut **CLIENT** + * **validationMode** le mode de validation dont les valeurs sont : + * **STRONG** pour utiliser une validation forte + * **PERMISSIVE** pour utiliser une validation souple + * **NONE** pour ne pas utiliser de validation + * valeur par défaut **STRONG** + +Toujours en v9, on ajoute au niveau de l'utilisateur des valeurs par défaut qui seront utilisées +pour toute permission ne définissant pas cette valeur. + +Un utilisateur possède : + * un login + * un mot de passe + * (optionel) une référence sur le role par défaut + * (optionel) un type d'accès aux API par défaut + * (optionel) un mode de validation par défaut + * des permissions + +Une permission possède : + * une référence sur une base de données + * (optionel) une référence sur un role de base de données + * (optionel) un type d'accès aux API + * (optionel) un mode de validation + +#### Exemple + +```yaml +roles: + - &role-admin + password: a +databases: + - &db-production + url: jdbc:postgresql://localhost:5432/obstuna-production + defaultDatabase: true + roles: + - *role-admin +users: + - login: utilisateur-admin + password: a + permissions: + - database: *db-production + role: *role-admin + apiAccess: ALL + validationMode: STRONG +``` + +Voici un exemple plus complexe qui utilise les valeurs par défaut : + +```yaml +roles: + - &role-admin + password: a +databases: + - &db-production + url: jdbc:postgresql://localhost:5432/obstuna-production + defaultDatabase: true + roles: + - *role-admin + - &db-test + url: jdbc:postgresql://localhost:5432/obstuna-test + roles: + - *role-admin +users: + - login: utilisateur-admin + password: a + defaultRole: *role-admin + defaultApiAccess: ALL + defaultValidationMode: STRONG + permissions: + - database: *db-production + - database: *db-test + validationMode: PERMISSIVE +``` + +Cette exemple équivant à cet autre : + +```yaml +roles: + - &role-admin + password: a +databases: + - &db-production + url: jdbc:postgresql://localhost:5432/obstuna-production + defaultDatabase: true + roles: + - *role-admin + - &db-test + url: jdbc:postgresql://localhost:5432/obstuna-test + roles: + - *role-admin +users: + - login: utilisateur-admin + password: a + permissions: + - database: *db-production + role: *role-admin + apiAccess: ALL + validationMode: STRONG + - database: *db-test + role: *role-admin + apiAccess: ALL + validationMode: PERMISSIVE +``` ===================================== src/site/site_fr.xml ===================================== @@ -88,10 +88,12 @@ <item name="Synchronisation référentiel avancée" href="./synchro-referential.html"/> </item> <item name="Server"> - <item name="Administration Obstuna" href="install-serverPG.html"/> - <item name="Administration Web" href="administration-web.html"/> - <item name="Configuration" href="./ServerConfig.html"/> - <item name="Configuration (fichier d'exemple)" target="_blank" href="./ServerConfig.properties"/> + <item name="Administration Web v9" href="server-configuration-application.html"/> + <item name="Configuration Sécurité" href="server-configuration-security.html"/> + <item name="Configuration Application" href="./ServerConfig.html"/> + <item name="Configuration Application (fichier d'exemple)" target="_blank" href="./ServerConfig.properties"/> + <item name="Administration Web v7" href="server-configuration-application-v7.html"/> + <item name="Administration Base de données" href="server-configuration-db.html"/> </item> <item name="Historique des versions" href="CHANGELOG.html"/> View it on GitLab: https://gitlab.com/ultreiaio/ird-observe/-/compare/cf6e8021b4f803df8b5665531... -- View it on GitLab: https://gitlab.com/ultreiaio/ird-observe/-/compare/cf6e8021b4f803df8b5665531... You're receiving this email because of your account on gitlab.com.