UNIX / How to install Bugzilla

Home | UNIX | Practical

How to install Bugzilla


Introduction
We're using a Redhat/Centos 5.1 for its use of Apache and MySQL configuration.


Security
Disable SELinux to let httpd behave freely,
system-config-securitylevel-tui
Note. no reboot needed
To authorize the http port (80),
vi /etc/sysconfig/iptables
and add this line,
-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 80 -j ACCEPT
then apply,
service iptables restart


RPM packages
Make sure thoses packages are installed (rpm -qa),
- perl
- httpd
- mysql-server, mysql
- php-mysql
- gcc
- cvs
- patchutils

To see how to install packages see pbraun.nethence.com/doc/sysutils_linux/redhat.html

Besides, those perl modules need to be added,
/usr/bin/perl -MCPAN -e 'install "Email::Send"'
/usr/bin/perl -MCPAN -e 'install "Template"'
/usr/bin/perl -MCPAN -e 'install "Email::MIME::Modifier"'
/usr/bin/perl -MCPAN -e 'install "Date::Format"'


Apache configuration
Edit this part inside /etc/httpd/conf/httpd.conf,
<Directory "/var/www/html">
Options Indexes FollowSymLinks ExecCGI
AllowOverride Limit
DirectoryIndex index.cgi index.html
Order allow,deny
Allow from all
</Directory>
Note "Indexes" for docs/html/*/ and index.html for docs/html/index.html

And uncomment this line,
AddHandler cgi-script .cgi

Start Apache,
service httpd start


MySQL configuration
Start MySQL,
service mysqld start
Secure the installation,
/usr/bin/mysql_secure_installation
or configure root's password yourself,
/usr/bin/mysqladmin -u root password 'xxxxxxx'


bugs database creation
Either create a "bugs" user and "bugs" database using phpMyAdmin or this script,
mysql_setpermission -u root
Note phpMyAdmin lets you have a better overview of the databases, users and their privileges.
To configure phpMyAdmin see pbraun.nethence.com/doc/databases/phpmyadmin.html


Bugzilla installation
Get the latest tarball release (today: ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-3.0.4.tar.gz).
Untar the bugzilla tarball into /var/www/html and run its setup script,
ls -al /var/www/html
rmdir /var/www/html
tar xzf bugzilla-xxx.tar.gz
mv bugzilla-xxx /var/www/html
cd /var/www/html
./checksetup.pl
Note this creates the tables inside the "bugs" db.

Make sure apache is running,
service httpd status
or restart it,
service httpd restart

Point your desktop's web browser to the Bugzilla server,
BUGZILLA_SERVER
Login with the email and password you entered during checksetup.pl and edit the base url into the settings.


Postinstall checks
To check if sending mail works, first check you got name resolution,
ping example.com
then try to send a mail,
echo content | mail -s subject email@example.com



Sat Nov 8 12:19:47 CET 2008
       © 2008 Pierre-Philipp Braun