====== Bugzilla ======

----

===== Installation système =====

==== Ubuntu server 18.04 ====

<code bash>
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
</code>

----

[[all:bibles:linux:serveur:bugzilla|Haut de page]]

===== Configuration =====

==== MySQL ====

<color #00a2e8>/etc/mysql/mysql.conf.d/mysqld.cnf</color>

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 :

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

Redémarrer le service mysql : 

<code bash>
sudo systemctl restart mysql
</code>

==== Apache ====

Activation modules

<code apache file>
sudo a2enmod cgi headers expires rewrite ssl
</code>

<color #00a2e8>/etc/apache2/sites-available/labts.conf</color>

<code apache 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>
</code>

Prise en compte

<code bash>
sudo a2ensite labts
sudo systemctl reload apache2
</code>

----

[[all:bibles:linux:serveur:bugzilla|Haut de page]]

===== Installation bugzilla =====

==== Installation ====

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

<code bash>
cd /var/www/html
sudo tar zxvf bugzilla-5.0.4.tar.gz
sudo mv bugzilla-5.0.4 labts
</code>

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

<code bash>
sudo chown -R root:www-data labts
</code>

==== Configuration bugzilla ====

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

Un message nous invite à customiser le fichier <color #00a2e8>/var/www/html/labts/localconfig</color>

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

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

==== Configuration apache ====

<color #00a2e8>/etc/apache2/sites-available/labts.conf</color>

<code apache 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>
</code>

Prise en compte de la nouvelle configuration : 

<code bash>
sudo systemctl reload apache2
</code>

----

[[all:bibles:linux:serveur:bugzilla|Haut de page]]

===== Customisation =====

==== Configuration SMTP ====

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

<code>
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        :
</code>

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

<note tip>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</note>

----

[[all:bibles:linux:serveur:bugzilla|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 ====

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

----

[[all:bibles:linux:serveur:bugzilla|Haut de page]]

===== Backup/Restore =====

==== Backup ====

database :

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

Fichiers de conf : repertoire data et fichier localconfig.

==== Restore ====

database :

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

==== 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 : 

<code bash>
mysql -u root -p -e "CREATE DATABASE bugs DEFAULT CHARACTER SET utf8;"
</code>

  * Import de la sauvegarde : 

<code bash>
mysql -u root -p bugs < backup.sql
</code>

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

----

[[all:bibles:linux:serveur:bugzilla|Haut de page]]