-
Notifications
You must be signed in to change notification settings - Fork 4
Instructions d'installation v 5.x
Ces instructions décrivent comment installer l'observatoire des démarches, versions 5.x. Des paragraphes spécifiques sont dédiés aux opérations de mise à jour depuis la version 4.10. Ces instructions sont construites pour être utilisées pour une mise à jour de la version 4.x.
Ce projet tourne sur la plateforme XWiki, version 9.11.3, avec modifications - voir http://www.xwiki.org/ .
Pour produire les artefacts de ce projet utilisés dans les instructions ci-dessous, utiliser la commande
mvn clean install
après avoir installé et configuré maven
tel que décrit dans http://dev.xwiki.org/xwiki/bin/view/Community/Building/#HInstallingMaven .
- Utiliser le war XWiki Standard 9.11.3 de http://maven.xwiki.org/releases/org/xwiki/platform/xwiki-platform-web/9.11.3/;
- Configurer tel que décrit dans les instructions XWiki https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Installation/InstallationWAR/ , sur tomcat, avec une base de données Mysql et un serveur front-end apache httpd.
Les configurations spécifiques suivantes sont à faire pour l'observatoire:
- le war XWiki doit être déployé dans le contexte
ROOT
au lieu dexwiki
(danswebapps/ROOT
au lieu dewebapps/xwiki
) - copier
xwiki.cfg
,xwiki.properties
eturlrewrite.xml
from the sources from web/src/main/webapp/WEB-INF dans le répertoireWEB-INF
de l'installation. Faire les configurations suivantes:- dans
xwiki.cfg
:- mettre des valeurs aléatoires dans
xwiki.authentication.validationKey
etxwiki.authentication.encryptionKey
- mettre des valeurs aléatoires dans
- dans
xwiki.properties
:- mettre la valeur du serveur courant dans
environment.permanentDirectory
- mettre la valeur du serveur courant dans
openoffice.homePath
- mettre le token d'API pingdom obtenu depuis (https://www.pingdom.com/ ) dans
pingdom.apitoken
.
- mettre la valeur du serveur courant dans
- dans
- Installer
xwiki-platform-legacy-oldcore-DINSICDEMA9.11.3-5ac27ae16a240b3e43376195312e34076dfe9ae4.jar
ainsi:- copier le fichier du répértoire bin des sources
- coller ce fichier dans le répértoire
WEB-INF/lib
du war installé - supprimer le fichier
xwiki-platform-legacy-oldcore-9.11.3.jar
de ce répértoire (ou une autre version ancienne de ce fichier)
- Installer
xwiki-platform-search-solr-api-DINSICDEMA9.11.3-45ad9b0e084d555ea5dc1361eb7edb41d61e30d0.jar
ainsi:- copier le fichier du répértoire bin des sources
- coller ce fichier dans le répértoire
WEB-INF/lib
du war installé - supprimer le fichier
xwiki-platorm-search-solr-api-9.11.3.jar
de ce répértoire (ou une autre version ancienne de ce fichier)
- Installer le correctif pour XCOMMONS-1151 ainsi:
- télécharger le fichier http://maven.xwiki.org/releases/org/xwiki/platform/xwiki-platform-rendering-macro-script/9.11.8/xwiki-platform-rendering-macro-script-9.11.8.jar
- copier le fichier dans le répértoire
WEB-INF/lib
du war installé - supprimer le fichier
xwiki-platform-rendering-macro-script-9.11.3.jar
de ce répértoire (ou une autre version ancienne de ce fichier) - télécharger le fichier https://repo1.maven.org/maven2/org/codehaus/groovy/groovy-all/2.4.13/groovy-all-2.4.13.jar
- copier le fichier dans le répértoire
WEB-INF/lib
du war installé - supprimer le fichier
groovy-all-2.4.7
de ce répértoire
- Installer le correctif pour XWIKI-16960 ainsi:
- copier le fichier
xwiki-platform-dashboard-macro-9.11.8-XWIKI-14247-1321d264e4cc2da38c395ad46d3ff2cc388d0dbb.jar
du répértoire bin des sources - coller ce fichier dans le répértoire
WEB-INF/lib
du war installé - supprimer le fichier
xwiki-platform-dashboard-macro-9.11.3.jar
de ce répértoire (ou une autre version ancienne de ce fichier)
- copier le fichier
- Installer le fichier [xwiki-dinsic-wikidemarches-extensions-]tools-api-.jar (compilé à partir du module extensions/tools-api), dans le répértoire
WEB-INF/lib
du war installé- supprimer une version ancienne de ce fichier si elle est présente
- Installer le plugin Excel dans le répértoire
WEB-INF/lib
du war installé ainsi:- télécharger le fichier http://maven.xwiki.org/releases/org/xwiki/contrib/xwiki-plugin-excel/1.1/xwiki-plugin-excel-1.1.jar et le copier dans le répértoire
WEB-INF/lib
- télécharger le fichier from https://repo1.maven.org/maven2/net/sourceforge/jexcelapi/jxl/2.6.12/jxl-2.6.12.jar et le copier dans le répértoire
WEB-INF/lib
- ajouter
,com.xpn.xwiki.plugin.excel.ExcelPlugin
à la fin de la valeur de la propriétéxwiki.plugins
dansxwiki.cfg
- télécharger le fichier http://maven.xwiki.org/releases/org/xwiki/contrib/xwiki-plugin-excel/1.1/xwiki-plugin-excel-1.1.jar et le copier dans le répértoire
- Installer les ressources DSFR & et les ressources statiques du projet:
- télécharger les répértoires
dsfr-scoped
etcustom-wikidemarches
du répértoireweb/src/main/webapp/uicomponents/
des sources du projet - copier ces 2 répértoires dans le répértoire
resources/uicomponents
du war installé - si les répértoires sont déjà présents, les vider ou les supprimer avant de les remplacer avec les nouveaux.
- télécharger les répértoires
- Configurer le fichier robots-public.txt pour être servi par Apache en tant que
robots.txt
sur la racine - La configuration Apache doit inclure les configurations suivantes:
- servir
observatoire.numerique.gouv.fr
, avec les aliasjedonnemonavis.numerique.gouv.fr
etcerfa.numerique.gouv.fr
, ainsi que les anciens nomsnosdemarches.gouv.fr
,monavis.numerique.gouv.fr
etvoxusagers.numerique.gouv.fr
. - inclure la configuration de redirection ci-dessous:
- servir
RewriteEngine On
# Backwards compat: All nosdemarches redirects to monavis
RewriteCond %{HTTP_HOST} "nosdemarches.gouv.fr"
RewriteRule ^/(.*)$ https://monavis.numerique.gouv.fr/$1 [R,L,NE]
# Backwards compat: All voxusagers redirects to jedonnemonavis
RewriteCond %{HTTP_HOST} "voxusagers.numerique.gouv.fr"
RewriteRule ^/(.*)$ https://jedonnemonavis.numerique.gouv.fr/$1 [R,L,NE]
# Jedonnemonavis homepage and login redirect to observatoire
RewriteCond %{HTTP_HOST} "jedonnemonavis.numerique.gouv.fr"
RewriteRule ^/$ https://observatoire.numerique.gouv.fr/ [R,L,NE]
RewriteCond %{HTTP_HOST} "jedonnemonavis.numerique.gouv.fr"
RewriteRule ^/login(.*) https://observatoire.numerique.gouv.fr/ [R,L,NE]
# Backwards compat for button ressources: Legacy monavis URLs: all view-mode=formulaire-avis go to jedonnemonavis
RewriteCond %{HTTP_HOST} "^monavis.numerique.gouv.fr$"
RewriteCond %{QUERY_STRING} view-mode=formulaire-avis
RewriteRule ^/(.*)$ https://jedonnemonavis.numerique.gouv.fr/$1 [R,L,NE]
# Backwards compat for button ressources: Legacy nosdemarches URLs avis form URLs but which don't contain view-mode=formulaire-avis but contain nd_mode (and will also contain nd_source in practice) go to jedonnemonavis
RewriteCond %{HTTP_HOST} "^monavis.numerique.gouv.fr$"
RewriteCond %{QUERY_STRING} nd_mode
RewriteRule ^/(.*)$ https://jedonnemonavis.numerique.gouv.fr/$1 [R,L,NE]
# Backwards compat for button ressources: all static ressources of monavis are now jedonnemonavis ressources, with the new static ressources path
RewriteCond %{HTTP_HOST} "^monavis.numerique.gouv.fr$"
RewriteRule ^/monavis-static/(.*)$ https://jedonnemonavis.numerique.gouv.fr/static/$1 [R,L,NE]
# Backwards compat: all other monavis URLs (which haven't matched above, so they're not button ressources) go to observatoire
RewriteCond %{HTTP_HOST} "^monavis.numerique.gouv.fr$"
RewriteRule ^/(.*)$ https://observatoire.numerique.gouv.fr/$1 [R,L,NE]
# Homepage is displayed as / whichever its actual address is
RewriteRule "^/$" "/bin/view/Main/" [L,PT]
RewriteRule "^/bin/view/Main/$" "/" [L,R]
RewriteRule "^/bin/Main/$" "/" [L,R]
RewriteRule "^/Main/$" "/" [L,R]
# Workaround issue with an accented character being improperly encoded / handled by IE and sent as messed up value
# This workaround can be removed if no requests are coming with the messed up character anymore, since we now encode properly all characters in the URLs and URLs are full ASCII. Check access logs before removing
RewriteCond %{QUERY_STRING} ^nd_source=service-public.fr&nd_mode=en-ligne-enti.rement
RewriteRule "^(.*)$" $1?nd_source=service-public.fr&nd_mode=en-ligne-entièrement [R,L]
Ajouter les éléments suivants à la configuration Apache:
Juste après les configuarations pour ErrorDocument
:
Alias "/static" /var/www/static
À la fin du fichier, avant ProxyPass /
:
ProxyPass /static !
Copier le répértoire static
des sources vers /var/www/static
sur le serveur. Changer le propriétaire du répértoire et sous-répértoires vers l'utilisateur www-data
.
Installer les fichiers maintenance.html
et error.html
(du répértoire maintenance
des sources) comme fichiers à servir par Apache lorsque le tomcat est indisponible. La configuration de ces fichiers au niveau d'apache dépend des éléments spécifiques de l'installation.
Redemarrer le wiki à ce moment et le serveur Apache httpd pour prendre en compte les configurations ci-dessus.
Accéder au wiki à partir du navigateur pour faire les configurations suivantes.
- XWiki Livetable Exporter Macro, version
4.0
(extension id:org.xwiki.contrib:xwiki-livetable-exporter-macro
)- ceci installera également Job Macro et tant que dépendance
- UIN Script Service:
org.xwiki.contrib:api-uin-scriptservice
, version2.0
- Open Sans Font Webjar: En utilisant la recherche avancée, installer l'extension
org.webjars.bower:open-sans
à la version1.1.0
- Query Generator and Query Macro, version
1.4.1
(extension id:org.xwiki.contrib:application-querygenerator
)- modifier les droits de la page Macros.QueryGenerator pour donner le droit 'voir' uniquement au groupe Admin
- AppWithin Minutes Charts and Data, version
1.2.2
(extension id:org.xwiki.contrib:appwithinminutes-charts
) - OpenCSV:
com.opencsv:opencsv
version3.10
- Chart.js Integration (
org.xwiki.contrib:application-chartjs-ui
), version1.5
-
org.webjars:datatables
version1.10.19
-
org.webjars:datatables-fixedheader
version3.1.4
-
org.webjars:requirejs-domready
, version2.0.1-2
-
org.webjars:require-css
, version0.1.7
-
org.xwiki.contrib.membership:application-membership-profile
, version1.0.7
- Matomo Application (
org.xwiki.contrib:application-piwik-extension
), version1.3.1
- JSON Storage API (
org.xwiki.contrib:api-jsonstore
) version1.0
- Help Center Application
1.2
, Sandbox application9.11.3
, Help Application9.11.3
- XWiki Platform - Distribution - Flavor - Tour
9.11.3
:org.xwiki.platform:xwiki-platform-distribution-flavor-tour
- cocher les cases pour supprimer toutes les pages à la dernière étape du processus de désinstallation - Tour Application
1.1
:org.xwiki.contrib:application-tour-ui
- cocher les cases pour supprimer toutes les pages à la dernière étape du processus de désinstallation
- Supprimer la traduction française de la page principale
Main.WebHome
ainsi:- Aller à l'administration du wiki
- Activer l'option multilange, configurer Anglais et Français comme langues disponibles
- Sauvegarder
- Aller à la page d'accueil, en français et changer l'URL manuellement pour y l'action d'effacement et pour y ajouter
?language=fr
à la fin (.../bin/delete/Main/WebHome?language=fr
) - À la question suivante, confirmer la suppréssion en utilisant l'option "Selectionner tout"
- Restaurer la configuration du wiki en monolangue, en français, dans l'administration du wiki
- Importer le paquet
xwiki-dinsic-wikidemarches-wikis-main-<version>.xar
dans le wiki
- Importer le paquet
xwiki-dinsic-wikidemarches-wikis-main-upgrade-<version>.xar
dans le wiki - Supprimer manuellement les pages supprimées des sources depuis la dernière version installée
- Mettre en place manuellement toutes les modifications sur les pages non-upgradable depuis la dernière version installée
- Dans Administration -> Autre -> Piwik, configurer les valeurs suivantes:
- url piwik : l'URL du serveur Matomo qui collectera les données d'audience
- Methode de tracking : tracking par Javascript
- Id du site : l'id obtenu depuis le serveur Matomo configuré à la première étape
- Tracking des utilisateurs : Non
- Tracking multi-domaine : Non
- URL du domaine : laisser vide
Suivre les instructions dédiées: Import des données de l'observatoire v5.x