[Repoze-checkins] r816 - buildouts/repoze.plone/trunk

[Chris McDonough]

Author: Chris McDonough <chrism at agendaless.com>
Date: Wed Mar 12 00:07:34 2008
New Revision: 816

Log:
Collected wisdom.


Added:
   buildouts/repoze.plone/trunk/README.txt

Added: buildouts/repoze.plone/trunk/README.txt
==============================================================================
--- (empty file)
+++ buildouts/repoze.plone/trunk/README.txt	Wed Mar 12 00:07:34 2008
@@ -0,0 +1,67 @@
+Buildout for repoze.plone
+
+Overview
+
+  This buildout will install the repoze.plone package.  This implies
+  (as of this writing) Zope 2.10.5, Plone 3.0.6, and glue that makes
+  Zope run under a WSGI pipeline using Paste (http://pythonpaste.org).
+  For more details about repoze.plone, see the documentation for that
+  package at http://svn.repoze.org/repoze.plone/trunk/README.txt.
+
+Running the Buildout
+
+  Run 'python2.4 bootstrap.py'
+
+  Run 'bin/buildout'
+
+  Some syntax errors will be printed to the console during the
+  buildout run.  These can safely be ignored.
+
+Post-Buildout Tasks
+
+  Run 'bin/supervisord'.  This starts both Zope and ZEO.
+
+  Run 'bin/addzope2user <username> <passwd>' to add an admin user
+
+Viewing the Result
+
+  Visit Zope's ZMI at http://localhost/8080/manage and log in as the
+  admin user you created in the "addzope2user" step.
+
+Starting and Stopping Zope and ZEO
+
+  Control Zope and ZEO via 'bin/supervisorctl'.  This is an
+  interactive shell.  To stop Zope, type "stop zope".  To stop ZEO,
+  type "stop zeo".  To restart Zope, type "restart zope", to start it,
+  type "start zope".  and so on.  You may also issue the command
+  'bin/supervisorctl {start|stop|restart} {zope|zeo|}' from the command
+  line without entering interactive shell mode.
+
+Running Zope in the Foreground
+
+  First, stop the Zope instance running under supervisord.  Then
+  invoke 'bin/paster serve etc/zope2.ini'.  This is functionally
+  equivalent to a stock Zope2's "runzope" command.
+
+FAQ:
+
+  - My buildout loops while attempting to install setuptools!
+
+    Run "easy_install -U setuptools" using the Python installation
+    that you're invoking the buildout command with.
+
+  - I get a version conflict error!
+
+    If you get a version conflict on elementtree (or anything else for
+    that matter), disable your buildout global "download cache".
+
+  - I'm on MacOS X and my system can't build PIL!
+
+    You get an error like so:
+
+    ld: in /sw/lib/libxml2.2.dylib, file is not of required \
+      architecture for architecture ppc collect2: ld returned 1 exit
+      status
+
+    See http://mail.python.org/pipermail/pythonmac-sig/2006-October/018339.html
+    for a possible solution.