Table des matières
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
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
- file
sudo a2enmod cgi headers expires rewrite ssl
/etc/apache2/sites-available/labts.conf
- 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
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
- 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
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.
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
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
