Prérequis : environnement technique mis en place
2.1 Sources
2.1.1 Solution 1 : Installation rapide
La personnalisation de l'application n'est pas prévue pour cette installation (couleurs, logos, etc..). Les étapes spécifiques à cette solution seront notées SOLUTION 1 dans le reste du document.
- Récupérer le war de la dernière version de eCandidat V2 sur https://sourcesup.renater.fr/projects/ecandidat/ (onglet Fichiers)
2.1.2 Solution 2 : Installation personnalisée
La personnalisation de l'application est prévue pour cette installation (couleurs, logos, etc..). Les étapes spécifiques à cette solution seront notées SOLUTION 2 dans le reste du document.
- Récupérer le zip de la dernière version de eCandidat V2 sur https://sourcesup.renater.fr/projects/ecandidat/ (onglet Fichiers)
- Dézipper l'archive dans un dossier puis passer au paramétrage de l'application
2.2 Paramétrage des ressources JNDI
- Copier les éléments situés dans le fichier context_samle.xml dans la déclaration des variables JNDI de votre serveur Tomcat (par exemple server.xml). Suivant le choix de la solution dans la partie 2.1, le fichier context_samle.xml se trouve :
- SOLUTION 1 : dans META-INF/
- SOLUTION 2 : dans /src/main/webapp/META-INF/
- Renseigner chaque propriété ou laisser les vide si vous n'en avez pas l’utilité
Propriété | Définition |
---|---|
Resource name="jdbc/dbEcandidat" | Déclaration de votre base de données MySql de eCandidat |
Parameter name="siscol.implementation" | Implémentation du service SiScol à utiliser. Si vous voulez utilisez Apogée ainsi que ses WebServices, laissez celui par défaut : siScolApogeeWSServiceImpl |
Resource name="jdbc/dbSiScol" | Déclaration de votre base de données Apogée (pour le requêtage direct sur la base) |
Parameter name="app.url" | Url de l'application |
Parameter name="cas.url" | Url de votre service d'authentification CAS |
Parameter name="assistance.documentation.url" Parameter name="assistance.documentation.url.candidat" Parameter name="assistance.documentation.url.candidat.en" Parameter name="assistance.helpdesk.url" Parameter name="assistance.contact.mail" | Informations d'assistance, respectivement :
|
Parameter name="ldap.base" Parameter name="ldap.url" Parameter name="ldap.branche.people" Parameter name="ldap.user" Parameter name="ldap.pwd" | Informations de connexion au ldap, respectivement :
|
Parameter name="ldap.champs.uid" Parameter name="ldap.champs.displayName" Parameter name="ldap.champs.mail" Parameter name="ldap.champs.sn" Parameter name="ldap.champs.cn" Parameter name="ldap.champs.supannCivilite" Parameter name="ldap.champs.supannEtuId" Parameter name="ldap.champs.givenName" | Champs utilisés dans le ldap, respectivement :
|
Parameter name="ldap.filtre.personnel" | Filtre ldap de recherche de personnel (pour les gestionnaires ou membres de commission) Exemple : (eduPersonAffiliation=employee) ou !(eduPersonAffiliation=student) Attention à bien placer les parenthèses comme dans les deux exemples ci-dessus. |
Parameter name="admin.technique" | Login de l'admin technique |
Parameter name="mail.smtpHost" Parameter name="mail.smtpPort" Parameter name="mail.from" Parameter name="mail.from.noreply" Parameter name="mail.to" | Paramètres pour l'envoi de mail, respectivement :
|
Parameter name="file.cmis.atompub.url" Parameter name="file.cmis.repository" Parameter name="file.cmis.user" Parameter name="file.cmis.pwd" Parameter name="file.cmis.candidat.id" Parameter name="file.cmis.gestionnaire.id" | Paramètres de dématérialisation (solution CMIS), respectivement :
Attention : si vous renseignez ces informations, vous ne DEVEZ pas renseigner les paramètres de dématérialisation (solution FileSystem) |
Parameter name="file.filesystem.candidat.path" Parameter name="file.filesystem.gestionnaire.path" | Paramètres de dématérialisation (solution FileSystem), respectivement :
Attention : si vous renseignez ces informations, vous ne DEVEZ pas renseigner les paramètres de dématérialisation (solution CMIS) |
Parameter name="limesurvey.path" Parameter name="limesurvey.user" Parameter name="limesurvey.pass" | Paramètres pour accéder aux webservices LimeSurvey, respectivement :
|
Parameter name="batch.fixedRate" | Fréquence de vérification de la table des batchs de l'application (en ms) |
Parameter name="piwikAnalytics.trackerUrl" Parameter name="piwikAnalytics.siteId" | Paramètres de piwik, optionnel (https://fr.piwik.org/), respectivement :
|
Parameter name="demoMode" | Mode démo. Doit être à false |
Parameter name="productionMode" | Mode production. Doit être à true |
Parameter name="enablePush" | Activation du push. Doit être à true |
Paramètres complémentaires pour un environnement en Load Balancing
Attention : ne renseignez surtout pas ces informations si vous ne faites pas de load balancing
Attention, dans cette configuration vous devrez avoir :
- Une instance de l'application dédiée aux gestionnaires. Cette instance ne peut pas être en mode load balancing. Cette instance aura une url propre. Exemple : http://eCandidat-gest.univ.fr
- Différentes instances de l'application dédiées aux candidats en mode load balancing. Ces instances auront la même url. Exemple : http://eCandidat.univ.fr
- Lors de chaque nouvelle installation, il est impératif de lancer une première fois l'application "Gestionnaire" en premier
- Pour les établissement utilisant la dématérialisation en mode "File System", il est nécessaire d'utiliser un répertoire partagé entre toutes les instances de l'application
Propriété | Définition |
---|---|
Resource name="load.balancing.gestionnaire.mode" | Renseigné à "true" si il s'agit de l'instance gestionnaire. Renseigné à "false" si il s'agit d'une instance candidat |
Parameter name="load.balancing.candidat.id.instance" | Identifiant de l'instance, par exemple "1", "2", "3", etc... Attention, toutes les instances devront avoir un id différent. Préconisation :
|
Resource name="load.balancing.candidat.url" | Obligatoire pour l'instance gestionnaire. Non utilisé pour l'instances candidat et donc facultative. Il s'agit de l'url de l'application côté candidat. |
Exemple :
Instance gestionnaire :
<Parameter name="load.balancing.gestionnaire.mode" value="true" />
<Parameter name="load.balancing.candidat.id.instance" value="1" />
<Parameter name="load.balancing.candidat.url" value="http://eCandidat.univ.fr" />
Instance candidat 1 :
<Parameter name="load.balancing.gestionnaire.mode" value="false" />
<Parameter name="load.balancing.candidat.id.instance" value="2" />
Instance candidat 2 :
<Parameter name="load.balancing.gestionnaire.mode" value="false" />
<Parameter name="load.balancing.candidat.id.instance" value="3" />
etc....
2.3 Paramétrage des webservices Apogée
L'application est livrée avec la bibliothèque gouv.education.apogee.apo-webservicesclient version 4.70.la. Nous ne garantissons le fonctionnement de l'application qu'avec cette version.
Copier le fichier configUrlServices.sample.properties et renommer le en configUrlServices.properties puis éditer le. Suivant le choix de la solution dans la partie 2.1, le fichier configUrlServices.sample.properties se trouve :
- SOLUTION 1 : dans /WEB-INF/classes/
- SOLUTION 2 : dans /src/main/resources/
Renseigner les url de vos webservices utilisés dans l'application :
# WebServices Dossier Etudiant etudiantMetier.urlService=https://wsapogee.univ.fr/services/amue_apo_update_etudiant etudiantMetier.urlService.ssl=https://wsapogee.univ.fr/services/amue_apo_update_etudiant pedagogiqueMetier.urlService=https://wsapogee.univ.fr/services/amue_apo_pedagogique pedagogiqueMetier.urlService.ssl=https://wsapogee.univ.fr/services/amue_apo_pedagogique # URL des Services Apogee-OPI opiMetier.urlService=https://wsapogee.univ.fr/services/amue_opi opiMetier.urlService.ssl=https://wsapogee.univ.fr/services/amue_opi
2.4 Base de données
La base de données (qui doit être préalablement créée vide) est automatiquement alimentée au démarrage de l'application