Configuration

• éditer le fichier ServletProperties du serveur (il est dans serveur_fr/WEB-INF/classes/paellos)
• éditer NOMSITE/constantes.jsp dans l'encodage UTF-8. Le nom du site doit correspondre au nom de l'application web, et donc au nom du dossier (on l'appelle NOMSITE par la suite).
• s'assurer que les fichiers de configuration ne sont pas en lecture pour tous (mais Tomcat doit pouvoir les lire)
• Si nécessaire, pour que Tomcat gère l'application web "NOMSITE", ajouter dans conf/server.xml de Tomcat les informations du fichier exemple_pour_tomcat_6_de_server.xml (il y a par exemple un connecteur pour rediriger les requêtes depuis Apache). Dans un premier temps il vaut mieux essayer sans modifier ce fichier (son édition n'est plus nécessaire depuis Tomcat 6).
• remplacer le fichier logo.png par celui de la formation
• vérifier que le connecteur Tomcat utilise URIEncoding="UTF-8" dans conf/server.xml (sinon les recherches ne marcheront pas avec des caractères accentués).

Si un gestionnaire de sécurité est activé (c'est par exemple le cas par défaut avec Ubuntu 9), il faut autoriser l'application web à faire des connexions avec mySQL en local, ainsi que lire les fichiers du site web, utiliser les fichiers de l'indexation pour les recherches sur le site, et utiliser certaines classes : créer un fichier tomcat6/conf/policy.d/paellos.policy, avec (en modifiant "NOMSITE", "serveur.smtp", "/var/www" et ".../index_lucene" si nécessaire) :

grant codeBase "file:${catalina.base}/webapps/NOMSITE/-" {
  permission java.net.SocketPermission "localhost:3306", "connect,resolve"; // acces a la base de donnees SQL
  permission java.net.SocketPermission "smtp.exemple.fr:25", "connect,resolve"; // envoi de mails
  permission java.io.FilePermission "/var/www/webjaxe/-", "read"; // lecture des fichiers de WebJaxe
  permission java.io.FilePermission "/var/www/public", "read"; // generation du site public
  permission java.io.FilePermission "/var/www/public/-", "read,write,delete"; // generation du site public
  permission java.io.FilePermission "${catalina.base}/webapps/NOMSITE/WEB-INF/sites", "read"; // sites de formation
  permission java.io.FilePermission "${catalina.base}/webapps/NOMSITE/WEB-INF/sites/-", "read,write,delete"; // sites de formation
  permission java.io.FilePermission "${catalina.base}/webapps/NOMSITE/WEB-INF/index_lucene/-", "read,write,delete"; // fichiers de l'indexation
  permission java.lang.RuntimePermission "accessClassInPackage.org.apache.jasper.compiler"; // compilation des jsp
  permission java.lang.RuntimePermission "accessClassInPackage.org.apache.jasper.compiler.*"; // compilation des jsp
};

• Si Apache est déjà utilisé comme serveur web principal, il est possible de l'utiliser pour toutes les requêtes avec des adresses particulières, et de rediriger les requêtes vers Tomcat. On peut faire cela avec le module d'Apache mod_jk. Il peut être nécessaire d'installer mod_jk s'il n'est pas déjà installé (sur Ubuntu, il peut aussi être nécessaire d'installer les mods include, rewrite et suexec pour Apache, et de changer le possesseur du répertoire webapps). On configure par exemple mod_jk ainsi dans httpd.conf :

  # remarque: avec Apache 2, ne pas utiliser AddModule, et remplacer httpd par apache2 dans les chemins
  AddModule mod_jk.c
  <IfModule mod_jk.c>
    JKLogFile /var/log/httpd/mod_jk.log
    JKWorkersFile /etc/httpd/workers.properties
    JKMount /NOMSITE/* PAELLOS
  </IfModule>
  

  et en ajoutant le fichier workers.properties à côté (s'il existe déjà, il faut le combiner).

  Dans chaque Virtualhost (typiquement les fichiers dans sites-enabled), il faut aussi ajouter:

  <IfModule mod_jk.c>
    JkMountCopy On
  </IfModule>
  

  Côté Tomcat, il faut un connecteur correspondant pour écouter les requêtes venant de Tomcat, comme décrit dans le fichier exemple_pour_tomcat_6_de_server.xml inclu dans PAELLOS.

• modifier éventuellement le fichier index.html d'entrée sur le site (il se trouve dans NOMSITE/site/) (par exemple pour désactiver les liens vers le forum et le chat s'ils ne sont pas utilisés)