Installation Ametys Workspaces

Installation Ametys Workspaces
Objet du document
Installation de l'application Ametys Workspaces et Intégration à l'ENT Esup
Environnement système
Serveur Linux Red Hat, java 6, tomcat 6, SGBD MySQL, Esup 2.6
Version des outils
L'application nécessite quelques outils tiers afin de s'exécuter correctement. La liste suivante présente donc les outils et leur version utilisé pour
l'environnement d'exécution :
Outils
Versions
Description
JRE
1.6
Machine virtuel Java
MySQL
5
Serveur de base de données
Red Hat Entreprise Linux
Tomcat
6
Esup
2.6
Cas
2
Nomenclature
Les paragraphes qui décrivent les tests pour vérifier la bonne marche de l'installation sont affichés sous fond bleu clair. Ainsi :
Test
Pour vérifier l'installation de l'élément précédent, ...
Ces tests sont facultatifs.
Les exemples de fichiers qu'il faut modifier ou les exemples de commandes à écrire dans une console sont affichés sous un fond jaune pâle. La
partie à saisir ou à modifier est mise en gras :
<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
<role rolename="tomcat"/>
<role rolename="role1"/>
<role rolename="manager"/>
*<user username="tomcat" password="tomcat" roles="tomcat,manager"/>*
<user username="both" password="tomcat" roles="tomcat,role1"/>
<user username="role1" password="tomcat" roles="role1"/>
</tomcat-users>
Certaines icônes ont pour but d'attirer votre attention sur des informations supplémentaires.
Point important : cette icône mets en évidence une contrainte ou un
contrôle ayant un fort impact sur l'installation et l'utilisation de
l'application. Le lecteur est fortement invité à lire et à prendre en
compte cette note.
Remarque : cette icône mets en évidence un point à noter ayant un
impact faible sur l'application. Le lecteur est invité à lire cette note.
Astuce : cette icône mets en évidence une technique permettant de
faciliter le travail du lecteur.
Procédure
Pré-requis
L'ENT doit être installé et configuré. La présente documentation ne concerne pas l'installation d'un ENT Esup. Un serveur CAS doit aussi être
configuré et fonctionnel (lié à esup).
Un nom de domaine permettant d'adresser l'application doit être disponible.
Un serveur de base de données doit être installé et il faut disposer soit d'un accès root soit d'une base dédiée à l'application avec un utilisateur
qui dispose de tous les droits sur cette base.
Pré-contrôles
Contrôler la version du système d'exploitation.
Test de la version du système d'exploitation
Dans une console shell, exécuter la commande suivante :
$ cat /proc/version
Linux version 2.6.18-92.1.6.el5 ([email protected]) (gcc version 4.1.2 20071124 (Red Hat 4.1.2-42)) #1 SMP Wed Jun 25
13:49:24 EDT 2008
Installation
Configuration du serveur apache
Il faut configurer le serveur apache afin qu'il réponde aux requêtes faites sur le nom de domaine dédié à l'application.
Création du fichier de configuration
Le fichier de configuration doit être créé sous /etc/httpd/conf.d/vhosts
Nommer ce fichier selon le nom de domaine par exempleged.sciencespobordeaux.fr.conf
Contenu du fichier
Exemple de contenu du fichier
<VirtualHost *:80>
ServerName srvgtest.sciencespobordeaux.fr
ServerAlias srvgtest
# Redirect / http://cas.sciencespobordeaux.fr:8080
#Protocols (SSLv2,SSLv3,TLSv1,All)
#SSLProtocol all
#SSLEngine on
# SSLCertificateFile /etc/httpd/ssl/wildcard.sciencespobordeaux.fr.crt
# SSLCertificateKeyFile /etc/httpd/ssl/wildcard.sciencespobordeaux.fr.key
DocumentRoot /usr/local/GED
RewriteEngine On
ProxyRequests Off
ProxyPass / http://srvgtest.sciencespobordeaux.fr:8080/
ProxyPassReverse / http://srvgtest.sciencespobordeaux.fr:8080/
<Location "/WEB-INF">
deny from all
</Location>
<Proxy http://srvgtest.sciencespobordeaux.fr:8080/\* (http://srvgtest.sciencespobordeaux.fr:8080/*)>
Order deny,allow
Allow from all
</Proxy>
CustomLog /var/log/httpd/ged.log combined
ErrorLog /var/log/httpd/ged.log
ServerSignature Off
</VirtualHost>
Rechargement du serveur
Relancer le serveur pour prendre en compte les modifications.
Configuration du serveur tomcat
Le serveur tomcat doit être configuré pour répondre aux requêtes qui lui seront transmises par le serveur apache.
Modification de server.xml
Il faut ajouter un host à la fin du fichier :
<Host name="ged.sciencespobordeaux.fr" xmlValidation="false" xmlNamespaceAware="false">
</Host>
Configuration de l'host
Créer un répertoire sous /usr/local/Tomcat/conf/Catalina au nom du host, dans notre cas ged.sciencespobordeaux.fr.
Dans ce répertoire, créer un fichier ROOT.xml :
<Context docBase="/usr/local/GED" privileged="true" antiResourceLocking="false" antiJARLocking="false">
</Context>
/usr/local/GED représente le chemin vers la webapp, donc il se peut que vous ayez à le modifier si vous ne déployez pas l'application au même
endroit.
Extraction de l'archive
L'archive livrée contient la webapp ainsi que les scripts de création de base de données.
Création de la base de données
Si la base n'est pas créée, créez en une, avec un utilisateur disposant de tous les droit dessus.
Il faut exécuter tous les scripts sql à l'exception des scripts full.sql, jdbc_users.sql et jdbc_groups.sql car les utilisateurs et les groupes sont gérés
par le ldap et esup.
Déploiement de l'application
Après avoir extrait l'archive copiez le répertoire GED dans /usr/local
Création du repository JCR
Il faut créer un répertoire qui va contenir le repository JCR par exemple /usr/local/data/repository.
Configuration de l'application
Créer un répertoire config sous GED/WEB-INF
Dans ce répertoire copier la configuration de l'application (config.xml)
Lancement de l'application
Pour lancer l'application lancer le tomcat.
Intégration à ESUP
Pour intégrer l'application à ESUP, créer un canal Iframe qui va appeler l'url de l'application.