- Vérifier les prérequis ;
- Récupérer le portail à partir de GitHub :
- Exécuter la commande "git clone https://github.com/EsupPortail/esup-uportal.git" (afin de récupérer le projet) ;
- Exécuter la commande "git tag" (afin de consulter la liste des versions du projet)
- Copier le nom version désirée (afin de ne pas récupérer la version en cours de développement)
- Exécuter la commande "git checkout <nom_version>" (afin de se placer sur la version désirée)
- Modifier le fichier "build.properties.sample"
- Le renommer en "build.properties" ;
- Modifier le paramètre "server.home" de build.properties : préciser le chemin utilisé pour la variable CATALINE_HOME. Attention : Linux et Windows, utiliser des slashs "/".
(Bonne pratique respectée : se reporter à la section / Installation par défaut : utiliser /PATH/apache_tomcat_6.0.36/) - Modifier le paramètre "server.base" de build.properties : préciser le chemin utilisé pour la variable CATALINA_BASE. Attention : Linux et Windows, utiliser des slashs "/".
(Bonne pratique respectée : se reporter à la section / Installation par défaut : utiliser /PATH/apache_tomcat_6.0.36/)
- Modifier le fichier "filters/esup.properties":
- modifier la section "Database Connection Settings" :
- Décommenter le connecteur JDBC désiré
- Renseigner les paramètres de connexion
- modifier la section "logs" :
- Renseigner la propriété "environment.build.log.logfileDirectory" avec un chemin valide.
- modifier la section "Database Connection Settings" :
Modifier le fichier "pom.xml" et décommenter le bon connecteur SQL :
(la modification s'effectue au niveau de la balise "<properties>").- Lancer votre serveur de base de données. Pour cela, exécuter une des commandes ci-dessous, en la laissant en tâche de fond afin de laisser le serveur de base de données actif :
- [MySQL] "mysqld.exe" / "mysqlsafe" (selon le système d'exploitation)
- [PostgreSQL] "postgres.exe" / "postgres" (selon le système d'exploitation)
- ...
- Exécuter la commande "ant -Dmaven.test.skip=true clean initportal" (effectue le déploiement initial) ou "ant -Dmaven.test.skip=true clean deploy-ear" (effectue les autres déploiements)
- Exécuter la commande "startup.bat" / "startup.sh" de tomcat selon le système d'exploitation (démarre le serveur applicatif)
- Se connecter à http://localhost:8080/uPortal
GitHub
GitHub est documenté par ailleurs sur le wiki : 05 - Git (esup 4)