Bugzilla 3.0.2 - Installation Guide
					^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Table of Contents:
^^^^^^^^^^^^^^^^^^

I. Introduction

II. Software Requirements

III. How to Install Bugzilla

VI. Suggestions


I. Introduction:
^^^^^^^^^^^^^^^^

	Bugzilla is a Bug-tracking system. It is an enterprise class
of software that keep tracks millions of bugs and issues for hundreds
of Projects in an organization.

II. Software Requirements:
^^^^^^^^^^^^^^^^^^^^^^^^^

1. Perl

    * Perl v5.8.0 (non-Windows platforms)
    * Perl v5.8.1 (Windows platforms)

2. MySQL

    * MySQL v4.1.2
    * perl module: DBD::mysql v2.9003

3. PostgreSQL

    * PostgreSQL v8.00.0000
    * perl module: DBD::Pg v1.45

4. Required Perl Modules
+----------------------------------+------------------+
|            Module                |     Version      |
+----------------------------------+------------------+
|CGI                               |      2.93        |
|Date::Format                      |      2.21        |
|DBI                               |      1.41        |
|File::Spec                        |      0.84        |
|Template                          |      2.12        |
|Email::Send                       |      2.00        |
|Email::MIME::Modifier             |      (Any)       |
+----------------------------------+------------------+

5. Optional Perl Modules
+----------------------------------+------------------+--------------------------------------------+
|            Module                |     Version      |            Enables Feature                 |
+----------------------------------+------------------+--------------------------------------------+
|LWP::UserAgent                    |      (Any)       | Automatic Update Notifications             |
|Template::Plugin::GD::Image       |      (Any)       | Graphical Reports                          |
|GD::Graph                         |      (Any)       | Graphical Reports                          |
|GD::Text                          |      (Any)       | Graphical Reports                          |
|GD                                |      1.20        | Graphical Reports, New Charts, Old Charts  |
|Email::MIME::Attachment::Stripper |      (Any)       | Inbound Email                              |
|Email::Reply                      |      (Any)       | Inbound Email                              |
|Net::LDAP                         |      (Any)       | LDAP Authentication                        |
|HTML::Parser                      |      3.40        | More HTML in Product/Group Descriptions    |
|HTML::Scrubber                    |      (Any)       | More HTML in Product/Group Descriptions    |
|XML::Twig                         |      (Any)       | Move Bugs Between Installations            |
|MIME::Parser                      |      5.406       | Move Bugs Between Installations            |
|Chart::Base                       |      1.0         | New Charts, Old Charts                     |
|Image::Magick                     |      (Any)       | Optionally Convert BMP Attachments to PNGs |
|PatchReader                       |      0.9.4       | Patch Viewer                               |
|SOAP::Lite                        |      (Any)       | XML-RPC Interface                          |
|mod_perl2                         |      1.999022    | mod_perl                                   |
|CGI                               |      3.11        | mod_perl                                   |
|Apache::DBI                       |      0.96        | mod_perl                                   |
+----------------------------------+------------------+--------------------------------------------+

6. Mail Transfer Agent (Sendmail 8.7 or above, or an MTA that is
   Sendmail-compatible)

7. Webserver to access the Bugzilla GUI [Recommended is Apache either 1.3.x or 2.x].

III. How to Install Bugzilla:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
	 
1. untar the bugzilla 3.0.2 tarball in the desired path(/usr/local/).

2. cd bugzilla 3.0.2 directory.

3. Run the ./checksetup.pl script.
   
   3.1. The checksetup.pl script shows the required perl modules to be
        installed.

   3.2. The localconfig file is created in the bugzilla directory to
        configure the Bugzilla parameters.

4. Edit the db_name, db_user, db_password and other necessary details
   in the localconfig file.

5. After editing the localconfig file, then again run the ./checksetup.pl
   script to create the bugzilla database.

6. Grant the permission for Bugzilla user in the mysql 'user' table.

   6.1. Make following enteries in the user table.

   Example:

   6.1.1. insert into user values('192.168.0.17','bugzilla',password('NNBugzilla'),'Y','Y','Y','Y','Y','Y','Y',
			      'Y','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y','','','','',0,0,0);

   6.1.2. insert into user values('%','bugzilla',password('NNBugzilla'),'Y','Y','Y','Y','Y','Y','Y','Y','Y','Y',
		              'Y','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y','','','','',0,0,0);

   6.1.3. insert into user values('localhost','bugzilla',password('NNBugzilla'),'Y','Y','Y','Y','Y','Y','Y','Y',
		              'Y','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y','','','','',0,0,0);

7. Create a soft link to Bugzilla in /var/www/html/

   7.1.   Create a directory bugzilla in /var/ww/html/ [ mkdir bugzilla]
   7.2. cd /var/www/html/
   7.3. ln -s /usr/local/bugzilla-3.0.2 bugzilla

   This will create a soft link.

8. Configure the Apache webserver to access Bugzilla.

   8.1. Apache uses <Directory> directives to permit fine-grained
	permission setting. Add the following lines to a directive
	(/etc/httpd/conf/httpd.conf file) that applies to the location
	of your Bugzilla installation.

		<Directory /var/www/html/bugzilla>
		AddHandler cgi-script .cgi
		Options +Indexes +ExecCGI
		DirectoryIndex index.cgi
		AllowOverride Limit
		</Directory>

   Note: [ These instructions allow 1.Apache to run .cgi files found
	 within the bugzilla directory, 2.Instructs the server to look
	 for a file called index.cgi if someone only types the
	 directory name into the browser and 3.Allows Bugzilla's
	 .htaccess files to override global permissions.]

	    
9. Access the bugzilla through GUI "http://<yourdomainname>/bugzilla"

   Example : http://192.168.0.17/bugzilla.

VI. Suggesstion:
^^^^^^^^^^^^^^^^

	Please send mail to nnbugzilla@ooty.tenet.res.in for suggestions.