3.7. Configuration post-installation essentielle

Bugzilla est configuré dans les paramètres d'administration. Connectez-vous avec le compte administrateur que vous avez défini lors de la dernière exécution de checksetup.pl, puis cliquez sur Administration dans l'en-tête, puis sur Paramètres. Vous verrez alors les différentes sections des paramètres.

3.7.1. Paramètres

Il y a beaucoup de paramètres importants à définir (ou à décider de ne pas changer).

Les premiers d'entre eux sont dans la section Paramètres requis.

  • urlbase : L'URL racine de cette installation de Bugzilla.
  • sslbase : L'URL racine de toutes les URL HTTPS (SSL) de Bugzilla.
  • ssl_redirect : Définissez ce paramètre si vous voulez que tout le monde soit redirigé vers la version SSL. Recommandé si vous avez paramétré SSL.
  • cookiepath : Bugzilla utilise des cookies pour se rappeler des utilisateurs. Pour que les cookies soient correctement définis, vous devrez définir une racine pour les cookies. Si Bugzilla est à la racine de votre domaine, vous n'avez pas besoin de modifier la valeur par défaut.

Vous pourriez vouloir indiquer votre adresse électronique dans le paramètre maintainer dans la section Général. Cela permettra aux utilisateurs de savoir qui contacter en cas de problèmes.

Si vous voulez que personne ne puisse lire les pages de Bugzilla, définissez le paramètre requirelogin dans la section Authentification utilisateur et modifier ou effacer la valeur du paramètre createemailregexp.

3.7.2. Courriel

Bugzilla nécessite l'utilisation de courriels. Il existe plusieurs possibilités. Le plus simple est d'utiliser une adresse de Gmail ou d'un autre fournisseur pour faire le travail, mais vous pouvez aussi utiliser un serveur de messagerie local ou en installer un sur le serveur hébergeant Bugzilla.

Les paramètres concernant les courriels sont définis dans la section Courriel.

3.7.2.1. Utiliser un autre serveur de messagerie

Cette section correspond au choix mail_delivery_method dans la partie SMTP.

Cette méthode traite les courriels en utilisant un serveur de messagerie existant. Votre organisation en dispose peut-être déjà d'un pour la gestion des courriels internes et préfère l'utiliser pour des raisons de confidentialité. Si c'est le cas, vous aurez besoin des informations suivantes :

  • Le nom de domaine du serveur (paramètre : smtpserver)
  • Le nom d'utilisateur et le mot de passe à utiliser (paramètres : smtp_username et smtp_password)
  • Si le serveur utilise SSL (paramètre: smtp_ssl)
  • L'adresse à partir de laquelle envoyer les courriels (paramètre : mailfrom)

Si votre organisation ne dispose pas de son propre serveur de messagerie, vous pouvez utiliser les services de différents fournisseurs.

Gmail

Rendez-vous sur https://gmail.com et créez un nouveau compte Gmail pour Bugzilla. Ensuite, renseignez les paramètres suivants dans la section Courriel :

  • mail_delivery_method : SMTP
  • mailfrom : nouvelle_adresse_gmail@gmail.com
  • smtpserver : smtp.gmail.com:465
  • smtp_username : nouvelle_adresse_gmail@gmail.com
  • smtp_password : nouveau_mot_de_passe_gmail
  • smtp_ssl : On

3.7.2.2. Utiliser son propre serveur de messagerie

Cette section correspond au choix de mail_delivery_method de Sendmail.

À moins de savoir ce que vous faites et de pouvoir gérer les possibles problèmes de courriels indésirables, de rejet et de listes noires, il n'est pas recommandé de configurer votre serveur de messagerie juste pour Bugzilla. Cependant, si vous souhaitez le faire, voici quelques indications.

Sous GNU/Linux, tout MTA (Mail Transfer Agent) compatible avec Sendmail suffira. Sendmail, Postfix, qmail et Exim sont des exemples de MTA courants. Sendmail est le MTA original d'Unix, mais les autres sont plus faciles à configurer et par conséquent, beaucoup de gens remplacent Sendmail par Postfix ou Exim. Ce sont des remplacements transparents donc Bugzilla ne fera pas la différence.

Si vous utilisez Sendmail, la version 8.7 ou supérieure est requise. Si vous utilisez un MTA compatible avec Sendmail, il doit être congruent avec au moins la version 8.7 de Sendmail.

Sous OS X 10.3 et versions suivantes, Postfix est utilisé comme solution de serveur de messagerie par défaut. Postfix fournit un exécutable qui se comporte comme sendmail et suffit pour utiliser Bugzilla.

Sous Windows, si vous n'arrivez pas à utiliser la gestion SMTP intégrée à Bugzilla (par ex. parce que les modules Perl nécessaires ne sont pas disponibles), vous pouvez utiliser Sendmail avec une petite application appelée sendmail.exe, qui fournit des fonctionnalités compatibles sendmail et encapsule la communication SMTP pour un autre serveur de messagerie. Comme Bugzilla, sendmail.exe peut être configuré pour journaliser les communications SMTP dans un fichier pour pouvoir déboguer en cas de problème.

Le paramétrage d'un MTA est en dehors du périmètre de ce document. Consultez le manuel du MTA que vous avez choisi pour des instructions d'installation détaillées. Chacun de ces programmes a ses propres fichiers de configuration où vous devez configurer certains paramètres pour vous assurer que les courriels seront distribués correctement. Ils sont mis en œuvre en tant que services et vous devez vous assurer que le MTA est dans la liste de démarrage automatique des services de votre machine.

Si un simple courriel envoyé avec la ligne de commande mail fonctionne, alors Bugzilla devrait fonctionner correctement.

3.7.2.3. Dépannage

Si vous rencontrez des problèmes, vérifiez que le serveur SMTP peut être joint pas votre serveur Bugzilla et que les identifiants de connexion sont valides. Si le paramètrage vous semble correct et que vos courriels ne sont toujours pas envoyés, vérifiez si votre distribution utilise SELinux ou AppArmor. Ceux-ci peuvent empêcher votre serveur Web d'envoyer des courriels. Le paramètre booléen SELinux httpd_can_sendmail devra peut-être être défini à « True ».

Si cela ne fonctionne toujours pas, activez le paramètre smtp_debug et consultez les journaux de votre serveur Web.

3.7.3. Produits, composants, versions et jalons

Les bogues dans Bugzilla sont classés dans des Produits, lesquels contiennent des composants. Vous pouvez facultativement activer le paramètre useclassifications. Les Catégories sont un niveau supérieur des Produits).

Bugzilla fournit par défaut un produit appelé « TestProduct », qui contient un seul composant, appelé avec beaucoup d'imagination « TestComponent ». Vous pouvez créer vos propres produits et composants. Vous pouvez avoir un seul composant par produit si vous le voulez. Les produits ont des versions (qui représentent la version du logiciel dans lequel le bogue a été trouvé) et des jalons cibles (qui représentent la future version dans lequel le bogue sera corrigé --ou, pour les bogues avec l'état RÉSOLU, la version dans laquelle ils ont été résolus).

Quand vos produits seront créés, vous pourrez supprimer le produit « TestProduct » (ce qui supprimera automatiquement le composant « TestComponent »). Veuillez noter que si vous avez créé un bogue dans « TestProduct » pour faire un essai, vous devrez le déplacer dans un autre produit avant de pouvoir supprimer « TestProduct ».

Maintenant, vous voudrez peut-être effectuer d'autres paramétrage optionnels dans Configuration post-installation facultative.


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