Installation. Conception, mise en œuvre, hébergement, exploitation et

(1)

Conception, mise en œuvre, hébergement, exploitation et support d’une solution open source d’ENT pour les EPLE de la région Île-de-France

Installation

Auteur : Logica et Région Île-de-France Version : 0.8

(2)

Gestion des changements de version

Ce tableau gère les modifications apportées au document au-delà de sa version initiale. Les petites modifications de type erreurs de frappe ou changements de syntaxe ne font pas l’objet d’un suivi.

Toute nouvelle version du document ne conserve pas systématiquement les changements apportés lors de la version précédente.

Version Date Auteur Objet de la mise à jour

0.1 26/04/10 LMAR Version initiale

0.2 28/04/10 LMAR Modifications suite à la demande de la Région Ile de France

0.3 02/12/10 APIR Mise à jour en version 1.4

0.4 22/02/11 LPOT Version 1.4.9 de l'ENT

0.5 16/03/11 LPOT Refonte des packages d'installation

0.6 21/03/11 LPOT Découpage des fichiers de conf en deux zip

0.7 11/04/11 LPOT Version 1.4.20 de l'ENT

0.8 22/08/11 SRIT Version 1.5.0 de l'ENT

(3)

Droit d’auteur

Ce texte est disponible sous contrat Creative Commons Paternité - Pas d'Uti- lisation Commerciale - Partage des Conditions Initiales à l'Identique 2.0 France : http://creativecommons.org/licenses/by-nc-sa/2.0/fr/

Introduction

Cette documentation est relative à la version 1.5.0 de Lilie.

✗ Pré-requis

✗ Récupération des paquets

✗ Installation

✗ Vérification

(4)

1 Pré-requis

Ce tableau reprend l'ensemble des différents composants nécessaires au fonctionnement de l'ENT :

Java

JDK 1.6

Serveurs

Apache 2.2

Tomcat 5.5

Liferay 5.1.2

SOLR 1.4

Jackrabbit 2.1.1

Base de données

PostgreSQL 8.3

1.6 Apache

Pour cette installation un serveur Apache est nécessaire pour la mise en place du SSL sur l’ensemble de l’ENT ainsi que les connexions entre le portail et les différentes applications déployées.

Cet Apache doit embarquer le mod-jk dans sa version 1.2.28 et le mod-ssl.

Lors de cette installation l'adresse générique utilisée est https://local.lilie.org.

1.7 Tomcat

L’installation décrite ci-dessous nécessite la création de 9 instances. Ces instances sont reparties comme suit :

✔ 1 instance pour l’authentification

✔ 1 instance pour le portail

✔ 6 instances pour les applications (dont une pour les serveurs SOLR et Jackrabbit)

✔ 1 instance pour les démons (scolarite et messagerie) 1.8 PostgreSQL

Un moteur de base de données PostgreSQL en version 8.3.x doit être installé.

(5)

1.9 JDK

Le JDK utilisé pour lancer les serveurs est le JDK dans sa version 1.6. Il peut être installé dans son ré- pertoire par défaut.

1.10 Liferay

Pour cette installation nous utiliserons la version du portail liferay embarquée dans le serveur Tomcat.

Ci-dessous la liste des packages à télécharger sur la forge sourceforge.net:

http://sourceforge.net/projects/lportal/files/Liferay%20Portal/5.1.2/

✔ liferay-portal-5.1.2.war

Description : war du portail liferay. Ce war est à renommer en « lilie » avant de le déployer à la main dans le serveur tomcat destiné à porter le portail.

Lien : http://sourceforge.net/projects/lportal/files/Liferay%20Portal/5.1.2/liferay-portal- 5.1.2.war/download

✔ liferay-portal-tunnel-web-5.1.2.war

Description : webapp permettant l'accès aux services du portail Liferay (web-service). Ce war est à renommer en tunnel-web.war avant déploiement.

Lien : http://sourceforge.net/projects/lportal/files/Liferay%20Portal/5.1.2/liferay-portal- tunnel-web-5.1.2.war/download

✔ liferay-portal-dependencies-5.1.2.zip

Description : ensemble des jars nécessaires au fonctionnement du portail. Ces jars sont à dé- poser dans le répertoire du classpath de tomcat (par défaut répertoire common/lib du serveur tomcat)

Lien : http://sourceforge.net/projects/lportal/files/Liferay%20Portal/5.1.2/liferay-portal- dependencies-5.1.2.zip/download

1.11 SOLR

Le serveur SOLR est utilisé pour l'indexation des différentes informations contenues dans l'ENT. SOLR est à installer sur la même instance que la console d'administration.

Lien : http://www.apache.org/dist/lucene/solr/1.4.1/apache-solr-1.4.1.zip

(6)

1.12 Jackrabbit

Lien :http://archive.apache.org/dist/jackrabbit/2.1.1/jackrabbit-webapp-2.1.1.war

(7)

2

Récupération des paquets

