Zope files and directories

Directories

Some important directories you'll see people talking about:

• SOFTWARE_HOME - the root of your zope software installation.
• INSTANCE_HOME - this may be the same as SOFTWARE_HOME, but often a separate directory where you can keep data and products independent of zope software upgrades (recommended). If you use ZEO (Zope Enterprise Objects) you might have several of these.
• STORAGE_HOME - if you use ZEO (Zope Enterprise Objects): home of the ZEO (Zope Enterprise Objects) storage server's ZODB (Zope Object Database), log and configuration files.
• Products directory - the directory where add-on products are installed. There may be two - one under SOFTWARE_HOME, one under INSTANCE_HOME (use this one).

Config files

• zope.conf in INSTANCE_HOME/etc/ is the main configuration file for a Zope instance
• [zeo.conf]? in STORAGE_HOME/etc/ is the configuration file for a ZEO (Zope Enterprise Objects) storage server
• [inituser]? in INSTANCE_HOME is used to initialise your fresh [acl_users]? in ZODB (Zope Object Database) - it contains initial username and password; be careful though - if Zope doesn't have write permission to it's INSTANCE_HOME (which is a very good idea, btw), your ZODB (Zope Object Database) will lose your users and get reinitialised each time you restart Zope

Logs

You can find useful information about a Zope server in a number of places:

In the ZMI (Zope Management Interface):

• /error_log
• /[Control_Panel]?

On the filesystem

• apache's access.log, if you are using Zope and Apache. On debian this is in /var/log/apache/.
• Z2.log in INSTANCE_HOME/log/
• event.log in INSTANCE_HOME/log/
• trace.log in INSTANCE_HOME/log/, if enabled. See also ForensicLogger.
• zeo.log in STORAGE_HOME/log/, if you are running ZEO (Zope Enterprise Objects)
• you can get a log of memory usage if you run the checkzopemem script
• you can see your zope processes by running pstree -ap |grep python |grep -v grep (unix)
• you can check your zope processes' size by running 'top" and pressing M (sort by memory usage). Often zope processes will be near the top.
• you can check if your zope processes are busy doing something by running top and checking the cpu usage.

Some examples can be seen here