Confirmed users
683
edits
Jongampark (talk | contribs) |
(A lot of cleanup, including using bzr instead of cvs) |
||
Line 13: | Line 13: | ||
=== Bugzilla === | === Bugzilla === | ||
There's two main methods to getting the Bugzilla source - from | 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/ | Read the [http://www.bugzilla.org/releases/4.0/release-notes.html Release Notes] before you do anything. | ||
==== Installing Bugzilla From | ==== Installing Bugzilla From bzr ==== | ||
Download the | 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'''. | Note: this document assumes you want to install Bugzilla into '''C:\Bugzilla'''. | ||
Line 27: | Line 25: | ||
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:\'''. | 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:\>''' | C:\>'''bzr co -r tag:bugzilla-4.0.2 bzr://bzr.mozilla.org/bugzilla/4.0 Bugzilla''' | ||
C:\> | 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 ==== | ==== Installing Bugzilla From the TarBall ==== | ||
Download Bugzilla from [http://bugzilla.org/download | 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. | Bugzilla ships as a Tarball, which has the extension .tar.gz. Any decent Windows archive tool should be able to extract tarballs. | ||
Line 83: | Line 41: | ||
==== Upgrading From TarBall ==== | ==== Upgrading From TarBall ==== | ||
If you installed Bugzilla from the TarBall, the simplest way to upgrade is to follow the | If you installed Bugzilla from the TarBall, the simplest way to upgrade is to follow the instructions given above about bzr. | ||
=== MySQL === | === MySQL === | ||
Line 89: | Line 47: | ||
==== Download MySQL ==== | ==== Download MySQL ==== | ||
Download the MySQL | Download the MySQL 32-bit or 64-bit MSI installer from the [http://www.mysql.com/downloads/mysql/ MySQL website] (28 MB). | ||
==== Install ==== | ==== Install ==== | ||
Line 111: | Line 67: | ||
Enter password: '''********''' | Enter password: '''********''' | ||
Welcome to the MySQL monitor. Commands end with ; or \g. | Welcome to the MySQL monitor. Commands end with ; or \g. | ||
Your MySQL connection id is | Your MySQL connection id is 1 | ||
Server version: 5.5.15 MySQL Community Server (GPL) | |||
mysql> '''GRANT ALL PRIVILEGES ON bugs.* TO 'bugs'@'localhost' IDENTIFIED BY 'sockmonkey';''' | mysql> '''GRANT ALL PRIVILEGES ON bugs.* TO 'bugs'@'localhost' IDENTIFIED BY 'sockmonkey';''' | ||
Query OK, 0 rows affected (0.03 sec) | Query OK, 0 rows affected (0.03 sec) | ||
mysql> '''quit''' | mysql> '''quit''' | ||
Line 145: | Line 81: | ||
=== ActiveState Perl === | === ActiveState Perl === | ||
==== Download ActiveState Perl | ==== Download ActiveState Perl ==== | ||
Download the ActiveState Perl 5. | Download the ActiveState Perl 5.12.4 or higher MSI installer from the [http://www.activestate.com/activeperl/downloads ActiveState website]. | ||
Note that Bugzilla requires | 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 ==== | ==== Install ==== | ||
Line 165: | Line 99: | ||
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. | 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 ==== | ==== 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> '''http://theoryx5.uwinnipeg.ca/ppms/'''<br>Perl 5.10.x:<br> '''http://cpan.uwinnipeg.ca/PPMPackages/10xx/''' and<br> '''http://trouchelle.com/ppm10/'''<br> | 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> '''http://theoryx5.uwinnipeg.ca/ppms/'''<br>Perl 5.10.x:<br> '''http://cpan.uwinnipeg.ca/PPMPackages/10xx/''' and<br> '''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]. | 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 | 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 | 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:\>ppm version | C:\>ppm version | ||
Line 325: | Line 251: | ||
=== Apache === | === 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/ | 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 Apache 2.x ==== | ||
Download the Apache HTTP Server version 2.x or | Download the Apache HTTP Server version 2.2.x or higher from: http://httpd.apache.org/download.cgi | ||
==== Install ==== | ==== Install ==== | ||
Line 507: | Line 433: | ||
C:\> | C:\> | ||
=== Configure Bugzilla === | === Configure Bugzilla === | ||
Line 525: | Line 444: | ||
C:\bugzilla>'''perl checksetup.pl''' | C:\bugzilla>'''perl checksetup.pl''' | ||
Checking perl modules ... | Set up gcc environment - 4.4.3 | ||
Checking for | * This is Bugzilla 4.1.3 on perl 5.14.1 | ||
Checking for | * Running on Win7 Build 7601 (Service Pack 1) | ||
Checking for | |||
Checking for | Checking perl modules... | ||
Checking for | Checking for CGI.pm (v3.51) ok: found v3.55 | ||
Checking for | Checking for Digest-SHA (any) ok: found v5.62 | ||
Checking for | Checking for TimeDate (v2.21) ok: found v2.24 | ||
Checking for | Checking for DateTime (v0.28) ok: found v0.70 | ||
Checking for | Checking for DateTime-TimeZone (v0.79) ok: found v1.35 | ||
Checking for | Checking for DBI (v1.614) ok: found v1.616 | ||
Checking for | 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: | The following Perl modules are optional: | ||
Checking for | Checking for GD (v1.20) ok: found v2.45 | ||
Checking for | Checking for Chart (v2.1) ok: found v2.4.2 | ||
Checking for Template-GD (any) ok: found v1.56 | |||
Checking for | Checking for GDTextUtil (any) ok: found v0.86 | ||
Checking for | [...] | ||
This version of Bugzilla contains some variables that you may want | This version of Bugzilla contains some variables that you may want | ||
Line 592: | Line 516: | ||
C:\bugzilla>perl checksetup.pl | C:\bugzilla>perl checksetup.pl | ||
[...] | |||
Looks like we don't have an administrator set up yet. Either this is your | 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 | first time using Bugzilla, or your administrator's privileges might have | ||
Line 695: | Line 534: | ||
==== Parameters ==== | ==== Parameters ==== | ||
You should now be able to log into to Bugzilla using the account '''checksetup.pl''' just created. Point your web browser to | 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'''. | In the page footer, choose '''Parameters'''. | ||
Line 775: | Line 614: | ||
== Installing Bugzilla on Microsoft Windows with IIS == | == 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. | 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 === | === Common Problems === |