Pleade Configurer un serveur

Pré-requis Serveur

Propriété	Recommandations minimales	Description
RAM	≥8Go	dépends du volume de donnée à indexé et servir
Processeur	amd64 (≥4 cœurs)	* dépends du volume de donnée à indexé et servir
OS	Ubuntu Server ≥12.04 Debian ≥6.0.6 Red Hat (RHEL) ≥6.3 CentOS ≥6.3	De préférence Ubuntu Server (LTS uniquement) ou Debian (stable uniquement).
Disque	SSD ; HDD ≥7200rpm ;	-
Partition racine /	≥20Go	formatage ext4
Partition de données /home	≥100Go	formatage ext4 ; La taille de la partition /home dépends du volume de données.
Shell	Bash ≥4	-
Serveur Web	Httpd (Apache2) ≥2.2	activé les module : cgi, proxy_ajp, rewrite, vhost_alias
Java	JRE ≥1.6.30	environnement applicatif. Remarques : Java7 n'est pas encore supporté.
Serveur Java	Tocmat6 ≥6.0.36	Prendre le binaire. Remarques : Tomcat7 n'est pas encore supporté.
Base de données	PostgreSQL ≥9.1 MySQL ≥5.5	-
Utilisateur	ajlsm	* propriétaire de tomcat (arrêt/redémarrage).

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 bmon tree nload bwm-ng openssl-blacklist openssl-blacklist-extra finger parted php5

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.

On vérifiera que le service PostgreSQL redémarre bien après un redémarrage du serveur physique :

chkconfig --list postgresql # RedHat/CentOS, à installer sur Debian/Ubuntu

On attends le résultat suivant<ref>Runlevel: Linux Standard Base specification</ref> :

postgresql      0:off   1:off   2:on    3:on    4:on    5:on    6:off

Apache

On crée un hôte virtuel VirtualHost pour chaque site, pour plus d'informations voir Apache HTTPd. On crée une passerelle entre Apache 2.0 et Tomcat.

La commande Modèle:A2enmod permet d'activer les modules disponibles de Apache 2.0.

Les modules les plus utilisés sont disponibles par défaut avec Apache 2.0, les autres doivent être installés.

La commande suivante active les modules couramment mis en oeuvre pour un hôte virtuel et une passerelle entre Apache 2.0 et Tomcat :

a2enmod alias auth_basic authn_file authz_default authz_groupfile authz_host \
authz_user autoindex cgi deflate dir env mime negotiation php5 proxy proxy_ajp \
 reqtimeout rewrite setenvif status

Notice :

Les modules jk et proxy_http ont été supprimés de la liste des modules. En effet, il suffit d'utiliser un des module jk, proxy_http ou proxy_ajp..

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.

Accès client

On consultera la procédure Accès client au serveur.

Voir aussi

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

Commandes utilisées pour une installation Debian 11

