Agent install quick start guide
After installing a PE master, you’re ready to install Puppet agents on Windows nodes. This guide walks you through the steps, which are different from the steps to install agents on *nix nodes.
Important: The Puppet master component, described in the “PE Install Quick Start Guide,” must be run on a supported Linux machine.
For more information about Puppet agents, as well as the components that make up your PE deployment, visit the installation overview in the PE docs.
For more information about Windows Puppet agents, including additional installation choices, refer to Installing Windows Agents.
Install Windows Puppet Enterprise agents
The PE Windows installer is a standard Windows .msi package and will run as a graphical wizard.
The installer must be run with elevated privileges. Installing Puppet does not require a system reboot.
Before you begin: Install a monolithic PE deployment so that the Puppet master, the PE console, and PuppetDB all run on one node. In addition, check that you’re working with a supported version of Windows.
Download and run the installer.
When prompted by the install dialog, provide the hostname of your Puppet master server.
Load a list of currently pending node requests by clicking Unsigned Certs.
Click Accept All to approve the requests and add the node. The Puppet agent can now retrieve configurations from the master the next time Puppet runs.
After you install a Puppet agent, you can automatically configure and manage your node.
Puppet agent runs as a Windows service, and fetches and applies configurations every 30 minutes (by default). You can now assign classes to the node; see Getting started with classification for more details. After the first Puppet run, the MCollective service will also run and the node can now be controlled with MCollective. The Puppet agent service and the MCollective service can be started and stopped independently using either the service control manager UI or the command line
sc.exeutility; see Running Puppet on Windows for more details.
The Start Menu contains a Puppet folder, with shortcuts for running Puppet agent manually, running Facter, and opening a command prompt for use with the Puppet tools. See [Running Puppet on Windows][running] for more details.
Puppet is automatically added to the machine’s PATH environment variable. This means you can open any command line and call
facterand the few other batch files that are in the
bindirectory of the Puppet installation. This will also add necessary items for the Puppet environment to the shell, but only for the duration of execution of each of the particular commands.
Next: Module install