This table lists
the release history for this feature.
Table 1 Feature History
for Puppet Support
This feature was introduced in Cisco Nexus 5600
and Cisco Nexus 6000 series switches.
The Puppet software
package, developed by Puppet Labs, is an open source automation toolset for
managing servers and other resources by enforcing device states, such as
include a puppet agent which runs on the managed device (node) and a puppet
master (server) that typically runs on a separate dedicated server and serves
multiple devices. The operation of the puppet agent involves periodically
connecting to the puppet master; which in turn compiles and sends a
configuration manifest to the agent; the agent reconciles this manifest with
the current state of the node and updates state based on differences.
A puppet manifest is a
collection of property definitions for setting the state on the device. The
details for checking and setting these property states are abstracted so that a
manifest can be used for more than one operating system or platform. Manifests
are commonly used for defining configuration settings, but they can also be
used to install software packages, copy files, and start services.
The following are
prerequisites for the Puppet Agent:
You must have a
Cisco device and operating system software release that supports the
5600 Series switch.
6000 Series switch.
release 7.3(0)N1(1) or later for Cisco Nexus 5600 and Cisco Nexus 6000 series
cannot run natively on Cisco Nexus 5600 and Cisco Nexus 6000. Instead, they run
in a special virtual environment called the Open Agent Container (OAC). For
information on how to install OAC on your switch, refer to the chapter
You must have
Puppet Master server with Puppet 4.0 or later.
You must have
Puppet Agent 4.0 or later.
You must have
ciscopuppet module 1.1.0 or later.
Puppet Agent NX-OS
The puppet agent
software must be installed in a Linux environment on the Cisco Nexus platform:
It is a 32-bit
CentOS 6.6 based container that is targeted to specifically allow Puppet and
Chef Agents on Nexus platforms. Although the container will have the ability to
provide a "bash" shell, it will restrict the applications that can be installed
in the Container.
You have to download
and install OAC on your device before you install the Puppet client on the
device. For information on how to download and install OAC, refer to the
Open Agent Container.
The following provide
information about agent software download, installation and setup:
ciscopuppet module is a Cisco developed open-source
interface between the abstract resources configuration in a puppet manifest and
the specific implementation details of the Cisco Nexus NX-OS operating system
and platform. This module is installed on the puppet master and is required for
puppet agent operation on Cisco Nexus switches.
ciscopuppet module is available on Puppet Forge. For
more information about ciscopuppet module location and setup instructions, see: