Install agents on network switches to operate them with Puppet Enterprise as managed devices.
Installing Arista EOS agents
You can run agents on Arista EOS network switches.
Install Arista EOS agents
The agent retrieves its catalog and is fully functional.
You see a message like:
Info: Retrieving pluginfacts
Info: Retrieving plugin
Info: Loading facts
Info: Caching catalog for <EOS INSTANCE FQDN>
Info: Applying configuration version '1424214157'
Notice: Finished catalog run in 0.46 seconds
Uninstall Arista EOS agents
The agent certificate is revoked and and related files are deleted from the master.
You see a message like:
Notice: Revoked certificate with serial 10
Notice: Removing file Puppet::SSL::Certificate <EOS INSTANCE FQDN> at '/etc/puppetlabs/puppet/ssl/ca/signed/<EOS INSTANCE FQDN>.pem'
Notice: Removing file Puppet::SSL::Certificate <EOS INSTANCE FQDN> at '/etc/puppetlabs/puppet/ssl/certs/<EOS INSTANCE FQDN>.pem'
Installing Cisco agents
You can install agents on network switches running Cisco NX-OS 7.0 and later and IOS-XR 6.0 and later.
Supported Cisco switches include:
- Cisco Nexus 95xx series switches
- Cisco Nexus 93xx series switches
- Cisco Nexus 31xx series switches
- Cisco Nexus 30xx series switches
- Cisco IOS-XR NCS5500 (IOS-XR 6.0)
- Cisco IOS-XR XR9kv (IOS-XR 6.0)
For more information about managing Cisco network switches, see the puppet-ciscopuppet module.
Install Cisco NX-OS agents
The puppet-ciscopuppet module contains the types and providers needed to configure Cisco NX-OS network switches.
If you're installing for bash, you must have networking and DNS configured for the bash environment.
-
Bash — Native Linux environment underlying NX-OS. It is disabled by default.
-
Guest — Secure Linux container environment running CentOS. It is enabled by default on most Nexus platforms
Install Cisco IOS-XR agents
The puppet-ciscopuppet module contains the types and providers needed to configure Cisco IOS-XR network switches.
If you're installing for bash, you must have networking and DNS configured for the bash environment.
Cisco IOS-XR agents must be run with bash.
Uninstall Cisco agents
The commands to uninstall NX-OS and IOS-XR Cisco agents are the same for both Bash and guest shell environments.
Installing Cumulus Linux agents
PE supports the Cumulus Linux operating system as an agent-only platform.
Install Cumulus Linux agents
- The IP address and the fully qualified domain name (FQDN) of your master.
- The FQDN of the network device that you're installing the Cumulus Linux on.
- From the network switch, retrieve the agent package:
wget http://apt.puppetlabs.com/puppetlabs-release-pc1-cumulus.deb
- Install the agent package:
sudo dpkg -i puppetlabs-release-pc1-cumulus.deb
- Update the package:
sudo apt-get update
- Install the agent:
sudo apt-get install puppet-agent
- Edit
/etc/hosts
puppet
so that it includes the IP address of your master, as well as its FQDN and default DNS alt name,puppet
. - Connect the agent to the master and create a certificate signing request for the new agent:
sudo /opt/puppetlabs/bin/puppet agent -t
- On your master, sign the cert for the network device:
puppet cert sign <NETWORK DEVICE FQDN>
- On the network device, run Puppet:
sudo /opt/puppetlabs/bin/puppet agent -t
The agent retrieves its catalog and is fully functional.
Uninstall Cumulus Linux agents
- Uninstall the agent and agent packages:
sudo apt-get remove puppet-agent puppetlabs-release-pc1
- On your master, revoke the cert for the agent:
puppet cert clean <NETWORK DEVICE FQDN>
The agent certificate is revoked and and related files are deleted from the master.