Installing or upgrading a ZenPack

Before you begin, review the following requirements and considerations:
  • Complete the steps in Preparing to install or upgrade a ZenPack.
  • Do not use this procedure to install or upgrade the Zenoss Service Impact ZenPacks, ZenPacks.zenoss.ImpactServer and ZenPacks.zenoss.Impact. For more information, refer to the Zenoss Core Installation Guide.
  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. Change directory to the directory in which the ZenPack egg file is located.
    For example:
    cd /tmp/zenpack
  4. Install the ZenPack:
    serviced service run zope zenpack-manager install ZenPack-File.egg
    Daemons that a ZenPack provides are packaged in Docker containers and installed as child services of the current instance of Zenoss Core.
  5. Restart all Zenoss Core application services:
    serviced service restart Zenoss.core/Zenoss