Docs Grey arrow pointing right Puppet Enterprise Grey arrow pointing right Troubleshooting Grey arrow pointing right Troubleshooting installation Grey arrow pointing right

Troubleshooting installation

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.