Configuring Client CPU Utilization

How to configure the amount of CPU the BigFix client uses on an endpoint machine.

Applies to

BigFix Platform


CPU utilization by the BigFix client and how to govern the amount of CPU the BigFix client uses.


The amount of CPU the BigFix client uses on an endpoint machine during the evaluation cycle is governed by the following two client settings:

  • _BESClient_Resource_WorkIdle
  • _BESClient_Resource_SleepIdle

By default, the _BESClient_Resource_WorkIdle setting is set to 10 and the _BESClient_Resource_SleepIdle setting is set to 480.

The BigFix client will do work (evaluate relevance) for a designated amount of time then go to sleep for a designated amount of time. The WorkIdle setting controls how many milliseconds to work before going to sleep in each cycle and the SleepIdle setting controls how many milliseconds to sleep after performing work in cycle. If the WorkIdle setting is high in comparison to the SleepIdle setting, then the BigFix client will evaluate Fixlet relevance faster, but the CPU usage will be higher. By default, WorkIdle is 10 milliseconds and SleepIdle is 480 Milliseconds. Since 10 is 2% of 480 you can expect the BigFix client to use at most 2% of the CPU. Both WorkIdle and SleepIdle have maximum values of 500.

To determine the upper bound on the amount of CPU the agent will use with your custom settings, use the formula:

Max agent %CPU = workidle / (workidle + sleepidle)

Example (default settings): 10 / (10 + 480) = 2%

You can easily manage these settings and adjust the amount of CPU the BigFix client will use via Task # 168 in the BES Support site.

The task offers you the ability to set the client CPU usage to any of 5 different modes (using 5 different actions and preset values in the action script).

_BESClient_Resource_WorkIdle _BESClient_Resource_SleepIdle CPU Mode CPU Upper bound
2 500 very low < 0.5%
10 480 default < 1-2%
25 460 medium < 5%
50 450 high < 10%
100 400 very high < 20%

All of these calculations apply to the single processor where the agent runs, so if you have multiple processors the overall % of agent CPU is reduced significantly because it is divided by the number of processors. For example, if you want your agent to use less than 5% of CPU and the relevance 'number of processors' returns 4, you must set workidle to 100 and sleepidle to 400 because [100 / (100 + 400)] / 4 = 5%.

In case of a system with a single processor, the CPU Mode to a value different from the default is Not Recommended.

For AIX components using an LPAR:

  • Max agent % CPU calculation for AIX LPAR with Entitled Capacity for Mode of Uncapped and Mode of Capped.
  • - Usage _BESClient_Resource_Entitlement=100 for AIX LPARs with mode of Uncapped can be considered to use to eliminate reduction of Max Agent CPU% by Entitled Capacity.

For the behavior of pSeries Hypervisor see the example below:

With Mode: Uncapped, Entitled Capacity : 0.10, if the AIX LPAR uses 0.10 CPU core, then 100% usage. If the physical CPU cores in the

pSeries pool are not fully utilized, then pSeries hypervisor will allow the AIX LPAR to use more of CPU cores. You can also use pSeries LPAR weighting to give certain AIX LPARs like production higher priority for CPU resources than other AIX LPARs like development.

BigFix computer settings _BESClient_Resource_WorkNormal, _BESClient_Resource_SleepNormal when the BigFix agent is running a task that can be set.

Questions and Answers:

Question 1:

For Red Hat, SLES, Windows:

Max agent % CPU = workidle / (workidle + sleepidle)

0.0476 = 20 / (20 + 400)

0.0476 x 100 = 4.76%


_BESClient_Resource_WorkIdle Statement "The "Entitled Capacity : 0.10," means we have 1/10th of a CPU so all calculations for the workidle/sleepidle need to have 0.1 multiplied against them as the system has told us we have 10% of a full CPU."

For AIX LPARs is the calculation the following?

Max agent % CPU = (workidle / (workidle + sleepidle) ) x Entitled


0.00476 = (20 / (20 + 400)) x 0.10

0.00476 x 100 / = 0.476% of CPU available to AIX LPAR can be used


It is true that the BigFix Max agent % CPU with be multiplied by the AIX LPAR Entitled Capacity to further reduce BigFix Max agent % CPU for AIX LPARs with mode of Uncapped or mode of Capped. The BigFix Max agent % CPU is based on a single physical CPU core.

Question 2:

For AIX LPAR with Mode: Uncapped from lparstat -i, can I turn off lparstat -i Entitled Capacity to reduce Max agent %CPU by setting the BigFix AIX computer _BESClient_Resource_Entitlement to 100?



Question 3:

For BigFix agent on AIX LPAR with _BESClient_Resource_Entitlement to 100, will the behaviour be the same as Linux on Intel and Windows on VMware for limiting Max agent %CPU to a single physical CPU core?



There is also BigFix computer setting _BESClient_Resource_WorkNormal, _BESClient_Resource_SleepNormal when the BigFix agent is running a task that can be set.

Question 4:

Why BigFix Client process keeps on using high CPU% after the completion of the action?


BigFix Client leaves on using high CPU% when it has no more actions to run and has completed an evaluation of the action sites.

  • Test these settings on a limited set of endpoint machines before deploying them to the majority of your deployment endpoint machines.
  • In practice, the CPU usage is typically lower than this ratio (because the agent will often be waiting for IO and it will yield its CPU time).
  • If you adjust the CPU usage away from the default and experience issues, switch the CPU usage back to the default values.
  • These CPU settings strictly govern BES Client evaluating content in the evaluation mode of the client's cycle. The BigFix agent might use up to 50% of the CPU at times during the execution parts of its operation (i.e. initiating an install). These CPU spikes are normal and are expected to be short lived to where they would not be typically noticeable. If the BES Client experiences a sustained CPU spike it may mean there is a problem in the client executing on a problematic action or a systemic issue. This would need to be investigated and the problem determined through analyzing the BigFix Client logs and/or BigFix Client debug log.

Allowing the clients to use additional CPU to complete download operations

After download actions, the BigFix Client performs the sha code evaluation on downloaded files. For large files, the time taken to evaluate can become very long, especially on a BigFix Client constrained to default 2% CPU. The optimization of this time is achieved by allowing the BigFix Client to temporarily use additional CPU during this operation.

Starting from Patch 2, you can speed up the operations to evaluate the sha code in downloaded files by temporarily directing the BigFix Client to use additional CPU. This results in a consistent time optimization for the download phase as the time required for the evaluation decreases as the CPU used increases.

The _BESClient_Resource_WorkFastHashVerify and _BESClient_Resource_SleepFastHashVerify configuration settings allow you to manage the amount of CPU that the BigFix Client can use.

For more details about these settings, see CPU Usage.

The _BESClient_Download_FastHashVerify configuration setting enables the BigFix Client to temporarily use additional CPU for the Hash Code Evaluation (default increase to 25%).

For more details about the setting, see Download.