Doc/Ville-Dole

Tomcat

Important :

L'installation comprendre 2 instances Apache Tomcat. De ce fait, la version installé avec les dépôts Debian ne doit pas être utilisé.

Localisation des serveur

Nous avons installé la version 6.0.35 (binaire) de Apache Tomcat à partir du site officiel et créé deux dossiers, respectivement :

• /opt/tomcat6-front : sert l'application de « production »,
• /opt/tomcat6-back : sert l'application de « recettage ».

Liens vers l'application

Il faut créer un lien de l'application dans le dossier webapps/ de Apache Tomcat :

Configuration du serveur : server.xml

Il faut modifier les ports pour que l'application de production et de recettage puissent être autonome :

• arrêt : 8005 → 9005
• connecteur HTTP :
  • écoute : 8080 → 9090
  • redirection : 8443 → 9443
• connecteur AJP/1.3 :
  • écoute : 8009 → 9009
  • redirection : 8443 → 9443

Il faut également rajouter emptySessionPath=true sur le connecteur HTTP/1.1 et AJP/1.3 :

<Server port="9005" shutdown="SHUTDOWN">
⋮
    <Connector port="9090" protocol="HTTP/1.1" 
        connectionTimeout="20000" 
        redirectPort="9443" 
        emptySessionPath="true" 
    />
⋮
    <Connector port="9009" protocol="AJP/1.3" 
        redirectPort="9443" 
        emptySessionPath="true" 
    />
⋮

Scripts

Des alias on étaient définis dans le fichier ~/.bashrc pour simplifier la maintenance :

• tomcat-log : affiche le log tomcat de l'application ;
• restartTomcat : redémarre l'application ;
• flushAndRestart : nettoie le cache et redémarre l'application.

Le paramètre application, est nécessaire et peut prendre l'une des valeurs suivante :

• back : application de « recettage » ;
• front : application de « production ».

Application

L'application et les fichiers sont installé dans /home/ajlsm :

.
├── apps
│   ├── ville-dole-back
│   └── ville-dole-front
├── backup
├── data
│   └── ville-dole
├── logs
│   ├── ville-dole-back
│   └── ville-dole-front
├── sdx-data
│   ├── ville-dole-back
│   └── ville-dole-front
├── shell-scripts
│   ├── backup
│   ├── httpd-maintenance
│   └── logs
└── tmp

Apache

Nous avons défini un hôte virtuel pour l'application /etc/apache2/sites-enabled/ville-dole-vhost.conf

<VirtualHost *:80>
    ServerAdmin ajlsm+ville-dole@ajlsm.com

    ServerName ville-dole.com
    ServerAlias www.ville-dole.com  www.ville-dole.prod ville-dole.prod

    # Application de recette
    ProxyPass /ville-dole-back/ ajp://localhost:9009/ville-dole-back/
    ProxyPassReverse /ville-dole-back/ ajp://localhost:9009/ville-dole-back/

    # Application de production
    ProxyPass / ajp://localhost:8009/ville-dole/
    ProxyPassReverse / ajp://localhost:8009/ville-dole/

    ErrorLog ${APACHE_LOG_DIR}/error-ville-dole.log

    # Possible values include: debug, info, notice, warn, error, crit,
    # alert, emerg.
    LogLevel warn

    CustomLog ${APACHE_LOG_DIR}/access-ville-dole.log combined
</VirtualHost>

Application Pleade

Utilisateurs

Nous avons créer un compte pour les utilisateurs de la ville de Dole et un pour la gestion faite par AJLSM :

• ville-dole ;
• script : compte désactivé par mesure de sécurité.

Paramètres spéciaux

pleade.url-interne=http://localhost:8080/ville-dole/
⋮
pleade.sdx-data-dir=file:///home/ajlsm/sdx-data/ville-dole-front
⋮
pleade.log-file-directory=/home/ajlsm/logs/ville-dole-front
⋮
pleade.img-server.racines=/home/ajlsm/data/ville-dole/images/
⋮
pleade.images.preparees=/home/ajlsm/data/ville-dole/images-preparees/

Dépot OAI

Nous avons activez le dépôt OAI dans le fichier ./apps/ville-dole-front/parametres.xconf avec les paramètres suivants :

<ead-oai-repo-name>ville-dole</ead-oai-repo-name>
<ead-oai-repo-admin-email>s.sauge@dole.org</ead-oai-repo-admin-email>

Emplacement des fichiers d’autorités

Nous définissons l'emplacement des fichiers d'autorités dans ./apps/ville-dole-front/WEB-INF/properties/pleade-ville-dole.properties :

pleade.csv-docs-dir=/home/ajlsm/data/ville-dole/ead/

# Le fichier de template xsl.
pleade.ead-file=/home/ajlsm/data/ville-dole/AJSLM_PVR_RAM/AJSLM_PVR_DATA_EAD_5-fev-02-modifier.csv

# le fichier d'information sur les images
pleade.img-file=/home/ajlsm/data/ville-dole/AJSLM_PVR_DATA_IMG/AJSLM_PVR_IMG_5-modifier.csv

# le fichier d'autorite rameau
pleade.ram-file=/home/ajlsm/data/ville-dole/AJSLM_PVR_RAM/AJSLM_PVR_RAM_1-fev-02-modifier.csv