Man Linux: Main Page and Category List


       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

ACTIONS (instances handling)

       make-instance <instance> -m AMODE [<options>]
                 Create  a  new  instance  running   Zope   version   specific

                 -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

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

                           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

       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

       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 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 various informations 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

       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.