Pleade Configurer un serveur

Installation des paquets requis

D'abord les paquets essentiel à l'administration UNIX et à l'application Pleade :

apt-get install vim vim-syntax-gtk locales sun-java6-jre tomcat6 apache2 imagemagick postgresql sudo graphicsmagick

Puis quelques autres paquets utiles :

apt-get install links2 openssl-blacklist openssl-blacklist-extra finger parted php5 nload bwm-ng bmon

Configuration des utilisateurs

voir Gestion d'utilisateurs UNIX

Configuration de la locale (fr_FR.UTF-8)

On travaille uniquement avec la locale UTF-8 Il existe une documentation pour les serveurs Debian<ref>Debian et UTF8</ref>. On installera le paquet de gestion des langues si il n'est pas présent et on configurera la langue par défaut :

apt-get install locales # installation du paquet pour les locales
dpkg-reconfigure locales # voir ci-dessous

1. On choisit les locales que l'ont veut (fr_FR.UTF-8), en_US.UTF-8 et éventuellement les locales historiques (fortement déconseillé) ;
2. on se déconnecte, re-connecte ;
3. on vérifie la locale avec la commande locale.

Si LC_TYPE, LC_LANG ou LC_LANGUAGE ne sont pas définit correctement, on ajoutera dans ~/.bashrc les lignes suivantes :

export LANGUAGE=fr_FR.UTF-8
export LC_ALL=fr_FR.UTF-8
export LANG=fr_FR.UTF-8

Remarques : Il est recommandé de surcharger la locale des messages dans ~/.bashrc et /root/.bashrc pour avoir les messages en anglais : LC_MESSAGES=en_US.UTF-8. Cela permet de trouver davantage de résultats dans les moteurs de recherche.

Tomcat6

Une instance

Si l'on veut une seule instance Apache Tomcat alors on utilisera le chemin /usr/share/tomcat6.

Deux instances ou plus

Dans le cas ou l'on veut plusieurs instance, une pour le « recettage » et une pour la « production », alors on téléchargera Apache Tomcat sur le site officiel et on l'installera dans le dossier /opt/. On créera un dossier pour chaque instance :

cd /opt/
wget -c http://mirrors.linsrv.net/apache/tomcat/tomcat-6/v6.0.35/bin/apache-tomcat-6.0.35.tar.gz
tar -xzf ./apache-tomcat-6.0.35.tar.gz
mv apache-tomcat-6.0.35 tomcat-front # instance de production
cp -R tomcat-front tomcat-back # instance de recettage
chown ajlsm:ajlsm -R ./* # attribution des droits à l'utilisateur 'ajlsm'

Si vous utilisez le fichier ~/.bashrc du dépot Git shell-scripts, il faut mettre à jour la variable tomcatFolder. De cette façon, les alias tomcat-log, restartTomcat, flushAndRestart seront fonctionnels.

Reconfiguration des droits

Après avoir installé Tomcat, on le reconfigurera pour que l'utilisateur ajlsm soit le propriétaire et le groupe de Apache Tomcat. Cela facilitera la gestion à l'avenir.

dpkg-reconfigure tomcat6

On utilisera les valeurs suivantes :

• utlisateur : ajlsm ;
• groupe : ajlsm ;
• Options Java (JAVA_OPTS) : -Xms400m -Xmx5000m -Djava.awt.headless=true -server -XX:+UseConcMarkSweepGC.

PostgreSQL

La procédure est détaillée dans la partie consacrée à PostgreSQL.

Apache

On utilise un hôte virtuel pour gérer l'application web et le lien avec Apache Tomcat, on trouvera un exemple dans la documentation consacré à Apache HTTPd. Il est nécessaire d'installer et d'activer un certains nombre de modules pour que l'application puissent fonctionnée avec Apache Tomcat :

a2enmod  alias auth_basic authn_file authz_default authz_groupfile authz_host \
authz_user autoindex cgi deflate dir env jk mime negotiation php5 proxy proxy_ajp \
proxy_http reqtimeout rewrite setenvif status # activation des modules

Application Pleade

Configuration des utlisateurs

Si l'installation à suivi l'arborescence de production alors on éditera le fichier apps/$projet/WEB-INF/pleade-users.xconf et on :

• supprimera le compte admin ;
• ajoutera le compte $projet et son mot de passe ;
• ajoutera un compte, commenté, pour les scripts :

<!--
    <user code="script"
        password="ajlsm:/vd/script"
        roles="admin,eadeac-admin,eadeac-editor,eadeac-web,thesx-editor"
        name="Script user"
        email="info@pleade.org" />
-->

Configuration des paramètres principaux

Si l'installation à suivi l'arborescence de production alors on éditera le fichier apps/$projet/WEB-INF/properties/pleade-admin.properties. Pour le détails des paramètres, veuillez consultez la section sur les Paramètres système de Pleade.

Dépôts OAI

Un premier test pourra être fait en consultant l'URL de vérification du dépôt OAI :

• http://ville-dole.prod/ead-oai?verb=Identify.

On pourra également vérifier la disponibilité d'un document EAD grâce à une URL de la forme :

• http://ville-dole.prod/ead-oai?verb=GetRecord&identifier=sdx:213.56.103.235:module-eadeac/ead/FR--391986102--1AP--1_AP_5-88&metadataPrefix=ead
  • 213.56.103.235, correspond au paramètre pleade.public-url décrit dans pleade /home/ajlsm/apps/ville-dole-front/WEB-INF/properties/pleade-admin.properties ;
  • FR--391986102--1AP--1_AP_5-88, correspond à l'identifiant d'un document EAD.

Sauvegardes

Nous utilisons un utilisateur special pour gérer les tâches de sauvegarde : backupAgent. Il a son propre compte UNIX, fait parti du groupe responsable de l'application et à son propre dossier personnel, dans lequel on place les sauvegardes (scénario par défaut).

La procédure est détaillée dans la section Doc/Script de Backup.

Voir aussi

• Fixing the annoying “perl: warning: Setting locale failed” error message

Références

<references/>