Installing Bugzilla on Windows

crashclappergapΛογισμικό & κατασκευή λογ/κού

13 Δεκ 2013 (πριν από 3 χρόνια και 6 μήνες)

62 εμφανίσεις

Installing Bugzilla on Windows




Installing Bugzilla on Windows


Software Requirements
:




Bugzilla 2.20.4 (Download Bugzilla from
http://www.bugzilla.org/download/#stable
)



MySQL 4.1.22 (Download MySQL From
http://dev.mysql.com/downloads/mysql/4.1.html

Windows (x86)
ZIP/Setup.EXE)



ActivePerl (Download ActivePerl from
http://www.activestate.com/store/download.aspx?prdGUID=81fbce82
-
6bd5
-
49bc
-
a915
-
08d58c2648ca

Windows (x86)
MSI

15.5MB)



b
ugzilla
-
bundle.zip

(Download
bugzilla
-
bundle.zip

from
http://landfill.bugzilla.org/ppm/
)



Apache 2.2.4 (Download Apache Web Server from
http://httpd.apache.org/download.cgi

Win32 Binary (MSI Installer):
apache_2.2.4
-
win32
-
x86
-
no_ssl.msi

[
PGP
] [
MD5
])


Installation Steps
:

(
Assuming Operation System is on C
:
\
)



Unzip
Bugzilla

2.20.4 tar File to
any folder(
C:
\
Bugzilla
)




Install Mysql 4.1.22

MySQL has a standard Windows installer. It's ok to select a Typical MySQL install
(the default). For the remainder of this document I will assume you have installed
MySQL i
nto C:
\
Progarm Files
\
Mysql
.


Create Bugs Database and User

Use the
Mysql

command line utility to create the Bugzilla database and a MySQL
account for Bugzilla. Note in the following example 'password' is my password for the
bugs account:


C:
\
Program File
s
\
MySQL
\
MySQL Server 4.1
\
bin>
mysql
--
user=root
-
p mysql

Enter password:
********

Welcome to the MySQL monitor. Commands end with ; or
\
g.

Your MySQL connection id is 15 to server version: 4.0.20a
-
debug


Type 'help;' or '
\
h' for help. Type '
\
c' to clear th
e buffer.


mysql>
create database bugs;


Query OK, 1 row affected (0.11 sec)


mysql>
grant all privileges on bugs.* to 'bugs'@'localhost' identified
by 'password';

Query OK, 0 rows affected (0.03 sec)


mysql>
flush privileges;

Query OK, 0 rows affected (0.
00 sec)

mysql>
quit

Bye

C:
\
Program Files
\
MySQL
\
MySQL Server 4.1
\
bin>

Installing Bugzilla on Windows




If you are running MySQL 4.1 or higher, you may encounter the
Client does not
support authentication protocol requested by server

error message. To fix this, once
the user has been creat
ed you will have to reset the password using
OLD_PASSWORD:


C:
\
Program Files
\
MySQL
\
MySQL Server 4.1
\
bin>
mysql
--
user=root
-
p mysql

Enter password:
********

Welcome to the MySQL monitor. Commands end with ; or
\
g.

Your MySQL connection id is 15 to server v
ersion: 4.1.11
-
nt


Type 'help;' or '
\
h' for help. Type '
\
c' to clear the buffer.


