How To Install And Use the zenoss.toolbox

Applies To

  • Zenoss 5.x
  • Zenoss 4.x


The zenoss.toolbox GitHub repository is the source for Zenoss-maintained tools. Toolbox tools cover zodb and catalog integrity as well as maintenance items for Zenoss instances. All tools are to be installed and run from the Zenoss master server as the zenoss user, unless otherwise specified. Consult the detailed instructions for each individual tool before use.


Detailed zenoss.toolbox Tool List:

  1. findposkeyerror
  2. zencatalogscan
  3. zenrelationscan
  4. zodbscan
  5. zencheckdbstats
  6. zenindextool
  7. zennetworkclean

Installation Procedures

The Zenoss toolbox is intended to be installed and run only from the master Zenoss server.

Zenoss Toolbox Installation on Zenoss Resource Manager 4.x

Perform the following as the zenoss user to download and install the package:

  1. Download the toolbox:
    $ wget -O --no-check-certificate
  2. Use easy_install to install the toolbox:
    $ easy_install

Zenoss Toolbox Installation on Zenoss Resource Manager 5.1.x

For specific installation instructions on Zenoss Resource Manager 5.1.x, see Using Zenoss Toolbox in the Zenoss Resource Manager Upgrade Guide at

Was this article helpful?
5 out of 6 found this helpful


Powered by Zendesk