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.1, 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 to avoid entering supervisorctl's interactive shell mode.

  To shut down supervisor (and all processes it runs, including Zope
  and ZEO in this case), use "supervisorctl shutdown".

  See http://supervisord.org for more information about supervisor.

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.

Notable Configuration Files

    etc/zope2.ini -- the "PasteDeploy" configuration file that
    configures a WSGI pipeline that Zope runs under.

    etc/supervisord.conf -- the configuration file that tells
    supervisor which programs to start when you invoke
    "bin/supervisord".

    etc/zope.conf -- the Zope 2 configuration file.

Notable Executable Files

    bin/addzope2user -- add an administrative user to the Zope root
    user folder.

    bin/debugzope2 -- start up an interactive Python shell with Zope's
    libraries preloaded and its database configured (equivalent to
    stock Zope's "zopectl debug").

    bin/paster -- the program which controls the "Paste" server that
    Zope runs under.

    bin/runzeo -- the program which runs a ZEO server.

    bin/runzope2script -- run a script in a Zope environment
    (equivalent to stock Zope's "zopectl run").

    bin/zope2testrunner -- find and run unit tests in a Zope 2
    environment (equivalent to stock Zope's "zopectl test").

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.