Try our new documentation site (beta).
TuneDynamicJobs
Dynamic distributed tuning job count
| Type: | int | |
|---|---|---|
| Default value: | 0 | |
| Minimum value: | -1 | |
| Maximum value: | MAXINT |
Enables distributed parallel tuning, which can significantly increase the
performance of the tuning tool. A value of n causes the tuning tool
to use a dynamic set of up to n workers in parallel. These workers
are used for a limited amount of time and afterwards potentially released
so that they are available for other remote jobs. A value of -1
allows the solver to use an unlimited number of workers. Note that this
parameter can be combined with TuneJobs
to get a static set of workers and a dynamic set of workers for distributed
tuning. You can use the WorkerPool
parameter to provide a distributed worker cluster.
Note that distributed tuning is most effective when the worker machines have similar performance. Distributed tuning doesn't attempt to normalize performance by server, so it can incorrectly attribute a boost in performance to a parameter change when the associated setting is tried on a worker that is significantly faster than the others.
One important note about integer-valued parameters: while the maximum
value that can be stored in a signed integer is 
, we use a
MAXINT value of 2,000,000,000. Attempting to set an integer
parameter to a value larger than this maximum will produce an error.
For examples of how to query or modify parameter values from our different APIs, refer to our Parameter Examples.
