[Zope3-checkins] SVN: Zope3/trunk/releases/ZopeX3/README.txt add instrctions for creating an instance home

[Fred L. Drake, Jr.]

Log message for revision 25069:
add instrctions for creating an instance home

more is needed about what is interesting in the configuration; what should
be checked for each new instance, how can components be enabled or disabled
via the etc/package-includes/ directory, etc.



-=-
Modified: Zope3/trunk/releases/ZopeX3/README.txt
===================================================================
--- Zope3/trunk/releases/ZopeX3/README.txt	2004-05-27 20:26:45 UTC (rev 25068)
+++ Zope3/trunk/releases/ZopeX3/README.txt	2004-05-27 20:48:53 UTC (rev 25069)
@@ -162,9 +162,26 @@
 Creating a Zope instance home
 -----------------------------
 
-XXX to be written
+The Zope installation includes a script called "mkzopeinstance"; this
+is used to create a new "instance home."  On Unix, this will be in
+$prefix/bin/, and on Windows this will be in Scripts\ in the Python
+installation.
 
+Run this script to create the instance home:
 
+  $ .../bin/mkzopeinstance -u username:password -d directory
+
+or
+  C:\Python23\Scripts> ..\python mkzopeinstance -u username:password -d directory
+
+This will create the directory named on the command line and provide a
+default configuration.  The configuration files for the Zope
+application server are in the etc/ sub-directory in the instance home.
+You should review those files to make sure they meet your needs before
+starting the application server for the first time.  Of particular
+interest are the files zope.conf and principals.zcml.
+
+
 Starting Zope
 -------------