Troubleshooting installation

This release was removed from general availability due to upgrade issues.
Docs for the latest available release are here.
This version is out of date. For current versions, see Puppet Enterprise support lifecycle.
Sections

If installation fails, check for these issues.

Note: If you encounter errors during installation, you can troubleshoot and run the installer as many times as needed.

DNS is misconfigured

DNS must be configured correctly for successful installation.
  1. Verify that agents can reach the primary server hostname you chose during installation.

  2. Verify that the primary server can reach itself at the primary server hostname you chose during installation.

  3. If the primary server and console components are on different servers, verify that they can communicate with each other.

Security settings are misconfigured

Firewall and security settings must be configured correctly for successful installation.
  1. On your primary server, verify that inbound traffic is allowed on ports 8140 and 443.

  2. If your primary server has multiple network interfaces, verify that the primary server allows traffic via the IP address that its valid DNS names resolve to, not just via an internal interface.

Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.