Install Bugzilla on Ubuntu 8.10

Written by Jarrod Hyder

Friday, 12 December 2008 02:08

A few nights ago I attempted to install Bugzilla on a Ubuntu 8.10 test machine but I ran into a few snags. The Ubuntu team does a great job of packaging Bugzilla and setting it up with a nifty little installer, but for some reason I couldn't get it working. After a lot of searching around on Google and the Ubuntu forums, I finally found the last few bits of information to get Bugzilla working on my test machine. Since I know that several people out there are probably having a similar experience to mine, I decided to post a quick tutorial.

Starting the Installation

To get going, you simply need to issue the following command:

sudo apt-get install bugzilla3

This will grab Bugzilla and all the packages required to make Bugzilla work. If you have never installed MySQL before, the first dialog you will be greeted with is the one shown below. This is the step to set the "root" password for MySQL. Just make sure you pick a secure password and don't forget it! When you are done, click "Forward" to move on to the next step.

bug_1

The next dialog window you will see is the one shown below. This dialog is simply asking if you would like help configuring your database, so just click "Forward" to move on to configuring Bugzilla.

bug_1_5

For this step you will need the password for your MySQL database server. More specifically, you need the password for the administrative user "root" (this is the password you entered in the first step) so that the installation program can install the default databases for you .
bug_3

The next step is to enter a password for the Bugzilla program to use. This is simply the password that is used by Bugzilla to interact with the MySQL database. If you don't want to make up a password for this step, you can just hit "Forward" and the installer will generate a password for you and store it in /etc/bugzilla3/localconf.

bug_4

Next you will see the dialog window shown below. This window is asking for information that will be used in your base Bugzilla install. The important thing to remember here is that you need to enter a valid e-mail address ( This e-mail address is being protected from spambots. You need JavaScript enabled to view it ). If you don't enter a proper address, you have to restart the installation from the beginning (something I learned the hard way). Once you have completed the form, click "Forward" to finish the installer.

bug_2

A Few Extra Tweaks

Now that you have the base install out of the way, you need to tweak a few files to get everything working. The first step is to copy the example Bugzilla configuration file to the Apache configuration folder. This can be done with the following command:

sudo cp /usr/share/bugzilla3/debian/apache.conf /etc/apache2/conf.d/bugzilla3.conf

This will setup Apache to point to the correct directories and libraries for Bugzilla. Once the file has been copied, restart Apache by issuing the following command:

sudo /etc/init.d/apache2 restart

The final step is to make sure that the Bugzilla parameter file is readable by Apache. This can be done with the following commands:

chmod g+rw /etc/bugzilla3/params

chown www-data:www-data /etc/bugzilla3/params

If all goes well you should be able to browse to your server (http://your_server_name/cgi-bin/bugzilla3) and see the Bugzilla login page. Now you are ready to login and get to smashing bugs!

If It Doesn't Work

If you follow all of these steps and Bugzilla still isn't working, your best option is to watch the Apache error log while you attempt to connect to the Bugzilla main page. You can do this by using the tail command to watch the log:

tail -f /var/log/apache2/error.log

Good luck!

Comments

Add New

Adam S - very helpful

|76.254.65.xxx |2009-09-26 02:16:47

this was really helpful, I didn't have problems installing, but the last bit of
configuration changes for apache I might not have figured out for a bit. Thanks
for the tutorial.
-adam

Reply | Quote

Chyne - Thanks a lot!

|60.53.250.xxx |2009-09-26 12:27:22

Thanks a lot for this guideline. It's very helpful for me and definitely I need
to spend more time on this if I haven't bumped into this page.

Reply | Quote

Jarrod Hyder - You're welcome!

|71.56.38.xxx |2009-09-26 13:45:53

I'm just glad somebody found this page useful

Reply | Quote

Anonymous

|69.141.181.xxx |2009-11-18 17:07:56

Reply | Quote

dagger

|115.119.39.xxx |2009-12-02 04:42:11

Was really helpful !! Thanks a lot!!

Reply | Quote

Ruchir

|117.242.12.xxx |2010-01-12 05:13:27

Hello,

I followed the process you have described but i do not find
apache.conf file that needs to be copied to
apache2/conf.d/

“cp/usr/share/bugzilla3/debia n/apache.conf
/etc/apache2/conf.d/b
ugzilla3.conf”

apache 2 restarted ok and when i
tried to view the url i got the following message:–

Bugzilla has suffered
an internal error. Please save this page and send it to Raphael Bossek with
details of what you were doing at the time this message appeared.

URL:
http://192.168.152.134/cgi-bin/bugzilla3/

Templ ate->process() failed
twice.
First error: file error – failed to create compiled templates
directory: /var/lib/bugzilla3/data/template//var/lib/bugzilla
3/template/en/default (mkdir /var/lib/bugzilla3/data: Permission denied at
/usr/lib/perl5/Template/Provider.pm line 859 )
Second error: file error –
failed to create compiled templates directory:
/var/lib/bugzilla3/data/template//var/lib...

Reply | Quote

amol	\|180.211.69.xxx \|2010-01-22 04:20:07

Hi,
I used
sudo aptitude install bugzilla
to install bugzilla on Unbuntu
server.

But following file is not
created
/usr/share/bugzilla3/debian/apache.conf

I have manualy configured
apache2. but still not able to access bugzilla.
Plz help

Reply | Quote