sourCEntral - mobile manpages

pdf

dzhandle

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

-h, −−help

Print usage information and exit

-f, −−force

Force things, for example file overwriting or removing

-z, −−zope-version=ZVERSIONS

limit actions to a comma separated list of zope versions; default behaviour is to act on all zope versions available

-u, −−user=USER[:GROUP]

User/Group ownership for new and copied files

-c, −−config-file=FILE

Configuration file; default is /etc/dzhandle.conf

-v, −−verbose

Enable verbose mode (not yet implemented)

-n, −−dry-run

Do not execute commands, print only them (not yet implemented)

ACTIONS (instances handling)

make-instance <instance> −m AMODE [<options>]

Create a new instance running Zope version specific mkzopeinstance.
−m AMODE, −−addon-mode=AMODE

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.

−t ATECHNIQUE, −−addon-install-technique=ATECHNIQUE

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.

−r RESTART, −−restart=RESTART

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

−u USER, −−user=USER

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.

−−service-user=SRVUSER

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. ‘groupdefault’ can be omitted.

Default: zope:zope

−−service-port=SRVPORT

HTTP port used to run this instance; this setting can be modified later editing the zope.conf file of the instance.

Default: 9673

−−skelsrc=SKEL

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-instance <instance>

Remove an instance (except data files) and mark it as removed.

purge-instance <instance>

Purge files for an instance (including data files).

show-instance <instance>

Print a short summary about an instance.

list-instances

Print the list of available instances.

instance-addon-mode <instance> [<mode>]

Get or set an addon-mode for an instance.

instance-addon-technique <instance> [<technique>]

Get or set an addon-install-technique for an instance.

instance-restart-policy <instance> [<restart-policy>]

Get or set a policy on addon-installation for an instance.

zopectl <instance> <zdctl-action> [<zdctl options>]

Call a zopectl action (e.g. ‘start’, ‘stop’ or ‘restart’) for a given instance.

restart-pending-instances

Restart instances with ‘restart-pending’ markers.

ACTIONS (ZEO instances handling)

make-zeoinstance <instance>

Create a new instance running Zope version specific mkzeoinstance.

purge-zeoinstance <instance>

Purge files for a ZEO instance (including data files).

list-zeoinstances

Print the list of available ZEO instances.

zeoctl <instance> <zeotl-action> [<zeotl options>]

Call a zeoctl action (e.g. ‘start’, ‘stop’ or ‘restart’) for a given ZEO instance.

ACTIONS (products and extensions handling)

list-products, list-extensions

show all products or extensions managed by dzhandle

add-product, add-extension

add a product or extension to an instance
−l, −−lazy

Add missing addons only (error on manually installed addons).

−t ATECHNIQUE, −−addon-install-technique=ATECHNIQUE

How to install the specified addons.

remove-product, remove-extension

remove a product or extension from an instance
−l, −−lazy

Do not complain about already removed addons.

−f, −−force

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.
dinstall-extension, dinstall-product

install a packaged extension/product

dremove-extension, dremove-product

remove a packaged extension/product

postinst-extension, postinst-product

handle postinst of a packaged extension/product

postrm-extension, postrm-product

handle postrm of a packaged extension/product

preinst-extension, preinst-product

handle preinst of a packaged extension/product

prerm-extension, prerm-product

handle prerm of a packaged extension/product

show-package-info

show various informations about zope packages

SEE ALSO

dh_installzope(1), dh_installzopeinstance(1)

AUTHOR

This manual page was written by Fabio Tranchitella <kobold AT debian DOT 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.

pdf