Récupération des sources
| Bloc de code |
|---|
| language | bash |
|---|
| theme | RDark |
|---|
| title | Clonage du projet |
|---|
|
cd /opt
git clone https://github.com/EsupPortail/esup-stage.git |
...
| Bloc de code |
|---|
| language | sql |
|---|
| title | Script Database |
|---|
|
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
...
| Bloc de code |
|---|
| language | java |
|---|
| theme | Confluence |
|---|
| title | Modifier le fichier de configuration : |
|---|
| linenumbers | true |
|---|
|
# 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
| Bloc de code |
|---|
| language | bash |
|---|
| theme | RDark |
|---|
| title | Production du WAR |
|---|
|
cd /opt/estage
mvn - |
...
Dmaven.test.skip=true clean package |
Déploiement / Lancement de l'application
| Avertissement |
|---|
|
Après la compilation, le chemin complet du fichier de déploiement est le suivant : /opt/estage/target/ROOT. |
...
Déploiement TOMCAT
| Avertissement |
|---|
|
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
| Avertissement |
|---|
|
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
| Bloc de code |
|---|
| language | bash |
|---|
| theme | RDark |
|---|
| title | Production du WAR |
|---|
|
cd /opt/estage
mvn -Dmaven.test.skip=true clean package |
| Bloc de code |
|---|
| language | bash |
|---|
| theme | RDark |
|---|
| title | 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
| Bloc de code |
|---|
| language | bash |
|---|
| theme | RDark |
|---|
| title | Arrêt du tomcat : |
|---|
|
/opt/tomcat-esup-stage/bin/shutdown.sh |
...
| Info |
|---|
|
Pensez à paramétrer les espaces mémoire JVM : export JAVA\_OPTS="-Xms1024m -Xmx1024m -XX:MaxPermSize=256m" |
| Bloc de code |
|---|
| language | bash |
|---|
| theme | RDark |
|---|
| title | Démarrage : |
|---|
|
/opt/tomcat-esup-stage/bin/startup.sh |
| Astuce |
|---|
Bravo, l'installation est terminée ! Vous pouvez y accéder sur http://localhost:8080 |
| Info |
|---|
| title | Lancement direct du war |
|---|
|
...
| (ne pas utiliser : en cours de debug) |
|
java -jar /opt/estage/target/ROOT.war |
| Remarque |
|---|
|
Dans le cas de l'utilisation d'un proxy (apache proxypass par exemple) il est conseillé d'utiliser le protocole AJP. |
| Bloc de code |
|---|
| language | yml |
|---|
| title | 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> |