Bugzilla

Installation système

Ubuntu server 18.04

sudo apt-get install apache2 mysql-server libappconfig-perl libdate-calc-perl libtemplate-perl libmime-tools-perl build-essential libdatetime-timezone-perl libdatetime-perl libemail-sender-perl libemail-mime-perl libemail-mime-perl libdbi-perl libdbd-mysql-perl libcgi-pm-perl libmath-random-isaac-perl libmath-random-isaac-xs-perl 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 libfile-mimeinfo-perl libhtml-formattext-withlinks-perl libfile-which-perl libgd-dev libmysqlclient-dev lynx graphviz python-sphinx rst2pdf git

Haut de page

Configuration

MySQL

/etc/mysql/mysql.conf.d/mysqld.cnf

Modifier la ligne : max_allowed_packet=100M (au lieu de 16M).

Ajouter dans la section [mysqld] : ft_min_word_len=2

Créer l'utilisateur bugs sous mysql :

sudo mysql -u root
mysql> CREATE USER 'bugs'@'localhost' IDENTIFIED BY '<mot de passe>'; mysql> GRANT ALL PRIVILEGES ON bugs.* TO bugs@localhost; quit

Redémarrer le service mysql :

sudo systemctl restart mysql

Apache

Activation modules

sudo a2enmod cgi headers expires rewrite ssl

/etc/apache2/sites-available/labts.conf

<VirtualHost *:80> ServerName www.bugzilla.acs.altran.com ServerAlias bugzilla.acs.altran.com DocumentRoot "/var/www/html/labts" ErrorLog ${APACHE_LOG_DIR}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined <Directory /var/www/html/labts> AddHandler cgi-script .cgi Options +ExecCGI DirectoryIndex index.cgi AllowOverride Limit FileInfo Indexes Options AuthConfig </Directory> </VirtualHost>

Prise en compte

sudo a2ensite labts sudo systemctl reload apache2

Haut de page

Installation bugzilla

Installation

Récupérer le fichier tar.gz sur le site https://www.bugzilla.org.

cd /var/www/html sudo tar zxvf bugzilla-5.0.4.tar.gz sudo mv bugzilla-5.0.4 labts

Vérifier les droits du répertoire et les mettre à jour si nécessaire :

sudo chown -R root:www-data labts

Configuration bugzilla

cd /var/www/html/labts sudo /usr/bin/perl install-module.pl --all sudo ./checksetup.pl

Un message nous invite à customiser le fichier /var/www/html/labts/localconfig

ligne 29 : $webservergroup = 'www-data';
ligne 67 : $db_pass = 'mot de passe';

sudo ./checksetup.pl (demande le mail et le mot de passe administrateur) sudo ./testserver.pl http://localhost

Configuration apache

/etc/apache2/sites-available/labts.conf

<VirtualHost *:80> ServerName www.bugzilla.acs.altran.com ServerAlias bugzilla.acs.altran.com ErrorLog ${APACHE_LOG_DIR}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined Redirect permanent / https://bugzilla.acs.altran.com/ </VirtualHost> <IfModule mod_ssl.c> <VirtualHost *:443> ServerName www.bugzilla.acs.altran.com ServerAlias bugzilla.acs.altran.com DocumentRoot "/var/www/html/labts" ErrorLog ${APACHE_LOG_DIR}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined SSLEngine on SSLCertificateFile /etc/ssl/certs/ssl-cert-snakeoil.pem SSLCertificateKeyFile /etc/ssl/private/ssl-cert-snakeoil.key <Directory /var/www/html/labts> AddHandler cgi-script .cgi Options +ExecCGI DirectoryIndex index.cgi AllowOverride Limit FileInfo Indexes Options AuthConfig </Directory> </VirtualHost> </IfModule>

Prise en compte de la nouvelle configuration :

sudo systemctl reload apache2

Haut de page

Customisation

Configuration SMTP

Choisir « Administration / Parameters / Email ». Renseigner les paramètres suivants :

mail_delivery_method : SMTP
mailfrom	: lpts-acs@altran.com
use_mailer_queue : off
smtpserver : smtp-ip-relay.altran.com
smtp_username :
smtp_password :
smtp_ssl : off
smtp_debug : off
whinedays : 7
globalwatchers :

Pour une authentification de manière anonyme l'adresse IP doit être inscrite en white liste sur le serveur SMTP.

smtp_ssl implique le port 465 par défaut pour le SSL et le port 25 sans SSL. Il est également possible de forcer le port en l'indiquant après l'adresse du serveur avec la notation url:port

Haut de page

Divers

Mode maintenance

Choisir « Administration / Parameters / General ». Ecrire un message dans le paramètre shutdownhtml.

Pour réactiver, supprimer le message en allant sur la page http://my-url/editparams.cgi

Reset password

/var/www/html/labts/checksetup.pl --reset-password=toto@free.fr

Haut de page

Backup/Restore

Backup

database :

mysqldump --max-allowed-packet=100M -u root –p<mot de passe> bugs > backup.sql

Fichiers de conf : repertoire data et fichier localconfig.

Restore

database :

mysql -u root -p<rootpw> -D bugs < backup.sql

Changement de machine

Après réinstallation de bugzilla sur le nouveau serveur :

Récupérer le repertoire data et le fichier localconfig

Modification éventuelle dans data/param.json (url, @IP, …)

Création d’une base de données vide :

mysql -u root -p -e "CREATE DATABASE bugs DEFAULT CHARACTER SET utf8;"

Import de la sauvegarde :

mysql -u root -p bugs < backup.sql

En cas d’erreur “packet too large” ou “MySQL server has gone away” adjuster max_allowed_packet dans le fichier /etc/my.cnf

Vérification en executant checksetup.pl

Haut de page