3.5.3. Microsoft IIS

Bugzilla fonctionne avec IIS comme une application CGI classique. Ces instructions supposent que vous utilisez Windows 7 ou Windows 10. Les procédures pour les autres versions sont probablement similaires.

Commencer par démarrer le Gestionnaire des services Internet (IIS). Démarrer --> Outils d'administration --> Gestionnaire des services Internet (IIS). Ou lancer la commande :

inetmgr

3.5.3.1. Créer une nouvelle Application

Développer votre Serveur jusqu'à ce que Default Web Site affiche ses éléments.

Faire un clic droit sur Default Web Site et sélectionner Ajouter une application… dans le menu contextuel.

Sous Alias, saisir l'alias du site Web. C'est le chemin pour le domaine où vous voulez voir apparaître Bugzilla.

Dans Chemin d'accès physique, saisir le chemin d'accès à Bugzilla, par exemple C:\Bugzilla.

Quand c'est terminé, cliquer sur OK.

3.5.3.2. Configurer le document par défaut

Cliquer sur l'application qui vient d'être créée. Faire un double clic sur Document par défaut, et cliquer sur Ajouter… dans le menu Actions.

Dans Nom, saisir index.cgi.

Tous les autres documents par défaut peuvent être supprimés pour cette application.

Avertissement

Ne pas supprimer le document par défaut pour Site Web par défaut.

3.5.3.3. Ajouter un mappage de gestionnaire

Assurez-vous d'être dans le site Web par défaut. Dans la section IIS, faites un double clic sur Mappages de gestionnaires. Dans la section Actions à droite, cliquez sur Ajouter un mappage de scripts…. Vous devez faire ceci à deux reprises.

Pour le premier, indiquez les valeurs suivantes (en modifiant les chemins d'accès si nécessaires) :

  • Chemin des demandes : *.pl
  • Exécutable : C:\Perl\bin\perl.exe "%s" %s%
  • Nom : Mappage de script Perl

Cliquez sur OK et sur l'invite qui apparaît, cliquez sur Oui.

Note

L'installeur ActiveState Perl a peut-être déjà créé cette entrée pour les fichiers .pl limité à GET,HEAD,POST. Si c'est le cas, ce mappage doit être supprimé car les fichiers *.pl de Bugzilla ne sont pas conçus pour être exécutés par un serveur Web.

Pour le second, indiquez les valeurs suivantes (adaptez les chemins si nécessaire) :

  • Chemin des demandes : *.cgi
  • Exécutable : C:\Perl\bin\perl.exe "%s" %s%
  • Nom : CGI Script Map

Cliquez sur OK et sur l'invite qui apparaît, cliquez sur Oui.

3.5.3.4. Application Bugzilla

Assurez-vous d'être dans l'application Bugzilla. Dans la section IIS à droite, faites un double clic sur Mappages de gestionnaires. Dans la section Actions, cliquez sur Ajouter un mappage de scripts….

Indiquez les valeurs suivantes (adaptez les chemins si nécessaire) :

  • Chemin des demandes : *.cgi
  • Exécutable : C:\Perl\bin\perl.exe -x"C:\Bugzilla" -wT "%s" %s
  • Nom : Bugzilla

Cliquez sur OK et sur l'invite qui apparaît, cliquez sur Oui.

Il faut à présent redémarrer le serveur IIS pour que les changements soient pris en compte. À partir du menu supérieur, qui contient le nom de votre machine, cliquer sur Redémarrer sous Gérer le serveur. Ou exécuter la commande :

iisreset

3.5.3.5. Activer les règles de réécriture pour REST

Les URL REST sont habituellement de la forme http://.../bugzilla/rest/version au lieu de http://.../bugzilla/rest.cgi/version. Pour permettre à IIS de rediriger les URL rest/ vers rest.cgi, vous devez télécharger et installer l'extension URL Rewrite pour IIS. Les liens de téléchargement directs sont disponibles au bas de la page pour les architectures Windows x86 et x64.

Une fois installée, ouvrez le gestionnaire de IIS à nouveau et rendez-vous dans votre application Bugzilla. De là, faites un double clic sur Réécriture d'URL. Cliquez alors sur Ajouter une règle dans le menu Actions et cliquez sur Règle vide dans la section Règles entrantes.

Remplissez les champs comme suit. Les autres champs n'ont pas besoin d'être modifiés.

  • Nom: REST
  • Motif: ^rest/(.*)$
  • Réécriture d'URL: rest.cgi/{R:1}

Il n'est pas nécessaire de redémarrer IIS. Les modifications prennent effet immédiatement.

3.5.3.6. Problèmes courants

Bugzilla s'exécute mais il n'est pas possible de se connecter.

Vous avez probablement configuré IIS pour utiliser la DLL ISAPI d'ActiveState -- en d'autres termes, vous utilisez PerlEx, ou IIS est configuré pour utiliser PerlS.dll ou Perl30.dll.

Reconfigurer IIS pour utiliser perl.exe.

IIS renvoie des erreurs HTTP 502.
Vous avez probablement oublié l'argument -T dans la ligne de commande perl en configurant l'exécutable dans IIS.

Cette documentation contient très probablement des bogues ; si vous en découvrez, veuillez les signaler ici.