2.7 - Installer les modules en ligne moveonline

2.7 - Installer les modules en ligne moveonline - Hébergement par
l'établissement
Ce chapitre décrit les modalités d’installation des modules en ligne moveonline dans le cas où ils sont hébergés sur un
serveur de votre établissement.
1- Réglages préliminaires
Création du répertoire PHP « move »
Afin d’héberger les fichiers PHP des modules moveonline, vous devez créer un répertoire « move » sur le serveur Web
de votre établissement.
Création de la base de données SQL « moveonline »
Pour les différents modules, vous devez créer une base de données SQL unique portant le nom « moveonline ». Le
codage de la base de données doit être impérativement UTF-8.
Pour cette base de données, deux utilisateurs doivent être créés avec des droits d’accès spécifiques :
- un utilisateur « moveonline_php » pour l’accès par les fichiers PHP. Cet utilisateur doit être restreint au serveur PHP.
Il doit disposer des droits de modification du contenu des tables (INSERT, UPDATE, SELECT, DELETE) et, durant
l’installation et les mises à jour, d’ajout et de modification des tables (CREATE, ALTER, DROP).
- un utilisateur « moveonline_odbc » pour l’accès depuis moveon via l’interface ODBC. Cet utilisateur peut être restreint
aux adresses IP des postes de travail utilisant moveon. Il doit disposer des droits de modification du contenu des
tables (INSERT, UPDATE, SELECT, DELETE).
2- Installation des modules PHP
Copie des fichiers PHP
Les fichiers PHP des différents modules doivent être installés dans le répertoire PHP « move » créé au préalable. Pour
cela, copiez le contenu du fichier d’installation correspondant dans le répertoire « move ».
Modification des droits sur les fichiers PHP
Après installation des fichiers, vérifiez impérativement les droits suivants :
- Tous les fichiers installés doivent être accessibles en lecture par le serveur Web.
- Le contenu du répertoire move/data/ doit être accessible en lecture, écriture, exécution.
- Le fichier move/libraries/fop/fop_0.93/libraries/fop doit être exécutable (uniquement pour les serveurs
de type Unix/Linux) [modules incoming et outgoing].
Configuration de la fonction mail
Les modules incoming, outgoing et reports incluent des fonctionnalités d'envoi de courriers électroniques via un serveur
SMTP utilisant la fonction mail de PHP. La directive de configuration sendmail_path doit être configurée correctement.
Sous Windows, les directives smtp, smtp_port et sendmail_from peuvent être utilisées alternativement.
Configuration du pare-feu
© QS unisolution (07.02.2017)
Le pare-feu doit être configuré de telle manière que les requêtes au portail http://www.moveonnet.eu (85.214.33.173) via
le port 80 soient autorisées, car moveonline accède à ce site pour récupérer des informations actuelles concernant les
établissements d'enseignement supérieur [modules exchanges et cooperations].
Configuration de base de moveonline
Il est nécessaire d'effectuer certains paramétrages des modules moveonline pour permettre leur fonctionnement,
notamment la connexion à la base de données SQL. Pour cela, ouvrez le fichier move/settings/moveonline/
settings.inc.php dans un éditeur de texte et remplacez dans les lignes suivantes la seconde valeur entre parenthèses
par le paramètre de votre établissement :
- Type de base de données
define("SQL_TYPE", "mysql");
2.7 - Installer les modules en ligne moveonline - Hébergement par l'établissement
page 1
Valeurs possibles : « mysql » (MySQL), « pgsql » (PostgreSQL)
- Nom de la base de données
define("SQL_DBNAME", "moveonline");
- Adresse du serveur de base de données
define("SQL_HOST", "192.168.0.1");
Indiquez l’adresse IP du serveur ou « localhost »/« 127.0.0.1 » lorsque la base de données se trouve sur le même
serveur que PHP
- Port du serveur de base de données
define("SQL_PORT", "");
A renseigner uniquement si le port du serveur de base de données est différent du port standard : 3306 (MySQL),
5432 (PostgreSQL)
- Nom de l’utilisateur « moveonline_php » pour l’accès à la base de données
define("SQL_LOGIN", "login");
- Mot de passe de l’utilisateur « moveonline_php »
define("SQL_PWD", "password");
- Encodage de la base de données
define("ENCODING_DATABASE", "UTF-8");
Seule valeur possible : UTF-8
- Intégration via IFrame (pour chaque module)
define("USE_IFRAME_NOMDUMODULE",false);
Valeurs possibles : true (Integration), false (Pas d'intégration)
- Nom de domaine de la page où le module est intégré en IFrame (en cas d'intégration via IFrame)
define("DOMAIN","");
Ex : univ-paris.fr
- Adresse du serveur LDAP (si un LDAP est utilisé pour l'identification) [modules outgoing, reports]
define("LDAP_HOST", "");
- Port du serveur LDAP (si un LDAP est utilisé pour l'identification) [modules outgoing, reports]
define("LDAP_PORT", "");
- Nom du champ contenant le nom de l'utilisateur dans le LDAP (si un LDAP est utilisé pour l'identification) [modules
outgoing, reports]
define("LDAP_LOGINFIELD", "");
Exemple : uid
- Nom du champ permettant la connexion au LDAP (si un LDAP est utilisé pour l'identification) [modules outgoing,
reports]
define("LDAP_BINDFIELD", "");
Exemple : cn
- DN du parent dans le LDAP (si un LDAP est utilisé pour l'identification) [modules outgoing, reports]
define("LDAP_BIND_DN", "");
Exemple : "ou=people,dc=univ-paris,dc=fr"
Configuration du chemin d'accès à Java (optionnel)
Si nécessaire, il est possible de définir un chemin particulier vers l'installation de Java sur le serveur pour que la
génération du fichier PDF fonctionne correctement. Pour cela, la constante FOP_PRECOMMAND doit être configurée
comme suit dans le fichier settings.inc.php:
define("FOP_PRECOMMAND", "export JAVA_HOME='/path/to/java/installation'");
La commande sera exécutée avant chaque génération de fichier PDF. Si la constante est vide ou non définie, aucune
commande ne sera exécutée avant la génération.
© QS unisolution (07.02.2017)
Note : Si l'exécutable Java se trouve sous /local/jre/bin/java, la constante JAVA_HOME doit alors être fixée à /
local/jre.
3- Création et initialisation des tables SQL
Les tables doivent maintenant être créées dans la base de données SQL en utilisant le module setup de moveonline.
Pour cela, ouvrez le fichier : move/moveonline/setup/start.php à l'aide de votre navigateur Internet.
Pour accéder à cette page, vous devez vous identifier en saisissant le nom et le mot de passe de l’utilisateur
« moveonline_php » de la base de données moveonline.
Une fois les données d’accès correctement saisies, le module setup vérifie les pré-requis techniques de PHP et de la
base de données et les droits d'accès aux différents répertoires. Dans le cas où des erreurs sont détectées, veuillez les
corriger puis cliquer sur le bouton Recheck system. Si aucune erreur n'est détectée lors de la vérification, cliquez sur le
bouton Next pour accéder à la page d’installation.
page 2
2.7 - Installer les modules en ligne moveonline - Hébergement par l'établissement
Effectuez ici les 4 étapes de l’installation l’une après l’autre en cliquant sur les boutons Execute :
-
ETAPE 1 : création des tables (create tables)
ETAPE 2 : initialisation des tables système (init system tables)
ETAPE 3 : initialisation des tables de configuration (init config tables)
ETAPE 4 : création des tables de candidature (create application tables) [modules incoming et outgoing]
A l'étape 3, vous avez le choix entre une installation standard et l'installation d'une configuration sauvegardée. Dans le
cas d'une première installation, sélectionnez l'installation standard.
4- Test des modules
Une fois les tables SQL créées et initialisées, les liens vers les différents modules (outgoing, incoming, cooperations,
exchanges et reports) s’affichent en bas de la fenêtre. Cliquez sur le bouton Start correspondant à chaque module pour
le démarrer et en vérifier le fonctionnement.
5- Intégration des modules dans les pages Internet de votre établissement
Après avoir testé le fonctionnement des modules installés, vous devez les intégrer dans les pages Internet de votre
établissement.
Adaptation du design
Le répertoire move/settings/moveonline/ contient la feuille de style (design.css) et les différents éléments graphiques
pour l’adaptation du design des modules moveonline à votre établissement.
QS unisolution prépare ces différents fichiers et vous les fournit pour l’installation. Cependant, vous pouvez effectuer
ultérieurement les modifications nécessaires dans ce répertoire. Le répertoire Images contient en particulier le fichier
logo.gif, correspondant au logo apparaissant sur les formulaires en ligne, et le fichier logo_pdf.gif, correspondant au logo
apparaissant sur les formulaires PDF [modules incoming et outgoing]. La taille optimale du logo pour les formulaires
PDF est 216 X 70 pixels.
Adaptation des balises méta
Le répertoire move/settings/moveonline/ contient également le fichier meta.txt. Ce fichier vous permet d'adapter à votre
établissement la liste des balises méta à inclure dans chaque page HTML du module.
Création d'un sous domaine « move »
Vous devez maintenant créer un sous-domaine « move » pour l'accès au répertoire move/ des modules moveonline. La
création de ce sous-domaine donne à l'adresse d'un module moveonline le format suivant :
- module outgoing : http://move.univ-paris14.fr/moveonline/outgoing/start.php (pointant vers le fichier move/moveonline/
outgoing/start.php)
N.B. : la création d'un sous domaine est indispensable lors de l'intégration des modules via IFrame en raison de la règle
de Same Origin Policy (cf. ci-dessous), notamment dans le cas où les modules sont hébergés par QS unisolution.
Intégration de moveonline via IFrame
Si votre site Internet permet l'utilisation d'IFrames, les modules moveonline peuvent être complètement intégrés dans
votre site. La navigation et l'apparence graphique de votre site sont ainsi conservées lors de l'utilisation des modules
moveonline. Cette intégration est également possible lorsque les modules sont hébergés par QS unisolution.
© QS unisolution (07.02.2017)
Pour chaque page de votre site Internet devant inclure un module moveonline, vous devez effectuer les modifications cidessous.
A l'emplacement où doit apparaître le module, la balise <body> doit contenir un texte sur le modèle suivant dans lequel
l'attribut src contient l'adresse du module moveonline :
<iframe src="http://move.univ-paris14.fr/moveonline/outgoing/start.php" name="move_frame"
id="move_frame" scrolling="auto" width="770" frameborder="0"></iframe>
La balise <header> ou <body> doit contenir un texte sur le modèle suivant :
<script type="text/javascript">document.domain="univ-paris14.fr";</script>
2.7 - Installer les modules en ligne moveonline - Hébergement par l'établissement
page 3
Il est en outre conseillé d'adapter l'apparence de l'IFrame via la feuille de style (CSS) sur le modèle suivant :
<iframe {width:770px; border:0; background: transparent;}>
La largeur minimale de l'IFrame est de 770px pour que les différents modules soient représentés correctement.
Le module moveonline doit être impérativement accessible sur le même domaine et le même port que la page principale.
Dans le cas contraire, une barre de défilement apparaît dans la partie droite de l'IFrame, car le JavaScript adaptant la
hauteur de l'IFrame est bloqué par violation de la règle de Same Origin Policy.
Dans le cas de l'utilisation d'IFrames, il est également nécessaire de configurer correctement les variables
USE_IFRAME_NOM DU MODULE (par exemple USE_IFRAME_INCOMING) et DOMAIN dans le fichier de configuration de
moveonline (settings.inc.php) comme décrit ci-dessus.
6- Configuration de la connexion ODBC sur chaque poste de travail
Pour que moveon puisse accéder au contenu de la base de données SQL (configuration et import de données), il est
nécessaire, sur chaque poste de travail utilisant moveon, d’installer le pilote ODBC correspondant et de configurer une
connexion à la base de données « moveonline ».
L'installation et la configuration d'un pilote ODBC sont décrites au chapitre 2.9.
7- Configuration du nom de la connexion à la base de données moveonline dans moveon
© QS unisolution (07.02.2017)
Une fois la connexion ODBC configurée sur chaque poste de travail, vous devez définir dans moveon le nom de la
connexion (DSN) à la base de données « moveonline ». Pour cela, ouvrez dans moveon le formulaire « Interfaces »,
accessible depuis le menu principal en cliquant sur « Configuration » puis « Interfaces ». Sélectionnez « moveonline »
dans la liste déroulante des interfaces et indiquez dans le champ « Nom de la connexion (DSN) » le nom de la
connexion ODBC.
page 4
2.7 - Installer les modules en ligne moveonline - Hébergement par l'établissement