mysql>
set password for 'bugs'@'localhost' = OLD_PASSWORD('
password
');

Query OK, 0 rows affected (0.00 sec)


mysql>
quit


Bye


C:
\
Program Files
\
MySQL
\
MySQL Server 4.1
\
bin>




Installing ActivePerl

Install ActivePerl to C:
\
perl
. Now unzip bugzilla
-
bundle.zip to a temporary directory
say C:
\

bugzilla
-
bundle.

Now open command prompt and go to C:
\

bugzilla
-
bundle. And perform the foll
owing


C:
\

bugzilla
-
bundle
\
>ppm

install AppConf
ig.ppd

C:
\

bugzilla
-
bundle
\
>ppm install TimeDate.ppd

C:
\

bugzilla
-
bundle
\
>ppm install DBI.ppd

C:
\

bugzilla
-
bundle
\
>ppm install DBD
-
mysql.ppd

C:
\

bugzilla
-
bundle
\
>ppm install Template
-
Toolkit.ppd

C:
\

bugzilla
-
bundle
\
>ppm install GD.ppd

C:
\

bugzilla
-
bundle
\
>
ppm install Chart.ppd

C:
\

bugzilla
-
bundle
\
>ppm install GDTextUtil.ppd

C:
\

bugzilla
-
bundle
\
>ppm install GDGraph.ppd

C:
\

bugzilla
-
bundle
\
>ppm install MailTools.ppd

C:
\

bugzilla
-
bundle
\
>ppm install MIME
-
tools.ppd

C:
\

bugzilla
-
bundle
\
>ppm install PatchReader.p
pd


If you want to uninstall any perl module, use the following command.


C:
\

bugzilla
-
bundle
\
>ppm
uninstall <perl
-
module>


E
xample:

C:
\

bugzilla
-
bundle
\
>ppm
un
install PatchReader.ppd




Installing Apache
web
server

Installing Apache on Windows is again a smo
oth process. Just follow the instructions.
Make sure you Install it for All Users.
A
pache is in
C:
\
Program Files
\
Apache
Software Foundation
\
Apache2.2


Configure Apache


Edit
C:
\
Program Files
\
Apache Group
\
Apache2
\
conf
\
httpd.conf

with your
favourite text edit
or.

Installing Bugzilla on Windows




# Change this to Listen on specific IP addresses as shown below to

# prevent Apache from glomming onto all bound IP addresses (0.0.0.0)

#

#Listen 12.34.56.78:80

Listen 80



Change the
DocumentRoot

setting to point to C:
\
Bugzilla. Note there are two
lo
cations in httpd.conf that need to be updated.

#

# DocumentRoot: The directory out of which you will serve your

# documents. By default, all requests are taken from this directory,
but

# symbolic links and aliases may be used to point to other locations.

#

DocumentRoot "C:/Bugzilla"


#

# This should be changed to whatever you set DocumentRoot to.

#

<Directory "C:/Bugzilla">



Enable CGI support in Apache by uncomme
nting the AddHandler cgi
-
script
.

cgi line.

#

# AddHandler allows you to map certain file exte
nsions to "handlers":

# actions unrelated to filetype. These can be either built into the
server

# or added with the Action directive (see below)

#

# To use CGI scripts outside of ScriptAliased directories:

# (You will also need to add "ExecCGI" to the "Op
tions" directive.)

#

AddHandler cgi
-
script .cgi


And allow .cgi scripts in the Bugzilla directory by adding the ExecCGI option. We also
need to allow Bugzilla's .htaccess file to restrict access to sensitive documents by
allowing it to override the defaul
ts. This involves changing AllowOverride None to
AllowOverride All.

<Directory "C:/Bugzilla">


#


# Possible values for the Options directive are "None", "All",


# or any combination of:


# Indexes Includes FollowSymLinks SymLinksifOwnerMatch

ExecCGI
MultiViews


#


# Note that "MultiViews" must be named *explicitly*
---

"Options
All"


# doesn't give it to you.


#


# The Options directive is both complicated and important. Please
see


# http://httpd.apache.org/docs/2.2/mod/co
re.html#options


# for more information.


#

Installing Bugzilla on Windows





Options Indexes FollowSymLinks ExecCGI



#


# AllowOverride controls what directives may be placed in .htaccess
files.


# It can be "All", "None", or any combination of the keywords:


# Op
tions FileInfo AuthConfig Limit


#


AllowOverride All



#


# Controls who can get stuff from this server.


#


Order allow,deny


Allow from all


</Directory>


Apache also needs to know to use Perl to execute .cgi files, via the
ScriptI
nterpreterSource directive.

#

# To enable the this Windows specific behavior (and therefore
-
disable
-

the

# equivilant Unix behavior), uncomment the following directive:

#

ScriptInterpreterSource Registry
-
Strict

#

# The directive above can be placed in ind
ividual <Directory> blocks or
the

# .htaccess file, with either the 'registry' (Windows behavior) or
'script'

# (Unix behavior) option, and will override this server default option.

#


You also should add index.cgi to the DirectoryIndex list.

#

# Directo
ryIndex: sets the file that Apache will serve if a directory

# is requested.

#


<IfModule dir_module>

DirectoryIndex index.html index.html.var index.cgi

</IfModule>


#

# The following lines prevent .htaccess and .htpasswd files from being

# viewed by Web
clients.

#


In order for ScriptInterpreterSource Registry
-
Strict to work, you also need to add an
entry to the Registry so Apache will use Perl to execute .cgi files.


Create a key HKEY_CLASSES_ROOT
\
.cgi
\
Shell
\
ExecCGI
\
Command with the default
value of th
e full path of perl.exe with a
-
T parameter. For example
C:
\
Perl
\
bin
\
perl.exe

T
. Restart the Apache Web Server.

Installing Bugzilla on Windows




Following steps are required for

creating

a key
:

1.

Go to Run by clicking the Start and type ‘regedit’ in it and press enter Key.

2.

Check for the .c
gi directory

under HKEY_CLASSES_ROOT.

3.

if it does not exit r
ight click on HKEY_CLASSES_ROOT
-
>New
-
>Key.

And g
ive the
Key name as .cgi
.

4.

Under .cgi create new keys upto
Shell
\
ExecCGI
\
Command

by following the above
step.

5.

The figure below shows the specifed dat
a.




6.

Now restart Apache web server.


Configuring Bugzilla

1.

Go to command prompt
C:
\
Bugzilla

an
d execute the following command.

C:
\
Bugzilla>Perl checksetup.pl

Installing Bugzilla on Windows






The above figure shows
installations of all perl modules are

done
.

If any module is
not instal
led, then it shows not found instead of ‘ok: found’.please download the not
found modules tar file from‘
http://ppm.activestate.com/PPMPackages/zips/8xx
-
builds
-
only/Windows
’ and untar it to
C:
\
bugzill
-
bundle

and install it again using the
command
C:
\
bugzill
-
bundle
>ppm install <module_name>.ppd
.


After installing all the not found modules, once again execute the following command

C:
\
Bugzilla>Perl checksetup.pl


If the command executes properly, then it crteates a

localconfig
file in

C:
\
Bugzilla
folder.
Open th
e localconfig file for the following changes

#

# How to access the SQL database:

#

$db_host = 'localhost';

# where is the database?

$db_name = 'bugs';

# name of the SQL database

$db_user = 'bugs';

# user to attach to the
SQL database

# Sometimes the database server is running on a non
-
standard

# port. If that's the case for your database server, set this

# to the port number that your database server is running on.

# Setting this to 0 means "use the default port for my dat
abase

# server."

$db_port = 3306;

#

# Enter your database password here. It's normally advisable to specify

# a password for your bugzilla database user.

# If you use apostrophe (') or a backslash (
\
) in your password, you'll

# need to escape it by precedi
ng it with a '
\
' character. (
\
') or (
\
)

# (Far simpler just not to use those characters.)

#

$db_pass = 'password';

Installing Bugzilla on Windows





After doing the above changes in the loacconfig file, Once again execute the
following command in the command prompt

C:
\
Bugzilla>Perl check
setup.pl


No
w it will ask you for the administratore Email Id, Real Name And Password.

After providing the Admin details, Bugzilla configuration is done. Now you can Exit
form the Command prompt.


Open the Internet Explorer and type
http://localhost

in the URL Window and press
Enter Key.

Now you will be able to see the Bugzilla Home Page

(If all above steps are
followed properly)
.