Zope Post-Installation Notes:                        12-Mar-00

Besides installing the core package(s) of Zope, you also need to
choose your web server and an empty Zope database.  You do this
by installing either of the Zope-zserver or Zope-pcgi RPMs.

The difference is that ZServer is a standalone web server designed
specifically for Zope and hence is very fast and efficient.  The
drawback is that ZServer does not allow you to also serve isolated
text files such as any existing .html files you have around nor
does it allow the use of the Secure Socket Layer (SSL) protocol.

With PCGI, you must be running the Apache web server.  Special
Apache configuration directives are then used to pass the web
requests for a -portion- of the web tree to a persistent Zope
server process, and the -rest- of the web tree to be handled
by Apache as usual.

At this point you should perform any other steps your web server
requires to install and configure a cgi script.  For some ideas,
check out http://starship.python.net/crew/jrush/Zope/Zope2.html.


Initial Administrator Username and Password:
-------------------------------------------

These items are stored in the text file /var/zope/access.  The
default administrator username is 'superuser' and password of '123'.
The format of this information in /var/zope/access is:

    <adminusername>:<adminpassword>:[<domain restriction>]

As a default of this RPM package, the domain is set to 'localhost',
to protect you against outside access during your learning period.
Remove or revise the domain as your security policy dictates.  For
example, to restrict adminstrator access to just the digicool domain:

    spam:eggs:*.digicool.com

Note that the 2.0.x release of Zope now supports the optional use of
encrypted passwords.  You create them by running the /usr/bin/zpasswd
utility and answering the prompts.  Once you have Zope installed
and have exercised it a bit so that you have confidence that it is
working, it is recommended that you switch to encrypted passwords.

Make these changes using the command

    zpasswd /var/zope/access


Zope-pcgi configuration with Apache:
-----------------------------------

PCGI mediates between your existing web server and Zope.  To use
PCGI, perform the following steps.

1. Confirm /var/zope/* and /var/zope/var/*  are writable by the
   user running zope, usually user zope.  If you are using RPMs
   thruout, you should be fine.

2. Using your favorite editor edit /etc/httpd/conf/httpd.conf and
   add this:

    RewriteEngine on
    RewriteRule ^/static/(.*)  /home/httpd/html/$1 [l]
    RewriteRule ^/cgi-bin/(.*) /home/httpd/cgi-bin/$1 [e=HTTP_CGI_AUTHORIZATION:%1,t=application/x-httpd-cgi,l]
    RewriteCond %{HTTP:Authorization}  ^(.*)
    RewriteRule ^(.*) /home/httpd/cgi-bin/Zope$1 [e=HTTP_CGI_AUTHORIZATION:%1,t=application/x-httpd-cgi,l]

   Note that Apache processes these rules __in order_ of their appearance.
   This means if you place the more general last one before the /static/
   one, say, that last one will match and the /static/ will __not__ be
   acted upon.

   Also note that if the last one contains trailing slashes, like the
   following, Zope will __appear__ to work, but you will have trouble
   deleting objects in the root folder.

    RewriteRule ^/(.*) /home/httpd/cgi-bin/Zope/$1 [e=HTTP_CGI_AUTHORIZATION:%1,t=application/x-httpd-cgi,l]


3. Edit /etc/httpd/conf/access.conf where you should see:

    <Directory /home/httpd/cgi-bin>
    AllowOverride None
    Options ExecCGI
    </Directory>

   Change the above to this:

    <Directory /home/httpd/cgi-bin>
    AllowOverride None
    Options ExecCGI FollowSymLinks
    </Directory>

4. Now do this:

    cd /home/httpd/cgi-bin
    ln -s /var/zope/Zope.cgi Zope

That's it, now you are ready to start Zope up.


Starting and Stopping Zope:
--------------------------

Upon installing the Zope RPMs, your system is configured to start
Zope web service automatically upon system bootup.  If you wish to
start manually, enter the command:

    /etc/rc.d/init.d/zope start

To stop web service, enter the command:

    /etc/rc.d/init.d/zope stop


Log Files:
----------

The pcgi-wrapper CGI program invoked by Apache, by default, logs
unusual conditions via syslog (facility defaults to LOCAL0, specified
in /var/zope/Zope.cgi, priority either WARNING or ERR).  The
ZServer background process logs errors and web hits via syslog
as well, using facility USER, priority INFO.


Accessing Zope from your Browser:
--------------------------------

The default setting of the Zope-zserver RPM is to begin listening
for HTTP requests on port 8080, and FTP requests on port 8021.
The monitor service is initially disabled, for security reasons.
To alter these port assignments or enable the monitor service,
edit the Zope startup script /var/zope/zserver.sh, changing the
arguments passed to the z2.py python program.  For the specific
arguments to change, see the source for /var/zope/z2.py.

To begin using Zope with the default settings for ZServer, point
your browser to:

    http://localhost:8080/

Or if you're using Zope-pcgi instead, point your browser to:

    http://localhost/Zope


Local Sources of Documentation
------------------------------

As of RPM version 2.1.1 some of the Zope manuals are placed under
the Apache HTML directory tree in /home/httpd/html/zopedocs/.
Assuming you don't have exotic URL rewrite rules defined in your
Apache configuration file, you can find the documents at the URL:

    http://localhost/zopedocs/

Other odd bits of documentation can be found under the usual
Read Hat documentation tree, under /usr/doc/<rpmname>/.

RPM-Packaged by Jeff Rush <jrush@taupro.com>
With minor modifications by Jonathan Marsden <jonathan@xc.org>