Troubleshooting the databases
If you have issues with the databases that support the
console, make sure that the PostgreSQL database is not too
large or using too much memory, that you don't have port conflicts, and that
puppet apply is configured correctly.
PostgreSQL is taking up too much space
autovacuum=on setting prevents the database
from growing too large and unwieldy. Routine vacuuming is turned on by default.
autovacuumis set to
PostgreSQL buffer memory causes installation to fail
When installing PE on machines with large amounts of RAM, the PostgreSQL database might use more shared buffer memory than is available.
/var/log/pe-postgresql/pgstartup.logshows the error:
FATAL: could not create shared memory segment: No space left on device DETAIL: Failed system call was shmget(key=5432001, size=34427584512,03600).
On the master, set the
shmmaxkernel setting to approximately 50% of the total RAM.
shmallkernel setting to the quotient of the new
shmmaxsetting divided by the page size. You can confirm page size by running
Set the new kernel settings:
sysctl -w kernel.shmmax=<your shmmax calculation> sysctl -w kernel.shmall=<your shmall calculation>
The default port for PuppetDB conflicts with another service
By default, PuppetDB communicates over port 8081. In some cases, this might conflict with existing services, for example McAfee ePolicy Orchestrator.
pe.confthat specifies a different port using
generates Ruby errors after connecting
puppet apply to PuppetDB
If Puppet apply is
configured incorrectly, for example by modifying
puppet.conf to add the parameters
storeconfigs_backend = puppetdb and
storeconfigs = true in both the main and master sections,
puppet resource ceases to function and displays a Ruby run error.
/etc/puppetlabs/puppet/routes.yamlto correctly connect Puppet apply without affecting other functions.