[Zope-Checkins] CVS: Zope/doc - INSTALL.txt:1.32.10.1
Chris McDonough
chrism@zope.com
Mon, 16 Sep 2002 02:09:07 -0400
Update of /cvs-repository/Zope/doc
In directory cvs.zope.org:/tmp/cvs-serv10446
Modified Files:
Tag: chrism-install-branch
INSTALL.txt
Log Message:
Modify INSTALL.txt to reflect chrism-install-branch.
=== Zope/doc/INSTALL.txt 1.32 => 1.32.10.1 ===
--- Zope/doc/INSTALL.txt:1.32 Wed May 29 15:58:57 2002
+++ Zope/doc/INSTALL.txt Mon Sep 16 02:09:06 2002
@@ -2,8 +2,9 @@
----------------------------------------
This document describes building and installing Zope on Unix.
- We will provide Windows instructions in later releases. We
- will also provide binary releases for some platforms.
+ We also provide binary releases for some platforms. See
+ "Zope.org's download section":http://www.zope.org/Downloads
+ for more information.
Important notes
@@ -13,25 +14,17 @@
See CHANGES.txt for important notes on Zope 2.5.
-
Quick Start
If you are impatient, the following commands should get you up and
- running with Zope 2 using ZServer and ZODB 3 on Unix::
-
- python w_pcgi.py # Note, this must be Python 2.1
- ./start
+ running with Zope 2 on Unix::
- The first command builds and adjusts Zope. Take note of the user
- name and password output at the end of this command. You will need
- these to manage Zope.
-
- If you get errors indicating that addresses are in use, then you
- will have to supply arguments to z2.py to change the ports used for
- HTTP or FTP. The default HTTP and FTP ports used by ZServer are 8080
- and 8021 respectively. (See the help for the z2.py script by running
- z2.py with the -h option for more information on how to specify
- different ports)
+ ./configure; make; make install
+ [cd to install directory]
+ ./makeinstance
+ [follow prompts]
+ [cd to instance directory]
+ ./zctl start
You can then connect to Zope 2 by directing your browser to::
@@ -49,30 +42,14 @@
between Zope object and on the right you can edit them by selecting
different management functions with the tabs at the top of the frame.
- If you haven't used Zope before, you should head to the Zope web site
- and read some documentation. The Zope Manager's Guide is a good place
- to start. You can access the Zope site at:
+ If you haven't used Zope before, you should head to the Zope web
+ site and read some documentation. The Zope Book is a good place to
+ start. It also contains more information on how to install Zope.
+ You can access the Zope site at:
'http://www.zope.org/'
- Have fun!
-
-Building Zope
-
- There are some python scripts in the top-level directory that should
- help you get started. You must run these scripts from the top-level
- directory.
-
- If you want to try out Zope in the simplest fashion using ZServer,
- then run the script wo_pcgi::
-
- python wo_pcgi.py
-
- If you want to use PCGI and an existing web server run w_pcgi::
-
- python w_pcgi.py
-
- Notes
+Notes
* You should be using Python 2.1 to run the build scripts.
@@ -90,49 +67,12 @@
* If you just want to use Zope components it's not necessary to build Zope
but it's a good idea since it will compile Python C extensions for you.
- * You can use PCGI and an existing web server if you use ZServer.
-
-Starting Zope with an existing web server
-
- See the WEBSERVERS.txt file for more information about configuring Zope
- with an existing web server. See also the pcgi/README file for further
- informations on the installation of PCGI.
-
-Running Zope
-
- There are two ways to run Zope:
-
- - You can use ZServer, the integration of Zope and Medusa. You must
- use ZServer if you want to use multiple concurrent threads.
- ZServer is a server application that supports multiple protocols:
-
- o HTTP -- ZServer is a Web server
-
- o FTP -- ZServer is a file-transfer protocol server. This
- allows you to use FTP-enabled publishing systems with Zope.
-
- o PCGI -- PCGI is a lightweight protocol for forwarding
- requests from other web servers, like Apache or Netscape, to
- Zope. This makes it possible to use web server features like
- connection encryption or logging with Zope.
-
- o monitor -- ZServer has the capability to allow you to access
- the Python interpreter directly over a network channel. If
- you intend to use this, please read the 'DEBUGGING.txt'
- document for more information.
-
- With ZServer, you must start Zope manually using the z2.py script.
- Typically, the command used to run the z2.py script will be put in
- system startup scripts.
-
- ZServer is the prefered way to run Zope.
+ * See the WEBSERVERS.txt file for more information about
+ configuring Zope with an existing web server. See also the
+ pcgi/README file for further informations on the installation of
+ "PCGI" or "persistent CGI", a way to interface Zope with webservers
+ which do not support "proxy passthrough".
- - If you *only* want to use PCGI and you don't need multi-threaded
- operation, you can have a special program, the pcgi_publisger,
- start Zope for you. See the WEBSERVER.txt file for details on
- using Zope with an existing webserver.
- If you wish to enable Zope logging you must specify options on the
- command line. See LOGGING.txt in the doc directory.