AutoDeploy - ZenPack Operation Errors

From Zenoss Wiki
Revision as of 08:01, 17 July 2014 by Dkpeall (Talk | contribs)$7

(diff) ← Older revision | Approved revision (diff) | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

When using the script, some users have encountered a ZenPack Operation Error that haults the installation. This error is rare and very difficult to reproduce. Below are suggestions you can use to help resolve the issue.

Example Error

There was an error during the ZenPack operation: 
Command 'zenpack  --install /opt/zenoss/packs/ZenPacks.zenoss.ApacheMonitor-2.1.3-py2.7.egg' 
returned non-zero exit status 3
Error: A zenpack failed to install. Fix the zenpack or delete it from 
/opt/zenoss/var/zenpack_actions.txt, then restart zenoss.

The Quicker Fix

The problem is simple to identify. Check the /opt/zenoss/etc/global.conf make sure the amqppassword does not contain any URI breaking characters like '/' if it does replace or remove these characters. You will need to set the new password and restart zenoss.

rabbitmqctl change_password zenoss <newpassword>

Quick Fix

Many users simply create a new Virtual Machine/Instance and start over from scratch. Since the error is intermittent, chances are that the second installation will go well.

Another Quick Fix

If you run the installation script on CentOS 6.5: Make sure you remove the default CentOS Postfix and Mysql libraries.

yum -y remove postfix* mysql*


See Working with Queues for examples...

  • Restart the rabbit service to verify there aren't any errors
  • Verify the queues are present, recreate them if missing
  • Start the zenrrdcached daemon to see if there are any errors (zenhub.log and syslog or system)
  • Adjust $ZENHOME/etc/global.conf with the correct rabbit user credentials (if you rebuilt the queues, you will most likely need to use zenoss for username/password)
  • Go through the ZenOSS_Tuning#rabbitmq-server


  • Execute $ZENHOME/bin/zenoss_upgrade_pre as the root user (you will have to add $ZENHOME="/opt/zenoss" to it)
  • Execute $ZENHOME/bin/zenoss_upgrade_post as the root user

  • Execute once more to see if the errors have cleared up

Delete the ZenPack

  • Delete the ZenPack the script is having issues with (Example "rm /opt/zenoss/packs/ZenPacks.zenoss.ApacheMonitor-2.1.3-py2.7.egg")
  • Delete the ZenPack entry from /opt/zenoss/var/zenpack_actions.txt
  • Once zenoss is up and running, install the ZenPack manually.


Any feedback or tips are greatly appreciated, we want to eliminate this error so that you can spend more time working on transforms or ZenPacks!