dzhandle Debian/Ubuntu Zope packages handling command line utility
dzhandle [options] action [action options]
dzhandle is the command-line utility for handling
Zope servers, instances and products. It is a system administration tool and a
Debian/Ubuntu maintainer's helper script at the same time: using dzhandle
you can manage your Zope installations, create instances, add Zope products to
them, start and stop them, but it is also used by the Debian/Ubuntu Zope
packages for their installation and removal.
Print usage information and exit
Force things, for example file overwriting or removing
limit actions to a comma separated list of zope versions; default behaviour is to act on all zope versions available
User/Group ownership for new and copied files
Configuration file; default is /etc/dzhandle.conf
Enable verbose mode (not yet implemented)
Do not execute commands, print only them (not yet implemented)
Create a new instance running Zope version specific mkzopeinstance.
Which products and extensions will be installed: `all' means every product
or extension available will be automatically installed, `manual' means that the products
or extensions will be installed manually through dzhandle.
How to install addons: `linked' means the product or extension directory
will be symlinked into the instance home, `tree-linked' means the directory structure will
be re-created and then files symlinked, `copied' means the file will be copied into the
when to restart on configuration of new products or extensions: `configuring'
means after every product or extension configuration, `end' means at the end of the installation
of all packages, `manually' means no automatic restart will happen.
user and password for the initial user (in the form `user:password'); these
settigs can be modified later using zpasswd.py utility from Zope.
system user used to run this instance (in the form `user:groupdefault', the
default is `zope:zope'); this setting can be modified later editing the zope.conf file of
HTTP port used to run this instance (default 9673); this setting can be modified
later editing the zope.conf file of the instance.
the directory from which skeleton files should be copied; must at least contain
the following directories: `bin', `etc', `Extensions', `import', `lib', `log', `Products', `var'
and files: `bin/zopeservice.py.in', `bin/runzope.bat.in', `bin/runzope.in',
`bin/runzope.in', `bin/zopectl.in', `etc/zope.conf.in'.
Remove an instance (except data files) and mark it as removed.
Purge files for an instance (including data files).
Print a short summary about an instance.
Print the list of available instances.
Get or set an addon-mode for an instance.
Get or set an addon-install-technique for an instance.
Get or set a policy on addon-installation for an instance.
Call a zopectl action (e.g. `start', `stop' or `restart') for a given instance.
Restart instances with `restart-pending' markers.
Create a new instance running Zope version specific mkzeoinstance.
Purge files for a ZEO instance (including data files).
Print the list of available ZEO instances.
Call a zeoctl action (e.g. `start', `stop' or `restart') for a given ZEO instance.
show all products or extensions managed by dzhandle
add a product or extension to an instance
Add missing addons only (error on manually installed addons).
How to install the specified addons.
remove a product or extension from an instance
Do not complain about already removed addons.
Force removal of the addons.
The following actions should be used inside the maintainer scripts of Debian/Ubuntu
packages of Zope products and extensions. If the package uses zope-debhelper's
dh_installzope, these actions will be automatically included.
install a packaged extension/product
remove a packaged extension/product
handle postinst of a packaged extension/product
handle postrm of a packaged extension/product
handle preinst of a packaged extension/product
handle prerm of a packaged extension/product
show various informations about zope packages
This manual page was written by Fabio Tranchitella <email@example.com> for
the Debian GNU/Linux and Ubuntu Linux systems (but may be used by others).
Permission is granted to copy, distribute and/or modify
this document under the terms of the GNU Free
Documentation License, Version 1.1 or any later version
published by the Free Software Foundation; with no Invariant
Sections, no Front-Cover Texts and no Back-Cover Texts. A copy
of the license can be found under