Scroll to navigation

dzhandle(1) General Commands Manual dzhandle(1)

NAME

dzhandle — Debian/Ubuntu Zope packages handling command line utility

SYNOPSIS

dzhandle [options] action [action options]

DESCRIPTION

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.

OPTIONS

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)

ACTIONS (instances handling)

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. This option is mandatory.
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 instance home.
Default: tree-linked.
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.
Default: end
user and password for the initial user (in the form `user:password'); these settigs can be modified later using zpasswd.py utility from Zope.
You'll be prompted for an username and password if the options is omitted.
system user used to run this instance (in the form `user:groupdefault'); this setting can be modified later editing the zope.conf file of the instance.
Default: zope:zope
HTTP port used to run this instance; this setting can be modified later editing the zope.conf file of the instance.
Default: 9673
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'.
Default: /usr/lib/zopeVER/skel
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.

ACTIONS (ZEO instances handling)

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.

ACTIONS (products and extensions handling)

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.

ACTIONS (for Zope products maintainers)

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 information about zope packages

SEE ALSO

dh_installzope(1), dh_installzopeinstance(1)

AUTHOR

This manual page was written by Fabio Tranchitella <kobold@debian.org> 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 /usr/share/common-licenses/FDL.