3.4. Mac OS X

Note

L’équipe Bugzilla a très peu d’expertise sur Mac et nous n’avons pas été capables de réussir l’installation sur la dernière version de Mac OS X. Nous y étions presque cependant. Si vous avez réussi, dites-nous comment et nous pourrons mettre à jour la documentation !

3.4.1. Installer les paquets

OS X 10.7 fournit Perl 5.12 et Apache 2.2. Installez les paquets supplémentaires suivants :

3.4.2. Bugzilla

Le meilleur moyen d’obtenir Bugzilla est de le faire par git :

git clone --branch release-X.X-stable https://github.com/bugzilla/bugzilla

Exécutez la commande ci-dessus dans votre répertoire home, en remplaçant X.X avec les deux nombres de la version stable de Bugzilla que vous désirez - par ex. 4.4. Ceci placera Bugzilla dans le répertoire $HOME/bugzilla.

Si ce n’est pas possible, vous pouvez télécharger l’archive de Bugzilla.

3.4.3. Bibliothèques système additionnelles

Apple ne fournit pas la bibliothèque GD avec Mac OS X. Bugzilla en a besoin si vous voulez afficher des graphiques de bogues, et vous devrez l’installer avant d’essayer d’installer le module Perl GD.

Vous pouvez utiliser MacPorts, Homebrew ou Fink, chacun d’eux pouvant installer les programmes Linux courants sur Mac OS X.

Si vous n’avez encore aucun d’entre eux installé, choisissez-en un et suivez les instructions pour l’installer. Puis, utilisez-le pour installer le paquet gd2 (MacPorts/Fink) ou le paquet gd (Brew).

Le gestionnaire de paquets peut vous inviter à installer des dépendances qu’il faudra accepter.

Note

Pour éviter les conflits avec les logiciels installés par défaut par Apple, Fink crée sa propre arborescence sur /sw où il installe la plupart des logiciels. Ceci signifie que les bibliothèques et les en-têtes seront situés dans /sw/lib et /sw/include au lieu de /usr/lib et /usr/include. Quand le script de configuration du module Perl GD demandera où se trouve libgd, assurez-vous d’indiquer /sw/lib.

3.4.4. Modules Perl

Bugzilla nécessite de nombreux modules Perl. Sous Mac OS X, le moyen le plus simple est d’installer des copies locales (plutôt que des copies système globales) des modules que vous n’avez pas encore. Cependant, si vous voulez les installer pour tout le système, exécutez les commandes qui suivent en tant que root avec l’argument --global.

Pour vérifier si vous disposez déjà de tous les modules nécessaires, exécutez la commande suivante :

perl checksetup.pl --check-modules

Vous pouvez exécuter cette commande autant de fois que nécessaire.

Pour installer localement tous les modules manquants, exécutez la commande suivante :

perl install-module.pl --all

3.4.5. Serveur Web

Tout serveur Web en mesure d’exécuter des scripts CGI peut être utilisé. Nous avons des instrutions spécifiques pour les suivants :

Vous devrez créer un lien symbolique pour que le serveur Web puisse localiser Bugzilla :

cd /Library/WebServer/Documents

sudo ln -s $HOME/bugzilla bugzilla

Dans les Préférences système –> Partage, cocher la case Partage Web pour démarrer Apache.

3.4.6. Database Engine

Bugzilla peut fonctionner avec les moteurs de base de données MySQL, PostgreSQL, Oracle et SQLite. Vous n’avez besoin que d’un seul de ces moteurs pour utiliser Bugzilla. MySQL est le plus couramment utilisé sous Mac OS X –en fait, nous avons pas connaissance de personnes utilisant autre chose. Configurez votre serveur en suivant les instructions ci-dessous :

3.4.7. localconfig

Vous devez maintenant exécuter checksetup.pl à nouveau, cette fois sans l’argument --check-modules.

perl checksetup.pl

Cette fois, checksetup.pl devrait vous dire que tous les modules appropriés sont installés et affichera un message à ce sujet, et générera un fichier de sortie appelé localconfig. Ce fichier contient les paramètres par défaut pour un grand nombre de paramètres de Bugzilla.

Ouvrez ce fichier dans votre éditeur. Les deux seules valeurs que vous avez besoin de changer sont $db_driver et $db_pass, respectivement le type de base de données et le mot de passe pour l’utilisateur qui créera pour vous la base de données. Choisissez un mot de passe compliqué (pour la simplicité, il ne devrait pas contenir d’apostrophe) et saisissez-le dans le fichier. $db_driver peut être mysql, Pg (PostgreSQL), oracle ou SQLite.

Définissez la valeur de $webservergroup avec le nom groupe avec lequel votre serveur Web s’exécute.

  • Fedora/Red Hat : apache

  • Debian/Ubuntu : www-data

  • Mac OS X : _www

  • Windows : ignorez ce paramètre car il n’est pas utile pour ce système d’exploitation

Les autres options dans le fichier localconfig sont documentées avec leurs commentaires. Si vous avez une configuration de base de données non standard, vous aurez peut-être besoin de modifier d’autres paramètres $db_*.

Note

Sous Oracle, $db_name devrait en fait être le nom du SID de votre base de données (par ex. XE si vous utilisez Oracle XE).

3.4.8. checksetup.pl

Ensuite, exécutez checksetup.pl une nouvelle fois :

perl checksetup.pl

Il confirmera à nouveau que tous les modules sont présents et remarquera la modification du fichier localconfig, en supposant que vous l’avez modifié à votre convenance. Il compile ensuite les modèles de l’interface utilisateur, se connecte à la base de données en utilisant l’utilisateur bugs que vous avez créé et le mot de passe que vous avez défini et crée enfin la base de données bugs et les tables à l’intérieur.

Après cela, il demande des détails sur le compte administrateur. Bugzilla peut avoir plusieurs administrateurs –vous pouvez en créer d’autres plus tard– mais il en a besoin d’un pour démarrer. Saisissez l’adresse électronique d’un administrateur, son nom complet, et un mot de passe approprié pour Bugzilla.

checksetup.pl se terminera alors. Vous pouvez relancer checksetup.pl à tout moment si vous le souhaitez.

3.4.9. Bravo

Votre installation Bugzilla devrait à présent fonctionner. Vérifiez-le en exécutant la commande suivante :

perl testserver.pl http://<your-bugzilla-server>/

Si elle passe sans erreur, accédez à http://<your-bugzilla-server>/ dans votre navigateur –vous devriez alors voir la page d’accueil de Bugzilla. Bien sûr, si vous avez installé Bugzilla dans un sous-répertoire, assurez-vous que celui-ci figure dans URL.

Ensuite, consultez Configuration post-installation essentielle.

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