This page lists known issues for installations and upgrades in Puppet Enterprise.
If you attempt to install Puppet Enterprise on a system that uses UTF-8 characters in path or file names, installation fails with a message indicating errors in the pe.conf file.
If you need to install PE on SLES 12 (SP1 or SP2), use the text-mode installation method, as this platform is not currently supported by the web-based installer.
PE does not currently support Ubuntu 16.10 agent installs using package management. If you need to install an Ubuntu 16.10 agent, perform the following steps:
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 downloading the package, update the apt package lists.
Install the Puppet agent.
apt-get install puppet-agent
puppet_enterprise::profile::database::manage_kernel_shmmax parameter is no longer used and has been removed. If you are upgrading and have this parameter set in your PE PuppetDB node group, you will receive an error message on your database node when you run the Puppet agent after the upgrade. You can safely remove this parameter from the classifier.
In some cases when attempting to install PE, some master platforms have received SSL errors when attempting to connect to s3.amazonaws.com, and thus have been unable retrieve puppet-agent packages needed for installation. In most cases, you should be able to properly install after updating the CA cert bundle on the master platform. To update the bundle, run the following commands:
rm /etc/ssl/certs/ca-bundle.crt yum reinstall ca-certificates
After updating the CA bundle, run the PE installer again.
If, during a split upgrade, you supply incorrect database credentials (specifically, incorrect database names, user names, or passwords for the databases associated with the PE console), the upgrade process will fail with a confusing error message. In most cases, ensure you have the correct database credentials and rerun the upgrader. The credentials can be found on the PuppetDB node at
When a PE installation fails because a system is not provisioned with adequate RAM, the web-based installer stops responding when verifying that PE is functioning on the server, but the installation appears to have succeeded, as the Start using Puppet Enterprise button is available. Note that in such cases, the command line shows an “out of memory: Kill process” error.
We recommend provisioning the system with adequate RAM and re-running the installation. Refer to the hardware recommendations.
If you’re upgrading, ensure that any Hiera YAML files do not include hard tabs for indentation. Hard tabs in these files will cause errors after upgrading.
To prevent potential failures, you should set an umask value of
0022 on your Puppet master.
Any entries in
/etc/puppetlabs/puppet/autosign.conf that don’t conform to the autosign requirements will cause the upgrade to fail to configure the PE console. Please correct any invalid entries before upgrading.
If your Puppet master uses a proxy server to access the internet, you may not be able to download the
pe_repo packages for the agent. In the case that you’re using a proxy, follow this workaround:
Tip: The following steps should be performed on your Puppet master (and, if you have a large environment installation, on all your compile masters as well).
/etc/sysconfig/, and create a file called
puppet add the following lines:
export http_proxy <YOUR_PROXY_SERVER> export https_proxy <YOUR_PROXY_SERVER>
puppet service with the following commands:
puppet resource service puppet ensure=stopped puppet resource service puppet ensure=running
database_hostcannot be an alt name for upgrades or installs
PostgreSQL does not support alt names when set to
verify_full. If you are upgrading or installing in text-mode, make sure
puppet_enterprise::database_host is set as the Puppet agent certname for the database node and not set as an alt name.