Manage settings

The General settings panel displays the list of global parameters with their default values.

Edit / restore a global setting

To Then
Modify a parameter
  1. Click Edit.
  2. Modify the parameters values.
  3. Click Save.
Restore the default value
  1. Click Edit.
  2. Click Restore default values.
  3. Click Save.
    The default values have been restored.

You can specify the following parameters:

Name Description Default value
Number of retries Maximum number of retries to recover a connection 3
Wait period Period of time between attempts to recover a connection (in milliseconds) 500
Operation timeout The time in seconds passed from the last heartbeat of an operation after that it is assumed the component that was holding the operation crashed or became unreachable 300
Heartbeat The period in seconds of the heartbeat mechanism for the pending or running operations that are under the control of a component 30
Keep time The metadata for each long-time operation is saved in Repository. This parameter specifies in minutes how long this metadata is being kept in Repository after the operation finishes its execution. 60
Core pool size

The number of threads that can be used to execute jobs in parallel.

If all threads are used, then a new job is added to the queue. When core pool and queue are full, the work manager creates new threads until max pool size is reached. If the number of threads is greater than core pool size but the job is finished and not used, then, threads that are not used are stopped when idle thread timeout is reached.

Above the max pool size and a full queue, the threads are in error.

Minimum value is 5. This property is configurable at component level. There is no need to restart the server after you change this value.

Max pool size

The maximum number of threads allowed in the pool. See the parameter Core pool size.

Minimum value is 5. This property is configurable at component level. There is no need to restart the server after you change this value.

Idle thread keep-alive time The number of seconds after an idle thread is stopped. See the parameter Core pool size. 60
Queue capacity

The maximum number of jobs allowed in the queue.

See the parameter Core pool size.

Monitor period

Configuration (Formats, Libraries, Editors, Dictionaries, Component settings) changes are monitored into the database regularly at specified period of time.

Set this value to zero if you do not want to monitor configuration changes.

Temporary folders pattern

Pattern used for the names of the auto generated temporary folders.

The value should be an alphanumeric string which may contain the ‘*’ character. The ‘*’ character will be replaced with the current date and time. If the ‘*’ character is not present, it is considered to be at the end of the string.

Example: “temp_*_ais”. In this case the name of an automatically generated temporary folder could be temp_2015_03_14_09_26_53_589_ais.

Token keep time

REST calls for exportDocuments that do not specify outputPath, generate files accessible via URL.

For each file, a token is saved into Repository. This parameter specifies in minutes how long this tokens are kept in.


After editing or restoring settings, you can validate the settings using the command dstools setting validate. For more information on the validate command, see Manage settings on page 1.

Configuration parameters profile

A configuration parameters profile enables you to execute dstools batch tools with a set of dedicated parameters. With this functionality, treatments such as injection can take advantage of a machine capacity without impacting the whole system.

Configuration parameters profiles are defined in Administration using the Components / Dynamic Properties panel.

In the following sample, the file is injected using the FLOW1 profile:

dstools inject --collection AUDIT_COLLECTION ../getStarted/withDatastore/data/ IEvent.seq --as FLOW1

Related Links