3.8. Configuration post-installation facultative

Bugzilla dispose de nombreuses fonctionnalités optionnelles. Cette section décrit comment les configurer ou les activer.

3.8.1. Tâches récurrentes

Plusieurs des fonctionnalités ci-dessous nécessitent d’écrire un script à exécuter à intervalles réguliers. La méthode pour ce faire varie selon les systèmes d’exploitation.

3.8.1.1. Linux

Exécutez :

crontab -e

Ceci doit ouvrir le fichier crontab dans votre éditeur. Ajoutez la ligne cron des sections ci-dessous pour activer la fonctionnalité correspondante.

3.8.1.2. Windows

Windows propose un gestionnaire de tâches. Pour exécuter un script spécifique, suivez les instructions ci-dessous :

  1. Panneau de configuration –> Tâches programmées –> Ajouter une tâche programmée

  2. Suivant

  3. Parcourir

  4. Rechercher perl.exe (normalement C:\Perl\bin\perl.exe)

  5. Donnez un nom à la tâche, par ex. Bugzilla <nom_du_script>

  6. Paramétrez la tâche pour s’exécuter au moment et pendant l’intervalle choisis

  7. Si vous exécutez Apache avec un utilisateur particulier, pas en tant que SYSTEM, saisissez cet utilisateur ici. Sinon, créez un compte qui a les droits d’écriture dans le répertoire de Bugzilla et utilisez-le ici

  8. Cochez Ouvrir les propriétés avancées… et cliquez sur Terminer

  9. Ajoutez le nom du script à la fin du champ Exécuter. Par exemple : C:\Perl\bin\perl.exe C:\Bugzilla\<nom_du_script>

  10. Modifiez le champ Démarrer dans en indiquant le répertoire de Bugzilla

3.8.2. Graphiques de bogues

Si vous avez installé les modules Perl nécessaires indiqués par le script checksetup.pl, vous pouvez demander à Bugzilla de collecter régulièrement des statistiques pour obtenir des graphiques et des tableaux.

Sous GNU/Linux, utilisez une ligne cron comme suit :

5 0 * * * cd <votre-répertoire-bugzilla> && ./collectstats.pl

Sous Windows, programmez le script collectstats.pl pour s’exécuter quotidiennement.

Après deux jours, vous pourrez voir des graphiques de bogues dans la page Rapports.

3.8.3. Notifications

Les notifications sont une fonctionnalité de Bugzilla qui peut venir ennuyer régulièrement les utilisateurs à des moments spécifiés. En utilisant cette fonctionnalité, les utilisateurs peuvent exécuter des recherches enregistrées à des moments spécifiques (c-à-d. le 15 du mois à minuit) ou à intervalles réguliers (c-à-d. toutes les 15 minutes le dimanche). Les résultats de la recherche sont envoyés à l’utilisateur, soit dans un seul courriel, soit un courriel par bogue, accompagné d’un texte descriptif. Pour que les notifications fonctionnent, un script Perl spécial doit être exécuté à intervalles réguliers. Plus de détails sont disponibles dans Notifications.

Sous GNU/Linux, utilisez une ligne cron comme suit :

*/15 * * * * cd <your-bugzilla-directory> && ./whine.pl

Sous Windows, programmez le script whine.pl pour s’exécuter toutes les 15 minutes.

3.8.4. Notifications pour les bogues non triés

Il est possible que des bogues stagnent dans un état NON CONFIRMÉ. Bugzilla a un système spécifique pour relancer les responsables de ces bogues par courriel.

Sous GNU/Linux, utilisez une ligne cron comme suit :

55 0 * * * cd <your-bugzilla-directory> && ./whineatnews.pl

Sous Windows, programmez le script whineatnews.pl pour s’exécuter quotidiennement.

3.8.5. Graphiques de dépendance

Bugzilla peut générer des graphiques de dépendance (relations dépend de/bloque) entre les bogues, si vous installez le paquet appelé graphviz.

3.8.5.1. Linux

Indiquez le chemin d’accès complet à la commande dot (provenant du paquet graphviz) dans la variable webdotbase du fichier localconfig. Par ex. /usr/bin/dot.

3.8.5.2. Windows

Téléchargez et installez Graphviz du site Web Graphviz. Indiquez le chemin d’accès complet à l’exécutable dot.exe dans la variable webdotbase du fichier localconfig. Par ex. : C:\Program Files (x86)\Graphviz2.38\bin\dot.exe.

3.8.6. Documentation

Bugzilla contient une documentation d’aide complète, écrite en format reStructured Text. Une copie générique compilée est disponible sur bugzilla.readthedocs.org, et les liens d”Aide pointe vers ce site par défaut. Vous pouvez aussi compiler et utiliser une copie locale de la documentation, peut-être parce que vous avez ajouté des extensions Bugzilla comportant de la documentation, ou parce que vos utilisateurs n’ont pas accès à Internet à partir de leurs machines.

Bugzilla détectera automatiquement que vous avez compilé la documentation et fera le lien vers celle-ci plutôt que la copie sur Internet. N’oubliez pas de la recompiler quand vous faites une mise à jour de Bugzilla ou quand vous installez de nouvelles extensions.

3.8.6.1. GNU/Linux

  • Installer Sphinx. La plupart des distribution GNU/Linux contient ce programme dans le paquet python-sphinx.

  • Se rendre dans le répertoire racine de Bugzilla et exécuter la commande :

    docs/makedocs.pl

3.8.6.2. Windows

  • Télécharger et installer Python. Les versions 2.7 et 3.x de Python fonctionnent. Ajouter python à la variable d’environnement PATH comme suggéré par l’installeur de Python, vous rendra la vie plus facile.

  • Installer Sphinx. Exécuter la commande cmd.exe puis saisir :

    pip install sphinx

  • Se rendre ensuite dans le répertoire C:\bugzilla\docs et exécuter :

    makedocs.pl

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