Bugzilla Server Setup

Bugzilla Server Setup


References :
    http://linuxdrops.com/installing-bugzilla-on-centos/
    http://blog.codylab.com/install-bugzilla-centos-6-3-step-step/
    http://certcollection.org/forum/topic/142605-bugzilla-tutorial-on-centos-6/
    http://parsedcontent.blogspot.in/2011/05/disabling-account-creation-in-bugzilla.html


1) Make Sure yours System/OS Installed Properly. As per os setup way

a) System Date is Correct and up2date
  date +%Y%m%d -s "20120818"
  date +%T -s "07:21:20"

b) System Network Settings

     

2) Veify or Install dependent Software

a) Make Sure Apache and Mysql installed locally and running properly
  Better to use User  guide to setup mysql and apache

b) Make sure perl version is >= 5.8.1 as shown below.
          perl -v
  if perl not exist then please install
  yum install perl
  perl -v
 
c)  Install perl-CPAN module
           yum install perl-CPAN

       d) Check perl install modules 
          instmodsh

e) Configure Apache with mod_perl
          if apache does not contains mod_perl module , then setup/configure mod_perl module for apache


3) Download bugzilla
cd /opt/
wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.4.tar.gz
tar -zxvf bugzilla-4.4.tar.gz
mv bugzilla-4.4 bugzilla
rm -fr bugzilla-4.4.tar.gz


4) Check Required Module by Bugzilla

cd /opt/bugzilla
./checksetup.pl --check-modules

Note : It will check required modules exist or not, The modules which are not exist are highlighted.
      You can manually setup those modules one by one or in single go as specified in below steps
      if you are not able to install any module by perl CPAN way then even you can also install it by yum way
      example :
      if you are not able to install DBD::mysql module by perl CPAN way , i.e.
      /usr/bin/perl install-module.pl DBD::mysql  --> if no luck , then you can try following
      yum install perl-DBD-mysql

5) Install Required Module by Bugzilla
  /usr/bin/perl install-module.pl <MODULE NAME>

Note :  better setup require modules only , not all modules       

    

6) Check Required Module by Bugzilla Again
cd /opt/bugzilla
./checksetup.pl --check-modules

7) Create localconfig file
./checksetup.pl

8)Create  bugzilla database on database server

mysql -u root -p
create database bugzilla;
GRANT ALL ON bugzilla.* TO 'bugzilla'@'localhost' IDENTIFIED BY 'bugzilla' ;
GRANT ALL ON bugzilla.* TO 'bugzilla'@'%' IDENTIFIED BY 'bugzilla' ;


9) define database settings in localconfig file
vi ./localconfig
Adding the database name, username and password
$db_driver = 'mysql';
$db_host = 'localhost';
$db_name = 'bugzilla';
$db_user = 'bugzilla';
$db_pass = 'bugzilla';
$db_port = 3306;
$db_sock = '/tmp/mysql.sock';

10) Create bugzilla database tables
./checksetup.pl


11) setup Apache configuration for bugzilla

vi /opt/apache/conf/httpd.conf

############SECURITY  SETTINGS START##############
NameVirtualHost *:80

##PerlSwitches -I/opt/bugzilla -I/opt/bugzilla/lib -w -T
##PerlConfigRequire /opt/bugzilla/mod_perl.pl

<VirtualHost *:80>
   ServerName bugzilla.linukstricks.com
   ServerAlias bugzilla.linukstricks.com

   DocumentRoot /opt/bugzilla
   ErrorLog  logs/bugzilla-error_log
   CustomLog logs/bugzilla-access_log custom

   <Directory /opt/bugzilla>
AddHandler cgi-script cgi
DirectoryIndex index.cgi
##Options +Indexes +ExecCGI +FollowSymLinks -MultiViews +SymLinksIfOwnerMatch
Options +ExecCGI -Indexes +FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
   </Directory>

</VirtualHost>
############ SECURITYSETTINGS END##############


12) Restart Apache and verify error logs
/opt/apache/bin/apachectl -k restart


13) set permission , if you are getting some permission error in error log then
   chmod -R 777 /opt/bugzilla
   /opt/apache/bin/apachectl -k restart

--------------------------------------------------------------------------------------------------------------
Additional Steps
--------------------------------------------------------------------------------------------------------------
1) if any modules relared error while bugzilla usage  , then you may required following modules to be setup additionally
  Install only those modules for which error is given

  cd /opt/bugzilla
  /usr/bin/perl install-module.pl Time::HiRes
  /usr/bin/perl install-module.pl Apache2::SizeLimit
  /usr/bin/perl install-module.pl Linux::Pid

2) Configure Bugzilla Default Urlbase , So that will apper in the mails
    a) Log in as an Administrator
    b) Go to: Administration->Parameters->Required Settings
    c) in the urlbase text , define http://bugzilla.DOMAIN.com/
    d) Click on "Save Changes"

3) Configure Maintainer
    a) Log in as an Administrator
    b) Go to: Administration->Parameters->General
    c) specify maintainer as devendra.joshi@linukstricks.com
    d) Click on "Save Changes"

4) Define only yours domain users can self register

  a) Log in as an Administrator
  b) Go to: Administration->Parameters->User Authentication
  c) Go to 'createemailregexp' field
  d) Secify following in value
     .*@(linukstricks.com)
  e) Click on "Save Changes"
  f) logout and check only yours specified domain user can self register via "Open New Account" link


5) Set Require Login
  a) Log in as an Administrator
  b) Go to: Administration->Parameters->User Authentication
  c) set requirelogin field value to On
  d) Click on "Save Changes"
  e) Now all access to the system beyond the front page will require a login.

6) Set Maximum Attachment Size to 10 MB
  a) Log in as an Administrator
  b) Go to: Administration->Parameters->Attachments
  c) set maxattachmentsize field value to 10000
  d) Click on "Save Changes"

4) Configure Bugzilla Sendmail Configuration
    a) Log in as an Administrator
    b) Go to: Administration->Parameters->Email
    c) Do Senmail setting
    d) Click on "Save Changes"

5) Define different Project/Product
    a) Log in as an Administrator
    b) Go to: Administration->Products->Add

6) Define Users
    a) Log in as an Administrator
    b) Go to: Administration->Users->add a new user


--------------------------------------------------------------------------------------------------------------