Command-Line Switches - Distributed Disk Services - Foundation 23.1 - Foundation 23.1 - Ready - OnBase - external

Distributed Disk Services

Distributed Disk Services
Foundation 23.1

If DDS is launched as an application from a shortcut that has command-line switches applied, those switches override the switches added to the INI file either manually or through OnBase Configuration. This includes any port number changes made using OnBase Configuration.

See the Configuration chapter for details on adding the most common command-line switches to DDS either manually or through OnBase Configuration.


The Distributed Disk Services Server must be started as an administrator under Windows User Account Control for the error-logging switches to behave as expected when applied. To launch an application as an administrator, right click the shortcut with the switches applied and select Run as Administrator. Depending on your system, you may be prompted to enter the administrator's user name and password before proceeding.




Sets the IP port that listens for requests from the OnBase Client and Configuration modules. For example, -port=8086.


Allows for multiple instances of distributed services to run on the same system.


This switch must be accompanied by the -port switch configured to specify an unused port.

-logfile =”path”

Specifies a log file to write to, where path is the full path to the file.


Controls the number of threads in the thread pool. The default setting is 10; the minimum is 5.


Do not use a number over 20 without first consulting Technical Support.


With this switch applied, the log file is not deleted. The log file will be appended with information using this switch. The date/time entry is stamped when distributed services server is started or stopped.

You can also specify that a set number of archived logs be kept. A new log is created each time the distributed services server is restarted. To accomplish this, set the -keeplog switch equal to the number of logs you want to retain. For example, if you want to allow 5 logs to be kept at a time, apply -keeplog=5. The distributed services server always writes to the log.txt file. When the server is restarted, the old log.txt file is renamed to log_1.txt. The next restart creates the next log as archive log_2.txt, and so on, until the maximum number is reached. Once the maximum number of logs is reached, the log_1.txt file is dropped and each subsequent archived log is renamed, such that log_2.txt becomes log_1.txt, and so on.


If you change the number you specify to a number smaller than the current setting, the logs that have numbers surpassing the new maximum are not deleted or overwritten with new logs.


Enabling Snaplock Mode prevents the OnBase.ID from being marked as read-only.


This switch enables logging to the error log for the purpose of troubleshooting problems.


Use of this switch negatively impacts DDS performance so only use it when required for troubleshooting specific issues.


This switch keeps the connection open for a configurable amount of time. This can be used in instances such as when viewing many documents or in poor network conditions. The default setting is 10 minutes.


The minimum time that can be set is 10 minutes and the maximum is 1440 minutes.


This switch enables the DDS server to act as a proxy to another workstation that contains the disk group files.

The overridename switch configures OnBase to allow the DDS server to service traffic with UNC paths whose computer name component matches the overridename. The value used for the overridename must match the computer name specified in the UNC path and the DDS server must be able to access the UNC path specified.

For example, DDS is running on, with as the overridename. The actual platter path for the Disk Group is \\\DiskGroups\System\copy1. There is no DDS running on, but DDS traffic will go through for platter paths beginning with because of the overridename, as long as the path \\\DiskGroups\System\copy1 is accessible from the DDS server (


Apply this switch to the DDS server if OnBase clients older than OnBase 12 will be attempting to access the distributed services server. This switch enables the older method of encrypted communication for those clients. This switch has no effect if a client is version 12 or higher.


This switch enables the use of FIPS-compatible encryption for communication by the DDS server.


With this switch applied, the server can only communicate with clients using FIPS-compatible encryption. Additionally, the DDS server will no longer properly function with databases that are not FIPS compatible.