Preparing to install or upgrade a ZenPack

Perform this procedure to minimize the amount of time that Zenoss Core is unavailable during a ZenPack installation or upgrade.
  1. Log in to your workstation and start a web browser.
  2. Download the ZenPack to install or upgrade from the ZenPack catalog site.
  3. Copy the ZenPack egg file to a local directory on the Control Center master host.
    1. Create a directory for the ZenPack egg file.
      The directory must be local (not mounted).
      The following command creates a directory in /tmp:
      mkdir /tmp/zenpack
    2. Use a file transfer command or utility to copy the file.
    3. Set full permissions on the directory and files:
      chmod -R 0777 /tmp/zenpack
  4. Optional: Install ZenPack dependencies.
    A ZenPack might require packages or other software not included in the ZenPack egg file. To ensure that the dependencies are available, perform the following substeps:
    1. Log in to the Control Center master host as a user with Control Center CLI privileges.
    2. Start an interactive shell in a Zope service container.
      In the following command, the -s flag saves and tags the changes that you make. Replace MyTag with a short name that describes the dependencies that you are installing.
      serviced service shell -i -s MyTag zope bash
      The serviced daemon starts a Bash shell and logs you in as the root user.
    3. Install required dependencies.
      For example, to install the terminus font for X Windows in Ubuntu Linux, enter the following command:
      apt-get install xfonts-terminus
      Enter any number of commands to install the required dependencies.
    4. Return to the Control Center master host shell session:
      exit
    5. Create a snapshot and commit your changes:
      serviced snapshot commit MyTag
    6. Restart all Zenoss Core application services:
      serviced service restart Zenoss.core/Zenoss