Install the Puppet agent so that your master can communicate with your Linux nodes.
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
PATH environment variable by default.
The executable path doesn’t matter for Puppet services — for instance,
service puppet start works regardless of the
PATH — but if you’re running interactive
puppet commands, you must either add their location to your
PATH or execute them using their full path.
To quickly add the executable location to your
PATH for 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
.bashrc configuration files.
For more information, see details about file and directory locations.
puppet-agent package on your Puppet agent nodes using the command appropriate to your system:
sudo yum install puppet-agent
sudo apt-get install puppet-agent
sudo zypper install puppet-agent
(Optional) Configure agent settings.
For example, if your master isn’t reachable at the default address,
server = puppet, set the
server setting 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.