ChainEdit. Documentation d'installation

Transcription

1 ChainEdit Documentation d'installation Auteurs Romuald Lorthioir CIRM Université de Rennes 1 mail : romuald.lorthioir@univ-rennes1.fr Nadia Henry CIRM Université de Rennes 1 Date de création 20/08/2007 Sources Version Tutorial d'installation ORI Windows Tutorial d'installation ORI Linux 1

2 Table des matières Introduction... 3 Pré requis Linux... 4 Installer Mandriva Spring Free...5 Installation de Java...6 Déclaration des variables d'environnement...6 Test...6 Installation de ANT... 7 Déclaration des variables d'environnement...7 Test...7 Installation de Tomcat... 8 Tomcat-users.xml...8 Copie... 8 Test...8 Pré requis Windows...9 Installation de Java...10 Déclaration des variables d'environnement...10 Test...11 Installation de ANT Déclaration des variables d'environnement...13 Test...14 Installation de Tomcat Tomcat-users.xml...15 Installation de l'application...16 Installation de l'application Paramétrage de l'application Fichier web.xml Fichier auth.xml Fichier navigation-rules.xml Fichier domain.xml Fichier exceptionhandling.xml...22 Fichier init.xml...22 Fichier ldap.xml Fichier portal.xml...22 Fichier smtp.xml Fichier urlgenerator.xml...24 Lancement de l'application Tester l'application

