...

Table des matières
1. Introduction
1.1. Objet du document
1.2. Organisation du document
1.3. Glossaire
1.4. Documents de référence
2. Installation du Front office
2.1. Installation de la base de donnée
2.1.1. Création du schéma en base de donnée
2.1.2. Initialisation des tables en base de données
2.1.3. Vérification des tables en base de données
2.2. Déploiement de l'application front office
2.2.1. Configuration de l'application
2.2.2. Déploiement de l'application
2.2.3. Intégration de l'applet au portail
3. Paramétrage du Front Office
3.1. Paramétrage Base de donnée et Hibernate
3.2. Paramétrage Web services
3.3. Paramétrage LDAP
3.4. Paramètres liés à l'adhésion
3.5. Paramétrage destinataires
3.6. Paramétrage envoi de SMS
3.7. Paramétrage CAS
3.8. Paramétrage SMTP
3.9. Paramétrage des purges
3.10. Paramétrage des traitements asynchrones
3.11. Test de connexion back office
3.12. Paramètres lié à Quartz
3.13. Paramétrage Front Office - – Back Office : Mise en place des certificats

...

Liste des tableaux
Tableau n°1: Glossaire
Tableau n°2: Documents de référence

Ancre
_Toc247369814 _Toc247369814

Introduction

Ancre
_Toc247369815 _Toc247369815

Objet du document

Ancre
_Toc247369816 _Toc247369816

Organisation du document

Le présent rapport est divisé en cinq chapitres :

• Le chapitre 1 (présent chapitre) constitue l'introduction du document.
• Le chapitre 2 présente l'installation du Front Office du service SMS-U.
• Le chapitre 3 expose le paramétrage du Front Office du service SMS-U.

Ancre
_Toc204482669 _Toc204482669

Ancre
_Toc204482694 _Toc204482694

Ancre
_Toc247369817 _Toc247369817

Glossaire

1. Ancre
   _Toc247369844 _Toc247369844

   Glossaire

Ancre
_Toc247369818 _Toc247369818

Documents de référence

1. Ancre
   _Toc247369845 _Toc247369845

   Documents de référence

Ancre
_Toc233773709 _Toc233773709

Ancre
_Toc247369819 _Toc247369819

Installation du Front office

L'application de Front office packagée se trouve dans le dossier /dist du projet.
Dézippez le contenue de la distribution la plus récente de esup-smsu dans un répertoire de travail.
Le paramétrage suivant est à effectuer dans le dossier ainsi créé.

Ancre
_Toc233773710 _Toc233773710

Ancre
_Toc247369820 _Toc247369820

Installation de la base de donnée

Le back office nécessite un serveur de base de donnée MySQL en version 5.

Ancre
_Toc247369821 _Toc247369821

Création du schéma en base de donnée

Pour créer le schéma de base de donnée :

• Se connecter au serveur mysql en tant qu'administrateur et saisir le mot de passe 

• Créer un schéma nommé « smsu »

Ancre
_Toc247369822 _Toc247369822

Initialisation des tables en base de données

Dans le fichier properties/config.properties, renseignez les paramètres relatifs à la base de donnée.
Il faut premièrement configurer le compte par défaut ainsi que le premier super administrateur. Pour ce faire, éditer le fichier «utils/database/populate_tables_esup-smsu.sql», puis modifier les lignes suivantes

...

Nb : Aucune table ne doit être présente dans le schéma smsu au moment de l'exécution de cette commande sous peine d'échec.
Nb : L'application étant lancée durant cette phase il faut que la configuration de l'application soit correcte avant de lancer la tache ant (cf chapitre 2.1.1)
Nb : Dû à un manque dans les classes appelées par la tâche init-data, il se peut que la tâche « ne rende pas la main » à la fin de son exécution. Ceci n'a pas d'impact sur les opérations effectuées.

Ancre
_Toc247369823 _Toc247369823

Vérification des tables en base de données

Pour vérifier que les étapes précédentes se sont correctement déroulées :

• Se connecter à la base de donnée et saisir le mot de passe : 

• Se placer dans le schéma smsu :

...

Ancre
_Toc233773711 _Toc233773711

Ancre
_Toc247369824 _Toc247369824

Déploiement de l'application front office

Ancre
_Configuration_de_l'application _Configuration_de_l'application

Ancre
_Toc247369825 _Toc247369825

Configuration de l'application

Paramétrage des propriétés de l'application

Le back office se déploie en mode portlet.
Vérifier la configuration des fichiers :

• properties/config.properties
  • vérifier les informations de connexion à la base de donnée
  • vérifier les informations de connexion au LDAP
  • vérifier l'URL d'accès au web service du portail
  • vérifier l'URL d'accès au web service du back office
  • vérifier le chemin d'accès au fichier libmgs.properties
  • vérifiez les informations de configuration du compte de validation
  • dans le cas d'un déploiement en servlet, vérifiez le paramétrage du serveur CAS
  • vérifiez le paramétrage SMTP
  • vérifiez le paramétrage Quartz
  • de manière générale, vérifiez l'ensemble des paramètres.
