- 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.
Path Info
Table of Contents
-
Challenge
Attempt to Install Puppet Enterprise
- Attempt to run the installer and access the graphical install:
cd puppet-enterprise-2018.1.7-el-7-x86_64/ sudo ./puppet-enterprise-installer
- 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
- Check the status of the firewall:
$ sudo firewall-cmd --state
- 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
- 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
- Return to the console and run the installer. We should see Puppet Enterprise install this time.
- Attempt to run the installer again. This time the graphical installer works, but Puppet cannot connect to
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.
Provided environment for hands-on practice
We will provide the credentials and environment necessary for you to practice right within your browser.
Guided walkthrough
Follow along with the author’s guided walkthrough and build something new in your provided environment!
Did you know?
On average, you retain 75% more of your learning if you get time for practice.