Removing a ZenPack

Removing a ZenPack can have unexpected consequences, and often, the safest choice is not to remove a ZenPack. Before you begin, review the following requirements and considerations:
  • Removing a ZenPack removes all objects provided by the ZenPack and all objects that depend on code provided by the ZenPack.
  • Removing a newer version of a ZenPack to install an older version fails if the newer version includes migration code.
  • Removing a ZenPack that installs a device class removes the device class, any contained device classes, and all devices in that class.
  • Some ZenPacks provide services upon which other ZenPacks rely. Make sure the service you remove is not needed by another ZenPack.
  • Do not use this procedure to remove the Zenoss Service Impact ZenPacks, ZenPacks.zenoss.ImpactServer and ZenPacks.zenoss.Impact. For more information, refer to the Zenoss Core Installation Guide.
  • Review the documentation of the ZenPack that you want to remove for information about classes and daemons (services) associated with it.
  • Delete data sources provided by the ZenPack that you want to remove.
  1. Log in to the Control Center master host as a user with Control Center CLI privileges.
  2. Create a snapshot:
    serviced service snapshot Zenoss.core
    On completion, the serviced command returns the ID of the new snapshot. If the installation of the ZenPack ends up failing, you can restore the snapshot you took in this step. For detailed instructions on restoring a snapshot, refer to the Control Center Reference Guide.
  3. Obtain the exact name of the ZenPack to remove:
    serviced service run zope zenpack list
    The first item of each line of output is the full name of an installed ZenPack.
  4. Stop services that are associated with the ZenPack.
    Daemons that a ZenPack provides are packaged in Docker containers and installed as child services of the current instance of Zenoss Core. For example, the zenwebtx service is provided by the ZenPacks.zenoss.ZenWebTx ZenPack.
    1. Log into the Zenoss Core browser interface as the Zenoss Core user.
    2. From the navigation menu, select ADVANCED > Control Center.
      The Control Center All Services page appears.
    3. Select the daemon for the service and click Stop.
      For example, select the zenwebtx daemon.
  5. Remove the ZenPack.
    In the Control Center CLI, replace ZenPack-Name with the full name of the ZenPack to remove.
    serviced service run zope zenpack-manager uninstall ZenPack-Name
    The ZenPack and any daemons that it provides are removed.