Installation avant la version 2.5.0
Si vous avez opté pour SOLUTION 1 (voir 2. Installation initiale), les points 4.1 et 4.2 ne vous concernent pas. Allez directement au 4.3 Installation des drivers oracle.
4.1 Création du war
- La compilation et la génération du war nécessite que maven version 3.2.5 minimum soit installé sur le poste
- La première compilation prend beaucoup de temps car maven télécharge toutes les librairies nécessaires à l'application dans son repository. Les compilations suivantes seront beaucoup plus rapides.
- Placez vous à la racine de l'application, vous devriez être au même niveau que le fichier pom.xml
- Ouvrez une invite de commande et lancez la commande :
mvn clean compile package
Astuce
Pour vous passer de l'étape "4.3 Installation des drivers oracle", vous pouvez configurer maven de telle sorte qu'il aille lui même rechercher les drivers oracle.
Pour cela vous devez ajouter un server dans le fichier settings.xml de maven en vous référent au point 6.5 de la documentation d'Oracle : http://docs.oracle.com/middleware/1213/core/MAVEN/config_maven_repo.htm. Les username et password indiqués dans ce document proviennent d'un compte oracle classique.
Ensuite, à la place de lancer la commande :
mvn clean compile package
Lancez cette commande :
mvn clean compile package -P oracle-enable
Les drivers Oracle seront alors contenus directement dans vos librairies sans avoir à les installer à la main.
4.2 Déploiement du war
- Un dossier target a été créé dans votre répertoire contenant le fichier ecandidat-X.X.X.war
- Déployez ce war sur votre serveur
- Avant de lancer l'application, rendez vous au point suivant (4.3 Installation des drivers oracle)
4.3 Installation des drivers Oracle (ignorez si vous installez une version >2.3.1, les drivers sont inclus dans l'application)
Plus valable depuis la version 2.3.2 : les drivers sont livrés directement dans l'application
Dans l'application eCandidat, nous utilisons des requêtes directes sur Apogée à divers endroits : synchronisation du référentiel Apogée et recherche de formations Apogée.
Si vous souhaitez utiliser ces fonctionnalités, il sera nécessaire de vous procurer les drivers Oracle. En effet, pour une problématique de licences nous ne sommes pas en mesure de fournir les drivers oracle dans l'installation.
Pour cela il suffit de vous rendre sur cette page : https://www.oracle.com/technetwork/database/application-development/jdbc/downloads/jdbc-ucp-183-5013470.html après s'être créé un compte sur le site d'Oracle, et de télécharger le driver ojdbc8.jar.
Une fois le fichier ojdbc8.jar en votre possession, placez-le dans WEB-INF/lib
4.4 Lancement du server
Une fois la configuration terminée, vous pouvez lancer le serveur.
4.5 Première utilisation
Pour les utilisateurs d'Apogée, au démarrage de l'application en étant connecté en AdminTechnique, consultez l'écran des batchs et lancez le batch de synchronisation du SI Scolarité
Installation à partir de la version 2.5.0
Si vous avez opté pour SOLUTION 1 (voir 2. Installation initiale), les points 4.1 et 4.2 ne vous concernent pas. Allez directement au 4.3 Lancement du serveur.
4.1 Création du war
- La compilation et la génération du war nécessite que maven version 3.2.5 minimum soit installé sur le poste
- La première compilation prend beaucoup de temps car maven télécharge toutes les librairies nécessaires à l'application dans son repository. Les compilations suivantes seront beaucoup plus rapides.
- Placez vous à la racine de l'application, vous devriez être au même niveau que le fichier pom.xml
- Ouvrez une invite de commande et lancez la commande :
mvn package
4.1.1 Utilisation d'un répertoire de configuration local
Etape optionnelle.
Si vous souhaitez utiliser un répertoire de configuration qui est sur votre poste ou sur un serveur et non dans le livrable, il est possible de spécifier la localisation de ce répertoire de configuration (celui-ci devra avoir la même arborescence que celui situé dans le livrable). Cette étape est optionnelle mais permet de ne pas refaire toutes les étapes de configuration précédentes.
Cette étape est inutile si vous utilisez les ressources externes sur le serveur (voir 2. Installation initiale - ressources-externes).
Exemple :
mvn package -Dressources.location=/home/configuration-ecandidat/
4.1.1 Génération d'une image Docker
Il est également possible de générer une image docker de eCandidat. eCandidat est livré avec un Dockerfile :
Génération image
mvn clean compile package docker build -t ecandidat:2.5.0
4.2 Déploiement du war
- Un dossier target a été créé dans votre répertoire contenant le fichier ecandidat-X.X.X.war
- Déployez ce war sur votre serveur
4.3 Lancement du server
Une fois la configuration terminée, vous pouvez lancer le serveur.
Si vous souhaitez utiliser un fichier properties plutôt que les ressources JNDI du serveur Tomcat, n'oubliez pas d'ajouter la localisation de ce fichier au démarrage :
Génération image
-Dconfig.location=/home/eCandidat/fichier/application.properties
4.2.1 Lancement de l'image Docker
Ne concerne que les établissements souhaitant utiliser une image Docker
Exemple de ligne de commande de run
docker run -p 8080:8080 -v /c/tmp/:/app/ -e JAVA_OPTS="-Dconfig.location=/app/config/application.properties" ecandidat:2.5.0
4.4 Première utilisation
Pour les utilisateurs d'Apogée, au démarrage de l'application en étant connecté en AdminTechnique, consultez l'écran des batchs et lancez le batch de synchronisation du SI Scolarité