Provided by: zope-common_0.5.54_all bug


       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.


       -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

                           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 utility from

                           You'll be prompted for an username and  password  if  the  options  is

                           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/',    `bin/',    `bin/',
                           `bin/', `bin/', `etc/'.

                           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.

                 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 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).

                 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

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


       dh_installzope(1), dh_installzopeinstance(1)


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