Preparing to install or update a ZenPack

Perform this procedure to minimize the amount of time that Resource Manager is unavailable during a ZenPack installation or update.

Log in to your workstation and start a web browser.
Download the ZenPack to install or update from the Zenoss Support site. Contact your Zenoss representative for login credentials.
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.
2. Set full permissions on the directory and files:
```
chmod -R 0777 /tmp/zenpack
```
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 Resource Manager application services:
```
serviced service restart Zenoss.resmgr/Zenoss
```

Installing or updating a ZenPack

Before you begin, review the following requirements and considerations:

Complete the steps in Preparing to install or update a ZenPack.
Do not use this procedure to install or update the Zenoss Service Impact ZenPacks, ZenPacks.zenoss.ImpactServer and ZenPacks.zenoss.Impact. For more information, see Installing Service Impact or one of the Servcie Impact update procedures.

Perform these steps:

Log in to the Control Center master host as a user with Control Center CLI privileges.
Create a snapshot:
```
serviced service snapshot Zenoss.resmgr
```
On completion, the serviced command returns the ID of the new snapshot. If the installation of a ZenPack fails, you can restore the snapshot created in this step. For more information about restoring a snapshot, see Creating snapshots and rolling back.
Change directory to the directory in which the ZenPack egg file is located. For example:
```
cd /tmp/zenpack
```
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 Resource Manager.

Restart all Zenoss services:

serviced service restart Zenoss.resmgr/Zenoss