Troubleshooting a Puppet Install

30 minutes
  • 3 Learning Objectives

About this Hands-on Lab

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.

Learning Objectives

Successfully complete this lab by achieving the following learning objectives:

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
  2. When we try to access the console, it will time out. Return to the command line and cancel the installer with (CTRL+C).
Check the Firewall
  1. Check the status of the firewall:

    $ sudo firewall-cmd --state
  2. 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
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
  2. Return to the console and run the installer. We should see Puppet Enterprise install this time.

Additional Resources

Your team has been tasked with setting up a Puppet Enterprise installation. A server has been provided for use as the Puppet Enterprise master, but a coworker is unable to get the graphical install running.

Take over for your coworker and perform the needed tasks to get the Puppet Enterprise installer up and running.

What are Hands-on Labs

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.

Sign In
Welcome Back!

Psst…this one if you’ve been moved to ACG!

Get Started
Who’s going to be learning?