Search

Chapter 9. Enforcing Puppet configuration on hosts

download PDF

You can enforce configuration from Satellite either manually on demand (run once) or automatically in configurable intervals.

9.1. Running Puppet once using SSH

Assign the proper job template to the Run Puppet Once feature to run Puppet on hosts.

Procedure

  1. In the Satellite web UI, navigate to Administer > Remote Execution Features.
  2. Select the puppet_run_host remote execution feature.
  3. Assign the Run Puppet Once – SSH Default job template.

Run Puppet on hosts by running a job and selecting category Puppet and template Run Puppet Once - SSH Default. Alternatively, click Run Puppet Once in the Schedule Remote Job drop down menu on the host details page.

9.2. Understanding intervals of automatic enforcement

Satellite considers hosts to be out of sync if the last Puppet report is older than the combined values of outofsync_interval and puppet_interval set in minutes. By default, the Puppet agent on your hosts runs every 30 minutes, the puppet_interval is set to 35 minutes and the global outofsync_interval is set to 30 minutes.

The effective time after which hosts are considered out of sync is the sum of outofsync_interval and puppet_interval. For example, setting the global outofsync_interval to 30 and the puppet_interval to 60 results in a total of 90 minutes after which the host status changes to out of sync.

9.3. Setting the Puppet agent run interval on a host

Set the interval when the Puppet agent runs and sends reports to Satellite.

Procedure

  1. Connect to your host using SSH.
  2. Add the Puppet agent run interval to /etc/puppetlabs/puppet/puppet.conf, for example runinterval = 1h.

9.4. Setting the global out-of-sync interval

Procedure

  1. In the Satellite web UI, navigate to Administer > Settings.
  2. On the General tab, edit Out of sync interval. Set a duration, in minutes, after which hosts are considered to be out of sync.

    You can also override this interval on host groups or individual hosts by adding the outofsync_interval parameter.

9.5. Setting the Puppet out-of-sync interval

Procedure

  1. In the Satellite web UI, navigate to Administer > Settings, and click the Config Management tab.
  2. In the Puppet interval field, set the value to the duration, in minutes, after which hosts reporting using Puppet are considered to be out of sync.

9.6. Overriding out-of-sync interval for a host group

Procedure

  1. In the Satellite web UI, navigate to Configure > Host Groups.
  2. Select a host group.
  3. On the Parameters tab, click Add Parameter.
  4. In the Name field, enter outofsync_interval.
  5. From the Type dropdown menu, select integer.
  6. In the Value field, enter the new interval in minutes.
  7. Click Submit.

9.7. Overriding out-of-sync interval for an individual host

Procedure

  1. In the Satellite web UI, navigate to Hosts > All Hosts.
  2. Click Edit for a selected host.
  3. On the Parameters tab, click Add Parameter.
  4. In the Name field, enter outofsync_interval.
  5. From the Type dropdown menu, select integer.
  6. In the Value field, enter the new interval in minutes.
  7. Click Submit.
Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.