Lab
A Cloud Guru

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.

Try for free Contact sales

Path Info

Level

Intermediate

Duration

30m

Published

Aug 02, 2019

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.

Author

A Cloud Guru

The Cloud Content team comprises subject matter experts hyper focused on services offered by the leading cloud vendors (AWS, GCP, and Azure), as well as cloud-related technologies such as Linux and DevOps. The team is thrilled to share their knowledge to help you build modern tech solutions from the ground up, secure and optimize your environments, and so much more!

What's a lab?

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.