[Zope-Checkins] CVS: Zope/doc - INSTALL.txt:1.35.22.2

Fred L. Drake, Jr. fred@zope.com
Wed, 5 Mar 2003 13:12:01 -0500


Update of /cvs-repository/Zope/doc
In directory cvs.zope.org:/tmp/cvs-serv15284

Modified Files:
      Tag: new-install-branch
	INSTALL.txt 
Log Message:
Update the "Quick Start" portion of this document.


=== Zope/doc/INSTALL.txt 1.35.22.1 => 1.35.22.2 ===
--- Zope/doc/INSTALL.txt:1.35.22.1	Thu Feb 20 16:40:11 2003
+++ Zope/doc/INSTALL.txt	Wed Mar  5 13:11:55 2003
@@ -19,50 +19,53 @@
 
 Quick Start
 
-  XXX  This section is not up to date.
-
   If you are impatient, the following commands should get you up and
   running with Zope 2 using ZServer and ZODB 3 on Unix::
 
     ./configure --prefix=/where/to/install/zope
     make
-    make install
-    /where/to/install/zope/bin/runzope
+    make instance
+
+  The last of these commands will prompt you to provide a user name
+  and password for an administrator's account.
 
-  These commands locate an appropriate version of Python and build
-  Zope.
+  These commands locate an appropriate version of Python, build Zope,
+  and create a usable Zope "instance" in the current directory.
 
-  Take note of the user name and password output at the end of
-  this command.  You will need these to manage Zope.
+  You can now start Zope by running::
+
+    ./bin/runzope
 
   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
+  will have to supply arguments to runzope 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)
+  and 8021 respectively. You can change the ports used by specifying
+  the "port-base" parameter to runzope:
+
+    ./bin/runzope -X port-base=1000
 
   You can then connect to Zope 2 by directing your browser to::
 
      http://yourhost:8080/manage
 
   where yourhost is the name or address of the machine running Zope 2.
-  If you changed the HTTP port with the -w option to z2.py, then use
-  it rather than 8080.
+  If you changed the HTTP port as described, use a port number of 8080
+  + the port-base value.
 
   You will be prompted for a user name and password. Use the user name
-  and password output above.
+  and password you provided in response to the prompts issued during
+  the "make instance" process.
 
   Now you're off and running! You should be looking at the Zope management
   screen which is divided into two frames. On the left you can navigate
-  between Zope object and on the right you can edit them by selecting
+  between Zope objects 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:
 
-    'http://www.zope.org/'
+    http://www.zope.org/
 
   Have fun!