Skip to content

Latest commit

 

History

History
92 lines (89 loc) · 3.25 KB

proc_installing-and-configuring-puppet-agent-manually.adoc

File metadata and controls

92 lines (89 loc) · 3.25 KB

Installing and Configuring Puppet Agent Manually

You can install and configure the Puppet agent on a host manually. A configured Puppet agent is required on the host for Puppet integration with your {Project}. For more information about Puppet, see {ManagingConfigurationsPuppetDocURL}[{ManagingConfigurationsPuppetDocTitle}].

Prerequisites

  • The host must have a Puppet environment assigned to it.

  • Ensure a repository containing the Puppet agent is enabled on the host, for example apt.puppet.com or yum.puppet.com.

Procedure

  1. Log in to the host as the root user.

  2. Install the Puppet agent package.

    • On hosts running {EL} 8 and above:

      # dnf install puppet-agent

    • On hosts running {EL} 7 and below:

      # yum install puppet-agent

    • On hosts running Debian:

      # apt-get install puppet-agent

    • On hosts running SUSE Linux Enterprise Server:

      # zypper install puppet-agent

  3. Add the Puppet agent to PATH in your current shell using the following script:

    . /etc/profile.d/puppet-agent.sh

  4. Configure the Puppet agent. Set the environment parameter to the name of the Puppet environment to which the host belongs:

    # puppet config set server {foreman-example-com} --section agent
# puppet config set environment My_Puppet_Environment --section agent

  5. Start the Puppet agent service:

    # puppet resource service puppet ensure=running enable=true

  6. Create a certificate for the host:

    # puppet ssl bootstrap

  7. In the {ProjectWebUI}, navigate to Infrastructure > {SmartProxies}.

  8. From the list in the Actions column for the required {SmartProxyServer}, select Certificates.

  9. Click Sign to the right of the required host to sign the SSL certificate for the Puppet agent.

  10. On the host, run the Puppet agent again:

    # puppet ssl bootstrap