=============================================================================== 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 the bin/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