Une fois ces pré-requis installés il est nécessaire de récupérer l'ensemble des paquets de l'ENT (c'est à dire l'en - semble des wars, jars et fichiers de configuration constituants la version de l'ENT).

Les paquets peuvent être récupérés sur la forge de l'ADULLACT (http://www.adullact.org).

Ils sont disponibles à l'adresse https://adullact.net/projects/lilie dans l'onglet Fichiers. Les paquets se composent de treize archives zips. Les neufs premiers sont les applications composant Lilie :

✔ lilie-tomauth-1.5.0.zip

➢ cas-server-webapp-lvl1-1.5.0.war (à renommer en connexion.war)

➢ cas-server-webapp-lvl2-1.5.0.war (à renommer en connexion-scol.war)

✔ lilie–tomapps1-1.5.0.zip

➢ lilie-ria-admin-ihm-1.5.0.war (à renommer en admin.war)

✔ lilie-web-actualite-1.5.0.war (à renommer en web-actualite.war)

✔ lilie-web-annuaire-1.5.0.war (à renommer en web-annuaire.war)

✔ lilie-web-incident-1.5.0.war (à renommer en web-incident.war)

✔ lilie-web-logos-1.5.0.war (à renommer en web-logos.war)

✔ lilie-web-recherche-1.5.0.war (à renommer en web-recherche.war)

✔ lilie-web-signets-1.5.0.war (à renommer en web-signets.war)

✔ lilie-web-statistiques-1.5.0.war (à renommer en web-statistiques.war)

✔ lilie-web-msgaccueil-1.5.0.war (à renommer en web-msgaccueil.war)

✔ lilie-web-servicesext-1.5.0.war (à renommer en web-servicesext.war)

✔ lilie-web-gestion-ressources-1.5.0.war (à renommer en web-gestion-ressources.war)

✔ lilie-web-moncompte-1.5.0.war (à renommer en web-moncompte.war)

✔ lilie-web-blog-1.5.0.war (à renommer en web-blog.war)

✔ lilie-web-forum-1.5.0.war (à renommer en web-forum.war)

✔ lilie-web-ftp-1.5.0.war (à renommer en web-ftp.war)

✔ lilie-docs-1.5.0.war (à renommer en eliot-docs-app.war)

✔ lilie-textes-1.5.0.war (à renommer en eliot-textes-app.war)

✔ lilie-messagerie-1.5.0.war (à renommer en eliot-messagerie-app.war)

(8)

✔ lilie-web-viescolaire-1.5.0.war (à renommer en web-viescolaire.war)

✔ lilie-agenda-1.5.0.war (à renommer en eliot-agenda-app.war)

✔ lilie-scolarite-1.5.0.war (à renommer en eliot-scolarite-app.war)

✔ lilie-chat-1.5.0.war (à renommer en ria-chat.war)

✔ lilie–tomdemon-1.5.0.zip

✔ lilie-demon-docs-1.5.0.war (à renommer en eliot-demon-docs-app.war)

✔ lilie-demon-scolarite-1.5.0.war (à renommer en eliot-demon-scolarite-app.war)

✔ lilie–tomportail-1.5.0.zip

✔ /webapps/

➢ lilie-ws-prttunnel-1.5.0.war (à renommer en ws-prttunnel.war)

➢ /liferay/deploy

➢ lilie-web-actualite-portlet-1.5.0.war (à renommer en web-actualite-portlet.war)

➢ lilie-web-blog-portlet-1.5.0.war (à renommer en web-blog-portlet.war)

➢ lilie-web-msgaccueil-portlet-1.5.0.war (à renommer en web-msgaccueil-portlet.war)

➢ lilie-web-notifications-1.5.0.war (à renommer en web-notifications.war-

✔ lilie-docs-1.5.0.zip

Ce Zip contient les documentations d'installation et de compilation:

➢ installation.pdf

➢ compilation.pdf

✔ lilie-conf-apache-1.5.0.zip

Ce zip contient les fichiers de configuration du frontal apache à installer pour faire fonctionner l'ENT lilie:

Les fichiers sont rangés dans les répertoires de destination dans les différentes instances des serveurs.

➢ Apache (configuration du frontal)

✔ lilie-conf-tomcat-1.5.0.zip

Ce zip contient les fichiers de configuration des différentes instances de serveur d'application à installer pour faire fonctionner l'ENT lilie:

Les fichiers sont rangés dans les répertoires de destination dans les différentes instances des serveurs.

➢ tomcat

• param (configuration des applications portées par les tomcat)

• logs (répertoire de sorties des traces des serveurs tomcat)

• instances

○ tomapps1 (configuration du serveur tomapps1)

(9)

○ tomauth (configuration du serveur d'authentification CAS)

○ tomdemon (configuration du serveur des applications "demon")

○ tomportail (configuration du serveur du portail)

✔ lilie-dump-1.5.0.zip

Ce zip contient les scripts de base permettant de créer l'ensemble des bases de l'ENT.

✔ lilie-openfire-1.5.0.zip

Ce zip contient les fichiers de bon fonctionnement d'openfire pour le chat.

✔ lilie-importannuaire-1.5.zip

Ce zip contient les fichiers et scripts d'import d'annuaire.

✔ lilie-sql_basevierge-1.5.0.zip

Ce zip contient les dump de base vierge.

(10)

3 Installation

La procédure ci-dessous décrit l’installation de l’ENT pour 9 instances Tomcat situées sur un même serveur. Il est évidemment possible de repartir ces différentes instances sur plusieurs serveurs ou machines virtuelles. La procé- dure doit alors être légèrement adaptée en fonction de votre architecture.

La documentation suivante suppose qu'un répertoire /appli/ est créé à la racine du système de fichier du serveur.

3.6 Installation d’apache

Pour fonctionner correctement l'ENT nécessite l'installation d'Apache avec les modules mod_ssl ainsi que le mod_jk.

Créer un répertoire /appli/apache, y décompresser le contenu du répertoire lilie-conf-1.5.0.zip\apache.

Les fichiers de configuration principaux sont les suivant :

➢ httpd.conf

En fonction de votre répertoire d'installation la propriété « ServerRoot » doit être mise à jour.

ServerRoot /appli/apache/conf

(11)

En aucun cas il ne faut modifier le nom du serveur « ServerName local.lilie.org ». Ce nom de serveur est utilisé pour fonctionner avec un certificat ssl.

➢ workers.properties

Ce fichier contient les informations de communication entre le serveur apache et les instances de tomcat.

➢ fichiers de configuration des virtualHost

Ces fichiers permettant de déclarer les virtualHost sont situés dans le répertoire conf/vhost.

➢ Les entrées DNS suivantes doivent être renseignées dans le fichier

■ C:\WINDOWS\system32\drivers\etc\hosts (pour windows)

■ \etc\hosts (pour linux)

127.0.0.1 local.lilie.org 127.0.0.1 ws.local.lilie.org 127.0.0.1 search.local.lilie.org 127.0.0.1 interne.local.lilie.org 127.0.0.1 db.local.lilie.org

Le certificat utilisé pour les communications SSL est dans /appli/apache/conf/cert.

Démarrer apache :

Ligne de commande pour un démarrage en mode console,

[Répertoire d'installation d'apache]/bin/httpd -f D:/appli/apache/conf/httpd.conf -d apache l'option -f permet d'indiquer le fichier de configuration httpd.conf

l'option -d permet d'indiquer le ServerRoot

Effectuer le test suivant :

url : https://local.lilie.org/accueil.html

(12)

3.7 Installation de JDK sur serveur tomcat

Pour une installation simple il est possible d’installer une seule instance du JDK (partagée par les 9 instances). En fonction de votre architecture vous pouvez adapter cette installation et donc installer le JDK 1.6 sur l'ensemble de vos serveurs tomcat.

3.8 Installation de postgres 8.3.x

L'installation décrite ici présuppose

■ que le serveur de base postgres a pour nom DNS db.local.lilie.org.

■ que le serveur de base répond sur le port 5432

■ que le compte utilisateur pour accéder aux bases est postgres/postgres

La Création des bases et schémas et leur initialisation s'effectue en restaurant le dump fournit dans le zip lilie- dump-1.5.0.zip (on peut aussi partir d'une base vierge lilie-sql_basevierge-1.5.zip -> voir juste apres) Décompresser le zip dans un répertoire temporaire.

Puis restaurer le dump en exécutant le script sql restore.sql contenu dans le zip.

Ce script supprime les instances de bases précédemment installer pour les recréer.

Depuis le répertoire temporaire lancer la commande

[Répertoire d'installation de postgres]/bin/psql -h db.local.lilie.org -U postgres -d postgres -p 5432 -f restore.sql

(13)

• l'option -f permet d'indiquer le fichier sql à lancer.

• l'option -h permet d'indiquer l'adresse du serveur

• l'option -p permet d'indiquer le port d'écoute du serveur de base

• l'option -U permet d'indiquer l'utilisateur

• l'option -d permet d'indiquer la base (seule la base postgres existe à ce stade)

• les options -o et -L permettent de rediriger les résultats de requêtes vers des fichiers laissant dans la console que les erreurs et les notifications.

Vérifier que l'ensemble des bases est bien crée. Pour cela se connecter à la base et lister les bases : postgres=# \l

List of databases

La Création des bases et schémas peut également s'effectuer à partir du fichier lilie-sql_basevierge.zip. Ici les bases seront vierges, c'est à dire qu'il faudra importer les utilisateurs pour la faire fonctionner. Cela dit c'est une très bonne méthode pour tester les imports d'annuaire et ainsi pouvoir utiliser toutes les fonctionnalités de l'ENT.

Décompresser le zip dans un répertoire temporaire.

Puis restaurer le dump en exécutant les script sql init1.5_logica.sh et init1.5_fylab.sh.

➢ Pour importer et synchroniser, voir le chapitre 8

(14)

3.9 Installation des instances de serveurs tomcat

Pré-requis : Apache doit être démarré pour la suite de l'installation

➢ Installation des binaires tomcat dans un répertoire du système (C:/Program Files sous windows, /opt/ sous linux)

➢ Configuration des applications.

La configuration des applications s'effectue par les fichiers de configuration (*.properties, *.groovy et *.xml) placés dans le répertoire 'param' qui doit être situé à la racine du répertoire tomcat.

Ces fichiers de configuration sont disponibles dans le zip lilie-conf-1.5.0.zip\tomcat\param.. Ces fichiers de configuration seront précisés au lancement de tomcat par l'intermédiaire de variables d'environnement:

-Deliot-demon-docs.config.location=%TOMCAT_HOME%\param\eliot-demon-docs-config.groovy -Deliot-demon-s- colarite.config.location=%TOMCAT_HOME%\param\eliot-demon-scolarite-config.groovy -Deliot-scolarite.config.location=%TOMCAT_HOME%\param\eliot-scolarite-config.groovy -Deliot-agenda.config.location=%TOMCAT_HOME

%\param\eliot-agenda-config.groovy -Dservicesext.config=%TOMCAT_HOME%\param\config_servicesext.properties -Dlogos.config=%TOMCAT_HOME%\param\config_logos.properties -Dgestionressources.config=

%TOMCAT_HOME%\param\config_gestionressources.properties -Driaadmin.config=%TOMCAT_HOME

%\param\config_riaadmin.properties -Dportailgestion.config=%TOMCAT_HOME%\param\config_portailgestion.- properties -Dactualite.config=%TOMCAT_HOME%\param\config_actualite.properties -Dadmin.config=

%TOMCAT_HOME%\param\config_admin.properties -Dfmk-core-ent.config=%TOMCAT_HOME

%\param\config_fmk-core-ent.properties -Dalimentation.config=%TOMCAT_HOME%\param\config_alimentation.- properties -Dannuaire.config=%TOMCAT_HOME%\param\config_annuaire.properties -Dannuairepb.config=%TOM- CAT_HOME%\param\config_annuairepb.properties -Dapirecherche.config=%TOMCAT_HOME%\param\config_api- recherche.properties -Dbandeau.config=%TOMCAT_HOME%\param\config_bandeau.properties -Dblog.config=

%TOMCAT_HOME%\param\config_blog.properties -Dcasauth.config=%TOMCAT_HOME%\param\config_casauth.- properties -Ddroits.config=%TOMCAT_HOME%\param\config_droits.properties -Dforum.config=%TOMCAT_HOME

%\param\config_forum.properties -Dimportfederateur.config=%TOMCAT_HOME%\param\config_importfedera- teur.properties -Dincident.config=%TOMCAT_HOME%\param\config_incident.properties -Dinitialisation.config=

%TOMCAT_HOME%\param\config_initialisation.properties -Dliferay.config=%TOMCAT_HOME%\param\config_life- ray.properties -Dmoncompte.config=%TOMCAT_HOME%\param\config_moncompte.properties -Dnotifications.- config=%TOMCAT_HOME%\param\config_notifications.properties -Dcore.config=%TOMCAT_HOME

%\param\config_core.properties -Dmsgaccueil.config=%TOMCAT_HOME%\param\config_msgaccueil.properties -Dblog-portlet.config=%TOMCAT_HOME%\param\config_blog-portlet.properties -Dactualite-portlet.config=%TOM- CAT_HOME%\param\config_actualite-portlet.properties -Dmsgaccueil-portlet.config=%TOMCAT_HOME

%\param\config_msgaccueil-portlet.properties -Dportail.config=%TOMCAT_HOME%\param\config_portail.properties -Drecherche.config=%TOMCAT_HOME%\param\config_recherche.properties -Dservicestiers.config=

%TOMCAT_HOME%\param\config_servicestiers.properties -Dsignets.config=%TOMCAT_HOME%\param\config_si- gnets.properties -Deliot-messagerie.config.location=%TOMCAT_HOME%\param\eliot-messagerie-config.groovy -Deliot-textes.config.location=%TOMCAT_HOME%\param\eliot-textes-config.groovy -Deliot-docs.config.location=

%TOMCAT_HOME%\param\eliot-docs-config.groovy -Dviescolaire.config=%TOMCAT_HOME%\param\config_vies- colaire.properties

De même il faut préciser les fichiers de configuration de log4j des applications :

-Dservicesext.log4j=%TOMCAT_HOME%\param\log_servicesext.xml -Driaadmin.log4j=%TOMCAT_HOME

%\param\log_riaadmin.xml -Dlogos.log4j=%TOMCAT_HOME%\param\log_logos.xml -Dgestionressources.log4j=

%TOMCAT_HOME%\param\log_gestionressources.xml -Dactualite.log4j=%TOMCAT_HOME%\param\log_actua-

(15)

lite.xml -Dactualite-portlet.log4j=%TOMCAT_HOME%\param\log_actualite-portlet.xml -Dalimentation.log4j=%TOM- CAT_HOME%\param\log_alimentation.xml -Dannuairepb.log4j=%TOMCAT_HOME%\param\log_annuairepb.xml -Dbandeau.log4j=%TOMCAT_HOME%\param\log_bandeau.xml -Dblog.log4j=%TOMCAT_HOME

%\param\log_blog.xml -Dblog-portlet.log4j=%TOMCAT_HOME%\param\log_blog-portlet.xml -Dcasauth.log4j=

%TOMCAT_HOME%\param\log_casauth.xml -Dforum.log4j=%TOMCAT_HOME%\param\log_forum.xml -Dincident.- log4j=%TOMCAT_HOME%\param\log_incident.xml -Dimportfederateur.log4j=%TOMCAT_HOME%\param\log_im- portfederateur.xml -Dinitialisation.log4j=%TOMCAT_HOME%\param\log_initialisation.xml -Dmoncompte.log4j=

%TOMCAT_HOME%\param\log_moncompte.xml -Dmsgaccueil-portlet.log4j=%TOMCAT_HOME

%\param\log_msgaccueil.xml -Dmsgaccueil.log4j=%TOMCAT_HOME%\param\log_msgaccueil-portlet.xml -Dre- cherche.log4j=%TOMCAT_HOME%\param\log_recherche.xml -Dservicestiers.log4j=%TOMCAT_HOME

%\param\log_servicestiers-portlet.xml -Dsignets.log4j=%TOMCAT_HOME%\param\log_signets.xml -Dnotifications.- log4j=%TOMCAT_HOME%\param\log_notifications.xml -Dviescolaire.log4j=%TOMCAT_HOME%\param\log_viesco- laire.xml

De plus il faut indiquer le keystore contenant le certificat permettant les communications SSL.

export JAVA_OPTS=' $JAVA_OPTS -Djavax.net.ssl.trustStore=%TOMCAT_HOME%/param/cert/ks_ssl -Djavax.- net.ssl.trustStorePassword=Prosodie23'

➢ Décompresser le contenu du repertoire lilie-conf-1.5.zip\tomcat\instances dans le répertoire \appli\tomcat\instances.

(16)

Les neufs instances de tomcat ainsi créées contiennent alors :

• le paramétrage serveur /conf

• les librairies /common/lib

• le répertoire de trace /logs

• le répertoire temporaire /temp

3.6 Installation des applications dans les serveurs

 tomauth : authentification

Cette instance va contenir les wars nécessaires au fonctionnement du SSO via CAS Déposer les 2 wars suivants dans le répertoire /webapps :

(17)

• connexion.war (issu du renommage de cas-server-webapp-lvl1-1.5.0.war contenu dans contenu dans lilie-war–tomauth-1.5.0.zip)

• connexion-scol.war (issu du renommage de cas-server-webapp-lvl2-1.5.0.war contenu dans contenu dans lilie-war–tomauth-1.5.0.zip)

Démarrer le tomcat puis effectuer le test suivant : url : https://local.lilie.org/connexion/

Faire un test de connexion avec le couple identifiant / Mot de passe suivant : Identifiant : lucie.ginette Mot de passe : 123456

(18)

url : https://local.lilie.org/connexion-scol/

Si cette deuxième connexion n'est pas réalisée dans la même fenêtre que la connexion ci dessus le mot de passe classique sera demandé d'abord, puis la mire de connexion suivante sera proposée :

Mot de passe : 72D23C1

(19)

 tomapps1 : applications

Déposer les wars suivant dans /webapps:

• admin.war (issu du renomage de lilie-ria-admin-ihm-.war contenu dans lilie–

tomapps1-1.5.0.zip)

• solr.war(issu du renomage du war de solr téléchargé)

• jackrabbit.war(issu du renomage du war de jackrabbit téléchargé) Créer le répertoire /appli/tomcat/upload

Ce répertoire doit être partagé sur tous les serveurs d'instances.

Démarrer le tomcat tomapps1 puis effectuer le test suivant : url : https://local.lilie.org/admin/

(20)

Utiliser le compte suivant pour s'authentifier : Identifiant : ent.admin

Mot de passe : 1234

Pré-requis : Le serveur tomauth doit être démarré pour la suite de l'installation.

Déposer les wars dans le répertoire /webapps

• web-actualite.war (issu du renommage de lilie-web-actualite-1.5.0.war contenu dans lilie–tomapps2-1.5.0.zip)

• web-annuaire.war (issu du renommage de lilie-web-annuaire-1.5.0.war contenu dans lilie–tomapps2-1.5.0.zip)

• web-incident.war (issu du renommage de lilie-web-incident-1.5.0.war contenu dans lilie–tomapps2-1.5.0.zip)

• web-logos.war (issu du renommage de lilie-web-logos-1.5.0.war contenu dans lilie–tomapps2-1.5.0.zip)

• web-recherche.war(issu du renommage de lilie-web-recherche-1.5.0.war contenu dans lilie–tomapps3-1.5.0.zip)

(21)

• web-signets.war(issu du renommage de lilie-web-signets-1.5.0.war contenu dans lilie–tomapps3-1.5.0.zip)

• web-statistiques.war (issu du renommage de lilie-web-statistiques-1.5.0.war contenu dans lilie–tomapps2-1.5.0.zip)

Démarrer le tomcat tomapps2 puis effectuer le test suivant : Si nécessaire utiliser le compte suivant pour s'authentifier :

Identifiant : lucie.ginette Mot de passe : 123456

url : https://local.lilie.org/web-actualite/

(22)

url : https://local.lilie.org/web-annuaire/

url : https://local.lilie.org/web-incident/

(23)

url

: https://local.lilie.org/web-recherche/

(24)

url

: https://local.lilie.org/web-signets/

Déposer les wars suivants dans le répertoire /webapps :

• web-msgaccueil.war (issu du renommage de lilie-web-msgaccueil-1.5.0.war contenu dans lilie–tomapps3-1.5.0.zip)

(25)

• web-servicesext.war (issu du renommage de lilie-web-servicesext-1.5.0.war contenu dans lilie–tomapps3-1.5.0.zip)

• web-gestion-ressources.war(issu du renommage de lilie-web-gestion-ressources- 1.5.0.war contenu dans lilie–tomapps3-1.5.0.zip)

• web-moncompte.war(issu du renommage de lilie-web-moncompte-1.5.0.war contenu dans lilie–tomapps3-1.5.0.zip)

• web-blog.war (issu du renommage de lilie-web-blog-1.5.0.war contenu dans lilie–

tomapps3-1.5.0.zip)

• web-forum.war (issu du renommage de lilie-web-forum-^1.5.0.war contenu dans lilie–tomapps3-1.5.0.zip)

• web-ftp.war (issu du renommage de lilie-web-ftp-1.5.0.war contenu dans lilie–

tomapps3-1.5.0.zip)

Démarrer le tomcat tomapps3 puis effectuer le test suivant : Si nécessaire utiliser le compte suivant pour s'authentifier : Identifiant : lucie.ginette

Mot de passe : 123456

url : https://local.lilie.org/web-moncompte/

(26)

url : https://local.lilie.org/web-blog/



url : https://local.lilie.org/web-forum/

(27)

url : https://local.lilie.org/web-servicesext/

url : https://local.lilie.org/web-gestion-resources/

url : https://local.lilie.org/web-ftp/

(28)

Pré-requis : Les serveurs tomauth et tomapps1 doivent être démarrés pour la suite de l'installation.

Déposer les wars suivants dans /webapps :

• eliot-docs-app.war (issu du renommage de lilie-docs-1.5.0.war contenu dans lilie–

tomapps4-1.5.0.zip)

• eliot-textes-app.war (issu du renommage de lilie-textes-1.5.0.war contenu dans lilie–tomapps4-1.5.0.zip)

• eliot-messagerie-app.war (issu du renommage de lilie-messagerie-1.5.0.war contenu dans lilie–tomapps4-1.5.0.zip)

url : https://local.lilie.org/eliot-textes-app/

Attention, si un annuaire n'est pas rechargé, cette application n'est probablement pas accessible car l'import scolarité n'est pas effectué : voir chapitre 8 sur l'import d'annuaire.

(29)

url : https://local.lilie.org/eliot-messagerie-app/

 tomapps5 : applications

Cette instance va contenir les wars d'applications de l'ENT.

(30)

• web-viescolaire.war (issu du renommage de lilie-web-viescolaire-1.5.0.war contenu dans lilie–tomapps5-1.5.0.zip)

• eliot-notes-app.war (issu du renommage de lilie-notes-1.5.0.war contenu dans lilie–tomapps5-1.5.0.zip)

• eliot-absences-app.war (issu du renommage de lilie-absences-1.5.0.war contenu dans lilie–tomapps5-1.5.0.zip)

Mot de passe de niveau 2 : 72D23C1

url : https://local.lilie.org/web-viescolaire/

Pour les applications eliot-notes-app/ et eliot-absences-app/, ces applications ne sont accessibles qu'après l'import AAF (voir chapitre 8)

(31)

 tomapps6 : applications

Cette instance va contenir les wars d'applications de l'ENT.

Déployer les wars suivant sur cette instance :

• eliot-scolarite-app.war(issu du renommage de lilie-scolarite-1.5.0.war contenu dans lilie-tomapps6-1.5.0–.zip)

• eliot-agenda-app.war(issu du renommage de lilie-agenda-1.5.0.war contenu dans lilie–tomapps6-1.5.0.zip)

• ria-chat.war(issu du renommage de lilie-chat-1.5.0.war contenu dans lilie–

tomapps6-1.5.0.zip)

url : https://local.lilie.org/eliot-agenda-app/

url : https://local.lilie.org/eliot-scolarite-app/

Ces applications ne sont accessibles qu'après l'import AAF (voir chapitre 8) Cette application utilise /appli/tomcat/upload (partagé par tous les serveurs)

(32)

url : https://local.lilie.org/ria-chat/

Pour accéder au chat, il est nécessaire de déployer le zip lilie-openfire-1.5.0.zip dans /appli/openfire

Vérifier l’IP de la base dans le fichier /appli/openfire/openfire/conf/openfire.xml.

Rendre exécutable /appli/openfire/openfire/bin/openfire Démarrer openfire: /appli/openfire/openfire/bin/openfire start

→ cela créé les tables dans la base de données openfire, il ne reste donc plus qu'à mettre à jour la table ofproperty en lancant le script sql d'openfire (dans ce script sont inscrites les url de l'ent : local.lilie.org)

Redémarrage d’openfire :

/appli/openfire/openfire/bin/openfire stop /appli/openfire/openfire/bin/openfire start

L'application chat est maintenant opérationnelle.

 tomdemon

Cette instance va contenir les wars des demons Eliot.

Déployer les wars suivant sur cette instance :

• eliot-demon-scolarite-app.war (issu du renommage de lilie-demon-docs- 1.5.0.war contenu dans lilie–tomdemon-1.5.0.zip)

• eliot-demon-docs-app.war (issu du renommage de lilie-demon-scolarite- 1.5.0.war contenu dans lilie–tomdemon-1.5.0.zip)

 tomportail : portail liferay

Cette instance contient les wars nécessaires au bon fonctionnement du portail ainsi que les portlets de Lilie.

Copier les librairies du zip liferay-portal-dependencies-5.1.2.zip dans le répertoire tomportail/common/lib

Placer les war suivants dans le répertoire /webapps

- tunnel-web.war (issu du renommage de liferay-portal-tunnel-web-5.1.2.war) – ws-prttunnel.war (contenu dans le zip lilie–tomportail-1.5.0.zip)

(33)

Décompresser le contenu du war liferay-portal-5.1.2.war dans le repertoire tomportail/webapps/lilie,

Extraire lilie-conf-1.5.0.zip\tomcat\instances\tomportail, dans tomportail.

Installation des portlets dans le portail liferay :

• le repertoire tomportail/liferay/deploy contient les war des portlets qui seront déployées dans liferay au démarrage. Il faut les renommées ainsi :

• web-actualite-portlet (livrées en lilie-web-actualite-portlet.war)

• web-blog-portlet (livrée en lilie-web-blog-portlet.war)

• web-msgaccueil-portlet (livrée en lilie-web-msgaccueil-portlet.war)

• web-notifications (livrée en lilie-web-notification-portlet.war)

• web-mosaique (livrées en lilie-web-mosaique.war)

Démarrer le tomcat tomportail puis effectuer le test suivant : url : https://local.lilie.org/

(34)

On obtient donc une arborescence de ce type pour le répertoire tomcat dans le cas d'une installation sur une seule machine (multi-instance):

A décliner suivant vos architectures mais ce tableau reprend l’ensemble de la configuration des 9 instances de tomcat :

Instance Port Paramétrage Applications déployées

tomauth HTTP : 8008 AJP : 7008

-Xms768m -Xmx1024m

connexion.war connexion-scol.war tomportail HTTP : 8009

AJP : 7009

-Xms768m -Xmx1024m

-Dfile.encoding=UTF8 -Duser.-timezone=GMT --XX:MaxPermSize=128m

tunnel-web.war ws-prttunnel.war

lilie (répertoire du war explosé et modifié) web-actualite-portlet(dans deploy de liferay) web-blog-portlet(dans deploy de liferay) web-msgaccueil-portlet(dans deploy de liferay)

web-notifications (dans deploy de liferay) tomapps1 HTTP : 8001

AJP : 7001

-Xms768m -Xmx1024m

--XX:MaxPermSize=256m

-Dsolr.solr.home= [répertoire d'installation]\tomapps1\solr

admin.war solr.war jackrabbit.war

tomapps2 HTTP : 8002 -Xms768m web-actualite.war

(35)

AJP : 7002 -Xmx1024m

web-annuaire.war web-logos.war web-recherche.war web-signets.war tomapps3 HTTP : 8003

AJP : 7003

-Xms768m -Xmx1024m

web-blog.war web-forum.war

web-gestion-ressources.war web-moncompte.war web-msgaccueil.war web-servicesext.war web-ftp.war tomapps4 HTTP : 8004

AJP : 7004

-Xms768m -Xmx1034m

eliot-docs-app.war eliot-messagerie-app.war eliot-textes-app.war tomapps5 HTTP : 8005

AJP : 7005

-Xms768m -Xmx1024m

web-viescolaire.war eliot-notes-app.war eliot-absences-app.war tomapps6 HTTP : 8006

AJP : 7006

-Xms768m -Xmx1024m

eliot-scolarite-app.war eliot-agenda-app.war ria-chat.war

tomdemon HTTP : 8007 AJP : 7007

-Xms768m -Xmx1024m

eliot-demon-scolarite-app.war eliot-demon-docs-app.war

Ordre de démarrage de l'ENT:

1. apache 2. postgres 3. tomapps1 4. tomapps2 5. tomapps3 6. tomapps4 7. tomapps5 8. tomapps6 9. tomauth 10. tomdemon 11. tomportail

(36)

8 ^{Import AAF}

1. Import et synchro à partir d'une base vierge :

Attention : Il faut mettre à jour la ligne « axis.servlet.hosts.allowed= 127.0.0.1,10,… » dans le fichier /tomportail/we- bapps/lilie/WEB-INF/classes/portal-ext.properties. Il faut configurer ici les machines qui accèdent aux applications.

Pré-requis : Apache, les instances tomcat et la base doivent être démarrés pour la suite de l'installation des annuaires.

Après avoir effectué les créations de base, et la mise en place des tomcat, il faudra initialiser le portail quand il sera dé- marré:

--1ère étape : initialisation du portail

supprime tout le contenu de la base portal (qui contient au démarrage des jeux de tests liferay) et le remplacer par ce qu’on lui indique dans le fichier init.xml

Sur l'instance tomportail, cd batchinit/

./bat-portailv2.sh -m BatchInitialisationPortal -f init/init.xml -> une erreur sur la création des Organizations peut se produire.

-> les logs sont dans /appli/tomcat/instances/tomportail/batchinit/logs/

-2ème étape : chargement de l'annuaire voir chargement de l'annuaire (ci dessous)

--3ème étape : synchronisation de l'annuaire avec le portail

permet de mettre le portail à jour par rapport aux données de l’annuaire.

./bat-portailv2.sh -m BatchImportAnnuaire -f init/initEtab.xml (vérifier le fichier initEtab.xml) -> Attendre la fin réelle du batch. Si le batch s'arrete avant d'être réellement terminé, le relancer.

-> Dans les log, il ne faut qu'il y ait d'erreur sur les Eleves, Autres et PersRelEleve, mais des erreurs sur les Personnels peuvent arriver

--4ème étape : update du portail

créer/mettre à jour les services de l’ENT. Et remettre d’aplomb dans le portail un utilisateur ou un établissement dont la synchro ne serait pas bien passé

(37)

./bat-portailv2.sh -m BatchUpdatePortal -u normal -> ne devrait pas générer d'erreurs dans les logs

--5ème étape : deuxième synchronisation du portail Sur l'instance tomportail,

cd batchinit/

./bat-portailv2.sh -m BatchImportAnnuaire -f init/initEtab.xml -> ne devrait plus générer d'erreurs dans les logs

Maintenant, l'annuaire et le portail sont ok.

2. Chargement de l'annuaire :

Attention : Il faut mettre à jour la ligne « axis.servlet.hosts.allowed= 127.0.0.1,10,… » dans le fichier /tomportail/we- bapps/lilie/WEB-INF/classes/portal-ext.properties. Il faut configurer ici les machines qui accèdent aux applications.

Créer un répertoire /appli/batch (s'il n'existe pas déjà), y décompresser le contenu du répertoire lilie-import-an- nuaire1.5.0.zip\

Dans le dossier TRAITEMENT_MANUEL se trouve un exemple factice de données à importer (des étab- lissements, des élèves, des personnels d'éducation, des parents).

Pour que les applications Notes, absences, agenda, … fonctionnnent, l'import entier doit être effectué (import annuaire + import scolarité)

Import Annuaire :

Premièrement, en base, doivent être inscrit les établissements que l'on va importer dans la table etablisse- ment_deploye de la base administration.

Exemple : insert into etablissement_deploye (etablissement_rne, etablissement_nom, code_porteur) values ("9300000U", "Lycée Lilie", "LOCAL");

Dans cette même base, l'académie et le porteur doivent aussi être configurés dans les tables homonymes.

La configuration des fichiers à importer se trouve dans les fichiers : ./batch/bat-configurations/ACADEMIES.lst et ./batch/bat-importfederateur/conf/config_importfederateur-paris.properties

Puis lancer le script sur batch:

./batch/scripts/bat-execute-ordonnanceur.sh ACADEMIES.lst -manuel

(38)

Il faut maintenant synchroniser le portail avec le nouvel annuaire avec la commande suivante sur l'instance tomportail :

./tomportail/batchinit/bat-portailv2.sh -m BatchImportAnnuaire -f init/initEtab.xml

Import Annuaire Scolarité:

La configuration des fichiers à importer se fait dans : tomcat/param/eliot-aaf-import-config.groovy.

Les fichiers exportés par le premier import se trouvent dans : ./batch/WORK/Y_exportannuaire. Il faut les copier dans /appli/tomcat/instances/tomapps1/aaf/fichiers (comme marqué dans le fichier de configuration).

→ il faut donc les importer avec la commande suivante (en vérifiant les variables dans le fichier de configuration):

java -Druntime.environment=integration -Deliot-aaf-import.config.location=/appli/tomcat/param/eli ot-aaf-import-config.groovy -jar /appli/tomcat/instances/tomapps1/aaf/eliot-aaf-import-2.5.0-SNAP SHOT-jar-with-dependencies.jar

Après avoir vérifié les rapports générés, l'import pour la scolarité est effectif. Les applications Notes, absences, agenda, … sont maintenant accessibles.

(39)

9 Synchronisation du portail

Attention : Il faut mettre à jour la ligne « axis.servlet.hosts.allowed= 127.0.0.1,10,… » dans le fichier /tompor- tail/webapps/lilie/WEB-INF/classes/portal-ext.properties. Il faut configurer ici les machines qui accèdent aux applications.

Il faut aussi synchroniser le portail en lancant les commandes suivantes sur l'instance tomportail:

./tomportail/batchinit/bat-portailv2.sh -m BatchUpdatePortal -u normal

→ permet de synchroniser les utilsateurs

./tomportail/batchinit/bat-portailv2.sh -m BatchUpdatePortal -e normal -f init/initEtab.xml (bien vérifier les chemins d'accès à tomportail/batchinit/init/initEtab.xml pour que cela marche)

→ permet de synchroniser les établissements

./tomportail/batchinit/bat-portailv2.sh -m BatchUpdatePortal -c normal -f init/init.xml (-n)(bien vérifier les chemins d'accès à tomportail/batchinit/init/init.xml pour que cela marche)

→ permet de synchroniser les communautés. Le -n peut être utilisé pour ajouter une nouvelle communauté (présente dans init.xml et initEtab.xml), il faut alors remplacer “normal” par le nom de la communauté.

(40)

10 Comptes utilisateurs

Pour se connecter à l'ENT vous pouvez utiliser les utilisateurs suivants :

Type Nom Login Mot de

passe

Établissement Mot de passe Mot de passe scolarité Enseignant Chazal Sylvie sylvie.chazal Enseignant Honoré de Balzac

Enseignant Ginette Lucie Lucie.ginette Enseignant Honoré de Balzac 123456 72D23C1 Direction Rougier Claire claire.rougier Direction Honoré de Balzac

Documentation Goudron Claire claire.goudron Documenta- tion

Honoré de Balzac

Enseignant Debraques Jean jean.debraques Enseignant Honoré de Balzac Elève Martin Marie marie.martin1 Elève Honoré de Balzac Elève Besnier Pierre pierre.besnier Elève Honoré de Balzac

Attention, ces comptes peuvent être désactivés après l'import d'un annuaire.

L'interface d'administration de l'ENT est accessible à l'adresse https://local.lilie.org/admin/

✔ Login : ent.admin

✔ Mot de passe : 1234

Installation. Conception, mise en œuvre, hébergement, exploitation et

Conception, mise en œuvre, hébergement, exploitation et support d’une solution open source d’ENT pour les EPLE de la région Île-de-France

Installation

Gestion des changements de version

Droit d’auteur

Introduction

1 Pré-requis

Récupération des paquets

3 Installation

8 Import AAF

9 Synchronisation du portail

10 Comptes utilisateurs

8 ^{Import AAF}