Bugzilla:Win32Install: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
(Added bug 708252 - XMLRPC interface not working with IIS.)
(Redirect to new docs.)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
'''If you want a single-package installer that will install Apache, MySQL, Perl, and Bugzilla all at once and configure them all for you, check out the [[Bugzilla:Win32InstallPackages|Windows Install Packages]].'''
See http://bugzilla.readthedocs.org/en/latest/installing/windows.html .
 
If you prefer to do everything yourself, the below instructions explain how to manually configure Bugzilla on Windows.
 
== Installing Bugzilla on Microsoft Windows with Apache ==
 
'''Original author: [http://bugzilla.glob.com.au/ Byron Jones]'''
 
Bugzilla version 2.18 was the first release that runs unmodified on Windows. This document guides you step by step through the installation process.
 
Note that there are a few things that don't work very well on Windows, such as mod_perl.
 
=== Bugzilla ===
 
There's two main methods to getting the Bugzilla source - from bzr or in a tarball. The best method for fetching Bugzilla is to grab it directly from bzr, as this will allow for simple upgrades, even if you have customised Bugzilla.
 
Read the [http://www.bugzilla.org/releases/4.0/release-notes.html Release Notes] before you do anything.
 
==== Installing Bugzilla From bzr ====
 
Download the Bazaar standalone installer from the [http://wiki.bazaar.canonical.com/WindowsDownloads Bazaar website], and run the installer.
 
Note: this document assumes you want to install Bugzilla into '''C:\Bugzilla'''.
 
Open the command line, and cd to the '''parent''' of the directory you want to install Bugzilla into. As we'll be installing Bugzilla into '''C:\Bugzilla''', the current directory must be '''C:\'''.
 
C:\>'''bzr co -r tag:bugzilla-4.0.2 bzr://bzr.mozilla.org/bugzilla/4.0 Bugzilla'''
C:\>
 
It can take a minute or two to download all files, be patient. In the example above, '''tag:bugzilla-4.0.2''' means we want to install Bugzilla 4.0.2, and '''bugzilla/4.0''' in the URL is the branch this version belongs to (bzr doesn't guess this part of the URL for you). If you already installed Bugzilla using bzr and want to upgrade to a newer version, please follow the instructions given [[Bugzilla:Bzr#Updating_to_a_Newer_Release|here]].
 
==== Installing Bugzilla From the TarBall ====
 
Download Bugzilla from the [http://www.bugzilla.org/download/#stable Bugzilla download page] (2.9 MB).
 
Bugzilla ships as a Tarball, which has the extension .tar.gz. Any decent Windows archive tool should be able to extract tarballs.
 
Extract the archive to the directory of your choice. For the remainder of this document I will assume that you have extracted Bugzilla into '''C:\Bugzilla'''.
 
==== Upgrading From TarBall ====
 
If you installed Bugzilla from the TarBall, the simplest way to upgrade is to follow the instructions given above about bzr.
 
=== MySQL ===
 
==== Download MySQL  ====
 
Download the MySQL 32-bit or 64-bit MSI installer from the [http://www.mysql.com/downloads/mysql/ MySQL website] (28 MB).
 
==== Install  ====
 
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 into '''C:\mysql'''.
 
Now change a few settings. Goto <tt>C:\mysql\bin\my.ini</tt> and set the <code>max_allowed_packet</code> setting to <code>4M</code>. Underneath that, add the following line:
 
ft_min_word_len = 2
 
==== Create Bugs Database User ====
 
Use the '''mysql''' command line utility to create a MySQL account for Bugzilla.
 
Note in the following example 'sockmonkey' is my password for the bugs account:
 
C:\mysql\bin&gt;'''mysql --user=root -p mysql'''
Enter password: '''********'''
Welcome to the MySQL monitor.  Commands end with&nbsp;; or \g.
Your MySQL connection id is 1
Server version: 5.5.15 MySQL Community Server (GPL)
mysql&gt; '''GRANT ALL PRIVILEGES ON bugs.* TO 'bugs'@'localhost' IDENTIFIED BY 'sockmonkey';'''
Query OK, 0 rows affected (0.03 sec)
mysql&gt; '''quit'''
Bye
C:\mysql\bin&gt;
 
=== ActiveState Perl ===
 
==== Download ActiveState Perl  ====
 
Download the ActiveState Perl 5.12.4 or higher MSI installer from the [http://www.activestate.com/activeperl/downloads ActiveState website].
 
Note that Bugzilla currently requires Perl 5.8.1 or higher, but it's highly recommended to install ActivePerl 5.12 or higher. Bugzilla 4.2 will be the last version to support Perl 5.8.x. The next release will require Perl 5.10.1 or better. Also, there are several bugs in Perl 5.8.x which have been fixed in 5.10.1 and 5.12.
 
==== Install ====
 
ActiveState Perl uses a standard Windows Installer. Install, sticking with the defaults, which will install Perl into '''C:\Perl'''.
 
Note: Installing Perl into a directory that contains a space (eg "C:\Program Files") will break the Template-Toolkit installer.
 
Once the install has completed, log out and log in again to pick up the changes to the PATH.
 
==== Upgrading Existing Installs ====
 
If you already have ActiveState Perl installed, now's a good time to ensure you're running the latest version of ActiveState Perl, along with the latest versions of the modules.
 
Upgrading ActiveState Perl requires to delete the old version and install the new one. The reason is that Perl modules installed with one version of Perl are not compatible with a newer version of Perl. So you will have to reinstall these modules again.
 
==== Install Modules  ====
 
Bugzilla requires a number of perl modules to be installed. They are available in the ActiveState repository and the following additional repositories:<br>Perl 5.8.x:<br>&nbsp;&nbsp;&nbsp;'''http://theoryx5.uwinnipeg.ca/ppms/'''<br>Perl 5.10.x:<br>&nbsp;&nbsp;&nbsp;'''http://cpan.uwinnipeg.ca/PPMPackages/10xx/''' and<br>&nbsp;&nbsp;&nbsp;'''http://trouchelle.com/ppm10/'''<br>Perl 5.12 doesn't require any additional repository. It already contains everything that Bugzilla needs.
 
If you use a proxy server or a firewall you may have trouble running PPM. This is covered in the [http://aspn.activestate.com/ASPN/docs/ActivePerl/faq/ActivePerl-faq2.html#ppm_and_proxies ActivePerl FAQ].
 
The '''Net::LDAP''' module is only required if you want to use Active Directory for authentication.
 
The following are the commands and ouput for a 5.10.x perl module installation. If you don't want to use the command-line interface but prefer a nice Graphical User Interface (GUI), simply type "ppm", or look for the Perl Package Manager in the Windows Start bar.
 
C:\&gt;ppm version
ppm 4.06 (ActivePerl 1006)
Copyright (C) 2009 ActiveState Software Inc. All rights reserved.
C:\&gt;'''ppm repo add UWinnipeg http://cpan.uwinnipeg.ca/PPMPackages/10xx/'''
Downloading ActiveState Package Repository packlist...done
Updating ActiveState Package Repository database...done
Downloading UWinnipeg packlist...done
Updating UWinnipeg database...done
Repo 2 added.
C:\&gt;'''ppm repo add Trouchelle http://trouchelle.com/ppm10/'''
Downloading Trouchelle packlist...done
Updating Trouchelle database...done
Repo 3 added.
C:\&gt;'''ppm repo list'''
+---------------------------------------------+
¦ id ¦ pkgs  ¦ name                          ¦
+----+-------+--------------------------------¦
¦ 1  ¦ 11417 ¦ ActiveState Package Repository ¦
¦ 2  ¦ 291  ¦ UWinnipeg                      ¦
¦ 3  ¦ 11737 ¦ Trouchelle                    ¦
+---------------------------------------------+
(3 enabled repositories)
C:\&gt;'''ppm upgrade --install'''
Syncing site PPM database with .packlists...done
Archive-Tar 1.54 (have 1.52-r1)
Attribute-Handlers 0.87 (have 0.86)
AutoLoader 5.70 (have 5.69)
Bit-Vector 7.1 (have 6.9)
Class-Accessor 0.34 (have 0.33)
Class-ISA 0.36 (have 0.33)
Compress-Raw-Bzip2 2.021 (have 2.020)
Compress-Raw-Zlib 2.021 (have 2.020)
DBD-ODBC 1.23 (have 1.22)
DBI 1.609 (have 1.607)
Date-Calc 5.8 (have 5.6)
Encode 2.37 (have 2.35)
ExtUtils-CBuilder 0.260301 (have 0.2603)
ExtUtils-Manifest 1.57 (have 1.56)
ExtUtils-ParseXS 2.21 (have 2.2002)
File-Path 2.08 (have 2.07_03)
File-Which 1.09 (have 1.07)
IO-Compress 2.021 (have 2.020)
IPC-Cmd 0.50 (have 0.46)
Log-Message-Simple 0.06 (have 0.04)
Math-BigRat 0.24 (have 0.22)
Module-CoreList 2.20 (have 2.17)
Module-Loaded 0.06 (have 0.02)
Object-Accessor 0.36 (have 0.34)
Safe 2.19 (have 2.17)
Test-Simple 0.94 (have 0.92)
Text-CSV_XS 0.68 (have 0.67)
Text-Reform 1.20 (have 1.11)
constant 1.19 (have 1.18)
parent 0.223 (have 0.221)
version 0.7702 (have 0.7701)
C:\&gt;'''ppm install AppConfig'''
Downloading AppConfig-1.66...done
Unpacking AppConfig-1.66...done
Generating HTML for AppConfig-1.66...done
Updating files in site area...done
14 files installed
C:\&gt;'''ppm install TimeDate'''
Downloading TimeDate-1.19...done
Unpacking TimeDate-1.19...done
Generating HTML for TimeDate-1.19...done
Updating files in site area...done
41 files installed
C:\&gt;'''ppm install DBI'''
No missing packages to install
C:\&gt;'''ppm install DBD-mysql'''
Downloading DBD-mysql-4.011...done
Unpacking DBD-mysql-4.011...done
Generating HTML for DBD-mysql-4.011...done
Updating files in site area...done
12 files installed
C:\&gt;'''ppm install Template-Toolkit'''
Downloading Template-Toolkit-2.22...done
Unpacking Template-Toolkit-2.22...done
Generating HTML for Template-Toolkit-2.22...done
Updating files in site area...done
140 files installed
C:\&gt;'''ppm install MailTools'''
Downloading MailTools-2.04...done
Downloading Test-Pod-1.40...done
Unpacking MailTools-2.04...done
Unpacking Test-Pod-1.40...done
Generating HTML for MailTools-2.04...done
Generating HTML for Test-Pod-1.40...done
Updating files in site area...done
43 files installed
C:\&gt;'''ppm install GD'''
No missing packages to install
C:\&gt;'''ppm install Chart'''
Downloading Chart-2.4.1...done
Unpacking Chart-2.4.1...done
Generating HTML for Chart-2.4.1...done
Updating files in site area...done
16 files installed
C:\&gt;'''ppm install GDGraph'''
Downloading GDGraph-1.44...done
Unpacking GDGraph-1.44...done
Generating HTML for GDGraph-1.44...done
Updating files in site area...done
21 files installed
C:\&gt;'''ppm install PatchReader'''
Downloading PatchReader-0.9.5...done
Unpacking PatchReader-0.9.5...done
Generating HTML for PatchReader-0.9.5...done
Updating files in site area...done
12 files installed
C:\&gt;'''ppm install Net-LDAP-Express'''
Downloading Net-LDAP-Express-0.11...done
Downloading perl-ldap-0.39...done
Downloading Convert-ASN1-0.22...done
Unpacking Net-LDAP-Express-0.11...done
Unpacking perl-ldap-0.39...done
Unpacking Convert-ASN1-0.22...done
Generating HTML for Net-LDAP-Express-0.11...done
Generating HTML for perl-ldap-0.39...done
Generating HTML for Convert-ASN1-0.22...done
Updating files in site area...done
103 files installed
 
=== Apache ===
 
It is recommended that you run Bugzilla with the Apache web server. If you want to use IIS to run Bugzilla, there are [http://www.bugzilla.org/docs/4.0/en/html/configuration.html#http-iis configuration instructions] in the Bugzilla documentation.
 
==== Download Apache 2.x ====
 
Download the Apache HTTP Server version 2.2.x or higher from: http://httpd.apache.org/download.cgi
 
==== Install ====
 
Yet another standard Windows Installer. Just follow the prompts, making sure you Install for All Users. Be aware the Apache will always install itself into an '''Apache2''' directory under what ever path you specify. The default install path will be displayed as '''C:\Program Files\Apache Group''' which will result in Apache being installed to '''C:\Program Files\Apache Group\Apache2'''. This gets me every time.
 
For the remainder of this document I will assume you installed Apache into the default location, '''C:\Program Files\Apache Group\Apache2'''.
 
If you are already running IIS, you must configure apache to run on a port other than 80, however you aren't asked the port to listen on at install time. Choose '''All Users''' (which says port 80), and we'll change the port later.
 
By default Apache installs itself to run as the SYSTEM account. For security reasons it's better the reconfigure the service to run as an Apache user. Create a user that is a member of '''no''' groups, and reconfigure the Apache2 service to run as that account.
 
==== Grant write access for Apache account ====
 
By default Apache will run as the SYSTEM account. This account needs write and modify access to the following directorys, and all their subdirectories. Depending on your version of Windows, this access may already be granted.
 
*C:\Bugzilla\data
*C:\Program Files\Apache Group\Apache2\logs
*C:\Temp
*C:\Windows\Temp
 
Note that '''C:\Bugzilla\data''' is created the first time you run '''checksetup.pl'''.
 
==== Configure Port and DocumentRoot ====
 
Edit '''C:\Program Files\Apache Group\Apache2\conf\httpd.conf''' with your [http://www.vim.org/ favourite text editor].
 
To change the port that Apache runs on (listens on, or binds to), edit the '''Listen''' option.
 
#
# Listen: Allows you to bind Apache to specific IP addresses and/or
# ports, instead of the default. See also the &lt;VirtualHost&gt;
# directive.
#
# 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 locations in '''httpd.conf''' that need to be updated. Note you need to use / instead of \ as a path separator.
 
#
# 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"'''
#
# Each directory to which Apache has access can be configured with respect
# to which services and features are allowed and/or disabled in that
# directory (and its subdirectories).
#
# First, we configure the "default" to be a very restrictive set of
# features. 
#
&lt;Directory /&gt;
    Options FollowSymLinks
    AllowOverride None
&lt;/Directory&gt;
#
# Note that from this point forward you must specifically allow
# particular features to be enabled - so if something's not working as
# you might expect, make sure that you have specifically enabled it
# below.
#
#
# This should be changed to whatever you set DocumentRoot to.
#
'''&lt;Directory "C:/Bugzilla"&gt;'''
 
==== Configure CGI ====
 
To enable CGI support in Apache, you need to enable the CGI handler, by uncommenting the '''AddHandler cgi-script .cgi''' line.
 
#
# AddHandler allows you to map certain file extensions 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 "Options" 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 defaults. This involves changing '''AllowOverride None''' to '''AllowOverride All'''.
 
Apache also needs to know to use Perl to execute .cgi files, via the '''ScriptInterpreterSource''' directive.
 
#
# This should be changed to whatever you set DocumentRoot to.
#
&lt;Directory "C:/Bugzilla"&gt;
#
# 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.0/mod/core.html#options
# for more information.
#
'''    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:
#  Options FileInfo AuthConfig Limit
#
'''    AllowOverride All'''
#
# Controls who can get stuff from this server.
#
    Order allow,deny
    Allow from all
#
# Tell Apache to use Perl to execute .cgi
#
'''    ScriptInterpreterSource Registry-Strict'''
&lt;/Directory&gt;
 
You also should add '''index.cgi''' to the '''DirectoryIndex''' list.
 
#
# DirectoryIndex: sets the file that Apache will serve if a directory
# is requested.
#
# The index.html.var file (a type-map) is used to deliver content-
# negotiated documents.  The MultiViews Option can be used for the
# same purpose, but it is much slower.
#
'''DirectoryIndex index.html index.html.var index.cgi'''
 
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 the full path of perl.exe with a -T parameter. For example '''C:\Perl\bin\perl.exe -T'''
 
[[Image:Bugzilla-Regedit.png|100px|Regedit]]
 
==== Disable Logging ====
 
Unless you want to keep statistics on how many hits your Bugzilla install is getting, it's a good idea to disable logging by commenting out the '''CustomLog''' directive.
 
#
# The location and format of the access logfile (Common Logfile Format).
# If you do not define any access logfiles within a &lt;VirtualHost&gt;
# container, they will be logged here.  Contrariwise, if you *do*
# define per-&lt;VirtualHost&gt; access logfiles, transactions will be
# logged therein and *not* in this file.
#
'''#CustomLog logs/access.log common'''
 
==== Restart Apache ====
 
Finally, restart Apache to get it pick up the changes.
 
C:\&gt;'''net stop apache2'''
The Apache2 service is stopping..
The Apache2 service was stopped successfully.
C:\&gt;'''net start apache2'''
The Apache2 service is starting.
The Apache2 service was started successfully.
C:\&gt;
 
 
=== Configure Bugzilla ===
 
==== checksetup.pl ====
 
Run '''checksetup.pl'''. This will check your Perl modules and create '''localconfig'''.
 
C:\&gt;'''cd bugzilla'''
C:\bugzilla&gt;'''perl checksetup.pl'''
Set up gcc environment - 4.4.3
* This is Bugzilla 4.1.3 on perl 5.14.1
* Running on Win7 Build 7601 (Service Pack 1)
Checking perl modules...
Checking for              CGI.pm (v3.51)    ok: found v3.55
Checking for          Digest-SHA (any)      ok: found v5.62
Checking for            TimeDate (v2.21)    ok: found v2.24
Checking for            DateTime (v0.28)    ok: found v0.70
Checking for    DateTime-TimeZone (v0.79)    ok: found v1.35
Checking for                  DBI (v1.614)    ok: found v1.616
Checking for    Template-Toolkit (v2.22)    ok: found v2.22
Checking for          Email-Send (v2.16)    ok: found v2.198
Checking for          Email-MIME (v1.904)    ok: found v1.908
Checking for                  URI (v1.37)    ok: found v1.58
Checking for      List-MoreUtils (v0.22)    ok: found v0.32
Checking for    Math-Random-ISAAC (v1.0.1)    ok: found v1.004
Checking for                Win32 (v0.35)    ok: found v0.44
Checking for            Win32-API (v0.55)    ok: found v0.62
Checking available perl DBD modules...
Checking for              DBD-Pg (v1.45)    ok: found v2.17.2
Checking for            DBD-mysql (v4.001)    ok: found v4.019
Checking for          DBD-SQLite (v1.29)    ok: found v1.33
Checking for          DBD-Oracle (v1.19)    ok: found v1.27
The following Perl modules are optional:
Checking for                  GD (v1.20)    ok: found v2.45
Checking for                Chart (v2.1)      ok: found v2.4.2
Checking for          Template-GD (any)      ok: found v1.56
Checking for          GDTextUtil (any)      ok: found v0.86
[...]
This version of Bugzilla contains some variables that you may want
to change and adapt to your local settings. Please edit the file
'./localconfig' and rerun checksetup.pl
The following variables are new to localconfig since you last ran
checksetup.pl:  index_html cvsbin interdiffbin diffpath create_htaccess
webservergroup db_driver db_host db_pass db_sock db_check
C:\bugzilla&gt;
 
==== Edit localconfig ====
 
Open '''C:\Bugzilla\localconfig''' in your favourite text editor to configure Bugzilla.
 
You have to tell Bugzilla how to access your database. If you used bugs/bugs, you'll only have to set '''db_pass'''.
 
#
# How to access the SQL database:
#
$db_host = "localhost";        # where is the database?
$db_port = 3306;                # which port to use
$db_name = "bugs";              # name of the MySQL database
$db_user = "bugs";              # user to attach to the MySQL database
#
# 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 preceding it with a \ character. (\') or (\\)
#
'''$db_pass = 'sockmonkey';'''
 
==== checksetup.pl ====
 
Run '''checksetup.pl''' again. This time it will build your database tables and initialise Bugzilla.
 
C:\bugzilla&gt;perl checksetup.pl
[...]
Looks like we don't have an administrator set up yet.  Either this is your
first time using Bugzilla, or your administrator's privileges might have
accidently been deleted.
Enter the e-mail address of the administrator: '''byron@example.com'''
You entered 'byron@example.com'.  Is this correct? [Y/n] '''y'''
Enter the real name of the administrator: '''Byron Jones'''
Enter a password for the administrator account: '''beef'''
Please retype the password to verify: '''beef'''
'byron@example.com' is now set up as an administrator account.
C:\bugzilla&gt;
 
==== Parameters ====
 
You should now be able to log into to Bugzilla using the account '''checksetup.pl''' just created. Point your web browser to http://localhost/, choose '''Log in to an existing account''', and login.
 
In the page footer, choose '''Parameters'''.
 
Put in your email address as the '''maintainer'''.
 
maintainer:
'''byron@example.com'''
 
Put in the URL to Bugzilla in the '''urlbase''' field. This URL will be used in emails, so don't use localhost.
 
urlbase:
'''http://bugzilla.example.com/'''
 
Download and install WebDot from http://www.graphviz.org/Download_windows.php. Put the complete path to dot.exe in '''webdotbase'''.
 
webdotbase:
'''C:/Program Files/ATT/Graphviz/bin/dot.exe'''
 
=== Scheduled Tasks ===
 
==== collectstats.pl ====
 
Add a Scheduled Task to run '''collectstats.pl''' nightly.
 
'''Step-by-step for Windows XP:'''
 
#Control Panel --&gt; Scheduled Tasks --&gt; Add Scheduled Task
#Next
#Browse
#Find '''perl.exe''' (normally '''C:\Perl\bin\perl.exe''')
#Give it a name, such as "Bugzilla Collect Stats"
#Perfom the task daily at your desired time
#If you're running Apache as a user, not as SYSTEM, enter that user here. Otherwise you're best off creating an account that has write access to the Bugzilla directory and using that
#Tick "Open Advanced Properties.." and click Finish
#Append the script name to the end of the "Run" field. eg '''C:\Perl\bin\perl.exe C:\Bugzilla\collectstats.pl'''
#Change "start in" to the Bugzilla directory
 
==== whineatnews.pl ====
 
Add a Scheduled Task to run '''whineatnews.pl''' nightly.
 
The steps for setting up '''whineatnews.pl''' are as per '''collectstats.pl'''
 
==== Backing up Bugzilla ====
 
You may want to backup the entire Bugzilla directory. It's small and you'll get all your settings and customisations on your backup media.
 
The most important component of Bugzilla to backup is the Bugzilla Database. It contains all your Bugs, Users, Attachments, pretty well everything. Like most databases, backups with MySql are performed by generating a dump of the database and backing up the dump.
 
Schedule the '''mysqldump''' utility to create the dump, and add the resulting file to your backup media. You'll find MySql's '''mysqldump''' documentation at http://dev.mysql.com/doc/mysql/en/mysqldump.html.
 
 
==== Testing if Bugzilla works ====
 
Try to access the your BugZilla by : (for example ) http://localhost:8080
   
If it doesn't display a BugZilla page, but "It works!!!", somehow your Apache still sees somehow original version of httpd.conf. Check if Apache picks another copy of httpd.conf. If you installed Apache once and somehow uninstalled it and install it again, it can see a copied version in conf/original of Apache directory.
When you edited conf/httpd.conf, try this :
 
  1. Stop Apache service
  2. Invoke your Apache in a console : httpd.exe -f conf/httpd.conf
 
If your httpd.conf setting is all correct, it should display BugZilla page on your web browser.
 
However, if it still shows the same problem, and looks like that the Apache doesn't pick your modification in httpd.conf, you probably use Windows 7.
Windows 7 has a new feature called "VirtualStore".
To figure out about it more and how to fix it, try to read this blog article.
 
  http://blog.netscraps.com/bugs/apache-httpd-conf-changes-ignored-in-windows-7.html
 
If it still fails but display "Internal Error..." message, '''ScriptInterpreterSource Registry-Strict''' is not set.
Check again if it is set properly.
 
When everything works, stop the httpd.exe invoked from your console and start it as a service. Be sure to make it pick a right httpd.conf.
 
==== Congratulations, the Bugzilla installation process is complete! ====
 
== Installing Bugzilla on Microsoft Windows with IIS ==
 
Bugzilla works with IIS as a normal '''CGI application'''; follow the Microsoft documentation with regards to configuring IIS. On Windows 7, configuring IIS 7 is very easy, as explained in this [http://lpsolit.wordpress.com/2010/10/22/make-bugzilla-work-with-iis7-easy/ blog post].
 
=== Common Problems ===
 
==== Bugzilla runs but I can't log in ====
 
You've probably configured IIS to use ActiveState's ISAPI DLL -- in other words you're using PerlEx, or the executable IIS is configured to use is PerlS.dll or Perl30.dll.
 
Reconfigure IIS to use perl.exe
 
==== IIS returns HTTP 502 errors ====
 
You probably forgot the '''-T''' argument to perl when configuring the executable in IIS:
 
  C:\Perl\bin\perl.exe -T "%s" %s
 
==== XMLRPC interface not working with IIS ====
 
This is a known issue.  See {{bug|708252}}.

Latest revision as of 15:43, 17 February 2015

See http://bugzilla.readthedocs.org/en/latest/installing/windows.html .

Retrieved from "https://wiki.allizom.org/index.php?title=Bugzilla:Win32Install&oldid=1056473"