Installing Bugzilla on Fedora 15

Bugzilla is a bug tracking system developed by Mozilla and licensed under the Mozilla Public License. It is a scalable system used by many large organizations for the software development process. I facilitates communications between both internal communities (wthin an organization) and with external communities as well. It is a system adopted by well known organizations such as NASA, Yahoo!, RedHat, Apache, and Novell.

The following is a step by step guide to installing Bugzilla on Fedora 15.

Begin by installing the dependencies for Bugzilla.

yum install mysql-server perl-YAML httpd gcc perl-Math-Random-Secure

If you believe you already have these requirements installed already, you can confirm by running:

rpm -q mysql-server and
rpm -q perl-YAML

Also, ensure the version of MySQL is 5.0.15 or higher; and perl is 5.8.1 or higher. You will also need to ensure your apache is 2.2 or better.

You can confirm the versions with the following:

perl -v
mysql -V
httpd -v

Once mysql has been installed/confirmed, we will need to set up a user with the proper permissions for Bugzilla. If you just installed MySQL, start the service, and have it start on boot up:


systemctl start mysqld.service
systemctl enable mysqld.service

Now log into MySQL (below is the command if you just installed MySQL; username and password may differ if you already have MySQL installed previously.)


mysql -u root -p

On a newly installed MySQL server, press enter at password prompt. Once at the MySQL> prompt, enter the following, replacing anything in tags.


grant SELECT,INSERT,UPDATE,DELETE,INDEX,ALTER,CREATE,LOCK TABLES,CREATE TEMPORARY TABLES,DROP, references on dbname.* TO username@hostname IDENTIFIED BY 'password';

In this installation example, we will be using:

grant SELECT,INSERT,UPDATE,DELETE,INDEX,ALTER,CREATE,LOCK TABLES,CREATE TEMPORARY TABLES,DROP, references on bugdb.* TO bugsRabbit@localhost IDENTIFIED BY 'daffyMallard';

and then...


FLUSH PRIVILEGES;

You can confirm the user was successfully created by:


use mysql;
SELECT USER,HOST,PASSWORD from USER where USER = 'bugsRabbit';

Exit MySQL.

If you want to get the latest version of Bugzilla, you can build from source; which can be found here; which of this writing is at version 4.4.1. However, we will be using yum to install Bugzilla; which will install version 3.6.9.

yum install bugzilla

Below is the list of packages installed by default, which you or your organization may want to consider before continuing.


================================================================================
Package Arch Version Repository
Size
================================================================================
Installing:
bugzilla noarch 3.6.9-1.fc15 updates 979 k
Installing for dependencies:
apr x86_64 1.4.6-1.fc15 updates 98 k
apr-util x86_64 1.3.12-1.fc15 updates 80 k
apr-util-ldap x86_64 1.3.12-1.fc15 updates 16 k
boa x86_64 0.94.14-0.16.rc21.fc15 fedora 90 k
httpd x86_64 2.2.22-1.fc15 updates 811 k
httpd-tools x86_64 2.2.22-1.fc15 updates 72 k
mod_perl x86_64 2.0.4-14.fc15 fedora 3.0 M
patchutils x86_64 0.3.2-1.fc15 fedora 97 k
perl-AppConfig noarch 1.66-10.fc15 fedora 86 k
perl-BSD-Resource x86_64 1.29.04-3.fc15 fedora 35 k
perl-CGI noarch 3.51-2.fc15 fedora 200 k
perl-CPAN noarch 1.9402-166.fc15 updates 249 k
perl-Class-Accessor noarch 0.34-5.fc15 fedora 28 k
perl-Class-Inspector noarch 1.25-1.fc15 fedora 30 k
perl-Class-Load noarch 0.06-4.fc15 fedora 12 k
perl-Class-Singleton noarch 1.4-9.fc15 fedora 17 k
perl-Class-Trigger noarch 0.14-4.fc15 fedora 15 k
perl-Convert-BinHex noarch 1.119-15.fc15 fedora 43 k
perl-Data-ObjectDriver noarch 0.08-3.fc15 fedora 128 k
perl-DateTime x86_64 2:0.70-2.fc15 updates 108 k
perl-DateTime-Locale noarch 0.45-1.fc15 updates 1.5 M
perl-DateTime-TimeZone noarch 1.46-1.fc15 updates 298 k
perl-Digest-SHA x86_64 1:5.47-166.fc15 updates 66 k
perl-Email-Address noarch 1.889-8.fc15 fedora 36 k
perl-Email-Date-Format noarch 1.002-9.fc15 fedora 16 k
perl-Email-MIME noarch 1.906-3.fc15 fedora 37 k
perl-Email-MIME-ContentType noarch 1.015-8.fc15 fedora 18 k
perl-Email-MIME-Encodings noarch 1.313-7.fc15 fedora 10 k
perl-Email-MessageID noarch 1.401-9.fc15 fedora 18 k
perl-Email-Send noarch 2.198-3.fc15 fedora 41 k
perl-Email-Simple noarch 2.100-3.fc15 fedora 32 k
perl-ExtUtils-MakeMaker noarch 6.56-166.fc15 updates 292 k
perl-ExtUtils-ParseXS noarch 1:2.2206-166.fc15 updates 51 k
perl-FCGI x86_64 1:0.74-1.fc15 updates 43 k
perl-IO-Socket-SSL noarch 1.40-1.fc15 fedora 72 k
perl-IO-stringy noarch 2.110-15.fc15 fedora 69 k
perl-List-MoreUtils x86_64 0.32-1.fc15 updates 64 k
perl-MIME-Lite noarch 3.027-6.fc15 fedora 88 k
perl-MIME-Types noarch 1.31-1.fc15 fedora 35 k
perl-MIME-tools noarch 5.502-1.fc15 fedora 251 k
perl-MailTools noarch 2.07-2.fc15 fedora 102 k
perl-Math-Round noarch 0.06-8.fc15 fedora 13 k
perl-Net-LibIDN x86_64 0.12-6.fc15 fedora 33 k
perl-Net-SMTP-SSL noarch 1.01-7.fc15 fedora 8.3 k
perl-Params-Validate x86_64 0.99-1.fc15 updates 70 k
perl-Pod-POM noarch 0.27-3.fc15 fedora 100 k
perl-Return-Value noarch 1.666001-3.fc15 fedora 21 k
perl-SOAP-Lite noarch 0.712-5.fc15 updates 320 k
perl-Template-Toolkit x86_64 2.22-8.fc15 fedora 1.3 M
perl-Test-Harness noarch 3.17-166.fc15 updates 242 k
perl-TheSchwartz noarch 1.10-5.fc15 fedora 41 k
perl-TimeDate noarch 1:1.20-4.fc15 fedora 42 k
perl-XML-Parser x86_64 2.40-3.fc15 fedora 225 k
perl-devel x86_64 4:5.12.4-166.fc15 updates 447 k
perl-parent noarch 1:0.224-2.fc15 fedora 14 k
systemtap-sdt-devel x86_64 1.8-1.fc15 updates 65 k

