Supported operating systems
Puppet Enterprise supports various operating systems depending on the role a machine assumes in your infrastructure.
Supported operating systems and devices
You can install PE and the agent on these supported platforms.
For details about platform support lifecycles and planned end-of-life support, see Platform support lifecycle on the Puppet website.
Primary server platforms
Operating system | Versions |
---|---|
AlmaLinux | 8 |
CentOS | 7 |
Oracle Linux | 7 |
Red Hat Enterprise Linux | 7, 8 |
Red Hat Enterprise Linux (FIPS 140-2 compliant) | 7, 8 |
Rocky Linux | 8 |
Scientific Linux | 7 |
SUSE Linux Enterprise Server | 12, 15 |
Ubuntu (General Availability kernels) | 18.04, 20.04 |
Agent platforms
puppet-agent
package (as explained in Installing agents) and reinstalling any Ruby plugins/gems that were added at /opt/puppetlabs/puppet/bin/gem
.Operating system | Versions | Architecture |
---|---|---|
AIX | 7.1, 7.2
Note: We support only technology levels that are
still under support from IBM.
|
POWER |
AlmaLinux | 8 | x86_64, aarch64, ppc64le |
Amazon Linux | 2 | x86_64 |
CentOS | 6, 7 |
|
Debian | Stretch (9), Buster (10), Bullseye (11) |
|
Fedora | 32, 34 | x86_64 |
macOS | 10.15, 11, 12 |
|
Microsoft Windows | 10, 11 |
For FIPS 140-2 compliant Microsoft Windows use version 10 with x64 architecture. |
Microsoft Windows Server | 2008 R2, 2012, 2012 R2, 2012 R2 Core, 2016, 2016 Core, 2019, 2019 Core, 2022 | x64 For FIPS 140-2 compliant Microsoft Windows Server, use 2012 R2 or 2012 R2 Core. |
Oracle Linux | 6, 7, 8, 9 |
|
Red Hat Enterprise Linux | 6, 7, 8, 9 |
For FIPS 140-2 compliant RHEL, use version 7 or 8 with x86_64 architecture. |
Rocky Linux | 8 | x86_64, aarch64, ppc64le |
Scientific Linux | 6, 7, 8, 9 |
|
Solaris | 10, 11 | SPARC, x86_64 |
SUSE Linux Enterprise Server | 11, 12, 15 |
|
Ubuntu (General Availability kernels) | 18.04, 20.04, 22.04 |
|
Platform dependencies
When you install PE or an agent, certain package dependencies are required to ensure the node is operational.
- If you're installing on AIX or Solaris.
- If the node doesn't have internet access.
CentOS dependencies
All nodes | Primary server | |
---|---|---|
cronie (versions 6 and later) | x | x |
dmidecode | x | x |
libxml2 | x | x |
logrotate | x | x |
net-tools | x | x |
pciutils | x | x |
tar | x | x |
vixie-cron (version 5) | x | x |
which | x | x |
zlib | x | x |
curl | x | |
libjpeg | x | |
libtool-ltdl (versions 7 and later) | x | |
libxslt | x | |
mailcap | x |
RHEL dependencies
All nodes | Primary server | |
---|---|---|
cronie (versions 6 and later) | x | x |
dmidecode | x | x |
libxml2 | x | x |
logrotate | x | x |
net-tools | x | x |
pciutils | x | x |
tar | x | x |
vixie-cron (version 5) | x | x |
which | x | x |
zlib | x | x |
curl | x | |
libjpeg | x | |
libtool-ltdl (versions 7 and later) | x | |
libxslt | x | |
mailcap | x |
SUSE Linux Enterprise Server dependencies
zypper package-search <PACKAGE NAME>
to
locate them for manual installation.All nodes | Primary server | |
---|---|---|
cron | x | x |
libxml2 | x | x |
libxslt | x | x |
logrotate | x | x |
net-tools | x | x |
pciutils | x | x |
pmtools | x | x |
tar | x | x |
zlib | x | x |
curl | x | |
db43 | x | |
libjpeg | x | |
unixODBC | x |
Ubuntu dependencies
All nodes | Primary server | |
---|---|---|
cron | x | x |
dmidecode | x | x |
gnupg | x | x |
hostname | x | x |
libldap-2.4-2 | x | x |
libreadline5 | x | x |
libxml2 | x | x |
logrotate | x | x |
pciutils | x | x |
tar | x | x |
zlib | x | x |
ca-certificates-java | x | |
curl | x | |
file | x | |
libcap2 | x | |
libgtk2.0-0 | x | |
libjpeg62 | x | |
libmagic1 | x | |
libossp-uuid16 | x | |
libpcre3 | x | |
libxslt1.1 | x | |
mime-support | x | |
perl | x |
AIX dependencies and limitations
Before installing the agent on AIX systems, install these packages.
- bash
- zlib
- readline
- curl
- openssl
- tar
To install the bash, zlib, and readline packages on a node
directly, run rpm -Uvh
with the
following URLs. The RPM package provider must be run as root.
- ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/bash/bash-3.2-1.aix5.2.ppc.rpm
- ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/zlib/zlib-1.2.3-4.aix5.2.ppc.rpm
-
ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/readline/readline-6.1-1.aix6.1.ppc.rpm (AIX 6.1 and 7.1 only)
-
ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/readline/readline-4.3-2.aix5.1.ppc.rpm (AIX 5.3 only)
If you are behind a firewall or running an http proxy, the above commands might not work. Instead, use the AIX toolbox packages download available from IBM.
GPG verification does not work on AIX, because the RPM version it uses is too old. The AIX package provider doesn't support package downgrades (installing an older package
over a newer package). Avoid using leading zeros when specifying a version number
for the AIX provide, for example, use 2.3.4
not 02.03.04
.
The PE AIX implementation supports the NIM, BFF, and RPM package providers. Check the type reference for technical details on these providers.
Solaris dependencies and limitations
Solaris support is agent only.
For Solaris 10, these packages are required:
- tar
- SUNWgccruntime
- SUNWzlib
- In some instances, bash might not be present on Solaris systems. It needs to be installed before running the installer. Install bash via the media used to install the operating system, or via CSW if that is present on your system. (CSWbash or SUNWbash are both suitable.
For Solaris 11 these packages are required:
- tar
- readline
- openssl
These packages are available in the Solaris release repository, which is enabled by default in version 11. The installer automatically installs these packages; however, if the release repository is not enabled, the packages must be installed manually.
Upgrade your operating system with PE installed
If you have PE installed, take extra precautions before performing a major upgrade of your machine's operating system.
Performing major upgrades of your operating system with PE installed can cause errors and issues with PE. A major operating system upgrade is an upgrade to a new whole version, such as an upgrade from RHEL 6.0 to 7.0; it does not refer to a minor version upgrade, like RHEL 6.5 to 6.6. Major upgrades typically require a new version of PE.
- Back up your databases and other PE files.
-
Perform a complete uninstall (using the
-p
and-d
uninstaller options). - Upgrade your operating system.
- Install PE.
- Restore your backup.