nano /etc/network/interfaces
   30  ifconfig
   31  ipconfig
   32  ip =a
   33  ip -a
   34  ip a
   35  ip a
   36  ping 10.0.0.19
   37  sudo su ajlsm
   38  su ajlsm
   39  apt install vim
   40  apt install htop
   41  htop
   42  vim -v
   43  apt install apache
   44  apt install apache2
   45  service apache2 restart
   46  vim /etc/apache2/apache2.conf 
   47  systemctl restart apache2
   48  ls java7/
   49  /home/ajlsm/java7/jre1.7.0_80/bin/java
   50  ls /home/ajlsm/java7/jre1.7.0_80
   51  ls /home/ajlsm/tomcats/preprod/bin/catalina.pid 
   52  rm /home/ajlsm/tomcats/preprod/bin/catalina.pid 
   53  apt install mysql-server
   54  apt install mysql-community-server
   55  apt install mysql-server
   56  apt update
   57  apt install mysql-server
   58  systemctl stop mysql
   59  apt install gnupg
   60  cd /tmp/
   61  wget 'https://dev.mysql.com/downloads/file/?id=509020'
   62  wget https://dev.mysql.com/get/mysql-apt-config_0.8.22-1_all.deb
   63  ls
   64  dpkg -i mysql-apt-config_0.8.22-1_all.deb 
   65  clear
   66   /home/ajlsm/
   67  dpkg -i mysql-apt-config_0.8.22-1_all.deb 
   68  cd /home/ajlsm/
   69  clear
   70  dpkg -i mysql-apt-config_0.8.22-1_all.deb 
   71  exit
   72  echo $PATH
   73  history
   74  exit
   75  echo $PATH
   76  dpkg -i mysql-apt-config_0.8.22-1_all.deb 
   77  history
   78  exit
   79  ls
   80  cd /home/ajlsm/
   81  dpkg -i mysql-apt-config_0.8.22-1_all.deb 
   82  echo $PATH
   83  echo $PATH
   84  exit
   85  echo $PATH
   86  mysql
   87  exit
   88  ls
   89  cd /home/ajlsm/
   90  ls
   91  dpkg -i mysql-apt-config_0.8.22-1_all.deb 
   92  apt update
   93  apt install mysql-server
   94  mysql_secure_installation
   95  mysqladmin -u root -p
   96  mysql -u root -p
   97  groupadd pleade
   98  apt install imagemagick
   99  convert -v
  100  convert -v
  101  vips -v
  102  apt instal lighttpd
  103  apt install lighttpd
  104  apt install iipimage-server
  105  vim /etc/lighttpd/lighttpd.conf 
  106  ls /etc/lighttpd/
  107  ls /etc/lighttpd/conf-enabled/
  108  ls /etc/lighttpd/conf-available/
  109  vim /etc/lighttpd/lighttpd.conf 
  110  ls /usr/lib/iipimage-server/iipsrv.fcgi
  111  touch /etc/lighttpd/conf-available/20-iipsrv.conf
  112  vim /etc/lighttpd/conf-available/20-iipsrv.conf
  113  touch /var/log/iipsrv-lighttpd.log
  114  chmod -R 777 /var/log/iipsrv-lighttpd.log
  115  lighty-enable-mod fastcgi
  116  lighty-enable-mod iipsrv
  117  service lighttpd force-reload
  118  service lighttpd stop
  119  service lighttpd start
  120  exit
  121  python -V
  122  htop
  123  htop
  124  ls /var/data/pleade.com-data/
  125  cd /home/ajlsm/
  126  vim tomcats/preprod/bin/catalina.sh 
  127  vim tomcats/preprod/bin/catalina.sh 
  128  ls /etc/apache2/
  129  ls /etc/apache2/conf-available/
  130  ls /etc/apache2/conf-enabled/
  131  vim /etc/apache2/conf-enabled/other-vhosts-access-log.conf 
  132  vim /etc/apache2/conf-enabled/apache2-doc.conf 
  133  ls /etc/apache2/sites-enabled/
  134  vim /etc/apache2/sites-available/000-default.conf 
  135  systemctl stop apache2
  136  systemctl start apache2
  137  systemctl status apache2.service
  138  ls /etc/apache2/mods-available/
  139  a2enmod alias buffer cache_disk cgid cgi deflate headers proxy_ajp proxy proxy_connect proxy_fcgi proxy_html request rewrite session ssl status vhost_alias
  140  systemctl start apache2
  141  systemctl status apache2.service
  142  ls /etc/apache2/mods-available/
  143  apt install php-fpm
  144  a2enmod proxy_fcgi
  145  systemctl start apache2
  146  systemctl stop apache2
  147  systemctl start apache2
  148  systemctl status apache2.service
  149  a2dissmode iipsrv
  150  a2dismode iipsrv
  151  a2dismod iipsrv
  152  systemctl start apache2
  153  vim /etc/apache2/sites-available/000-default.conf 
  154  lynx 'http://localhost:9001/iipsrv/iipsrv.fcgi'
  155  apt install lynx
  156  apt install lynx
  157  lynx 'http://localhost:9001/iipsrv/iipsrv.fcgi'
  158  lynx 'http://localhost:9000/iipsrv/iipsrv.fcgi'
  159  lynx 'http://localhost:9001'
  160  vim /etc/lighttpd/conf-enabled/20-iipsrv.conf 
  161  lynx 'http://localhost:9001/fcgi-bin/iipsrv.fcgi'
  162  vim /home/ajlsm/pleades/preprod/WEB-INF/properties/pleade-plus.properties 
  163  vim /etc/apache2/sites-available/000-default.conf 
  164  systemctl stop apache2
  165  systemctl start apache2
  166  vim /etc/apache2/sites-available/000-default.conf 
  167  systemctl stop apache2
  168  systemctl start apache2
  169  vim /etc/apache2/sites-available/000-default.conf 
  170  vim tomcats/preprod/webapps/pleade/WEB-INF/pleade-users.xconf 
  171  vim tomcats/preprod/webapps/pleade/WEB-INF/properties/pleade-admin.properties 
  172  htop
  173  vim /etc/apache2/sites-available/000-default.conf 
  174  ls /var/log/apache2/
  175  tail -f /var/log/apache2/error.log
  176  a2enmod proxy_http
  177  systemctl stop apache2
  178  systemctl start apache2
  179  vim /etc/apache2/sites-available/000-default.conf 
  180  service apache2 restart
  181  cd /etc/apache2/sites-enabled/

Références

<references/>