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 Auteur : Logica et Région Île-de-France Version : 0.8 Page 1 de 40
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 Page 2 de 40
Droit d auteur Ce texte est disponible sous contrat Creative Commons Paternité - Pas d'utilisation 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 Vérification Page 3 de 40
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 1.6 8.3 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.8 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) PostgreSQL Un moteur de base de données PostgreSQL en version 8.3.x doit être installé. Page 4 de 40
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-portal5.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-portaltunnel-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-portaldependencies-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 Page 5 de 40
1.12 Jackrabbit Lien :http://archive.apache.org/dist/jackrabbit/2.1.1/jackrabbit-webapp-2.1.1.war Page 6 de 40
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 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 tomapps4-1.5.0.zip lilie-web-actualite-1.5.0.war (à renommer en web-actualite.war) lilie tomapps3-1.5.0.zip lilie-ria-admin-ihm-1.5.0.war (à renommer en admin.war) lilie tomapps2-1.5.0.zip cas-server-webapp-lvl2-1.5.0.war (à renommer en connexion-scol.war) lilie tomapps1-1.5.0.zip cas-server-webapp-lvl1-1.5.0.war (à renommer en connexion.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) lilie tomapps5-1.5.0.zip Page 7 de 40
lilie tomapps6-1.5.0.zip 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-web-viescolaire-1.5.0.war (à renommer en web-viescolaire.war) 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 lilie-ws-prttunnel-1.5.0.war (à renommer en ws-prttunnel.war) /webapps/ /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) Page 8 de 40
tomapps2 (configuration du serveur tomapps2) tomapps3 (configuration du serveur tomapps3) tomapps4 (configuration du serveur tomapps3) tomapps5 (configuration du serveur tomapps3) tomapps6 (configuration du serveur tomapps3) 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. Page 9 de 40
3 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 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 Page 10 de 40
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 Page 11 de 40
3.7 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 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 liliedump-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 Page 12 de 40
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 Name Owner Encoding -----------------------+-------------------+---------actualite postgres administration annuaire postgres eliot-docs msgaccueil signets jack UTF8 UTF8 UTF8 postgres UTF8 postgres postgres gestionressources lportal UTF8 postgres eliot-scolarite ftp postgres postgres blog forum UTF8 UTF8 UTF8 postgres postgres postgres postgres postgres UTF8 UTF8 UTF8 UTF8 UTF8 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 Page 13 de 40
3.9 des instances de serveurs tomcat Pré-requis : Apache doit être démarré pour la suite de l'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-scolarite.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=%TOMCAT_HOME%\param\config_annuairepb.properties -Dapirecherche.config=%TOMCAT_HOME%\param\config_apirecherche.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_importfederateur.properties -Dincident.config=%TOMCAT_HOME%\param\config_incident.properties -Dinitialisation.config= %TOMCAT_HOME%\param\config_initialisation.properties -Dliferay.config=%TOMCAT_HOME%\param\config_liferay.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=%TOMCAT_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_signets.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_viescolaire.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- Page 14 de 40
lite.xml -Dactualite-portlet.log4j=%TOMCAT_HOME%\param\log_actualite-portlet.xml -Dalimentation.log4j=%TOMCAT_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_importfederateur.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 -Drecherche.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_viescolaire.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. Page 15 de 40
Les neufs instances de tomcat ainsi créées contiennent alors : 3.6 le paramétrage serveur /conf les librairies /common/lib le répertoire de trace /logs le répertoire temporaire /temp 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 : Page 16 de 40
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 Page 17 de 40
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 Page 18 de 40
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/ Page 19 de 40
Utiliser le compte suivant pour s'authentifier : Identifiant : ent.admin Mot de passe : 1234 tomapps2 : applications 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) Page 20 de 40
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/ Page 21 de 40
url : https://local.lilie.org/web-annuaire/ url : https://local.lilie.org/web-incident/ Page 22 de 40
url : https://local.lilie.org/web-recherche/ Page 23 de 40
url : https://local.lilie.org/web-signets/ tomapps3 : applications Pré-requis : Le serveur tomauth doit être démarré pour la suite de l'installation. 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) Page 24 de 40
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-ressources1.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/ Page 25 de 40
url : https://local.lilie.org/web-blog/ url : https://local.lilie.org/web-forum/ Page 26 de 40
url : https://local.lilie.org/web-servicesext/ url : https://local.lilie.org/web-gestion-resources/ url : https://local.lilie.org/web-ftp/ tomapps4 : applications Page 27 de 40
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) Démarrer le tomcat tomapps4 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/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. Page 28 de 40
url : https://local.lilie.org/eliot-messagerie-app/ tomapps5 : applications Pré-requis : Le serveur tomauth doit être démarré pour la suite de l'installation. Cette instance va contenir les wars d'applications de l'ent. Déployer les wars suivant sur cette instance : Page 29 de 40
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) Démarrer le tomcat tomapps5 puis effectuer le test suivant : Si nécessaire utiliser le compte suivant pour s'authentifier : Identifiant : lucie.ginette Mot de passe : 123456 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) Page 30 de 40
tomapps6 : applications Pré-requis : Le serveur tomauth doit être démarré pour la suite de l'installation. 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) Démarrer le tomcat tomapps6 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/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) Page 31 de 40
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-docs1.5.0.war contenu dans lilie tomdemon-1.5.0.zip) eliot-demon-docs-app.war (issu du renommage de lilie-demon-scolarite1.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) Page 32 de 40
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. 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/ Page 33 de 40
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 admin.war -Xmx1024m solr.war --XX:MaxPermSize=256m jackrabbit.war -Dsolr.solr.home= [répertoire d'installation]\tomapps1\solr tomapps2 HTTP : 8002 -Xms768m web-actualite.war Page 34 de 40
AJP : 7002 -Xmx1024m --XX:MaxPermSize=256m web-annuaire.war web-logos.war web-recherche.war web-signets.war tomapps3 HTTP : 8003 AJP : 7003 -Xms768m -Xmx1024m --XX:MaxPermSize=256m 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 --XX:MaxPermSize=256m eliot-docs-app.war eliot-messagerie-app.war eliot-textes-app.war tomapps5 HTTP : 8005 AJP : 7005 -Xms768m -Xmx1024m --XX:MaxPermSize=128m web-viescolaire.war eliot-notes-app.war eliot-absences-app.war tomapps6 HTTP : 8006 AJP : 7006 -Xms768m -Xmx1024m --XX:MaxPermSize=256m eliot-scolarite-app.war eliot-agenda-app.war ria-chat.war tomdemon HTTP : 8007 AJP : 7007 -Xms768m -Xmx1024m --XX:MaxPermSize=256m 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 Page 35 de 40
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/webapps/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. Sur l'instance tomportail, cd batchinit/./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é Page 36 de 40
Sur l'instance tomportail, cd batchinit/./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/webapps/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-annuaire1.5.0.zip\ Dans le dossier TRAITEMENT_MANUEL se trouve un exemple factice de données à importer (des établissements, 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 etablissement_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 Page 37 de 40
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. Page 38 de 40
9 Synchronisation du portail Attention : Il faut mettre à jour la ligne «axis.servlet.hosts.allowed= 127.0.0.1,10,» dans le fichier /tomportail/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é. Page 39 de 40
10 Comptes utilisateurs Pour se connecter à l'ent vous pouvez utiliser les utilisateurs suivants : Type Nom Login Mot de passe Établissement Enseignant Chazal Sylvie sylvie.chazal Enseignant Honoré de Balzac Enseignant Ginette Lucie Lucie.ginette Enseignant Honoré de Balzac Direction Rougier Claire claire.rougier Direction Honoré de Balzac Documentation Goudron Claire claire.goudron Documenta- Honoré de Balzac tion 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 Mot de passe 123456 Mot de passe scolarité 72D23C1 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 Page 40 de 40