3.1. Démarrage rapide (Ubuntu Linux 14.04)

Ce guide de démarrage rapide propose l'installation de Bugzilla de la façon la plus simple possible pour les utilisateurs pouvant choisir leur environnement. Il décrit l'installation en utilisant Ubuntu Linux 14.04 LTS, Apache et MySQL. Il nécessite d'être familier avec l'environnement Linux et les lignes de commande.

3.1.1. Le matériel

Ubuntu 14.04 LTS Server nécessite un processeur 64 bits. Bugzilla lui-même n'a pas de prérequis en dehors de ça, si ce n'est de choisir du matériel fiable. Vous pouvez aussi utiliser une machine virtuelle 64 bits ou une instance cloud sur laquelle vous avez un accès root.

3.1.2. Installer le système d'exploitation

Téléchargez Ubuntu Server 14.04 LTS à partir du site de Ubuntu et suivrez les instructions d'installation. Quelques indications :

  • Choisir le nom du serveur.
  • Pour la création du premier utilisateur Linux, utiliser le nom bugzilla, et lui associer un mot de passe fort et le noter quelque part.
  • Il n'est pas nécessaire d'avoir un répertoire home chiffré.
  • Choisir le partitionnement proposé par défaut (sauf bien sûr, quand le défaut est Non et qu'il est nécessaire de cliquer sur Oui pour continuer).
  • Choisir Installer les mises à jour de sécurité automatiquement sauf si vous voulez les faire manuellement.
  • Dans les options d'installation, choisir Serveur OpenSSH et Serveur LAMP.
  • Définir un mot de passe fort pour l'utilisateur root de MySQL et le noter quelque part.
  • Installer le gestionnaire de démarrage Grub pour le Master Boot Record.

Redémarrer le serveur à la fin de l'installation.

3.1.3. Se substituer à l'utilisateur root

Connectez-vous en ssh sur la machine avec l'utilisateur bugzilla et démarrez une console. Puis :

sudo su

3.1.4. Installer les prérequis

apt-get install git nano

apt-get install apache2 mysql-server libappconfig-perl libdate-calc-perl libtemplate-perl libmime-perl build-essential libdatetime-timezone-perl libdatetime-perl libemail-sender-perl libemail-mime-perl libemail-mime-modifier-perl libdbi-perl libdbd-mysql-perl libcgi-pm-perl libmath-random-isaac-perl libmath-random-isaac-xs-perl apache2-mpm-prefork libapache2-mod-perl2 libapache2-mod-perl2-dev libchart-perl libxml-perl libxml-twig-perl perlmagick libgd-graph-perl libtemplate-plugin-gd-perl libsoap-lite-perl libhtml-scrubber-perl libjson-rpc-perl libdaemon-generic-perl libtheschwartz-perl libtest-taint-perl libauthen-radius-perl libfile-slurp-perl libencode-detect-perl libmodule-build-perl libnet-ldap-perl libauthen-sasl-perl libtemplate-perl-doc libfile-mimeinfo-perl libhtml-formattext-withlinks-perl libgd-dev libmysqlclient-dev lynx-cur graphviz python-sphinx

Ceci prend un peu de temps. Ces commandes sont séparées en deux parties de sorte que vous puissiez faire les étapes suivantes (jusqu'à l'étape 7) dans un autre terminal sans attendre la fin de l'exécution de la deuxième commande. Si vous démarrez un autre terminal, vous devez à nouveau exécuter la commande sudo su.

3.1.5. Télécharger Bugzilla

Récupérez-le à partir de notre dépôt Git :

cd /var/www/html

git clone --branch release-X.X-stable https://git.mozilla.org/bugzilla/bugzilla bugzilla

(où X.X est le numéro à deux chiffres de la version stable de Bugzilla que vous voulez - par ex. : 5.0)

3.1.6. Configurer MySQL

Les commandes suivantes utilisent l'éditeur minimaliste nano, mais vous pouvez utiliser n'importe quel autre éditeur de texte.

nano /etc/mysql/my.cnf

Définissez les valeurs suivantes, qui augmentent la taille maximale autorisée pour les fichiers joints et permettent la recherche de termes et mots courts :

  • Modifiez la ligne 52 : max_allowed_packet=100M
  • Ajoutez une nouvelle ligne 32, dans la section [mysqld] : ft_min_word_len=2

Enregistrez et quittez.

Ajoutez ensuite un utilisateur MySQL pour Bugzilla :

mysql -u root -p -e "GRANT ALL PRIVILEGES ON bugs.* TO bugs@localhost IDENTIFIED BY '$db_pass'"

Remplacez $db_pass par un mot de passe fort et notez-le quelque part. En lançant la commande ci-dessus, le mot de passe de l'utilisateur root de MySQL que vous avez configuré en installant Ubuntu vous sera demandé. Il est conseillé d'utiliser un mot de passe différent pour $db_pass.

Redémarrez MySQL :

service mysql restart

3.1.7. Configurer Apache

nano /etc/apache2/sites-available/bugzilla.conf

Copier le contenu suivant et enregistrez le fichier :

ServerName localhost

<Directory /var/www/html/bugzilla>
  AddHandler cgi-script .cgi
  Options +ExecCGI
  DirectoryIndex index.cgi index.html
  AllowOverride All
</Directory>

a2ensite bugzilla

a2enmod cgi headers expires

service apache2 restart

3.1.8. Vérifier la configuration

Bugzilla fournit un script appelé checksetup.pl qui vous aidera dans le processus d'installation. Il devra être exécuté à deux reprises. La première fois, il génère un fichier (appelé localconfig) pour les informations de connexion à la base de données, et la seconde fois (étape 10), il utilise les informations que vous avez indiquées dans ce fichier pour paramétrer la base de données.

cd /var/www/html/bugzilla

./checksetup.pl

3.1.9. Éditer localconfig

nano localconfig

Vous devrez définir les valeurs suivantes :

  • Ligne 29 : pour $webservergroup indiquez www-data
  • Ligne 67 : pour $db_pass indiquez le mot de passe pour l'utilisateur MySQL bugs que vous avez créé un peu plus tôt

3.1.10. Vérifier la configuration (à nouveau)

Exécutez le script checksetup.pl à nouveau pour configurer la base de données.

./checksetup.pl

Le script demandera une adresse électronique, un nom réel et un mot de passe pour créer le premier compte Bugzilla, lequel sera administrateur. Notez l'adresse électronique et le mot de passe que vous avez indiqués.

3.1.11. Tester le serveur

./testserver.pl http://localhost/bugzilla

Tous les tests devraient s'exécuter avec succès. Vous observerez des avertissements concernant l'obsolescence du module Perl Chart::Base. Ignorez-les.

3.1.12. Accéder à Bugzilla avec un navigateur Web

Accès à la page d'accueil :

lynx http://localhost/bugzilla

Il n'est pas vraiment possible d'utiliser Bugzilla avec Lynx, mais vous pourrez accéder à la page d'accueil pour valider visuellement que Bugzilla est démarré et qu'il fonctionne.

Vous pourriez vouloir configurer votre DNS pour que le serveur soit accessible à l'aide d'un nom plutôt que de son adresse IP. Ce paramétrage n'est pas dans le périmètre de ce document. Le serveur Bugzilla est accessible sur votre réseau local sur l'URL suivante http://<adresse IP>/bugzilla, où <adresse IP> est (à moins que votre paramétrage réseau soit complexe) la valeur affichée dans inet addr en exécutant la commande ifconfig eth0.

3.1.13. Configurer Bugzilla

Sur la page d'accueil de Bugzilla, cliquez sur Se connecter dans l'en-tête de la page, puis utilisez identifiants de l'utilisateur administrateur que vous avez défini à l'étape 10.

Cliquez sur le lien Paramètres puis définissez les paramètres suivants dans la section Paramètres requis :

  • urlbase: http://<nom_du_serveur>/bugzilla/ ou http://<adresse IP>/bugzilla/

Cliquez sur Enregistrer les modifications au bas de la page.

Il existe plusieurs façons pour que Bugzilla puisse envoyer des courriels. La façon la plus simple consiste à utiliser Gmail, ce que nous allons faire ici. Rendez-vous sur https://gmail.com et créez un nouveau compte Gmail pour Bugzilla. Ensuite, cliquez sur la section Courriel dans la page des Paramètres en utilisant le lien dans la colonne de gauche et indiquez les valeurs de paramètres suivantes :

  • 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

Cliquez sur le bouton Enregistrez les modifications au bas de la page.

Et voilà. :-)

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