Thursday, November 22, 2007

Bugzilla

Bugzilla is server software designed to help you manage software development. It is a bug tracking tool.

1. Download
Download the bugzilla tar ball from the link http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-3.0.2.tar.gz.

2. Install Perl and some dependent modules.

Install Perl v5.6.0 and above. The perl comprises large number of modules and deploying the bugzilla need some modules to be configured prior.

Required Perl modules:
1. CGI 2.93 or CGI 3.11 if using mod_perl
2. Date::Format (2.21)
3. DBI (1.41)
4. DBD::mysql (2.9003) if using MySQL
5. DBD::Pg (1.45) if using PostgreSQL
6. File::Spec (0.84)
7. Template (2.12)
8. Email::Send (2.00)
9. Email::MIME::Modifier (any)

Optional Perl modules:
1. GD (1.20) for bug charting
2. Template::Plugin::GD::Image (1.20) for Graphical Reports
3. Chart::Base (1.0) for bug charting
4. GD::Graph (any) for bug charting
5. GD::Text (any) for bug charting
6. XML::Twig (any) for bug import/export
7. MIME::Parser (5.406) for bug import/export
8. LWP::UserAgent (any) for Automatic Update Notifications
9. PatchReader (0.9.4) for pretty HTML view of patches
10. Image::Magick (any) for converting BMP image attachments to PNG
11. Net::LDAP (any) for LDAP Authentication
12. SOAP::Lite (any) for the web service interface
13. HTML::Parser (3.40) for More HTML in Product/Group Descriptions
14. HTML::Scrubber (any) for More HTML in Product/Group Descriptions
15. Email::MIME::Attachment::Stripper (any) for Inbound Email
16. Email::Reply (any) for Inbound Email
17. mod_perl2 (1.999022) for mod_perl
18. CGI (2.93) for mod_perl
19. Apache::DBI (0.96) for mod_perl2

CPAN is the best tool for installing the perl modules.

# perl -MCPAN -e shell

Once the Perl interpreter has loaded (and been configured), you can install modules by issuing the command install MODULENAME.please use /var/spool/CPAN as the primary location for building the CPAN repository. The interpreter will ask for more options and preferably provide with the default values. After getting lot of inputs, it ends with the prompt "cpan>".

The first thing you should do is upgrade your CPAN:
cpan> install Bundle::CPAN (take's time to complete)

Once it's done, type:
cpan> reload cpan

Now, enter the following command to retrieve all of the required modules:
cpan> install MODULENAME
eg.,
cpan> install DBI
cpan> install DBD::mysql

2. Install MySQL version 3.23.41 or later.

3. Install Apache Webserver - "httpd".

4. Install Sendmail 8.7 or later.

5. Final Check for prerequisites before deploying bugzilla source

Start mysql,sendmail and apache service

#perl -v
#mysql -V

In browser : http://localhost (should have apache test page)

At this point, conclude that prerequisites for bugzilla installation is done.

6. Unpack bugzilla

# cd /var/www/html/
# tar zxvf bugzilla-2.18rc3.tgz
# mv bugzilla-2.18rc3/ bugzilla/ (for simplicity purpose)

7. Checking the perl modules by script

# cd /var/www/html/bugzilla
# ./checksetup.pl

Executing the script gives the status of the perl modules installed.Try to install the modules that failed the test and rerun the script.(Even after installing some modules, it may show failed test for some optional perl modules.There is no problem start continuing the next step)

8. Create a DB account for bugzilla user

# mysql
mysql> GRANT SELECT, INSERT, UPDATE, DELETE, INDEX, ALTER, CREATE, LOCK TABLES, CREATE TEMPORARY TABLES, DROP, REFERENCES ON bugs.* TO bugs@localhost IDENTIFIED BY 'enterpassword';
mysql> FLUSH PRIVILEGES;

9. Edit the bugzilla config file:

# vi /var/www/html/bugzilla/localconfig

search for $db_pass and replace with 'enterpassword'

10. Last Compile ./checksetup.pl (it will ask for bugzilla's administrative account details at the end)

11. Edit apache configuration file:

# vi /etc/httpd/conf/httpd.conf

a. uncomment the line "AddHandler cgi-script .cgi"

b. add the below two lines.
Document root
.......
Options ExecCGI FollowSymLinks <---- add this line.
AllowOverride Limit <---- add this line.
.......

/document root
c. add "index.cgi" in the below line
DirectoryIndex index.html index.html.var index.cgi

#/etc/init.d/httpd restart

12. Open browser http://localhost/bugzilla , gives you the home page of the bugzilla application successfully.

Please mail me if you have any questions.

Logu
logu_microsoft@hotmail.com
91-98414-99143

No comments: