This page lists known issues for platforms supported in Puppet Enterprise.
Puppet agents running RHEL 7 or Ubuntu 16.04 on IBM POWER8 hardware do not use Ruby gems correctly, preventing the MCollective service from starting. This issue will be resolved in an upcoming release.
PE does not currently support Ubuntu 16.10 agent installs using package management. If you need to install an Ubuntu 16.10 agent, log into the node where you want to install the agent and run the following command:
wget https://apt.puppetlabs.com/puppetlabs-release-pc1-yakkety.deb
sudo dpkg -i puppetlabs-release-pc1-yakkety.deb
After upgrading a Solaris agent, the PXP agent service may not properly restart. To restart the Puppet agent, run Puppet again or wait until the next timed run.
We’ve discovered an issue in which customers on some Ubuntu 14.04 amd64 platforms, such as on a Fusion VM or in Amazon EC2 cannot properly install or upgrade to PE 2015.2. Depending on your situation, the current workarounds are available:
You will need to install the libc6-dev package on the machine you’ve assigned the Puppet master component.
On the machine assigned the Puppet master component, install the libc6-dev package.
Run sudo apt-get install --no-install-recommends libc6-dev
.
Follow the PE installation process or upgrade process as normal.
If you have attempted a brand new install and are in a broken state, perform the following steps:
From the directory where you unpacked the Puppet Enterprise tarball, run sudo ./puppet-enterprise-uninstall -pd
.
On the machine assigned the Puppet master component, install the libc6-dev package.
Run sudo apt-get install --no-install-recommends libc6-dev
.
Follow the PE installation process as normal.
If you have already attempted to upgrade, are now in a broken state and have a backup, perform the following steps:
On the machine assigned the Puppet master component, install the libc6-dev package.
Run sudo apt-get install --no-install-recommends libc6-dev
.
If you have already attempted to upgrade, are now in a broken state and do not have a backup:
On the machine assigned the Puppet master component, install the libc6-dev package.
Run sudo apt-get install --no-install-recommends libc6-dev
.
Still on the Puppet master, change your PE version to the version number you were upgrading from.
Run sudo sh -c 'echo "<VERSION UPGRADING FROM>" > /opt/puppet/pe_version'
Note that the PE installer script has a check to ensure we do not attempt to upgrade/install if the same version is already installed.
Run the upgrade again.
AIX 5.3 Puppet agents depend on readline-4-3.2 being installed. You can check the installed version of readline by running rpm -q readline
. If you need to install it, you can download it from IBM. Install it before installing the Puppet agent.
On AIX 6.1 and 7.1, the default version of readline, 4-3.2, is insufficient. You need to replace it before upgrading or installing by running
rpm -e --nodeps readline
rpm -Uvh readline-6.1-1.aix6.1.ppc.rpm
If you see an error message after running this, you can disregard it. Readline-6 should be successfully installed, and you can proceed with the installation or upgrade (you can verify the installation with rpm -q readline
).
We’ve seen an issue in which Puppet agents on Solaris platforms have quit responding after the core Solaris OS was updated. Essential Puppet configuration files were erased from the /etc/
directory (which includes SSL certs needed to communicate with the Puppet master), and the /etc/hosts
file was reverted.
If you encounter this issue, log in to the Puppet master and clear the agent cert from the Solaris machine (puppet cert clean <HOSTNAME>
), and then re-install the Puppet agent.
symlink
directorySolaris 10 and 11 will not by default have the symlink
directory in their path. Therefore, if you use one of these two platforms, add /usr/local/bin
to your default path.
On some versions of Debian/Ubuntu, the default /etc/hosts
file contains an entry for the machine’s hostname with a local IP address of 127.0.1.1. This can cause issues for PuppetDB and PostgreSQL, because binding a service to the hostname causes it to resolve to the local-only IP address rather than its public IP. As a result, nodes (including the console) will fail to connect to PuppetDB and PostgreSQL.
To fix this, add an entry to /etc/hosts
that resolves the machine’s FQDN to its public IP address. This should be done prior to installing PE. However, if PE has already been installed, restarting or reloading the pe-puppetdb
and pe-postgresql
services after adding the entry to the hosts file should fix things.
If you attempt to install and start Samba using PE resource management, you might encounter the following errors:
Error: /Service[smb]: Could not evaluate: Could not find init script or upstart conf file for 'smb'`
Error: Could not run: Could not find init script or upstart conf file for 'smb'`
To work around this issue, install and start Samba with the following commands:
puppet resource service smbd provider=init enable=true ensure=running
puppet resource service nmbd provider=init enable=true ensure=running
Or, add the following to a Puppet manifest:
service { 'smbd':
ensure => running,
enable => true,
provider => 'init',
}
service { 'nmbd':
ensure => running,
enable => true,
provider => 'init',
}
On AIX agents, the Augeas lens is unable to access or modify /etc/services
. There is no known workaround.
Puppet will automatically expand variables in a system path.
For example, this path:
PATH=%SystemRoot%\System32
Will be expanded, as follows:
PATH=C:\Windows\System32
This should not cause any problems.
This applies if:
You run a PE agent on Windows with non-admin privileges and attempt to create a file without the correct access.
You run a PE agent on Windows with non-admin privileges and attempt to create a registry key.
If you run the puppet agent on Windows without admin privileges, you are subject to Microsoft’s file and registry virtualization. Essentially, this means that if you create any Puppet agent reporting resources (e.g., files or registry keys) in privileged locations, Windows redirects them to the current user’s VirtualStore.