From 393f13a4022de3eb44228bc75391733abec49054 Mon Sep 17 00:00:00 2001 From: "jake%bugzilla.org" <> Date: Sat, 1 Feb 2003 12:56:16 +0000 Subject: Recompiling the docs because of the large change to the installation section just checked in. --- docs/html/win32.html | 1683 -------------------------------------------------- 1 file changed, 1683 deletions(-) delete mode 100644 docs/html/win32.html (limited to 'docs/html/win32.html') diff --git a/docs/html/win32.html b/docs/html/win32.html deleted file mode 100644 index c7e1eb88a..000000000 --- a/docs/html/win32.html +++ /dev/null @@ -1,1683 +0,0 @@ -
This section covers installation on Microsoft Windows. - Bugzilla has been made to work on Win32 platforms, but the Bugzilla team - wish to emphasise that The easiest way to install Bugzilla on - Intel-archiecture machines - is to install some variant of GNU/Linux, then follow the UNIX - installation instructions in this Guide. If you have any influence in the - platform choice for running this system, please choose GNU/Linux instead - of Microsoft Windows.
After that warning, here's the situation for 2.16 - and Windows. It doesn't work at all out of the box. - You are almost certainly better off getting - the 2.17 version from CVS (after consultation with the Bugzilla Team to - make sure you are pulling on a stable day) because we'll be doing a load - of work to make the Win32 experience more pleasant than it is now. - |
If you still want to try this, to have any hope of getting it to work, - you'll need to apply the - mail patch from - bug 124174. - After that, you'll need to read the (outdated) installation - instructions below, some (probably a lot better) more - recent ones kindly provided by Toms Baugis and Jean-Sebastien - Guay, and also check the - Bugzilla 2.16 Win32 update page - . If we get time, - we'll write some better installation instructions for 2.16 and put - them up there. But no promises. -
You should be familiar with, and cross-reference, the rest of - the - Bugzilla Installation - - section while performing your Win32 installation. Making Bugzilla work on Microsoft Windows is no picnic. Support - for Win32 has improved dramatically in the last few releases, but, if - you choose to proceed, you should be a - very - - skilled Windows Systems Administrator with strong troubleshooting - abilities, a high tolerance for pain, and moderate perl skills. - Bugzilla on NT requires hacking source code and implementing some - advanced utilities. What follows is the recommended installation - procedure for Win32; additional suggestions are provided in - Appendix A - - . |
Install - Apache Web Server - - for Windows, and copy the Bugzilla files somewhere Apache can serve - them. Please follow all the instructions referenced in - Bugzilla Installation - - regarding your Apache configuration, particularly instructions - regarding the - "AddHandler" - - parameter and - "ExecCGI" - - .
You may also use Internet Information Server or Personal - Web Server for this purpose. However, setup is quite different. - If ActivePerl doesn't seem to handle your file associations - correctly (for .cgi and .pl files), please consult - Appendix A - - . If you are going to use IIS, if on Windows NT you must be - updated to at least Service Pack 4. Windows 2000 ships with a - sufficient version of IIS. |
Install - ActivePerl - - for Windows. Check - http://aspn.activestate.com/ASPN/Downloads/ActivePerl - - for a current compiled binary.
Please also check the following links to fully understand the - status of ActivePerl on Win32: - Perl Porting - - , and - Perl on Win32 FAQ -
Use ppm from your perl\bin directory to install the following - packs: DBI, DBD-Mysql, TimeDate, Chart, Date-Calc, Date-Manip, GD, - AppConfig, and Template. You may need to extract them from .zip - format using Winzip or other unzip program first. Most of these - additional ppm modules can be downloaded from ActiveState, but - AppConfig and Template should be obtained from OpenInteract using - the - instructions on the Template Toolkit web site - - .
You can find a list of modules at - http://www.activestate.com/PPMPackages/zips/5xx-builds-only/ - - or - http://www.activestate.com/PPMPackages/5.6plus - |
The syntax for ppm is: - C:> - - ppm <modulename> - -
Example 4-1. Installing ActivePerl ppd Modules on Microsoft - Windows
C:> - - ppm - DBD-Mysql - -
Watch your capitalization!
ActiveState's 5.6Plus directory also contains an AppConfig - ppm, so you might see the following error when trying to install - the version at OpenInteract:
Error installing package 'AppConfig': Read a PPD - for 'AppConfig', but it is not intended for this build of Perl - (MSWin32-x86-multi-thread) -
If so, download both - the tarball - - and - the ppd - - directly from OpenInteract, then run ppm from within the same - directory to which you downloaded those files and install the - package by referencing the ppd file explicitly via in the install - command, f.e.: -
-Install MySQL for NT. -
You can download MySQL for Windows NT from - MySQL.com - - . Some find it helpful to use the WinMySqlAdmin utility, included - with the download, to set up the database. |
Setup MySQL
C:> - - C:\mysql\bin\mysql -u root mysql - -
mysql> - - DELETE FROM user WHERE Host='localhost' AND - User=''; - -
mysql> - - UPDATE user SET Password=PASSWORD ('new_password') - WHERE user='root'; - -
"new_password" - - , above, indicates whatever password you wish to use for your - "root" - - user.
mysql> - - GRANT SELECT, INSERT, UPDATE, DELETE, INDEX, - ALTER, CREATE, DROP, REFERENCES ON bugs.* to bugs@localhost - IDENTIFIED BY 'bugs_password'; - -
"bugs_password" - - , above, indicates whatever password you wish to use for your - "bugs" - - user.
mysql> - - FLUSH PRIVILEGES; - -
mysql> - - create database bugs; - -
mysql> - - exit; - -
C:> - - C:\mysql\bin\mysqladmin -u root -p - reload - -
Edit - checksetup.pl - - in your Bugzilla directory. Change this line:
my $webservergid = - getgrnam($my_webservergroup); |
to
my $webservergid = - $my_webservergroup; |
my $webservergid = - 'Administrators' |
Run - checksetup.pl - - from the Bugzilla directory.
Edit - localconfig - - to suit your requirements. Set - $db_pass - - to your - "bugs_password" - - from - step 5.d - - , and - $webservergroup - - to - "8" - - .
Not sure on the - "8" - - for - $webservergroup - - above. If it's wrong, please send corrections. |
Edit - defparams.pl - - to suit your requirements. Particularly, set - DefParam("maintainer") - - and - DefParam("urlbase") to match your install. -
This is yet another step I'm not sure of, since the - maintainer of this documentation does not maintain Bugzilla on - NT. If you can confirm or deny that this step is required, please - let me know. |
There are several alternatives to Sendmail that will work - on Win32. The one mentioned here is a - suggestion - - , not a requirement. Some other mail packages that can work - include - BLAT - - , - Windmail - - , - Mercury - Sendmail - - , and the CPAN Net::SMTP Perl module (available in .ppm). Every - option requires some hacking of the Perl scripts for Bugzilla to - make it work. The option here simply requires the least. |
Download NTsendmail, available from - www.ntsendmail.com - - . You must have a "real" mail server which allows you to relay - off it in your $ENV{"NTsendmail"} (which you should probably - place in globals.pl)
Put ntsendmail.pm into your .\perl\lib directory.
Add to globals.pl:
# these settings configure the NTsendmail - process use NTsendmail; - $ENV{"NTsendmail"}="your.smtpserver.box"; - $ENV{"NTsendmail_debug"}=1; - $ENV{"NTsendmail_max_tries"}=5; |
Some mention to also edit - $db_pass - - in - globals.pl - - to be your - "bugs_password" - - . Although this may get you around some problem - authenticating to your database, since globals.pl is not - normally restricted by - .htaccess - - , your database password is exposed to whoever uses your web - server. |
Find and comment out all occurences of - " - open(SENDMAIL - " - - in your Bugzilla directory. Then replace them with: -
# new sendmail functionality my $mail=new - NTsendmail; my $from="bugzilla\@your.machine.name.tld"; my - $to=$login; my $subject=$urlbase; - $mail->send($from,$to,$subject,$msg); |
Some have found success using the commercial product, - Windmail - - . You could try replacing your sendmail calls with: -
|
Change all references in all files from - processmail - - to - processmail.pl - - , and rename - processmail - - to - processmail.pl - - .
Many think this may be a change we want to make for - main-tree Bugzilla. It's painless for the UNIX folks, and will - make the Win32 people happier. |
Some people have suggested using the Net::SMTP Perl module - instead of NTsendmail or the other options listed here. You can - change processmail.pl to make this work. -
|
This step is optional if you are using IIS or another web - server which only decides on an interpreter based upon the file - extension (.pl), rather than the - "shebang" - - line (#/usr/bonsaitools/bin/perl) |
Modify the path to perl on the first line (#!) of all files - to point to your Perl installation, and add - "perl" - - to the beginning of all Perl system calls that use a perl script as - an argument. This may take you a while. There is a - "setperl.csh" - - utility to speed part of this procedure, available in the - Useful Patches and Utilities for Bugzilla - - section of The Bugzilla Guide. However, it requires the Cygwin - GNU-compatible environment for Win32 be set up in order to work. - See - http://www.cygwin.com/ - - for details on obtaining Cygwin.
Modify the invocation of all system() calls in all perl - scripts in your Bugzilla directory. You should specify the full - path to perl for each system() call. For instance, change this line - in processmail: -
-system ("./processmail",@ARGLIST); - </programlisting> to - <programlisting> -system ("C:\\perl\\bin\\perl", "processmail", @ARGLIST); - - |
If you are using IIS or Personal Web Server, you must add cgi - relationships to Properties -> Home directory (tab) -> - Application Settings (section) -> Configuration (button), such - as:
|
- |