Upgrading Puppet Agents
A newer version is available; see the version menu above for details.
Depending on the version of PE you are upgrading from, there are two paths to choose from when upgrading your agents:
If your agents are running
pe-puppet(Puppet agent version 3.8), use the puppetlabs-puppet_agent module to upgrade, as described in Upgrade Agents to PE 2015.3 from 3.8.x.
If your agents are running the All-in-One (AIO) Puppet agent (introduced in PE 2015.2), use the
pe_repoto upgrade, as described in Upgrade Agents to PE 2015.3 from 2015.2.x.
Before beginning, make sure you’ve upgraded your Puppet master and other PE components. Upgrades to PE 2015.3 are only supported from PE 3.8.3 or 2015.2.3.
Upgrade Agents to PE 2015.3 from 3.8.x
If you want to upgrade your Puppet agents to PE 2015.3, they must be running a Puppet agent from PE 3.8.3 or 3.8.4 (Puppet version 3.8). Puppet masters running PE 2015.3 will manage agents running 3.8, but we recommend you upgrade to take advantage of the most recent features in the Puppet agent. For the PE 2015.3 series and beyond, we’ve gone to an all-in-one (AIO) Puppet agent package, which contains several key Puppet components.
To upgrade your Puppet agents, download and install the puppetlabs-puppet_agent module. We created this module to handle some of the heavy-lifting in the move to the “AIO” Puppet agent. This module automates important path and configuration changes to make the upgrade process much easier.
Tip: When upgrading your agents to PE 2015.3, we recommend that you first upgrade a subset of your agents, and once you’ve verified the install, upgrade your remaining agents. The following procedure assumes you will do this.
To upgrade your Puppet agents:
- Upgrade your monolithic or split Puppet master.
Ensure your Puppet master is classified with the appropriate repos that correspond to the platforms and architectures and architectures of your agents.
a. Navigate to the PE Masters group.
b. Click the Classes tab.
c. In the Class name field, begin typing
pe_repo, and select the repo class from the list of classes.
The repo classes are listed as
Note: If you need to add any repo classes, you need to run Puppet on the Puppet master before those changes will be available in the classifier.
- On your Puppet master, download and install the puppetlabs-puppet_agent module. Run
puppet module install puppetlabs-puppet_agent.
In the PE console, create a classification node group and a rule to pull in the subset of nodes you want to upgrade. (In this example, we’ll create a rule to upgrade all agents running the RedHat OS).
a. Click Nodes.
b. Click Classification.
c. From the Classification page, in the Node group name field, enter the name your agent upgrade group (e.g., agent_upgrade).
d. From the Parent name drop-down list, select All Nodes, and from the Environment drop-down list, choose the environment your agents are in.
e. Click Add group.
f. Select the group you’ve just created—you’ll be taken to the Rules tab.
g. Create a rule to add agents to this group. In the Fact field select osfamily. From the Operator drop-down list, select is, and in the Value field, enter RedHat.
h. Click Add rule, and then click the Commit changes button.
Your RedHat agents are now pinned to the upgrade group.
Still in the group you’ve created, click the Classes tab, and in the Add new class field, add the
If you don’t immediately see the class, click Refresh to update the classifier.
Note: If you’ve changed the prefix parameter of the
pe_repoclass in your PE Master node group, set the
puppet-agent sourceparameter of the upgrade group to
Click Add class, and then click the Commit changes button.
On the Puppet agents you are upgrading, run Puppet with
/opt/puppet/bin/puppet agent -t.
Warning: If you’re upgrading EL 7 or SLES 12 agents, when performing this step, do not use the
mco runoncecommand to run Puppet on all your agents, as this causes the upgrade to fail. A full explanation is available in the known issues .
After Puppet runs, you can verify the upgrade by running
Upgrade Agents to PE 2015.3 from 2015.2.x
Before upgrading your agents, check the Agent Components table to ensure your AIO Puppet agent version is correct for the PE version you’re upgrading to.
If you are using the PE package repo (
pe_repo) hosted on the Puppet master, it will get upgraded when you upgrade the Puppet master.
To upgrade your Puppet agents:
- Upgrade your Puppet master.
Follow the instructions for using the agent install script to upgrade your agents.
a. If the OS/architecture of your Puppet master is the same as your agents, choose scenario 1.
b. If the OS/architecture of your Puppet master is different than your agents, choose scenario 2.
If you are using your own package manager (e.g., Satellite), the simplest way to upgrade agents is to upgrade the
puppet_agent package in the repo your package manager (e.g., Satellite) is using.
PE services should restart automatically after the upgrade. But if you want to check that everything is working correctly, you can run
puppet agent -t on your agents to ensure that everything is behaving as it was before upgrading. Generally speaking, it’s a good idea to run Puppet right away after an upgrade to make sure everything is hooked and has the latest configuration.
Upgrading Agents in a Puppet Enterprise Infrastructure Without Internet Access
If your PE infrastructure does not have access to the outside internet, to upgrade your agents you should:
- Follow Option 1 or Option 3 in installing agents without internet access to get the agent packages into your infrastructure.
- Download the puppetlabs-apt, puppetlabs-inifile, puppetlabs-stdlib and puppetlabs-puppet_agent modules from the Puppet Forge, and transfer them your Puppet master.
- Follow the Puppet agent instructions provided above.