ESUP SISCOL

Cette application expose à l'application ESUP-STAGE des API REST (OPEN API - Swagger). Ainsi seule ESUP SIScol fait des accès au SI de l'établissement (Annuaire LDAP et Apogée).

Versions

• APOGEE 6.4.x
• JDK 11, 8
• APOGEE WS 62031 ...62070

Installation du JAR client WS-APOGEE

Avant de commencer l'installation, il faut vous procurer le client Web service Apogée soit auprès des collègues qui déploient Apogée dans votre établissement ou directement auprès de l'AMUE. Les WebServices Apogée doivent être installés selon les préconisations de l'AMUE et fonctionnelles sinon, il n'est pas nécessaire d'aller plus loin...

Le jar client apo-webservices-client doit correspondre au web-service Apogée installé. Votre fichier apo-webservices-client{mettre la version}.jar doit être installé ainsi :

mvn install:install-file -Dfile=apo-webservices-client{mettre la version}.jar -DgroupId=gouv.education.apogee -DartifactId=apo-webservices-client -Dversion={mettre la version} -Dpackaging=jar

Clonage et installation

git clone https://github.com/EsupPortail/esup-siscol.git esup-siscol
cd esup-siscol/src/main/resources/
cp application.yml.sample application.yml

vim application.yml

La première partie LDAP : renseigner les paramtères LDAP

ldap:
	urls: 
		- ldap://ldap-paris.fr:389
   username: uid=xxxx,ou=admins,dc=u-paris10,dc=fr
   password: xxxx
   base: dc=u-paris10,dc=fr

La deuxiéme partie concerne les urls APOGEE

  administratifMetier: http://ws.uni.fr:8080/aws/services/AdministratifMetier
  tudiantMetier: http://ws.uni.fr:8080/aws/services/EtudiantMetier
  pedagogiqueMetier: http://ws.uni.fr:8080/aws/services/PedagogiqueMetier
  geographieMetier: http://ws.uni.fr:8080/aws/services/GeographieMetier
  referentielMetier: http://ws.uni.fr:8080/aws/services/ReferentielMetier
  offreFormationMetier: http://ws.uni.fr:8080/aws/services/OffreFormationMetier

La troisième Partie

credential:
	userscredential:
		root:
  			username: root
  			password: un-super-mot-de-passe-a-remplacer-ici

il faut ajouter la bonne dépendance vers votre numéro de vesrion du client Apogée ex. 62070 au lieu de "version-ws-apogee-a-définir-ici" dans le pom.xml

			<dependency>
				<groupId>gouv.education.apogee</groupId>
				<artifactId>apo-webservices-client</artifactId>
				<version>version-ws-apogee-a-définir-ici</version>
			</dependency>

Pour tester le bonne compilation.

mvn clean compile
mvn install

Overview

Pour éxecuter le projet en mode développement il suffit de le lancer avec la commande :

cp application.yml.sample application.yml
##configurer la partie LDAP, apogee (urls de services) et userscredential
mvn  spring-boot:run

Configuration

en mode Tomcat:

cp target/esup-siscol-0.1.11.jar {path}/tomcat/webapps
unzip esup-siscol-0.1.11.jar -d esup-siscol
cd esup-siscol/WEB-INF/classes/
cp application.yml.sample application.yml

dans le fichier application.yml configurer la partie LDAP, apogee (urls de services) et userscredential

en mode java (alternative)

Attention à adapter selon le fonctionnement de chaque établissement,

• The etc directory contains the configuration files and directories that need to be copied to /etc/apogee/config. --example usage :

cd path/apogee
./cp -r etc/conf /etc/apogee/conf/
java -server  -noverify -Xmx2048M -jar target/apogee-0.0.1-SNAPSHOT.jar --spring.config.location=/etc/apogee/conf/

Clear Maven Cache

If you need to, on Linux/Unix systems, you can delete all the existing artifacts (artifacts and metadata) Maven has downloaded using:

# Only do this when absolutely necessary
rm -rf $HOME/.m2/
mvn dependency:purge-local-repository -DactTransitively=false -DreResolve=false

Same strategy applies to Windows too, provided you switch $HOME to its equivalent in the above command.

Deployment

• TODO

Executable WAR

java -server  -noverify -Xmx2048M -jar target/apogee-0.0.1-SNAPSHOT.jar --spring.config.location=etc/apogee/conf/
f/

External

Deploy the binary web application file apogee.jar after a successful build to a servlet container of choice.