This guide describes the process for installing a Puppet Enterprise master and agent. A master is the node that controls configuration information. An agent is the node that the master controls, such as a Windows machine. The two communicate via HTTPS with client verification. You can find out more about master and agent architecture in the Puppet architecture documentation.
Puppet masters can only run on *nix machines, but Windows machines can run as Puppet agents. For this reason, this guide shows you how to use a Windows machine to install a Puppet master on a Linux server and then install a Puppet agent on your Windows machine. In total you will:
To perform these steps, you’ll need a Windows machine and a Linux server. The following examples use a Linux server running Red Hat Enterprise Linux (RHEL) 6.
Your Linux machine (aka the Puppet master) will need:
On your Windows machine:
Before you can manage a machine running the Windows operating system, you must first install the Puppet master on a Linux server, because the Puppet master cannot run on Windows.
After you install the Puppet master, you will install PE on your Windows machine.
rootuser, or as a user that has sudo privileges.
Tip: Although the method for doing so depends on both the OS and cloud/virtualization platform you’re using, you can ensure this port is open by disabling
iptables, as shown in the following example.
tar -xvf puppet-enterprise-2015.2.0-*.
yto install the necessary packages to perform a guided installation. A message says, “Installing setup packages,” and then another message tells you to go to a URL in your browser. For example, “https://master.inf.puppetlabs.demo:3000”.
Note: From this point the examples will refer to your Linux Machine as the Puppet master.
Important: Your Puppet agents will identity the Puppet master via its alias, so you must identify this correctly. The default is “puppet”.
Note: The installer takes several minutes to complete.
Congratulations! You have successfully installed the Puppet Enterprise master!
When you log into the web UI, you’re taken to the Overview page. This page shows a list of all of the machines that have a PE agent installed on them and are communicating with your Puppet master. The Puppet master itself has an agent installed so that Puppet can keep it configured correctly—that’s why you see it here in this list.
After you install a Puppet agent in the next example, it will check in with the Puppet master, and once you give the OK to have that agent communicate with the Puppet master, the machine that that agent is running on will show up in the Overview list as well.
In the following steps, you’ll install a Puppet agent on your Windows machine. However, before you can install the agent, you have to configure the Puppet master so that it has the correct agent installer for your system.
windowsand select the architecture that matches your Windows machine.
Note: Running 32-bit Puppet agent on a 64-bit Windows system is now deprecated. Update your Puppet installation to the 64-bit platform.
puppet agent -t. This Puppet run will download the Puppet agent for Windows onto your Puppet master.
https://<YOUR PUPPET MASTER HOSTNAME>:8140/packages/current/windows-x86_64/puppet-agent-x64.msi. This will download the .msi package you need to install the Puppet agent on your Windows machine.
puppet agent -t.
Whether you run Puppet manually, or wait for it to run as part of the regular 30 minute run, on first installing an agent, a certificate signing request (CSR) is created. You must sign the certificate for that agent before the install is complete and the node can be managed.
Now that you’ve finished installing PE and a Windows agent, you’re ready to see what you can do with Puppet. Go to Managing Windows configurations to learn how to automate managing services, scheduling tasks, managing users and groups, and more. See Installing and using Windows modules to take advantage of pre-existing modules—essentially, Puppet code solutions—that jump-start additional automation tasks.