To upgrade your deployment, you must upgrade both the infrastructure components and agents.
The order in which you upgrade components is important. Always upgrade Puppet Server and PuppetDB simultaneously, including the puppetdb-termini
package on Puppet Server nodes, and always upgrade them before you upgrade agent nodes. Do not run different major versions on your Puppet masters (including Server) and PuppetDB nodes.
Upgrade Puppet Server
Upgrade Puppet Server to adopt features and functionality of newer versions.
Upgrading the puppetserver
package effectively upgrades Puppet Server. The puppetserver
package, in turn, depends on the puppet-agent
package, and your node’s package manager automatically upgrades puppet-agent
if the new version of puppetserver
requires it.
Upgrade agents
Regularly upgrade agents to keep your systems running smoothly.
Upgrade Puppet Server.
Upgrade *nix agents
To upgrade *nix nodes, use the update
command.
yum update puppet-agent
Apt:apt-get update
apt-get install --only-upgrade puppet-agent
Upgrade Windows agents
To upgrade Windows agents, reinstall the agent using the installation instructions. You don't need to uninstall the agent before reinstalling unless you’re upgrading from 32-bit Puppet to the 64-bit version.
Upgrade macOS agents
Use the puppet resource
command to upgrade macOS agents.
Download the appropriate agent tarball.
sudo puppet resource package "<NAME>.dmg" ensure=present source=<FULL PATH TO DMG>
Upgrade PuppetDB
PuppetDB can be upgraded independently of your master and agent nodes.