fr/LXR 0.9-0.10 Configuration serveur web

Les versions LXR 0.9 et 0.10 sont périmées, l'information n'est conservée ici que pour référence historique.

Ces versions contiennent de nombreux bugs, dont certains peuvent être qualifiés de "bloquants". Si vous envisagez d'installer un tout nouveau service LXR, préférez systématiquement la dernière version. Vous profiterez d'une amélioration considérable de la performance et l'installation est notablement plus facile.

Les rapports d'anomalie ne sont pas acceptés.

La dernière tâche est de configurer le serveur web. Les instructions ci-dessous sont données pour Apache et mod_perl.

Le document INSTALL des versions précédentes de LXR disait de modifier httpd.conf. Ceci présente de sérieux inconvénients. Une meilleure approche est d'écrire votre configuration dans un fichier lxrserver.conf (n'importe quel nom convient pourvu que l'extension soit .conf) à placer dans /etc/httpd/conf.d/. Il est automatiquement lu lors de l'initialisation du serveur et fusionné avec httpd.conf. Vous pouvez en garder une copie dans votre répertoire personnel et, quand le logiciel du serveur est mis à jour, tout ce que vous avez à faire est de copier de nouveau ce fichier dans le répertoire /etc/httpd/conf.d/.

L'accès au répertoire /etc/httpd/conf.d/ nécessite les privilèges de root.

Faites pointer DocumentRoot vers le répertoire racine de LXR et permettez un accès public Alias /lxr /usr/local/share/lxr <Directory /usr/local/share/lxr> AllowOverride All Order allow,deny Allow from all </Directory> Si vous êtes à cheval sur la sécurité, vous pouvez remplacer la directive AllowOverride par la suivante moins permissive AllowOverride FileInfo Limit Options
- Sous Apache version 2.x, des pas supplémentaires sont nécessaires.
  Ajoutez la ligne:
  PerlRequire /usr/local/share/lxr/apache2-require.pl
  Puis, selon le type de MPM (déterminé par la commande suivante):
  $ apachectl -V Server version: Apache/2.2.21 (Unix) … Server MPM: Prefork …
  - Si la ligne Server MPM affiche Prefork:
    Vous n'avez normalement pas besoin de modifier apache2-require.pl. Le contenu ci-dessous est "universel": @INC= ( @INC , "." # <- LXR root directory , "./lib", # <- LXR library directory ); Si, toutefois, vous rencontrez des difficultés, vous pouvez utiliser des chemins absolus vers les répertoires dans lesquels LXR et sa bibliothèque sont installés. Voir plus bas le contenu pour Worker.
  - Si la ligne Server MPM affiche Worker: $ apachectl -V Server version: Apache/2.2.21 (Unix) … Server MPM: Worker …
    Vous pouvez remplacer la ligne PerlRequire par la ligne suivante, mais ce n'est pas obligatoire (cette ligne est une directive mod_perl version 2 plus précise pour charger le script de démarrage):
    PerlPostConfigRequire /usr/local/share/lxr/apache2-require.pl
    et vous devez modifier deux fichiers:
    - Dans apache2-require.pl, écrivez tous les chemins sous forme absolue
      i.e. pour service global:
      @INC= ( @INC , "/usr/local/share/lxr" # <- LXR root directory , "/usr/local/share/lxr/lib", # <- LXR library directory );
      ou pour installation privée:
      @INC= ( @INC , "/home/your_userid/lxr" # <- LXR root directory , "/home/your_userid/lxr/lib", # <- LXR library directory );
    - dans .htaccess-apache2
      remplacez la ligne
      PerlHandler ModPerl::RegistryPrefork
      par
      PerlHandler ModPerl::Registry
Sauvegardez le fichier à un endroit pratique et copiez-le dans /etc/httpd/conf.d/.
D'autres directives de configuration sont déjà groupées dans des fichiers fournis.
Vous devez placer ces fichiers à leurs emplacements attendus.
- Avec Apache version 1.x $ cp .htaccess-apache1 .htaccess $ cp Local.pm /usr/lib/perl5/site_perl/ $ cp -r lib/LXR /usr/lib/perl5/site_perl/
- Avec Apache version 2.x $ cp .htaccess-apache2 .htaccess
Si vous n'avez pas installé mod_perl, LXR fonctionne sans modification comme scripts CGI.
Vous n'avez besoin que de copier le fichier suivant:
$ cp .htaccess_cgi .htaccess
Si vous rencontrez ultérieurement des difficultés avec SELinux (alertes de sécurité liées au répertoire racine de LXR)
Les scripts et leurs répertoires doivent être spécialement étiquetés pour les faire reconnaître comme exécutant du code dans un contexte classics. Ceci est implicite quand ils sont situés dans /var/www/cgi-bin/. Pour supprimer les alertes, la méthode la plus fiable est de copier le contexte de /var/www/cgi-bin/ par la commande suivante:
$ chcon --reference /var/www/cgi-bin -R LXR_root_directory/

Démarrez votre navigateur web et aller à http://localhost/lxr/source. Vous devriez voir le contenu du répertoire de la version par défaut de votre arbre.