...

• Apogée (pour la synchro/récupération des étudiants en situation de handicap)
• Esup-signature (pour la signature des aménagements)

Création d'un utilisateur pour compiler et lancer l'application

adduser esup

Récupération des sources

cd /opt/
git clone https://github.com/EsupPortail/esup-agape.git
sudo chown esup:esup esup-agape
/ -R
cd esup-agape

Configuration

PosgreSQL

Installation

Exemple sous debian :

apt install postgresql

...

Création de la base

su postgressu postgres
psql
create database esupsignatureesupagape;
create USER esupsignatureesupagape with password password 'esup';
grant ALL ON DATABASE esupsignatureesupagape to esupsignatureesupagape;

Esup-Agape

La configuration s’effectue dans le fichier `src/main/resources/application.yml`properties`.

Voici un exemple de configuration :

...

Afin de publier esup-agape de manière securisée, il est possible de mettre un frontal Apache à l'aide du module mod_proxy.

Pour ce faire, installer apache puis activer le mod_proxy, voici . Voici un exemple sous debian :

apt install apache2

a2enmod proxy proxy_http

Voici maintenant un exemple de configuration apache qui va rediriger les requetes requêtes http vers https puis faire proxy vers l'application esup-agape :

<VirtualHost *:80>
    ServerName esup-agape.univ-ville.fr
    ServerAlias esup-agape
    ServerAdmin  system@univ-ville.fr
    ServerSignature Off
 
    RewriteEngine On
    RewriteRule ^(.*) https://esup-agape.univ-ville.fr$1 [L,R]
</VirtualHost>
 
<VirtualHost *:443>
    ServerName esup-agape.univ-ville.fr
    ServerAlias esup-agape
    ServerAdmin  systeme@univ-ville.fr
    ServerSignature Off
 
    SSLEngine on
    SSLCertificateFile /etc/pki/tls/certs/crt
    SSLCertificateKeyFile /etc/pki/tls/private/key
    SSLCertificateChainFile /etc/pki/tls/certs/cacert
    SSLverifyclient none  
 
    ProxyPreserveHost On
 
    ProxyPass / http://localhost:8080/ ttl=10 timeout=3600 loadfactor=100 retry=1
    RequestHeader set "X-Forwarded-Proto" expr=%{REQUEST_SCHEME}
    RequestHeader set "X-Forwarded-SSL" expr=%{HTTPS}
    ProxyPreserveHost On
  </VirtualHost>

Enfin, recharger la configuration Apache :

service apache2 reload

Compilation et lancement

Compilation

Après configuration, dans le dossier du dépôt :

su esup
cd /opt/esup-agape
mvn clean package

Création d'un service

Voici un exemple de configuration de systemd pour chaque "mode" de démarrage d'esup-signature (à mettre un fichier esup-agape.service dans /etc/systemd/system/) :

[Unit]
Description=esup-agape

[Service]
User=esup
Group=esup
Environment=JAVA_OPTS=--add-exports=java.base/sun.security.pkcs=ALL-UNNAMED -Xms1024m -Xmx1024m
WorkingDirectory=/opt/esup-agape
ExecStart=/opt/esup-agape/target/esup-agape.jar

[Install]
WantedBy=multi-user.target

Ajustements après installation

Ajout du trigger pour les larges objects

L'application a été développée avec la fonction de lecture/écriture des blobs dans une transaction par streaming de PostgreSQL. CF https://www.postgresql.org/docs/11/static/lo.html

Pour une bonne gestion des blob blobs de cette application, il faut ajouter dans PostgreSQL un trigger sur la base de données sur la table big_file. La fonction lo_manage est nécessaire ici.

...

su postgres
psql
\c esupsignatureesupagape
CREATE EXTENSION lo;

Enfin, seulement après avoir démarré une première fois esup-signature,  ajout du ajouter le trigger à l'aide du script suivant : 

CREATE TRIGGER t_big_file BEFORE UPDATE OR DELETE ON big_file FOR EACH ROW EXECUTE PROCEDURE lo_manage(binary_file);

Import des tables de correspondances

Les tables de correspondances apogee, sise, ldap doivent être renseignées dans la table postgresql "DataMapping". Voici un premier jeu de données issues de l'instance de l'université de Rouen :

https://github.com/EsupPortail/esup-agape/blob/main/src/main/resources/data_mapping.sql

Il est à ajouter en fonction de vos données. Pour l'instant (vesion 0.0.23-SNAPSHOT), il n'y a pas d'interface admin pour gérer cette table. Pour vous aider, voici une version excel :