Étape 5: Configuration du serveur web


  Flag for language en  Flag for language fr   Flag for language zh 
Version actuellement sélectionnée:

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

ATTENTION!
Les noms de fichiers et répertoires de configuration sont donnés ci-dessous pour une distribution Fedora. Les autres distributions peuvent avoir des noms différents. En particulier, consultez cette astuce pour Debian et Ubuntu.

En toutes circonstances, vérifiez soigneusement l'exactitude des fichiers de configuration générés. De plus, en contexte multi-arbres, éliminez les canaux et racines virtuelles en double. Les dernières se produisent fréquemment quand la racine virtuelle commune est remplacée pour quelques arbres (la racine commune est alors dupliquée pour les occurrences non remplacées).

Serveur web Apache

L' étape de configuration a créé un fichier custom.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 custom.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 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/ $ cp lib/Local.pm /usr/lib/perl5/site_perl/

Serveur web lighttpd

L' étape de configuration a créé un fichier custom.d/lighttpd-lxrserver.conf.

Versions 2.1 et supérieures: Version 2.0: Versions 1.1 et inférieures:
  • LXR versions 2.1 et supérieures

    Vérifiez que le fichier principal /etc/lighttpd/lighttpd.conf permet l'exploitation des hôtes virtuels. La dernière directive du fichier ne doit pas être commentée:

    include_shell "cat /etc/lighttpd/vhosts.d/*.conf"

    Vérifier aussi que le "mode CGI simple" est activé dans le fichier /etc/lighttpd/modules.conf, i.e. la ligne suivante de la section CGI modules n'est pas commentée:

    include "conf.d/cgi.conf"

    Le fichier de configuration custom.d/lighttpd-lxrserver.conf ne doit normalement pas nécessiter d'ajustement manuel, sauf l'élimination des doublons. Copiez-le à son emplacement final:

    $ cp custom.d/lighttpd-lxrserver.conf /etc/lighttpd/vhosts.d/ Il est automatiquement lu lors de l'initialisation du serveur et fusionné avec lighttpd.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/lighttpd/vhosts.d/.

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

    Si vous avez besoin de (re)démarrer lighttpd, tapez la commande suivante en tant que root:

    $ systemctl restart lighttpd.service

Faites contrôler le fichier de configuration:

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

Lancez le serveur web lighttpd.

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

    Tapez ctl-C pour arrêter lighttpd.

  • service général
    • avec le service systemd opérationnel

      Copiez d'abord le fichier de configuration à son emplacement attendu:

      $ cp custom.d/lighttpd-lxrserver.conf /etc/lighttpd/conf.d

      Démarrez le serveur:

      $ systemctl start lighttpd.service

      Pour arrêter lighttpd, tapez:

      $ systemctl stop lighttpd.service
    • sans systemd (sur une seule ligne ou avec des marques de continuation) $ LIGHTTPD_CONF_PATH="/path/to/lxr/custom.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.

Problèmes avec SELinux

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/

Vérification finale

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.