Doc/Houat

Notice :

Application sous contrat de Maintenance.

Montage

/dev/sda1 on / type ext3 (rw,errors=remount-ro)                                                               
/dev/proc on /proc type proc (rw)                                                                             
/dev/sys on /sys type sysfs (rw)                                                                              
/dev/devpts on /dev/pts type devpts (rw,gid=5,mode=620)                                                       
/dev/sda2 on /home type ext3 (rw)                                                                             
/dev/shm on /dev/shm type tmpfs (rw)                                                                          
none on /proc/sys/fs/binfmt_misc type binfmt_misc (rw)                                                        
/home/www/archives-etat-valais/data/cdc on /home/Etat-Valais/cdc type none (rw,bind)                          
/home/www/archives-etat-valais/data/ead on /home/Etat-Valais/ead type none (rw,bind)                          
/home/www/archives-etat-valais/data/pdf on /home/Etat-Valais/pdf type none (rw,bind)

Installation d'une application Pléade

Création d'un sous-domaine

On crée un sous-domaine à partir du manager d'OVH :

• On sélectionne le domaine ajlsm.com;
• On crée une Zone DNS;
• de Type CNAME;
• On renseigne le formulaire Zone DNS :

  Sous-domaine : pleade-social-media;
  Host : houats ????????????????????

Ouverture d'une session sur le serveur

On récupère les codes d'accès au serveur, puis on ouvre une session sur le serveur :

user@ile$ sudo gpg --decrypt ~/workspace/internals/srv-houat.asc
user@ile$ ssh ajlsm@ns206795.ovh.net

Installation de l'application Web

Sur le serveur, on créer le répertoire webapp pour son application :

ajlsm@houat$ mkdir /home/www/pleade-social-media

On copie l'archive de son application sur le serveur :

user@ile$ cd ~workspace/pleade-social-media/build
user@ile$ tar -cv webapp | bzip2 > pleade-social-media-webapp.tar.bz2
user@ile$ scp pleade-social-media-webapp.tar.bz2 ajlsm@ns206795.ovh.net:/home/www/pleade-social-media
ajlsm@houat$ tar xjfv pleade-social-media-webapp.tar.bz2
ajlsm@houat$ rm -f pleade-social-media-webapp.tar.bz2

On adapte le fichier de paramètres pleade-social-media/webapp/parametres.xconf à la nouvelle configuration :

ajlsm@houat$ nano pleade-social-media/webapp/parametres.xconf

Intégration de l'application Web

On crée un hôte virtuel pour le serveur Apache de la forme :

ajlsm@houat$ more /etc/httpd/conf.d/pleade-social-media.ajlsm.com.conf

<VirtualHost *:80>
  ServerName pleade-social-media.ajlsm.com

  #Activation page de maintenance
  #Alias /maintenance.html /home/www/ad52/maintenance.html
  RewriteCond %{REQUEST_URI} !maintenance.html       

  ProxyPass / ajp://localhost:8009/pleade-social-media/
  ProxyPassReverse / ajp://localhost:8009/pleade-social-media/        
</VirtualHost>

On crée un lien symbolique pleade-social-media dans le répertoire des applications Web de Tomcat 6 webapps vers le répertoire webapp de notre application :

ajlsm@houat$ cd /usr/share/tomcat6/webapps
ajlsm@houat$ ln -s /home/www/pleade-social-media/webapp pleade-social-media

On redémarre les serveurs Tomcat et Apache :

sudo /sbin/service tomcat6 stop
sudo /sbin/service tomcat6 start
sudo /sbin/service httpd restart

Vérification

On vérifie que l'installation fonctionne :

user@ile$ mozilla http://pleade-social-media.ajlsm.com/ &

Préparer une formation

On placera les applications pour la formation dans le dossier : /home/www/formation/. Pour se faire, on commencera par placer l'application dite matrice/générique, à partir de laquelle on créera les autres instances.

Configuration de l'application générique

L'application de base doit être modifiés pour contenir des placeholder (chaine de texte précise) dans les fichiers de propriétés. Les scripts décrit ci-après s'appuient sur la présence de ces placeholders pour générer chaque instance. Dans notre cas, la chaîne est la suivante à ne pas supprimer: « user-# »

Voici une liste des configurations présente dans <app>/WEB-INF/properties/pleade-admin.properties qu'il est utile de modifier.

To do :

Si votre application utilise d'autre fichier .properties voyez si les paramètres doivent être modifiés.

pleade.url-interne=http://localhost:8080/user-#
pleade.public-url=http://user-#.ajlsm.com/
pleade.static-content=context://module-eadeac/pages
pleade.theme-dir=context://theme
pleade.sdx-data-dir=context://module-eadeac/datadir
pleade.sdx-database=
pleade.sdx-ead-repository=
pleade.sdx-eac-repository=
pleade.eadeac.fs-pdf=file:///home/www/formation/pdf/
pleade.eadeac.fs-files=/home/www/formation/multimedia/
pleade.ead-docs-dir=file:///home/www/formation/ead/
pleade.cdc-src=context://module-eadeac/conf/cdc/FRAD033_EFG.xml
pleade.img-server.racines=/home/www/formation/images
pleade.images.preparees=/home/www/formation/images-preparees

Création des instances

On duplique l'application générique autant d'exemplaire que nécessaire :

appGenerique="ad33-recette-2012-dec-10/"
userCount=5
for i in $(seq 1 $userCount); do
	cp -R "$appGenerique" ./user-"$i"
	sed -i "s/user-\#/user-$i/g" ./user-"$i"/WEB-INF/properties/pleade-admin.properties
done

Activer dans tomcat

Ensuite il faut lier les applications dans Apache Tomcat :

cd /usr/share/tomcat6/webapps
for i in /home/www/formation/user-*; do ln -s "$i" $(basename "$i"); done

Configurer les hôtes virtuels

Notice :

Vous devez être en root pour configurer les hôtes virtuels.

su -

On se place dans le dossier de Httpd pour créer l'hôte virtuel de chaque application :

cd /etc/httpd/conf.d/

Le fichier formation-generique.conf est un fichier générique qui servira de matrice pour créer les hôtes virtuels de chaque application de la formation.

vhostGenerique="formation-generique.conf"
userCount=5
for i in $(seq 1 $userCount); do
	cp "$vhostGenerique" ./formation-user-"$i".conf
	sed -i "s/user-\#/user-$i/g" ./formation-user-"$i".conf
done

Récupération des images

Si l'on a besoin d'images, il est possible d'extraire la liste des <daoloc> des documents à l'aide de la commande xmlstarlet. On stockera la valeur de l'attribut href dans un fichier txt.

xmlstarlet sel -t -m "//daoloc" -v "./@href" -n ./*.xml > ./images-formation.txt

Une fois la liste généré on travaille sur le serveur où sont les données et on créé une archives basés sur la liste :

 cat images-formation.txt | xargs tar czvf images-formations.tar.gz