[ZDP] Win32Installation - Draft 1

Thu, 7 Oct 1999 15:42:46 +0200

Brian, this is my first draft installation topic document.
Thanks for your reading and comments from all.

Regards,
Kamon
_______________________________________________________
ZOPE INSTALLATION ON WINDOWS

System requirements

Pentium PC
Windows 95/NT
RAM 128 Mb minimum recommended for a production server

Installing Zope

What you need

You need to get the latest stable precompiled version of Zope for Windows
on the Zope.org site.

Installation steps

1. Launch the self-extracting installation file using Windows Explorer or
from a DOS window.
2. The Zope installation welcome window appears. Click next to go to the
Zope Public License terms and conditions page. Click Accept if you
understand them and agree.
3. You will be prompted for a name for the site. This name will be used, by
 default, as the name for the Zope installation top level directory. So we
suggest you choose ?Zope?. Click Next to continue.
4. You will be asked to choose a location to install Zope. Change the
default location path to X:\WebSite, X: being the local drive reserved for
Zope. Click Next to continue.
5. Finally, you will be prompted for a username and password to be used for
 the super manager account. This is the account that will give you complete
 access to the entire site. Pick a username and password, and click Next.
The installation program will begin copying files.
6. If you are installing Zope on Windows NT, the installation program will
prompt you at this point whether you would like to have Zope started
automatically as an NT service or you would like to start Zope manually.
7. When the installation is completed, click Finish to exit the installer.

Starting Zope for the first time

- Using Windows Explorer or from a DOS window, run the file start.bat in
X:\WebSite, to start Zope.
- Start a browser installed on the same machine, and point it the address :
 ?http://localhost:8080/manage'*
- You will be prompted for the user name and password you provided during
the installation.
- Enter this name and password and click OK. You will reach the Zope
Management interface which allows you to build and manage all the Zope site
 objects.

Running Zserver

Zserver is the integration of Zope with the high-performance, multiprotocol
 Medusa server toolkit.
It allows you to access the Zope application server through the main Web
protocols : HTTP, FTP, WebDAV, and LDAP. One other advantage of Zserver
over traditionnal web servers is that it is multi-threaded ? it can handle
multiple web requests at the same time.

Generally, when you start Zope/ZServer, you actually get three processes
started :
The HTTP server process
The FTP server process
The Monitor server process

There are a number of options available when starting Zserver for the first
 time, with a command of the type
C:\WebSite\bin\python.exe c:\WebSite\z2.py -D

You can edit the start.bat file provided for manually starting Zope and
place additional command line switches after the Ť -D ť :
C:\WebSite\bin\python.exe c:\WebSite\z2.py -D %1 %2 %3 %4 %5 %6 %7 %8 %9

Setting up Zope with IIS 4.0

You may be obliged to run Zope with IIS Web server in one of the following
cases :
You already have an IIS server running that you cannot take down and you
cannot run Zserver on a different port.
You would like to protect all your Zope content with SSL.
You would like to use your existing IIS server to do such things as
advanced load balancing or map virtual hosts to different folders in the
Zope hierarchy.
You would like to run Zope on your ISP?s machine.
You are an ISP who would like to run an instance of Zope for each of your
customers.

What you need

You need to get the latest stable precompiled version of Zope for Windows
on the Zope.org site.
IIS is only available with Windows NT 4. Windows NT Server includes a free
copy of Internet Information Server 2.0. You need to download
(http://www.microsoft.com) and install the Microsoft Options Pack to
upgrade your IIS to version 4.0.

Installation steps

1. Install Zope the normal way.
2. Copy over the Zope.cgi file from a non-Windows Zope distribution. Put it
 in your Zope root directory (WebSite), and rename it zope.pcgi.
3. Edit zope.pcgi, and change it to the following : [FILL IN TEXT]
4. Copy zope.pcgi and pcgi\bin\pcgi-wrapper.exe into IIS's CGI scripts
directory (\cgi-bin).
5. Add a new extension mapping to IIS for PCGI. In the Microsoft Management
 Console, select your site's Properties, and then under the 'Home
Directory' tab click on 'Configuration'. Here you should be able to add a
new extension linking .pcgi to 'pcgi-wrapper %s'.

Starting Zope for the first time

- Modify the Zope startup script by adding the option '-p zope.pcgi'.
- If you installed Zope as a Windows NT Service, you will have to edit the
registry key:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\
                     <Service Name>\Parameters\start

Add '-p zope.pcgi' after ?start?.

- Make sure that IIS and Zope are both started up, and try accessing your
server via 'http://localhost/cgi-bin/zope.pcgi/'
This should give you the same thing as ?http://localhost:8080/?.

END FOR NOW