direct.agent.load.size

Use this parameter to configure the number of direct agents that can be loaded by Management Server. This configuration applies during Management Server restart or when a host is added or removed from CloudStack.

Default Value

Default value of the direct.agent.load.size parameter is 16. Use this value if you are using less than 50 hosts.

Scope

Global

Category

Performance

Behavior

To easily connect hosts to CloudStack, you must set an optimal value to the direct.agent.load.size parameter. The number of hosts in your CloudStack environment decides the value that you want to set for this parameter.

If you set too low a value to this parameter, you will experience inordinate delay in connecting hosts on Management Server restart. If the value that you set is too high, Management Server may consume the entire thread pool, which will slow down the host connections.

Example

For example, if you have 100- 500 hosts in your CloudStack environment, you can set the value for the direct.agent.load.size parameter to 50. If you have 15000 to 20000 hosts, you should set the value of this parameter to 1000.

The following table lists the optimal values that you can set to the direct.agent.load.size parameter for host pools with various sizes:

Notes

In the Management Server logs, the tasks that direct agent threads handle are prefixed with AgentTaskPool. This provides an easy way for you to identify them while debugging.

Impact on APIs

Nil

Related Configuration Parameters

direct.agent.scan.interval