Transaction Summary
================================================================================

This will place the necessary installation files to /usr/share/bugzilla, switch to this directory.

cd /usr/share/bugzilla

Begin by entering the command:

./checksetup.pl --check-modules

This will test the perl modules installed on the system and generate a report of installed and missing modules. Some of these modules are optional, while others are required. You will probably notice multiple red lines, but much of these modules are listed under optional. However, you may be worried about the following as it is not listed under optional:


Checking available perl DBD modules...
Checking for DBD-Pg (v1.45) not found
Checking for DBD-mysql (v4.00) ok: found v4.018
Checking for DBD-Oracle (v1.19) not found

Bugzilla will work with any of the three above databases, so as long as one of them is status ok (in this case MySQL) we can continue with the installation. If there are any optional modules you want to install, you can go ahead and install those at this point.

Once you are ready to continue, we will begin the installation with the following:

/usr/bin/perl install-module.pl --all

This process can take several minutes. Assuming the instructions were followed properly, you should not receive any errors. However, if you are receiving errors, I addressed the errors I encountered in my previous blog. Please refer to that post in your troubleshooting procedure.

Once any issues have been address, enter the following command, it will generate an error related to MySQL, however, a configuration file will be created, which will allow us to resolve this issue.

./checksetup.pl

Once done, we will need to edit the configuration file /etc/bugzilla/localconfig.

vi /etc/bugzilla/localconfig

We will need to change several lines. These will differ depending on your choice in Database software, and the entry made earlier for your bugzilla database user. Below is the example for this set up:


$db_driver = 'mysql';
$db_host = 'localhost';
$db_name = 'bugdb';
$db_user = 'bugsRabbit';
$db_pass = 'daffyMallard';

You can change any of the other settings in the file to match your organization or set up. Once this is done, enter the command ./checksetup.pl again. This should allow the script to create all the necessary tables to the database.

You will be prompted for your information, this will be the initial administrator account for the site.

If your web server (apache) is not already running (or was installed recently with these instructions), turn the service on.


systemctl start httpd.service
systemctl enable httpd.service

or restart the service if already installed and previously running:


systemctl restart httpd.service

Open a web browser and enter the URL:


http://localhost/bugzilla

Your Bugzilla site should be up and running, And you should be able to log in with the email address you were earlier prompted to enter. If you have any questions, concerns or issues, leave a comment, I will answer it the best I can.

-Richard K.

EDIT ADD:

To configure/modify the attachment size to bugzilla, edit the file /etc/my.cnf, and change/add the following line: max_allowed_packet=4M. This will allow the maximum attachment to be 4MB in size. Change according to your needs.

Leave a comment