Installing Puppet agent: Linux
Included in Puppet Enterprise 2017.2.
Install the Puppet agent so that your master can communicate with your Linux nodes.
Before you begin: Review the pre-install tasks and installing Puppet Server. If you’re familiar with Puppet 3 and earlier, learn about new locations for many of the files and directories by reading a summary of changes in Puppet 4 or referring to the full specification of Puppet directories. Install the release package for your OS to enable Puppet Collection repositories.
Confirm that you can run Puppet executables.
The location for Puppet’s executables is
/opt/puppetlabs/bin/, which is not in your
PATHenvironment variable by default.
The executable path doesn’t matter for Puppet services — for instance,
service puppet startworks regardless of the
PATH— but if you’re running interactive
puppetcommands, you must either add their location to your
PATHor execute them using their full path.
To quickly add the executable location to your
PATHfor your current terminal session, use the command
export PATH=/opt/puppetlabs/bin:$PATH. You can also add this location wherever you configure your
PATH, such as your
For more information, see details about files and directories moved in Puppet 4.
puppet-agentpackage on your Puppet agent nodes using the command appropriate to your system:
- Yum –
sudo yum install puppet-agent.
- Apt –
sudo apt-get install puppet-agent.
- Yum –
(Optional) Configure agent settings.
For example, if your master isn’t reachable at the default address,
server = puppet, set the
serversetting to your Puppet master’s hostname.
For other settings you might want to change, see a list of agent-related settings.
sudo /opt/puppetlabs/bin/puppet resource service puppet ensure=running enable=true.
(Optional) To see a sample of Puppet agent’s output and verify any changes you may have made to your configuration settings in step 5, manually launch and watch a Puppet run:
sudo /opt/puppetlabs/bin/puppet agent --test
Sign certificates on the certificate authority (CA) master.
On the Puppet master:
sudo /opt/puppetlabs/bin/puppet cert listto see any outstanding requests.
sudo /opt/puppetlabs/bin/puppet cert sign <NAME>to sign a request.
As each Puppet agent runs for the first time, it submits a certificate signing request (CSR) to the CA Puppet master. You must log into that server to check for and sign certificates. After an agent’s certificate is signed, it regularly fetches and applies configuration catalogs from the Puppet master.