ZenPacks are distributed as .egg
files.
You can install ZenPacks from the command line on the Zenoss server, or from the user interface.
The following ZenPack command can be used from the command line to install ZenPack files. After installing or updating ZenPacks you need to restart:
zenpack --install <filename> zenoss restart
If you have the source code for the ZenPack you can install directly from that rather than from a .egg
file. The command is the same, you just specify the directory containing the source code. This copies the source code into either $ZENHOME/ZenPacks (for newer egg ZenPacks) or $ZENHOME/Products (for older style ZenPacks.)
zenpack --install <directoryname> zenoss restart
If you are developing a ZenPack you usually will want to maintain your source code outside of $ZENHOME/ZenPacks
or $ZENHOME/Products
. This is advisable for two reasons. First, if you issue a zenpack --remove command it will delete your code from either of those two locations and you would lose your files unless you had them backed up elsewhere. Second, if you are maintaining your source code in a version control system it is frequently more convenient to have the files reside elsewhere on the file system. Using the --link option you can install the ZenPack but have the system use your code from its current location. Instead of installing your code in $ZENHOME/ZenPacks
or $ZENHOME/Products
the system will create a link in one of those locations that points to your source code directory.
zenpack --link --install <directoryname> zenoss restart
You can upload and install a ZenPack .egg
file via the user interface. To do this:
After installing the ZenPack, you should restart the system.
The Core ZenPacks, along with third party ZenPacks, are available for download individually from:
Also on that page is a link to download an RPM that includes the most popular Core ZenPacks. To install via the Core ZenPacks RPM follow these steps:
Download the appropriate file from the ZenPacks download area specific to your version.
Make sure ZEO is running (as the zenoss user):
zeoctl start
Install the rpm (as root user):
rpm -ihv <rpm file>
Restart Zope and ZenHub:
zopectl restart zenhub restart