Metadata-Version: 1.1
Name: zenoss.toolbox
Version: 0.1.7
Summary: Utilities for analyzing and debugging Zenoss environments.
Home-page: git@github.com:zenoss/zenoss.toolbox.git
Author: Zenoss, Inc.
Author-email: dev@zenoss.com
License: Proprietary
Description: zenoss.toolbox
        ==============
        Utilities for analyzing and debugging Zenoss environments.
        
        To install the latest tools from zenoss.toolbox:
          1) Login to the zenoss master
          2) Become the zenoss user:
            su - zenoss
          3) Download the latest zenoss.toolbox:
            wget -O master.zip --no-check-certificate https://github.com/zenoss/zenoss.toolbox/archive/master.zip
          4) Use python's easy_install to install the zenoss.toolbox:
            easy_install ./master.zip
        
        ==============
         
        findposkeyerror
        ------------
        ``findposkeyerror`` will scan the supplied zodb path, looking for
        dangling references for certain objects and fix those if --fixrels
        is supplied as a command argument.
        
        zencatalogscan
        ------------
        ``zencatalogscan`` will scan the various zenoss catalogs for any references
        that point to unresolvable paths.  It is safe to run this in the background.
        If you run with "-f" or "--fix" it will attempt to uncatalog any detected
        references that are no longer present.  
        
        zodbscan
        --------
        ``zodbscan`` will scan the zodb and zodb_session databases, looking for
        dangling references. If it finds one, it will analyze the pickled object
        state to determine the path through the object graph, the name of the
        attribute referencing the missing oid, and the class that should be there::
        
               ==================================================
        
                   DATABASE INTEGRITY SCAN:  zodb
        
               ==================================================
                                                                                               
               FOUND DANGLING REFERENCE
               PATH /zport/dmd/Devices/devices/ian
               TYPE <class 'Products.ZenModel.Device.Device'>
               OID 0x0001ff38 '\x00\x00\x00\x00\x00\x01\xff8' 130872
               Refers to a missing object:
                   NAME os
                   TYPE <class 'Products.ZenModel.OperatingSystem.OperatingSystem'>
                   OID 0x0001ff43 '\x00\x00\x00\x00\x00\x01\xffC' 130883
                                                                                               
               SUMMARY:
               Found 1 dangling references
               Scanned 96294 out of 96294 reachable objects
        
        cleancatalog (deprecated)
        ------------
        ``cleancatalog`` will scan the global catalog and remove entries that
        point to unresolvable paths. It is safe to run in the background.
        
        Author: Ian McCracken (ian@zenoss.com)
        
        Changelog
        =========
        
        0.1.7
        --------------------
        * Added zencatalogscan - replaces cleancatalog and support's fixCatalogs.py
        
        0.1.6
        --------------------
        * Added findposkeyerror, which finds/fixes relationships having POSKeyErrors
        
        0.1.5
        --------------------
        * Added cleancatalog, which cleans stale objects from the catalog
        
        0.1
        --------------------
        * Added zodbscan, which detects and reports on POSKeyErrors
        
        
Platform: UNKNOWN
Classifier: Programming Language :: Python
