Installing Cisco IOS-XR agents
Puppet Enterprise supports Cisco IOS-XR release 6.0 and higher as a platform for running Puppet agents on their network switches. Supported Cisco switches include:
- Cisco IOS-XR NCS5500 (IOS-XR 6.0)
- Cisco IOS-XR XR9kv (IOS-XR 6.0)
Important: Currently the Puppet agent only supports the built-in package, file, and service resources.
These instructions assume you’ve already installed Puppet Enterprise and have a compatible Cisco IOS-XR switch running the minimum required version of IOS-XR. Installing the Cisco agent requires that you install the puppet-ciscopuppet module, which contains the types and providers needed to configure your Cisco IOS-XR switches.
Step 1: Install the puppetlabs-ciscopuppet module
On your Puppet master, run,
puppet module install puppetlabs-ciscopuppet.
Step 2: Install the Puppet agent
These instructions assume you have networking and DNS configured for the bash environment. Detailed instructions can be found in the section “Puppet agent environment: bash-shell” from README-AGENT-INSTALL.md in the ciscopuppet module.
Note: To install the Puppet agent, we recommend 400 MB of free disk space on bootflash.
To install the Puppet agent with Bash:
Start a root Bash shell with networking enabled. From the command line of your network switch, run the following commands:
run bash sudo ip netns exec management bash
Install the Puppet Collections PC1 repository package for cisco_wrlinux:
bash-4.2# yum install http://yum.puppetlabs.com/puppetlabs-release-pc1-cisco-wrlinux-7.noarch.rpm
Note: Make sure you install the repository which has “cisco-wrlinux-7” in the filename, which works on IOS-XR devices. Any files which have “cisco-wrlinux-5” in the filename will not run on IOS-XR devices and are intended for Cisco NX-OS devices instead.
Install the Puppet agent:
yum install puppet-agent
The Puppet agent is now installed under
/opt/puppetlabs. Add the
libpaths to your login shell’s
Uninstalling Puppet agent with Bash or “guest shell”
The commands to uninstall the Puppet agent are the same for both Bash and “guest shell” environments.
Remove the Puppet agent:
sudo su - yum remove puppet-agent
Remove the Puppet Collections PC1 repository package package:
yum remove puppetlabs-release-pc1
Refer to the puppet-ciscopuppet module for more information about using the module on your IOS-XR network switch.