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.
puppetserver package effectively upgrades Puppet Server. The
puppetserver package, in turn,
depends on the
puppet-agent package, and your node’s package manager
puppet-agent if the new version of
puppetserver requires it.
On your Puppet Server
node, run the command appropriate to your package installer:
yum update puppetserver
apt-get update apt-get install --only-upgrade puppetserver
If you pinned Puppet packages to a specific version, remove the pins.
For yum packages locked with theOn apt systems, remove
/etc/yum/pluginconf.d/versionlock.listto remove the lock.
/etc/apt/preferences.d/that pin packages, and use the
apt-mark unholdcommand on each held package.
Regularly upgrade agents to keep your systems running smoothly.
Upgrade Puppet Server.
Upgrade *nix agents
To upgrade *nix nodes, use
yum update puppet-agent
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
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 to get the newest features available.
Follow these steps, depending on whether you want to
automate upgrade or manually upgrade.
To automate upgrade, specify the
versionparameter of the
To manually upgrade, on the PuppetDB node, run the command appropriate to your package installer:Yum:
yum update puppetdb
apt-get update apt-get install --only-upgrade puppetdb
On your master, upgrade the
puppetdb-terminipackage by running the command appropriate to your package installer:Yum:
yum update puppetdb-termini
apt-get update apt-get install --only-upgrade puppetdb-termini