Étape 7: configuration du serveur web


  Flag for language en  Flag for language fr  
L'utilisation de LXR 0.11 est déconseillée, sauf si vous ne pouvez pas amener votre interpréteur Perl à la version 5.10 au minimum.

Cette version est figée et contient encore des bugs qui ont été corrigés dans les versions ultérieures. Seuls les rapports d'anomalies ayant trait à la "compatibilité" seront acceptés.

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

Serveur web Apache

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 proposée avec la version 0.11. L'étape de préconfiguration a créé un fichier lxrconf.d/apache-lxrserver.conf à copier dans /etc/httpd/conf.d/. Il est automatiquement lu lors de l'initialisation du serveur et fusionné avec httpd.conf. 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.

Copiez le fichier dans le répertoire de configuration d'Apache:

$ cp lxrconf.d/apache-lxrserver.conf /etc/httpd/conf.d Ce fichier est valide aussi bien pour Apache version 1.x que pour la version 2.x.

Le fichier de configuration "de répertoire" .htaccess a été créé par l'étape de préconfiguration et est déjà placé dans le répertoire racine de LXR. Modifiez-le pour autoriser le listage de répertoire ou lui appliquer d'autres préférences personnelles.

  • Apache version 1.x

    mod_perl pour Apache 1.x ne peut accéder qu'à la bibliothèque sytème de Perl. En conséquence, vous devez y copier la bibliothèque privée de LXR:

    $ cp -r lib/LXR/* /usr/lib/perl5/site_perl/

Serveur web lighttpd

L'étape de préconfiguration a créé un fichier lxrconf.d/lighttpd-lxrserver.conf à utiliser comme base de configuration pour LXR. Révisez et éditez ce fichier.

lighttpd fonctionne grâce à des modules: les modules nécessaires doivent être chargés par le fichier de configuration. Un ensemble minimal de modules est énuméré dans le fichier templates/lighttpd/lighttpd-lxr-modules.conf. Si d'autres modules sont nécessaires, copiez le fichier lighttpd-lxr-modules.conf dans le répertoire lxrconf.d/, ouvrez-le et changez une directive dans le fichier de configuration. Descendez jusqu'à la section Load the modules pour vérifier la directice include.

include "/LXR_root_directory/lxrconf.d/lighttpd-lxr-modules.conf"

La configuration spécifique de LXR est située à la fin du fichier dans LXR section.

Décommentez la directive $HTTP. Dupliquez-la un nombre de fois égal à celui des noms d'hôte. Remplacez la chaîne host_name par vos noms d'hôte. Exemple:

$HTTP["host"] == "192.168.1.1" { server.document-root = "/usr/local/share/lxr/" }

Faites contrôler le fichier de configuration:

$ lighttpd -t -f lxrconf.d/lighttpd-lxrserver.conf

Lancez le serveur web lighttpd.

  • service individuel $ lighttpd -D -f lxrconf.d/lighttpd-lxrserver.conf

    Tapez ctl-C pour arrêter lighttpd.

  • service général (sur une seule ligne) $ LIGHTTPD_CONF_PATH="/path/to/lxr/lxrconf.d/lighttpd-lxrserver.conf" \ ./scripts/lighttpd-init start

    Pour arrêter lighttpd, tapez:

    $ ./scripts/lighttpd-init stop
Si vous exploitez déjà un serveur lighttpd, L'incorporation de LXR dans la configuration globale vous est laissée en exercice.

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 "normal". 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.