...
Cette documentation et les procédures qui s'y rapportent sonr en cours de développement et mise au point.
| Sommaire |
|---|
Apports de Grouper 5.x par rapport à la 2.3
...
Si la documentation officielle recommande très fortement l'usage de docker (et docker-compose) pour installer un Grouper dans un environnement fonctionnel, nous proposons ici de partir des sources, en prenant en compte une ou 2 modifications réalisées sur le fork ESUP.
Si l'usage de docker est certainement appréciable, on préfère ici être proche des sources et éviter d'utiliser un docker utilisant lui-même la distribution centos dont la fin de vie est maintenant dépassée.
On n'a aucun doute sur le fait que les prochaines versions seront proposées sur une distribution linux supportée par une communauté.
Environnement technique
On utilise une debian bookworm avec :
...
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
cd /opt git clone https://github.com/EsupPortail/grouper-esup.git cd /opt/grouper-esup git checkout -b grouper-esup-5 origin/grouper-esup-5 |
Compilation
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
cd /opt/grouper-esup/grouper-parent
mvn clean install |
Pour que gsh fonctionne il faut également forcer la récupérer des dépendances ainsi :
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
cd /opt/grouper-esup/grouper
mvn dependency:copy-dependencies |
Apache, mod_shib, Postgresql, Tomcat, ...
L'installation de ces différents composants ne change pas vraiment par rapport à la version 2.3, notons simplements quelques points :
- Côté Tomcat, on modifiera le server.xml pour définir le contexte /grouper ainsi :
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
<Context docBase="/opt/grouper-esup/grouper-misc/webapp/grouper-ui-webapp/target/grouper-ui-webapp-5.0.0-SNAPSHOT.war" path="/grouper" reloadable="false"/> |
Récupération des données et configurations de l'installation de Grouper 2.3
Configurations :
Vous pouvez récupérer l'essentiel de vos configurations via simples copies des fichiers properties donnés dans le répertoire grouper/conf
Pour la partie PSP (fichiers XML) qui n'est plus nécessaire, voir ci-après.
Il faudra cependant fournir un fichier subject.properties en conséquence.
Dans le fork esup, nous proposons ces fichiers d'exemple à modifier pour s'adapter à votre ldap notamment :
- grouper/conf/grouper-loader.properties
- grouper/conf/grouper.hibernate.properties
- grouper/conf/grouper.properties
- grouper/conf/morphString.properties
- grouper/conf/subject.properties
Base de données
Un dump et restore postgresql de la base grouper doit pouvoire fonctionner.
Voir ci-après pour la mise à jour via DDL.
GSH
On pourra lancer gsh ainsi (le répertoire de lancement est important, la récupération des dépendances, cf ci-dessous, est requise) :
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
cd /opt/grouper-esup/
./grouper/bin/gsh.sh |
Grouper Daemon
Avec un gsh fonctionnel on pourra lancer le grouper dameon via un systemd ainsi configuré - fichier /etc/systemd/system/grouper-loader-daemon.service
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
# Systemd unit file for grouper-loader-daemon
[Unit]
Description=Synchro incrementale grouperloader (bases de données) vers grouper
After=syslog.target network.target
[Service]
EnvironmentFile=/opt/grouper-env
ExecStart=/opt/grouper-esup/grouper/bin/grouper-loader-daemon
User=grouper
Group=grouper
[Install]
WantedBy=multi-user.target |
Mise à jour de la base de données
Une fois le tomcat et le grouper daemon lancé, la mise à jour de la base de données se fait via l'interface web.