Avertissement | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
- Vérifier les prérequis ;
- Récupérer les sources du portail ESUP à partir de GitHub :
- sous forme d'archive :
- Aller sur le repo Github du projet : https://github.com/EsupPortail/esup-uportal
- Switcher sur la version que vous souhaitez (tag ou branche) via le menu déroulant
- Télécharger l'archive Zip
- via Git directement :
- 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 tagguées du projet)
- Copiez le nom de la 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)
- sous forme d'archive :
- 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/to/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 ${server.home}) - Modifier le paramètre "server.webapps" de build.properties : préciser le chemin du répertoire webapps de tomcat utilisé pour le déploiement des applications. Attention : Linux et Windows, utiliser des slashs "/".
(Bonne pratique respectée = se reporter à la section | Installation par défaut = utiliser ${server.base}/webapps)
- 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 :
Bloc de code language html/xml title pom.xml firstline 85 linenumbers true collapse true <properties> <!-- The final name of the uPortal web-application --> <uportal.docbase>uPortal</uportal.docbase> <project-site-path>/uportal/${project.version}</project-site-path> <!-- The JDBC Driver used by uPortal --> <!-- HSQL driver. Uncomment if you need to --> <!-- <jdbc.groupId>org.hsqldb</jdbc.groupId> <jdbc.artifactId>hsqldb</jdbc.artifactId> <jdbc.version>${hsqldb.version}</jdbc.version> --> <!-- POSTGRESQL driver. Uncomment if you need to --> <!-- <jdbc.groupId>postgresql</jdbc.groupId> <jdbc.artifactId>postgresql</jdbc.artifactId> <jdbc.version>9.0-801.jdbc4</jdbc.version> --> <!-- MYSQL driver. Uncomment if you need to --> <!-- <jdbc.groupId>mysql</jdbc.groupId> <jdbc.artifactId>mysql-connector-java</jdbc.artifactId> <jdbc.version>5.1.22</jdbc.version> -->
- 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)
- [HSQL] "ant hsql" (à la racine du projet)
- ...
- 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
...
Info | ||
---|---|---|
| ||
L'utilisation de Git est documentée par ailleurs sur le wiki : 05 06 - Git (esup 4) |