Lyo/BuildTRS4JBugzilla/BugzillaInstallation

This page has the reference instruction to install Bugzilla for Tracked Resource Set(TRS) Workshop

Installing Bugzilla on Windows

Prerequisites

The following specific version of software images need to be downloaded.

• XAMPP v1.7.7
• Bugzilla v4.0.10
• Strawberry Perl v5.16.3.1
• Cygwin

Installation

1. Download XAMPPv1.7.7
   1. Install all components in it to C:\xampp folder.
2. Download bugzilla v4.0.10
   1. Un-gzip and un-tar it under c:\xampp\ (so that bugzilla will be extracted at C:\xampp\bugzilla-4.0.10)
3. Download strawberry-perl v5.16.3.1
   1. Install it to C:\strawberry. This strawberry perl is needed for 'cpan' to work. 'cpan' is a tool to install Perl modules.
      Note: strawberry perl componnets are used for the perl modues to be built. The runtime for Perl is xampp's perl.)
4. Download cygwin.
   1. Install it to c:\cygwin.
   2. You can install whatever you want. But Devel's gcc, gcc-g++, gcc4, gcc4-g++ andtheir prerequisite packages need to be installed. They are necessary to build perl modules. ( Suggestion: If cygwin is installed already, please delete them, and install cygwin with gcc, gcc-g++, gcc4, gcc4-g++ and their prerequisite packages as well as what you need again. )

Initial setup for XAMPP

1. set PATH=C:\xampp\apache\bin;C:\xampp\perl\bin;C:\strawberry\c\bin;%PATH%
2. cd C:\xampp
3. setup_xampp.bat
4. xampp-control.exe

Install necessary Perl modules for Bugzilla

1. Check the necessary modules are installed
      cd C:\xampp\bugzilla-4.0.10
      c:\xampp\perl\bin\perl.exe checksetup.pl --check-module
2. Make sure that missing modules are :
      c:\xampp\perl\bin\perl.exe install-module.pl CGI
      c:\xampp\perl\bin\perl.exe install-module.pl DateTime
      c:\xampp\perl\bin\perl.exe install-module.pl DateTime::TimeZone
      c:\xampp\perl\bin\perl.exe install-module.pl Template
      c:\xampp\perl\bin\perl.exe install-module.pl Email::MIME
      c:\xampp\perl\bin\perl.exe install-module.pl List::MoreUtils
   Also make sure that installed SOAP::Lite is old and Test::Taint is missing
3. Work around for Template-Toolkit and Test::Tain installation issue
      c:\xampp\perl\bin\ppm.bat install Template-Toolkit
      c:\xampp\perl\bin\ppm.bat install Test::Taint
4. Install prerequisite perl modules. Create a bat file which has the following commands, and save it and execute it. It takes a long time.
      c:\xampp\perl\bin\perl.exe install-module.pl CGI
      c:\xampp\perl\bin\perl.exe install-module.pl DateTime
      c:\xampp\perl\bin\perl.exe install-module.pl DateTime::TimeZone
      c:\xampp\perl\bin\perl.exe install-module.pl Email::MIME
      c:\xampp\perl\bin\perl.exe install-module.pl List::MoreUtils
      c:\xampp\perl\bin\perl.exe install-module.pl SOAP::Lite
5. Work around for TimeZone linkage error
   1. cd C:\xampp\bugzilla-4.0.10\lib\DateTime\TimeZone
   2. Edit Local.pm to change "TimeZone" subroutine to return the fixed time zone. The time zone name, in the following case, 'Asia/Tokyo', is in the list of Win32.pm in C:\xampp\bugzilla-4.0.10\lib\DateTime\TimeZone\Local so you can pick the correct one from them. The following is for Japan. (See "Cannot determine local time zone" error )
      
      Sub TimeZone {
        return DateTime::TimeZone->new(name => 'Asia/Tokyo');
      }
      Note1: This time zone name will be used in Bugzilla preferences. See Initial Bugzilla setup section below.
      Note2: Local.pm might be read-only, so you need to change its attribute before editing it.

Configure Apache

1. cd C:\xampp\apache\conf
2. Edit httpd.conf to add the following lines after the line of "Include "conf/extra/httpd-perl.conf"
      Alias /bugzilla "C:\xampp\bugzilla-4.0.10"
      PerlSwitches -IC:\xampp\bugzilla-4.0.10 -w -T
      PerlConfigRequire "C:\xampp\bugzilla-4.0.10\mod_perl.pl"
3. Continued : comment out the following two lines.
     <Directory />
        Options FollowSymLinks
   #   AllowOverride None
        Order deny,allow
   #   Deny from all
     </Directory>
4. cd C:\xampp\bugzilla-4.0.10
5. Edit mod_perl.pl, comment out the following three lines.
   # use Apache2::SizeLimit;
   ...
   # Apache2::SizeLimit->set_max_unshared_size(70_000);
   ...
   #   PerlCleanupHandler Apache2::SizeLimit Bugzilla::ModPerl::CleanupHandler

Configure MySQL

1. cd C:\xampp\mysql\bin
2. Edit my.ini
3. Add/modify the following lines in [mysqld] section.
    max_allowed_packet=4M <<- modify this line
     ft_min_word_len=2 <<- add this line
4. cd C:\xampp\bugzilla-4.0.10
5. Start MySQL by xampp-control.exe
6. c:\xampp\perl\bin\perl.exe checksetup.pl
7. Edit localconfig
      $db_user='root' <<-- change this to the user name to be used. 'root' is recommended.
8. c:\xampp\perl\bin\perl.exe checksetup.pl
9. Input required values ( for example, hostname, )
   DO NOT FORGET BUGZILLA ADMIN USER/PASSWD ! ( admin=root@localhost.here, passwd=passw0rd )

Start Bugzilla

In order to start Bugzilla, please :

1. Start MySQL by xampp-control.exe
2. Start Apache by xampp-control.exe

As a reference, in order to stop Bugzilla, please

1. Stop Apache by xampp-control.exe
2. Stop MySQL by xampp-control.exe

Initial Bugzilla setup for the TRS Workshop

1. Login bugzilla (http://<full qualified your host name >/bugzilla) with admin user/pasword( admin=root@localhost.here, passwd=passw0rd )
2. Administration -> Parameters -> Email -> mail_delivery_method : None (or Test), then "Save Changes"
3. Administration -> Parameters -> Required Settings -> urlbase : Type Bugzilla uri (for example, http://foo.bar.com/bugzilla), then "Save Changes"
4. Administration -> Default Preferences -> Timezone used to display dates and times -> Set the time zone name which is used as the workaround for the perl installation. ( For example, Asia/Tokyo ) then "Submit Changes"
5. Restart Bugzilla by xampp-control.exe (Restarting Apache is fine. )
6. Login bugzilla with admin user/pasword
7. Add users. For example,
   1. Administration -> Users -> add a new user, user=bugs@localhost.here, passwd=bugs4me. Add "editbugs" group access for "User is a member of these groups", then "Save Changes"
8. Add products. For example,
   1. Administration -> Products -> Add a product -> Add 'Integration Product' product
   2. Edit components -> Add a new component ... -> Add 'Client', 'Install', 'Server' components with bugs@localhost.here as a default assignee.
9. Add Bugs. For example,
   1. Log out and Log in with bugs@localhost.here/bugs4me
   2. Create several bugs in 'Integration Product' product/'Server' components.