Remarque : Si vous êtes à la recherche d'un outil de suivi des bugs intuitif, je vous conseille d'essayer Redmine, qui est bien plus simple à utiliser que Bugzilla.

Installation

En premier lieu, nous allons installer les logiciels nécessaires à Bugzilla

apt-get install apache2 libapache2-mod-perl2 libtemplate-perl libmime-perl \
                libappconfig-perl libdbd-mysql-perl libtimedate-perl \
                libgd-gd2-perl libgd-text-perl libxml-twig-perl perlmagick \
                libemail-send-perl libemail-mime-modifier-perl libchart-perl \
                libgd-graph-perl libhtml-scrubber-perl make

Nous renseignons le numéro de la dernière version de Bugzilla :

BZ_VERSION=3.0.2

Puis nous téléchargeons les sources de Bugzilla :

wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-$BZ_VERSION.tar.gz --output-document=/tmp/bugzilla-$BZ_VERSION.tar.gz

et nous les décompressons :

tar --directory /var/www -xzf /tmp/bugzilla-$BZ_VERSION.tar.gz

Nous renommons le dossier ainsi créé :

mv /var/www/bugzilla-$BZ_VERSION /var/www/bugzilla

Afin de créer un fichier de configuration basique, nous lançons le script checksetup :

cd /var/www/bugzilla
./checksetup.pl

Ce script vous indique que quelques dépendances optionnelles sont manquantes. Si vous souhaitez un support LDAP ou XML-RPC, vous pouvez installer les paquets nécessaires :

apt-get install libnet-ldap-perl
apt-get install libsoap-lite-perl

Cependant, ceci n'est pas nécessaire. De même pour les autre dépendances, il n'y a pas de paquets debian et il faut les installer via CPAN mais cela non plus n'est pas obligatoire.

Base de données

Installation du serveur

Si vous ne disposez pas d'une installation fonctionnelle de MySQL, nous allons maintenant en créer une. En premier lieu, installez les paquets nécessaires :

apt-get install mysql-server apg

Nous générons le mot de passe root de MySQL :

MYSQL_PWD=`apg -q -a  0 -n 1 -M NCL`

Nous affichons le nouveau mot de passe :

echo "Votre mot de passe pour l'utilisateur root de MySQL sera : '$MYSQL_PWD'."

Attention: Notez la valeur affichée et conservez la précieusement !

Nous mettons en place le nouveau mot de passe :

mysqladmin -u root password "$MYSQL_PWD"

Votre serveur MySQL est maintenant prêt à être utilisé. Nous pouvons maintenant y créer la base de données de Bugzilla.

Création de la base de donnée de Bugzilla

Nous allons maintenant créer la base de données destinée à Bugzilla avec un utilisateur capable de l'administrer. En premier lieu, configurez le nom de votre base de données :

MYSQL_DB=BUGZILLA

Nous créons ensuite la base de données :

echo "CREATE DATABASE IF NOT EXISTS $MYSQL_DB DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci" \
    | mysql --user=root --password

Remarque: Le mot de passe demandé est celui de l'utilisateur root de MySQL.

Nous configurons maintenant l'utilisateur habilité à administrer la base de données :

MYSQL_USERNAME="`echo $MYSQL_DB|tr '[A-Z]' '[a-z]'`"
MYSQL_USERPWD=`apg -q -a  0 -n 1 -M NCL`

Nous affichons l'identifiant et le mot de passe de l'utilisateur pour la base de données :

echo "L'utilisateur habilité pour la base de donnée '$MYSQL_DB' est '$MYSQL_USERNAME' avec le mot de passe '$MYSQL_USERPWD'."

Attention: Notez les informations affichées et conservez les précieusement !

Nous créons l'utilisateur et réglons ses habilitations.

echo "GRANT ALL PRIVILEGES ON $MYSQL_DB.*
        TO $MYSQL_USERNAME@localhost
        IDENTIFIED BY '$MYSQL_USERPWD';"  | mysql --user=root --password

Et nous configurons Bugzilla de façon à ce qu'il utilise cette base de données.

sed -i -e "s/^\$db_name = '.*';/\$db_name = '$MYSQL_DB';/" \
       -e "s/^\$db_user = '.*';/\$db_user = '$MYSQL_USERNAME';/" \
       -e "s/^\$db_pass = '.*';/\$db_pass = '$MYSQL_USERPWD';/" /var/www/bugzilla/localconfig

Configuration

Nous allons maintenant adapter Bugzilla à nos besoins. En premier lieu, nous lui renseignons le groupe du serveur Apache :

sed -i -e "s/^\$webservergroup = '.*';/\$webservergroup = 'www-data';/" /var/www/bugzilla/localconfig

Enfin, nous lançons une dernière fois le script de configuration de Bugzilla qui va créer les tables dans la base de données et créer un compte administrateur :

cd /var/www/bugzilla
./checksetup.pl

Nous allons maintenant configurer Apache 2 pour que Bugzilla fonctionne correctement :

sed -i -e '/<\/VirtualHost>/i\
  <Directory "\/var\/www\/bugzilla">\
    Options +ExecCGI\
    AllowOverride Limit\
    DirectoryIndex index.cgi\
    AddHandler cgi-script .cgi\
  <\/Directory>' /etc/apache2/sites-available/default

Et enfin, rechargez la configuration d'Apache :

/etc/init.d/apache2 reload

Vous pouvez maintenant accéder à votre Bugzilla via l'url :

http://localhost/bugzilla

Identifiez-vous avez votre login d'administrateur, et cliquez sur le lien "Parameters" en bas de la page pour finir votre configuration.

Traduction française

Par défaut, aucune traduction n'est installée, nous allons maintenant installer les fichiers nécessaires à la traduction en Français de l'interface de Bugzilla. En premier lieu, nous téléchargeons l'archive contenant la traduction française de l'interface :

wget http://switch.dl.sourceforge.net/sourceforge/frenchmozilla/bugzilla-$BZ_VERSION.fr.tar.gz \
     --output-document=/tmp/bugzilla-$BZ_VERSION.fr.tar.gz

Nous décompressons le fichier ainsi obtenu dans notre répertoire d'installation de Bugzilla :

tar --directory /var/www/bugzilla -xzf /tmp/bugzilla-$BZ_VERSION.fr.tar.gz

Nous faisons de même pour les fichiers de la documentation :

wget http://belnet.dl.sourceforge.net/sourceforge/frenchmozilla/bugzilla-docs-$BZ_VERSION.fr.tar.gz \
     --output-document=/tmp/bugzilla-docs-$BZ_VERSION.fr.tar.gz
tar --directory /var/www/bugzilla -xzf /tmp/bugzilla-docs-$BZ_VERSION.fr.tar.gz

Vous devez maintenant visiter la page "Localization" de votre installation Bugzilla pour modifier la liste des langues disponibles et la langue par défaut.

Adaptation aux besoins

Maintenant que vous disposez d'une installation de Bugzilla fonctionnelle (enfin, j'espère :D), vous devez la configurer selon vos besoins. Je vous conseille pour ce faire de visiter un par un tous les liens situés dans le pied de page sur la même ligne que les "Paramètres". Cette application est assez touffue à configurer, mais une fois que c'est fait, c'est fait :D

Vous pouvez aussi éventuellement vous lancer dans la création d'une skin pour Bugzilla qui améliorera son interface par défaut :D.

Remerciements

• Merci aux développeurs de Bugzilla.
  
• Merci aux personnes assurant la traduction française de Bugzilla.