Featured resource
2025 Tech Upskilling Playbook
Tech Upskilling Playbook

Build future-ready tech teams and hit key business milestones with seven proven plays from industry leaders.

Check it out
  • Lab
    • Libraries: If you want this lab, consider one of these libraries.
    • Cloud
Google Cloud Platform icon
Labs

Troubleshooting Puppet Communication

In an ideal world, we would be able to provision our hosts and have things work consistently without problems every day ― but that is not the case because a system that is completely immune to all issues does not exist. In this hands-on lab, we explore the reasons why a node with the Puppet agent is unable to connect to our Puppet master. We will start this lesson by ensuring that there are no connection issues overall and then explore using the certificate authority to confirm if any conflicting certificates are preventing the node from connecting. Once the problem is tracked down, we will take the appropriate steps to fix the communication issue and connect our node to the Puppet master.

Google Cloud Platform icon
Lab platform
Lab Info
Level
Intermediate
Last updated
Sep 13, 2025
Duration
30m

Contact sales

By filling out this form and clicking submit, you acknowledge our privacy policy.
Table of Contents
  1. Challenge

    Replicate the Issue
    1. Install Puppet on the node1 Ubuntu node using the one-command installer:

       $ curl -k https://puppet.ec2.internal:8140/packages/current/install.bash | sudo bash
      
    2. On the master, attempt to approve the cert:

      $ sudo puppetserver ca sign --all
      
  2. Challenge

    Discover the Root of the Issue
    1. Since we know that the node can connect to the Puppet master thanks to the installation command's success, we know the issue isn't related to a firewall or with any inter-node communications. So, let's see if our status message for the puppet service tells us anything (make sure to work from the node1 node):

       $ sudo systemctl status puppet | less
      
    2. Now, from the master, list the available cert information:

      $ sudo puppetserver ca list --all
      

      The output informs us of a revoked certificate's node that is identical to the one we've been working with. We've tracked down the problem!

  3. Challenge

    Solve the Issue
    1. Clean the original cert from the master:

      $ sudo puppetserver ca clean --certname node1.ec2.internal
      
    2. Remove existing certificate information from the node1 node:

      $ sudo -i
      ~# rm -r $(puppet agent --configprint ssldir)
      
    3. Generate new certs for the node:

      ~# puppet agent -t
      
    4. Sign the cert on the master:

      $ sudo puppetserver ca sign --certname node1.ec2.internal
      
    5. It is optional, but we can confirm it worked by performing a puppet run against the node:

      ~# puppet agent -t
      
About the author

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.

Get started with Pluralsight