Récupération des sources
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
Il faut adapter en changeant a minima 'password' par un vrai mot de passe :
CREATE DATABASE estage; CREATE USER 'esupstage_user'@'%' IDENTIFIED BY 'password'; GRANT ALL PRIVILEGES ON estage.* TO 'esupstage_user'@'%' WITH GRANT OPTION; 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
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/estage/etc/estage/estage-example.properties estage.properties
# 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 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 appli.mailer.username=username@monuniv.fr appli.mailer.password=xxx appli.mailer.from=from@monuniv.fr # paramètres pour le développement, par défaut disable_delivery=false, delivery_address=null appli.mailer.disable_delivery=true appli.mailer.delivery_address=user@monuniv.fr # 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
Compilation du projet
cd /opt/estage mvn -Dmaven.test.skip=true clean package
Déploiement / Lancement de l'application
Chemin
Après la compilation, le chemin complet du fichier de déploiement est le suivant : /opt/estage/target/ROOT.war
Déploiement TOMCAT
Installation 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 repertoire tomcat ainsi : /opt/tomcat-esup-stage
Répertoire ROOT
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
cd /opt/estage mvn -Dmaven.test.skip=true clean package
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
Espace mémoire
Pensez à paramétrer les espaces mémoire JVM : export JAVA\_OPTS="-Xms1024m -Xmx1024m -XX:MaxPermSize=256m"
/opt/tomcat-esup-stage/bin/startup.sh
Bravo, l'installation est terminée !
Lancement direct du war (ne pas utiliser : en cours de debug)
java -jar /opt/estage/target/ROOT.war