[satellite6] puppet agent too slow or timeout

Solution Verified - Updated

Environment

  • Red Hat Satellite 6

Issue

Puppet agent run on client take too long time or it can timeout.

Resolution

Verify how many instances of puppetserver running on Satellite or Capsule used by client

# grep max-active-instances /etc/puppetlabs/puppetserver/conf.d/puppetserver.conf
    max-active-instances: 1

Tuning heavily depends on how much is puppet used, but basic recommendation is to have at least 2 instances to be able to handle 2 requests at same time and max vCPU count.
Every instance consume additional memory so be careful about adding new instances.

To check vCPU count

# cat /proc/cpuinfo  | grep ^processor | wc -l
8

Set max-active-instances to suitable count on Satellite or used Capsule and restart services

# satellite-installer --puppet-server-max-active-instances 4
# foreman-maintain service restart

For more KB articles/solutions related to Red Hat Satellite 6.x Puppet Issues, please refer to the Red Hat Satellite Consolidated Troubleshooting Article for Red Hat Satellite 6.x Puppet Issues

Root Cause

One of possible reasons may be too low puppetserver instances on Satellite or Capsule used by client.
If the count is too low puppetserver may be overloaded by concurrency requests from clients.
To explain for example if you have just 1 instance when 2 clients will make requests at same time one of them need to wait until 1st request will be finished which may end in long run or even timeout.

Diagnostic Steps

Verify how many instances of puppetserver running on Satellite or Capsule used by client

# grep max-active-instances /etc/puppetlabs/puppetserver/conf.d/puppetserver.conf
    max-active-instances: 1

To check vCPU count

# cat /proc/cpuinfo  | grep ^processor | wc -l
8
SBR
Product(s)
Components
Category
Tags

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.