Installing Puppet agent: Linux
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.
Install a release package to enable Puppet Platform 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 file and directory locations.
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
- Zypper –
sudo zypper 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 with the following command:
puppet config set server <MASTER FDQN> --section main.
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.