ESUP STAGE

Prérequis

Les pérequis sont les suivants sur votre serveur :

1. Git
2. Java OpenJdk 11
3. Apache Maven
4. Installation Mariadb
5. Installation du projet Esup-SIscol (sur le même serveur ou sur un serveur dédié)

Clonage du projet

cd /opt
git clone https://github.com/EsupPortail/esup-stage.git

La base de donnée

Création de la base et de l'utilisateur

CREATE DATABASE estage;
CREATE USER 'esupstage_user'@'%' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON estage.* TO 'esupstage_user'@'%';
FLUSH PRIVILEGES;

Import de la base pStage et passage du patch

Si vous n'avez pas de base pStage a reprendre, cette partie est inutile

Pour importer votre base pStage d'une installation en production, vous devez réaliser un dump, ici le fichier :
mysql-pstage-2022-01-25-16h00.sql.gz

Votre dump ne doit pas comporter de CREATE DATABASE ou USE DATABASE

Les commandes suivantes permettent d'importer votre dump (pStage) dans votre base estage (ESUP STAGE) :

zcat /opt/estage/mysql-pstage-2022-01-25-16h00.sql.gz | mysql -u esupstage_user -p estage
cat /opt/estage/src/main/resources/db/changelog/init-changelog.sql | mysql -u esupstage_user -p estage

Modification du fichier de configuration

cd /etc
mkdir estage
cd estage
cp /opt/esup-stage/etc/estage/estage-example.properties estage.properties

Modifier le fichier de configuration

# parametres des URLs pour l'authentication CAS
cas.url.login=https://cas.monuniv.fr/cas/login?service={service}
cas.url.service=https://cas.monuniv.fr/cas/p3/serviceValidate?service={service}&ticket={ticket}&format=json
cas.url.logout=https://cas.monuniv.fr/cas/logout

# parametres base de donnees
appli.datasource.url=jdbc:mariadb://monserversql.monuniv.fr:3306/estage
appli.datasource.username=estage
appli.datasource.password=xxx
appli.datasource.driver=org.mariadb.jdbc.Driver

# url de l'application (notamment utilisée pour envoyer des liens par mail)
appli.url=http://esupstage.monuniv.fr:8080/frontend/#/

# logins des admin technique, séparés par des ; (utilisateurs à créer au 1er lancement pour paramétrer l'application)
appli.admin_technique=xxx;yyy

# identifiant pour l'accès au web services référentiel (cela correspond aux identifiants du WS esup-SIscol)
referentiel.ws.login=root
referentiel.ws.password=xxx
# url du service LDAP
referentiel.ws.ldap_url=https://referentiel.monuniv.fr/ldap
# url du service Apogée
referentiel.ws.apogee_url=https://referentiel.monuniv.fr/apogee

# mailer
appli.mailer.protocol=smtp
appli.mailer.host=smtp.monuniv.fr
appli.mailer.port=25
appli.mailer.auth=true
[email protected]
appli.mailer.password=xxx
[email protected]
appli.mailer.disable_delivery=true
# paramètres pour le développement, par défaut disable_delivery=false, delivery_address=null
# si appli.mailer.disable_delivery=true alors l'envoi de mail est désactivé sinon si false alors l'envoi de mail est activé
[email protected]
# Permet de rediriger les mails vers une adresse mail. Si adresse mail renseignée alors les mails sont redirigés vers cette adresse. Si null alors les mails sont envoyés aux utilisateurs.

# chemin vers le dossier contenant les uploads
# pour les logos des centres de gestion il faut que le dossier ${appli.data_dir}/centregestion/logos soit existant sur le serveur
appli.data_dir=/data_esup_stage

Remarque : il faut que l'utilisateur faisant tourner votre Tomcat puisse avoir les droits en écriture sur le répertoire data_esup_stage

Compilation du projet

cd /opt/esup-stage
mvn -Dmaven.test.skip=true clean package

Déploiement / Lancement de l'application

Après la compilation, le chemin complet du fichier de déploiement est le suivant : /opt/estage/target/ROOT.war

Déploiement TOMCAT

Cette documentation ne va pas décrire l'installation d'un Tomcat. ESUP STAGE a été déployé et testé sur une version TOMCAT 9

Vous pouvez télécharger tomcat ici : https://tomcat.apache.org/download-90.cgi

Nous considérons par exemple le chemin du répertoire tomcat ainsi : /opt/tomcat-esup-stage

Supprimer (ou déplacer une sauvegarde) votre répertoire /opt/tomcat-esup-stage/webapp/ROOT avant le déploiement

Copier directement votre fichier /opt/estage/target/ROOT.war dans votre répertoire webapp de tomcat

cp /opt/esupstage/target/ROOT.war /opt/tomcat-esup-stage/webapp/

On arrête le tomcat avant et on le redémarre ensuite

/opt/tomcat-esup-stage/bin/shutdown.sh

Pensez à paramétrer les espaces mémoire JVM : export JAVA\_OPTS="-Xms1024m -Xmx1024m -XX:MaxPermSize=256m"

Démarrage :

/opt/tomcat-esup-stage/bin/startup.sh

Bravo, l'installation est terminée ! Vous pouvez y accéder sur http://localhost:8080

Lancement direct du war (ne pas utiliser : en cours de debug) java -jar /opt/estage/target/ROOT.war

Dans le cas de l'utilisation d'un proxy (apache proxypass par exemple) il est conseillé d'utiliser le protocole AJP.

Exemple de configuration Apache :

<VirtualHost *:80>
    ServerAdmin [email protected]
    ServerName esup-stage.monuniv.fr
    DefaultType text/html
    ProxyRequests off
    ProxyPreserveHost On
    ProxyPass / http://localhost:8080/
    ProxyPassReverse / http://localhost:8080/
</VirtualHost>