ESUP-Stage

Raccourcis espace

Arborescence des pages


Récupération des sources

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

Il faut adapter en changeant a minima 'password' par un vrai mot de passe :

Script Database
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

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

Copie de la base
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


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
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
Production du WAR


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
Production du WAR


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


Copie du WAR pour déploiement :


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


On arrête le tomcat avant et on le redémarre ensuite
Arrêt du tomcat :


/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"

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
Proxy
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 admin@monuniv.fr
    ServerName esup-stage.monuniv.fr
    DefaultType text/html
    ProxyRequests off
    ProxyPreserveHost On
    ProxyPass / http://localhost:8080/
    ProxyPassReverse / http://localhost:8080/
</VirtualHost>




                
        
    
        


                        
    





    

	

		
    
    
            
  • 
            Aucune étiquette
        
    •