ZenPacks.zenoss.Puppet
Contents
About
This ZenPack provides a mechanism to gather information from the Puppet master about Puppet clients. Information about the Puppet system can be found at http://docs.puppetlabs.com/
Features
The Puppet
modeling plugin provides components that represent the Puppet
clients.
The Processes
list is also updated with information about the Puppet
(master and client) processes.
A JSON API for importing and exporting zenbatchload
format configuration
files is available:
Name | Value |
---|---|
action |
PuppetRouter |
router |
puppet_router |
The methods available are:
exportDevices
- Export out the list of devices, and the complete listing of acquired and local zproperties.
importDevices
- Import a
zenbatchload
file.
Prerequisites
Prerequisite | Restriction |
---|---|
Product | Zenoss 4.1.1 or higher |
Required ZenPacks | ZenPacks.zenoss.Puppet |
Other dependencies | The zenoss.rb integration requires the following
Ruby gems:
* httpclient
* json |
Usage
Modeling Puppet Masters
Once a Puppet master has been identificed, follow this procedure:
- Navigate to a device.
- Click on the
Modeler Plugins
link. - Ensure that the modeler plugin
zenoss.cmd.Puppet
is selected. - Click on the
Save
button.
Managing Zenoss Configuration via Puppet
- Create a new user with
Manager
privileges specifically for Puppet. - Update the
bin/getDeviceExport.sh
script (or thebin/getDeviceExport-ssl.sh
script if using SSL) to use the new credentials. - Run the
exportDevices.sh
script to verify the router/facade pair is working. - Update the
zenoss.rb
calls to include the new credentials.
Troubleshooting
Unauthorized Messages
This usually indicates a credentials issue. Please verify the username and password combinations.
Installing
Install the ZenPack via the command line and restart Zenoss:
zenpack --install ZenPacks.zenoss.Puppet-1.0.0-py2.7.egg zenoss restart``
Removing
To remove the ZenPack, use the following commands:
zenpack --erase ZenPacks.zenoss.Puppet zenoss restart