• build.properties
  • Paramétrez le type de déploiement désiré. (servlet, protlet, quick-start ... voir documentation du framework : http://www.esup-portail.org/pages/viewpage.action?pageId=1867791^{Image Removed})
• properties/logging/log4j.properties
  • Vérifier le chemin d'accès au fichier de log

Paramétrage des groupes PAGS

Déposez dans le dossier properties\groups le fichier de configuration des groupes pags PAGSGroupStoreConfig.xml
Ce fichier doit être le même que celui déposé au sein du portail.
Pour sa configuration, reportez-vous à la document disponible sur le site suivant :
http://www.esup-portail.org/consortium/espace/Socle_1A/gestion_groupes/serviceGroup/pags.html

Ancre
_Toc247369826 _Toc247369826

Déploiement de l'application

L'application se déploie par la tache ant deploy :

...

Ancre
_Toc238630153 _Toc238630153

Ancre
_Toc247369827 _Toc247369827

Intégration de l'applet au portail

La portlet du front office se déploie par le biais du gestionnaire de canaux.
La configuration utilisée est la suivante :

Ancre
_Toc233709185 _Toc233709185

Ancre
_Toc247369828 _Toc247369828

Paramétrage du Front Office

Le fichier /properties/config.properties de propriété permet aux exploitants de paramétrer le Front Office.
Voici la liste des paramètres disponibles :

Ancre
_Toc247369829 _Toc247369829

Paramétrage Base de donnée et Hibernate 

• Url d'accès à la base de donnée :

...

hibernate.useJndi=false
Défini le mode d'accès à la base de donnée du front office.

Ancre
_Toc247369830 _Toc247369830

Paramétrage Web services

• Adresse du web service portail :

*portail.ws.adress{*}=http://\[Nom_De_La_Machine_Front_Office\]:\[Port_Portail\]/uPortal/services/UportalService

...

*smsuapi.ws.address{*}=https://\[Nom_De_La_Machine_Back_Office\]:\[Port_WebService\]/xfire

Ancre
_Toc247369831 _Toc247369831

Paramétrage LDAP

• Adresse du serveur LDAP :

...

ldap.group.testFilter=cn=mati
Ce paramètre défini l'expression qui sera utilisé pour tester le LDAP par le biais des taches ant livrées par esup-commons

Ancre
_Toc247369832 _Toc247369832

Paramètres liés à l'adhésion

• Expression régulière de validation de la forme du numéro de téléphone d'un adhérent :

*adhesion.phoneNumberPattern{*}= 06\[0-9\]\{8\}
(10 chiffres commençant par 06)
Ce paramètre peut être vidé (pas de vérification du tout)

...

*adhesion.accountValidation{*}=\[compte_de_validation\]

...

*adhesion.roleValidation{*}=\[role_compte_validation\]

...

*adhesion.titleSmsValidation{*}=\[Titre_SMS_valdidation\]

...

adhesion. phoneNumberAttributes=homePhone,mobile
Les champs sont séparés par une virgule.

Ancre
_Toc247369833 _Toc247369833

Paramétrage destinataires

• Expression régulière de validation de la forme du numéro de téléphone d'un adhérent :

*recipient.phoneNumberPattern{*}= 06\[0-9\]\{8\}
(10 chiffres commençant par 06.
Ce paramètre peut être vidé (pas de vérification du tout)

Ancre
_Toc247369834 _Toc247369834

Paramétrage envoi de SMS

• Compte par défaut d'envoi de SMS :

...

sms.defaultSupervisorLogin=e0891022243

Ancre
_Toc247369835 _Toc247369835

Paramétrage CAS

• • Attribut d'authentification utilisateur auprès du portail :

...

• • URL serveur CAS :

*cas.url{*}=https://\[Nom_De_La_Machine_Cas\]:\[Port_Cas\]/cas

Ancre
_Toc247369836 _Toc247369836

Paramétrage SMTP

• L'adresse du serveur SMTP à utiliser :

...

• L'adresse email qui sera utilisée pour envoyer les emails:

*smtp.fromEmail=*example@domain.org
Ce paramètre défini l'adresse email qui sera utiliser pour envoyer les emails

• L'adresse email qui sera utilisée pour envoyer les emails:

*smtp.fromEmail=*example@domain.org
Ce paramètre défini l'adresse email qui sera utiliser pour envoyer les emails

• Le nom qui apparaitra dans les emails :

*smtp.fromName=*Name firstName
Ce paramètre défini le nom qui apparaitra comme expéditeur des emails envoyés par le front office.

Ancre
_Toc247369837 _Toc247369837

Paramétrage des purges

• • Purge de la base des utilisateurs en attente de validation de numéro de téléphone :

...

purge.periodic.seniorityDay=120

Ancre
_Toc247369838 _Toc247369838

Paramétrage des traitements asynchrones

• La localisation du fichier de configuration de quartz :

...

quartz.notificationByMailForInvalidPhoneTrigger.cronExpression = 0 0 12 ? * MON

Ancre
_Toc247369839 _Toc247369839

Test de connexion back office

• Test de connexion avec le back office. En cas de succès, le nom de l'application cliente lue dans le certificat est retourné :

welcome. isConnexionTested= false

Ancre
_Toc247369840 _Toc247369840

Paramètres lié à Quartz

Liste des paramètres :

• Le driver a utiliser pour se connecter à la base de données :

...

org.quartz.dataSource.myDS.maxConnections = 5
Défini le nombre de connections maximum qui peuvent être utilisées.
Les autres paramètres n'ont normalement pas à être modifiés, dans le cas contraire se référer à la documentation Quartz.

Ancre
_Toc247369841 _Toc247369841

Paramétrage Front Office

...

– Back Office : Mise en place des certificats

Se reporter à la documentation UPA001-MI05.doc