Puppet Enterprise 2018.1

These are the known issues for configuration and maintenance in this release.

Restore fails if /tmp folder is too small

When restoring a master using puppet backup restore, the /tmp folder is always used as the temporary location for unpacking PostgreSQL dumps. If /tmp doesn't have enough space to hold these dumps, the restore fails. Additionally, attempting to use a different temp directory by setting the TMPDIR environment variable does not work correctly.

Restore resets master DNS altnames

When restoring a master using puppet backup restore, pe_install::puppet_master_dnsaltnames is reset as an array with only the certname of the restore host. As a workaround, after the restore is complete, modify pe_install::puppet_master_dnsaltnames in pe.conf as needed, then complete the monolithic master certificate regeneration process.

 

Restoring the pe-rbac database fails with the puppet-backup restore command

When restoring the pe-rbac database, the restore process exits with errors about a duplicate operator family, citext_ops.

To work around this issue: 
  1. Log into your existing PostgreSQL instance: 
    sudo su - pe-postgres -s /bin/bash -c "/opt/puppetlabs/server/bin/psql pe-rbac"
  2. Issue these commands: 
    ALTER EXTENSION citext ADD operator family citext_ops using btree; 
    ALTER EXTENSION citext ADD operator family citext_ops using hash
  3. Exit the PostgreSQL shell and re-run the backup utility.

puppet-backup fails if gems are missing from the master's agent environment

The puppet-backup create command might fail if any gem installed on the Puppet Server isn't present on the agent environment on the master. If the gem is either absent or of a different version on the master's agent environment, you'll get the error "command puppet infrastructure recover_configuration failed".

To fix this, you'll need to install any missing or incorrectly versioned gems on the master's agent environment. To find which gems are causing the error, check the backup logs for any gem incompatibility issues with the error message. PE creates backup logs as a report.txt whenever you run a puppet-backup command.

To see what gems and their versions you have installed on your Puppet Server, run the command puppetserver gem list . To see what gems are installed in the agent environment on your master, run /opt/puppetlabs/puppet/bin/gem list.

Back to top
The page rank or the 1 our of 5 rating a user has given the page.
The email address of the user submitting feedback.
The URL of the page being ranked/rated.