Puppet Enterprise 2017.3

Puppet Enterprise supports various operating systems depending on the role a machine assumes in your infrastructure.

Supported operating systems and devices

When choosing an operating system, first consider the machine's role. Different roles support different operating systems and architectures.

Tip: For details about platform support lifecycles and planned end-of-life support, see Platform support lifecycle on the Puppet website.

Master platforms

The master role can be installed on these operating systems and architectures.
Operating systemVersionsArchitecture
Red Hat Enterprise Linux 6, 7x86_64
CentOS 6, 7x86_64
Oracle Linux 6, 7x86_64
Scientific Linux 6, 7x86_64
SUSE Linux Enterprise Server 11 (SP1/SP2), 12 (SP1, SP2)x86_64
Ubuntu 14.04, 16.04x86_64

Agent platforms

The agent role can be installed on these operating systems and architectures.
Operating systemVersionsArchitecture
Red Hat Enterprise Linux 5, 6, 7
  • x86_64

  • i386 for 5, 6

  • IBM z System for 6, 7 (contact Sales)

  • ppc64le for 7
CentOS 5, 6, 7
  • x86_64

  • i386 for 5, 6

Oracle Linux 5, 6, 7
  • x86_64

  • i386 for 5, 6

Scientific Linux 5, 6, 7
  • x86_64

  • i386 for 5, 6

SUSE Linux Enterprise Server 11 (SP1/SP2), 12 (SP1/SP2)
  • x86_64

  • i386 for 10, 11

  • IBM z System for 11, 12 (contact Sales)

Solaris 10 (update 9 or later), 11
  • SPARC

  • i386

Ubuntu 14.04, 16.04, 16.10
  • x86_64

  • i386

  • ppc64le for 16.04

Fedora 24, 25
  • x86_64

  • i386

Debian Wheezy (7), Jessie (8), Stretch (9)
  • x86_64

  • i386

Microsoft Windows (Server OS) 2008, 2008R2, 2012, 2012R2, 2012R2 core, 2016
  • x86_64

  • i386

Microsoft Windows (Consumer OS) Vista, 7, 8.1, 10
  • x86_64

  • i386

Mac OS X 10.10, 10.11, macOS Sierra
  • x86_64

AIX 5.3, 6.1, 7.1, 7.2
  • Power

Amazon Linux 2017.03 (using packages for RHEL 6)
Note: Some operating systems require an active subscription with the vendor's package management system (e.g., the Red Hat Network) to install dependencies.

Agent network devices

The agent role can be installed on these network devices and operating systems. Refer to the Forge for specific system requirements and dependencies.

  • Arista EOS
  • Cumulus Linux
  • Cisco NS-OX EOS
  • Cisco IOS-XR
  • Huawei CloudEngine

CentOS dependencies

When you install PE or an agent, these packages are also installed from the various operating system repositories.

If the machine you're installing on has internet access, dependencies are set up during installation. If your machine doesn't have internet access, you must manually install dependencies.

All Nodes Master Nodes Console Nodes Console/Console DB Nodes
pciutils x
system-logos x
which x
libxml2 x
dmidecode x
net-tools x
curl x x
mailcap x x
libjpeg x x
libtool-ltdl x x
unixODBC x x
libxslt x
zlib x

RHEL dependencies

When you install PE or an agent, these packages are also installed from the various operating system repositories.

If the machine you're installing on has internet access, dependencies are set up during installation. If your machine doesn't have internet access, you must manually install dependencies.

All Nodes Master Nodes Console Nodes Console/Console DB Nodes
pciutils x
system-logos x
which x
libxml2 x
dmidecode x
net-tools x
cronie (RHEL 6, 7) x
vixie-cron (RHEL 4, 5) x
curl x x
mailcap x x
libjpeg x x
libtool-ltdl (RHEL 7) x x
unixODBC (RHEL 7) x x
libxslt x
zlib x
gtk2 x

SUSE Linux Enterprise Server dependencies

When you install PE or an agent, these packages are also installed from the various operating system repositories.

If the machine you're installing on has internet access, dependencies are set up during installation. If your machine doesn't have internet access, you must manually install dependencies.

All Nodes Master Nodes Console Nodes Console/Console DB Nodes
pciutils x
pmtools x
cron x
libxml2 x
net-tools x
libxslt x x x
curl x x
libjpeg x x
db43 x x
unixODBC x x
zlib x

Ubuntu dependencies

When you install PE or an agent, these packages are also installed from the various operating system repositories.

If the machine you're installing on has internet access, dependencies are set up during installation. If your machine doesn't have internet access, you must manually install dependencies.

All Nodes Master Nodes Console Nodes Console/Console DB Nodes
pciutils x
dmidecode x
cron x
libxml2 x
hostname x
libldap-2.4-2 x
libreadline5 x
file x x
libmagic1 x x
libpcre3 x x
curl x x
perl x x
mime-support x x
libcap2 x x
libjpeg62 x x
libxslt1.1 x
libgtk2.0-0 x x x
ca-certificates-java x x x
openjdk-7-jre-headless* x x x
libossp-uuid16 x x x
zlib x

*For Ubuntu 10.04 and Debian 6, use openjdk-6-jre-headless.

AIX dependencies and limitations

Before installing the agent on AIX systems, install these packages.

  • bash
  • zlib
  • readline
  • curl
  • OpenSSL
Warning: For cURL and OpenSSL, you must use the versions provided by the "AIX Toolbox Cryptographic Content" repository, which is available via IBM support. Note that the cURL version must be 7.9.3. Do not use the cURL version in the AIX toolbox package for Linux applications, as that version does not include support for OpenSSL.

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.

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:

  • 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:

  • system/readline
  • system/library/gcc-45-runtime
  • library/security/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 CentOS 6.0 to 7.0; it does not refer to a minor version upgrade, like CentOS 6.5 to 6.6. Major upgrades typically require a new version of PE.

  1. Back up your databases and other PE files.
  2. Perform a complete uninstall (using the -p and -d uninstaller options).
  3. Upgrade your operating system.
  4. Install PE.
  5. Restore your backup.
Back to top