Troubleshooting a Puppet Install

Libraries: If you want this lab, consider one of these libraries.
Cloud

Troubleshooting a Puppet Install

The Puppet installation process can be quite simple — as long as everything is set up properly to begin with. However, when we go to perform what should be simple tasks, things can go wrong. In this hands-on lab, we will explore what happens when our Puppet Enterprise install doesn't go the way we expect it to. We will also examine what steps we can take to pinpoint the problem, fix it, and then get Puppet back to an operational state.

Get started Contact sales

Lab Info

Level

Intermediate

Last updated

May 23, 2025

Duration

30m

Challenge

Attempt to Install Puppet Enterprise
1. Attempt to run the installer and access the graphical install:
```
cd puppet-enterprise-2018.1.7-el-7-x86_64/
sudo ./puppet-enterprise-installer
```
1. When we try to access the console, it will time out. Return to the command line and cancel the installer with (CTRL+C).
Challenge

Check the Firewall
1. Check the status of the firewall:
```
$ sudo firewall-cmd --state
```
1. Since the firewall is being enforced, we cannot access the installer. Let's assume we will update our firewall ports via a Puppet post-install, so just stop it using the following firewalld commands:
```
$ sudo systemctl stop firewalld
$ sudo systemctl disable firewalld
```
Challenge

Check the Hosts File
1. Attempt to run the installer again. This time the graphical installer works, but Puppet cannot connect to puppet.ec2.internal. We need to update the /etc/hosts file:
```
$ sudo vim /etc/hosts

127.0.0.1   puppet.ec2.internal localhost localhost.localdomain localhost4 localhost4.localdomain4
```
1. Return to the console and run the installer. We should see Puppet Enterprise install this time.

About the author

Pluralsight Skills

Pluralsight Skills gives leaders confidence they have the skills needed to execute technology strategy. Technology teams can benchmark expertise across roles, speed up release cycles and build reliable, secure products. By leveraging our expert content, skill assessments and one-of-a-kind analytics, keep up with the pace of change, put the right people on the right projects and boost productivity. It's the most effective path to developing tech skills at scale.

Real skill practice before real-world application

Hands-on Labs are real environments created by industry experts to help you learn. These environments help you gain knowledge and experience, practice without compromising your system, test without risk, destroy without fear, and let you learn from your mistakes. Hands-on Labs: practice your skills before delivering in the real world.

Learn by doing

Engage hands-on with the tools and technologies you’re learning. You pick the skill, we provide the credentials and environment.

Follow your guide

All labs have detailed instructions and objectives, guiding you through the learning process and ensuring you understand every step.

Turn time into mastery

On average, you retain 75% more of your learning if you take time to practice. Hands-on labs set you up for success to make those skills stick.