3 Introduction L'objectif de ce document est de faciliter l'installation de l'application ChainEdit. Ainsi, il est décrit une installation des différents éléments nécessaires au bon fonctionnement de l'application (JAVA, ANT, TOMCAT). Ces explications sont données à titre indicatives et doivent être adaptées à chaque contexte et pratiques des services informatiques. L'ensemble des pré requis et des installations des éléments d'infrastructure (Linux, Windows, JAVA, ANT, TOMCAT) sont très inspirés de la documentation réalisée dans le cadre du projet ORI-OAI ( La seconde partie décrit les éléments spécifiques à l'application et les différents fichiers de paramétrage à modifier. 3

4 Pré requis Linux En tant que root, créez le répertoire chainedit sous /usr/local et affectez l'utilisateur chainedit comme propriétaire du répertoire («su», «cd /usr/local», «mkdir chainedit»). Créez ensuite le répertoire download sous /usr/local/chainedit et affectez l'utilisateur chainedit comme propriétaire des répertoires chainedit et download («cd /usr/local/chainedit», «mkdir download», «cd..», «chown -R chainedit:root chaineidt»). Tous les fichiers téléchargés devront être placés dans le répertoire : /usr/local/chainedit/download. Assurez vous que l'utilisateur chainedit a bien tous les droits (RWX) sur ces fichiers. Logiciel Mandriva Spring Free JAVA (JDK 5.0 Update 11 Source télécharger l'image iso (4,4Go) par exemple jdk-1_5_0_12-linux-i586-rpm.bin ANT 1.7 TOMCAT 5.5 Serveur LDAP : OpenLDAP Browser LDAP Schéma SUPANN Tex.php Optionnel pour le traitement du Latex apache-ant bin.tar.gz apache-tomcat tar.gz télécharger le fichier Jxv3.2deploy.zip supann.schema _ortho_et_tex et 4

5 Installer Mandriva Spring Free Insérer le DVD Mandriva dans le lecteur et suivre les instructions qui s'affichent à l'écran. Au cours de l'installation, indiquez les informations ci-dessous pour compléter la configuration : Niveau de sécurité : STANDARD Choisir : Utiliser l'espace disponible Mot de passe root : «admin» Créer un utilisateur : login : «chainedit» mot de passe : «chainedit» clic sur avancé : groupe : «root» A la fin de l'installation, lorsque le serveur est relancé, il faut configurer le réseau. Allez dans le menu Mandriva, Système, Configuration, Configurer votre ordinateur (mot de passe : «admin»). Menu Réseau & Internet, Configurer une nouvelle connexion internet. Choisir Ethernet, cliquez sur Suivant. Cliquez sur Configuration manuelle. Cochez Autoriser les utilisateurs à gérer la connexion. Voulez vous démarrer la connexion maintenant : oui. Le réseau est maintenant opérationnel. 5

6 Installation de Java NE PAS INSTALLER LE JAVA FOUNI AVEC MANDRIVA Ouvrir une console en tant que root. Placez vous dans le répertoire /usr/local/chainedit/download. Changez les droits : «chmod 755 jdk-1_5_0_12-linux-i586.rpm.bin». Tapez «./jdk-1_5_0_12-linux-i586-rpm.bin». Suivez les instructions. Déclaration des variables d'environnement Éditez le fichier /home/chainedit/bash_profile et ajoutez : ANT_HOME=/usr/local/chainedit/apache-ant export ANT_HOME PATH=$PATH:$ANT_HOME/bin export PATH Fermez la session et ouvrez une nouvelle connexion en tant qu'utilisateur chainedit (mot de passe «chainedit» afin que les variables d'environnement soient chargées). Test Lorsque la session est démarrée, ouvrez une fenêtre terminal et tapez : «ant -version». Vous devriez avoir l'affichage suivant : Si vous ne voyez pas cet affichage, vérifiez que les variables sont bien définies puis 6

7 redémarrez le serveur et essayez à nouveau la commande «ant -version». Installation de ANT NE PAS INSTALLER ANT FOUNI AVEC MANDRIVA En tant qu'utilisateur chainedit, placez vous dans le répertoire /usr/local/chainedit/download/. Tapez : «tar -xvf apache-ant bin.tar.gz». Déplacez le répertoire apache-ant dans /usr/local/chainedit : «mv apache-ant /». Déclaration des variables d'environnement Éditez le fichier /home/chainedit/bash_profile et ajoutez : ANT_HOME=/usr/local/chainedit/apache-ant export ANT_HOME PATH=$PATH:$ANT_HOME/bin export PATH Fermez la session et ouvrez une nouvelle connexion en tant qu'utilisateur chainedit (mot de passe «chainedit» afin que les variables d'environnement soient chargées). Test Lorsque le session est démarrée, ouvrez une fenêtre terminal et tapez : «ant -version». Vous devriez avoir l'affichage suivant : 7

8 Si vous ne voyez pas cet affichage, vérifiez que les variables sont bien définies puis redémarrez le serveur et essayez à nouveau la commande «ant -version». Installation de Tomcat Nous allons utiliser un serveur Tomcat pour l'application plus facilement) En tant qu'utilisateur chainedit, allez sans le répertoire /usr/local/chainedit/download. Tapez : «tar -xvf apache-tomcat tar.gz». Tomcat-users.xml Ouvrez le fichier tomcat-users.xml (/usr/local/chainedit/download/apache-tomcat /conf/). Ajoutez l'utilisateur admin : <tomcat-users> <user name="tomcat" password="tomcat" roles="tomcat" /> <user name="role1" password="tomcat" roles="role1" /> <user name="both" password="tomcat" roles="tomcat,role1" /> <user name="admin" password="admin" roles="admin,manager" /> </tomcat-users> Enregistrez le fichier. Ouvrez le fichier catalina.sh (/usr/local/ori/download/apache-tomcat /bin/). Ajoutez (après la grande section de commentaires) export CATALINA_OPTS="-Dfile.encoding=UTF-8 $CATALINA_OPTS" Enregistrez le fichier. Copie Créer un tomcat pour l'application. Allez dans le répertoire /usr/local/chainedit/download. Tapez «cp -R apache-tomcat /tomcat-chainedit». Test Ne pas oublier de mettre le serveur en ISO : 8

9 setenv LANG ''fr_fr_iso88591'' setenv LANGAGE ''fr_fr_iso88591'' Pour accéder au menu manager de chaque serveur TOMCAT, démarrer tomcat (/usr/local/chainedit/tomcat-chainedit/bin/startup.sh), ouvrez un navigateur et allez à la page « login : «admin» mot de passe : «admin». Pré requis Windows Logiciel Windows XP PRO SP2 JAVA (JDK 5.0 Update 11 Source jdk-1_5_0_11-windows-i586-p.exe ANT 1.7 TOMCAT 5.5 7ZIP pour décompresser apache-ant bin.zip apache-tomcat zip 9

10 Installation de Java Cliquez sur le fichier jdk-1_5_0_11-windows-i586-p.exe, indiquez C:\Java\jdk1.5.0_11\ comme répertoire pour le JDK (première partie de l'installation) et C:\Java\jre1.5.0_11\ pour le JRE : Déclaration des variables d'environnement Plusieurs méthodes existent pour accéder au menu d'ajout ou de modification des variables d'environnement, choisissez en une parmi : Allez dans le menu démarrer, clic droit sur le poste de travail, propriété, Avancé, et cliquer sur Variables d'environnement. A partir du bureau clic droit sur le poste de travail, propriété, Avancé, et cliquer sur Variables d'environnement. Allez dans le menu démarrer, Panneau de configuration (affichage par catégories), Performance et maintenance, Système, Avancé, et cliquer sur Variables d'environnement. Allez dans le menu démarrer, Panneau de configuration (affichage classique), Système, Avancé, et cliquer sur Variables d'environnement. 10

11 Dans la partie variables système créer une variable «JAVA_HOME» et donnez lui «C:\Java\jdk1.5.0_11» comme valeur : Modifiez la variable «PATH» et rajoutez «C:\Java\jdk1.5.0_11\bin;» au début de la ligne : Test Pour tester l'installation, allez dans le menu démarrer, cliquez sur exécuter, dans la case ouvrir, tapez «cmd», une fenêtre DOS s'ouvre. Tapez la commande «java -version» dans cette fenêtre DOS. Vous devriez avoir la réponse suivante: JAVA est maintenant installé. Si vous n'avez pas cet affichage, vérifiez que les variables 11

12 sont bien définies puis redémarrez windows et essayez à nouveau la commande «java -version». 12

13 Installation de ANT Décompressez le fichier apache-ant bin.zip dans C:\apache-ant Déclaration des variables d'environnement Allez dans le menu démarrer, clic droit sur le poste de travail, propriété, Avancé, et cliquer sur variables d'environnement. Dans la partie variables système créer une variable «ANT_HOME» et donnez lui «C:\apache-ant-1.7.0» comme valeur : 13

14 Modifiez la variable «PATH» et rajoutez «C:\apache-ant-1.7.0\bin;» au début de la ligne : Test Pour tester l'installation, allez dans le menu démarrer, cliquez sur exécuter, dans la case ouvrir, taper «cmd», une fenêtre DOS s'ouvre. Tapez la commande «ant -version» dans cette fenêtre DOS. Vous devriez avoir la réponse suivante : Si vous ne voyez pas cet affichage, vérifiez que les variables sont bien définies puis redémarrez windows et essayez à nouveau la commande «ant -version». 14

15 Installation de Tomcat Nous allons utiliser un serveur Tomcat. Décompressez le fichier apache-tomcat zip dans c:\tomcat-chainedit Tomcat-users.xml Modifiez le fichier conf\tomcat-users.xml et ajoutez le user admin : <tomcat-users> <user name="tomcat" password="tomcat" roles="tomcat" /> <user name="role1" password="tomcat" roles="role1" /> <user name="both" password="tomcat" roles="tomcat,role1" /> <user name="admin" password="admin" roles="admin,manager" /> </tomcat-users> Pour chaque serveur TOMCAT, le login/mot de passe pour accéder au menu manager est admin/admin. 15

16 Installation de l'application Installation de l'application Téléchargez le zip de l'application. Décompressez le zip Installer le zip dans le répertoire /webapps de Tomcat Modifier le paramétrage de l'application. Ce paramétrage est à modifier dans tous les cas en fonction des paramètres spécifiques à votre environnement (Sauf en cas d'installations pré-paramétrée). Attention! Pour fonctionner correctement, il faut que l'application fonctionne sur un serveur d'application fonctionnant en ISO Au lancement de l'application, il est donc conseillé de positionner les variables d'environnement suivante dans le script de lancement : setenv LANG ''fr_fr_iso88591'' setenv LANGAGE ''fr_fr_iso88591'' 16

17 Paramétrage de l'application Fichier web.xml Si l'application fonctionne avec un serveur d'authentification SSO CAS, il faut indiquer l'adresse du serveur CAS de votre établissement ainsi que l'adresse du site au retour du CAS. Sinon aucune modification n'est nécessaire. <context-param> The logout URL of the CAS server. <param-name>edu.yale.its.tp.cas.client.logouturl</param-name> <param-value> </param-value> </context-param> <filter> The CAS filter, used to authenticate users. <display-name>casfilter</display-name> <filter-name>cas Filter</filter-name> <filter-class> edu.yale.its.tp.cas.client.filter.casfilter </filter-class> <init-param> <param-name> edu.yale.its.tp.cas.client.filter.loginurl </param-name> <param-value> </param-value> </init-param> <init-param> <param-name> edu.yale.its.tp.cas.client.filter.validateurl </param-name> <param-value> </param-value> </init-param> <init-param> <param-name> edu.yale.its.tp.cas.client.filter.servername </param-name> <param-value>localhost:8080</param-value> </init-param> <init-param> <param-name> edu.yale.its.tp.cas.client.filter.wraprequest </param-name> <param-value>true</param-value> </init-param> </filter> 17

18 Fichier auth.xml L'application peut être utilisée avec une authentification CAS ou une authentification manuelle. Pour le préciser, il faut modifier le fichier en mettant en commentaire certains paramètres comme suit: Mode manuel : <!-- CAS <bean id="authenticationservice" class="org.esupportail.commons.services.authentication. PortalOrCasFilterAuthenticator"> The name of the Portal attribute that holds the uid of users, as set in portlet.xml. <property name="uidportalattribute" value="uid" /> </bean> --> <!-- manual --> <bean id="authenticationservice" class="org.esupportail.chainedit.services.authentication. ManualAuthentication"> For Manual authentication. <property name="contextloginattributename" value="chaineditlogin"> The file where users are stored. </bean> Mode CAS : Dans ce cas, il ne faut pas oublier de paramétrer tomcat avec le bon certificat pour garantir les échanges avec le serveur CAS. <!-- CAS --> <bean id="authenticationservice" class="org.esupportail.commons.services.authentication. PortalOrCasFilterAuthenticator"> The name of the Portal attribute that holds the uid of users, as set in portlet.xml. <property name="uidportalattribute" value="uid" /> </bean> <!-- manual <bean id="authenticationservice" class="org.esupportail.chainedit.services.authentication. 18

19 ManualAuthentication"> For Manual authentication. <property name="contextloginattributename" value="chaineditlogin"> The file where users are stored. --> </bean> Fichier navigation-rules.xml En fonction du mode d'authentification précisé dans le fichier auth.xml il est nécessaire d'effectuer une modification dans le fichier navigation-rules.xml : Mode manuel : <!-- For other authentication <navigation-case> <from-outcome>navigationlogin</from-outcome> <to-view-id>/stylesheets/login.jsp</to-view-id> <redirect /> </navigation-case> --> <!-- For manual authentication --> <navigation-case> <from-outcome>navigationlogin</from-outcome> <to-view-id>/stylesheets/manuallogin.jsp</to-view-id> <redirect /> </navigation-case> Mode CAS : <!-- For other authentication --> <navigation-case> <from-outcome>navigationlogin</from-outcome> <to-view-id>/stylesheets/login.jsp</to-view-id> <redirect /> </navigation-case> <!-- For manual authentication --> <navigation-case> <from-outcome>navigationlogin</from-outcome> <to-view-id>/stylesheets/manuallogin.jsp</to-view-id> <redirect /> </navigation-case> 19

20 Fichier domain.xml C'est dans ce fichier que doivent être indiqués les différents chemins d'accès aux fichiers de paramétrage de Chainedit. Si une connection Ldap est utilisée pour récupérer les information utilisateur et que cet annuaire ne respecte pas la norme SupAnn, il faut également modifier les propriétés relatives à l'annuaire (Les propriétés dont le nom contient LdapAttribute). <property name="displaynameldapattribute" value="displayname" > The name of the LDAP attribute used to retrieve the display name of the users from the LDAP directory. <property name="nameldapattribute" value="sn" > The name of the LDAP attribute used to retrieve the name of the users from the LDAP directory. <property name="lastnameldapattribute" value="givenname" > The name of the LDAP attribute used to retrieve the last name of the users from the LDAP directory. <property name="mailldapattribute" value="mail" > The name of the LDAP attribute used to retrieve the mail of the users from the LDAP directory. Chemin d'un répertoire qui contiendra les fichiers temporaires. Par exemple c:/temp ou /tmp sous Linux. <property name="uploaddirectory" value="c:/temp" > The directory where uploaded files are stored. <property name="usersfile" value="/properties/domain/users.xml"> The file where users are stored. Indiquer le chemin d'installation de l'application. Par exemple c:\chainedit\projets\projets.xml ou /data/chainedit/projets/projets.xml <property name="projectsfile" value="c:\chainedit\projets\projets.xml"> The file where projets are stored. Indiquer le chemin d'installation de l'application. <property name="chartesfile" value="c:\chainedit\chartes\chartes.xml"> 20

21 The file where graphics chartes are stored. Indiquer le chemin d'installation de l'application. <property name="pathprojects" value="c:\chainedit\application\projets"> The directory where projets are stored. Indiquer le chemin d'installation de l'application. <property name="pathconfigs" value="c:\chainedit\configs"> The directory where config files are stored. Indiquer le chemin d'installation de l'application. <property name="pathchartes" value="c:\chainedit\chartes"> The directory where chartes files are stored. <property name="anonymoususer" value="anonymous" > The file where users are stored. Indiquer l'url d'accès au répertoire qui contiendra les sites générés. Si ce répertoire ne se trouve pas dans le répertoire application, il est nécessaire de créer un «Context» Apache qui va permettre d'y accéder. <property name="urlresult" value=" > The url for parsing result access Indiquer l'url d'accès au service qui va permettre d'interpréter les saisies latex pour les transformer en fichiers image. <property name="pathtexplugin" value=" > The url of php code for Latex transformation. 21

22 Fichier exceptionhandling.xml Indiquer l'adresse mail où les messages d'erreur seront envoyés. <property name="recipient " > The address the exception reports will be sent to. This property is optional; if the tag is ommited or empty, then no mail is sent. Fichier init.xml Indiquer l'identifiant de l'utilisateur qui sera administrateur principal de l'application (si vous utilisez une authentification CAS et un LDAP, cet identifiant doit exister). <property name="firstadministratorid" value="admin" > The id of the first administrator of the application. This user will be created and set as administrator when the database is initialized with 'ant init'. Fichier ldap.xml Si vous n'utilisez pas un annuaire LDAP aux normes SupAnn, vous devrez également modifier les attributs listés dans ce fichier. Indiquer l'url du serveur LDAP. <property name="url" value="ldap://ldapglobal.mydomain.fr:389"> The LDAP URL of the directory. Fichier portal.xml Ce fichier n'est à modifier que si vous souhaitez tester l'application en Portlet. 22

23 Fichier smtp.xml Ce fichier contient les paramètre nécessaires à l'envoi de messages électronique à destination de l'équipe de maintenance ou pour l'envoi de mail par l'application. <bean id="smtpservice" class="org.esupportail.commons.services.smtp.asynchronoussmtpserviceimpl" > This bean is used to send s. It must implement interface org.esupportail.commons.services.smtp.smtpservice. <property name="servers"> The SMTP servers to try. <list> <ref bean="smtpserver" /> </list> <property name="fromaddress" ref="smtpfromaddress" > The 'from' address to use when sending s. <property name="interceptaddress" ref="smtpinterceptaddress" > The address to which _all_ the s should be sent. This tag is particularly useful when setting up the application to prevent from spam effects. When no tag is used, then all the s are normally sent to their recipients. <property name="testaddress" ref="smtpinterceptaddress" > The address to which test s (sent by ant target tets-smtp) will be sent. </bean> <bean id="smtpfromaddress" class="javax.mail.internet.internetaddress" > see above. Indiquer ici une adresse mail valide. C'est l'adresse qui apparaîtra dans le From des messages. <property name="address" /> <property name="personal" value="user" /> </bean> <bean id="smtpinterceptaddress" class="javax.mail.internet.internetaddress" > 23

24 see above. Indiquer ici une adresse mail valide. <property name="address" /> <property name="personal" value="user Name" /> </bean> <bean id="smtpserver" class="org.esupportail.commons.services.smtp.smtpserver" > This beans describes a SMTP server. Indiquer ici l'adresse du serveur smtp qui servira à l'émission des messages, ainsi que le port et les paramètres utilisateur. <property name="host" value="smtp.domain.fr" > The host name or IP number of the server, defaults to localhost. <property name="port" value="25" > The port number the SMTP server is running on (defaults to 25). <property name="user" value="user1" > The SMTP user (comment or leave empty for an anonymous connection). <property name="password" value="secret" > The SMTP password (ignored for an anonymous connection). </bean> Indiquer ici l'adresse du serveur smtp de secours qui servira à l'émission des messages, ainsi que le port et les paramètres utilisateur. <bean id="smtpserver2" class="org.esupportail.commons.services.smtp.smtpserver"> <property name="host" value="smtp2.domain.org" /> <property name="port" value="25" /> <property name="user" value="user2" /> <property name="password" value="secret" /> </bean> Fichier urlgenerator.xml??????????????????????????????? 24

25 Lancement de l'application Lancer le serveur Tomcat : Sous Windows : Lancer le fichier C:\tomcat-chainedit\bin\startup.bat Ouvrez un navigateur WEB et allez dans le manager (« login : «admin» mot de passe «admin» Sous Linux : /usr/local/chainedit/tomcat-chainedit/bin/startup.sh, ouvrez un navigateur et allez à la page« login : «admin» mot de passe : «admin». Tester l'application Ouvrez un navigateur et connectez vous à l'adresse de l 'application par exemple. Vous devez obtenir l'écran suivant : 25

26 Pour tester l'authentification, cliquez sur connexion. En fonction du mode choisi, vous devez voir apparaître l'écran de login manuel ou l'écran d'authentification CAS de votre établissement : 26