Load balancer service configuration file

This configuration file enables you to configure the Load Balancer Service settings. The configuration file is divided into three sections.

The first section contains settings for the server, the second section defines the logging settings, and the third section defines the WCF throttling settings for the service, all specific to the Load Balancer.

The following settings are available.

RunningMode

Defines if the server is running in "Normal" mode or "Restricted" mode. The value for this setting is set to "Normal" by default. Only use the "Restricted" mode when you want two load balancers to work together without sending contradictory information.

Port

Select the network port that is used to establish communication during search and configuration operations with the server. By default, either 22000 or 22001 are assigned. You can assign any valid port.

Language

The language used for log messages posted by the service. The value for this setting is set to "en" by default.

For support of additional languages, a language pack for that language is needed.

DataRootDirectory

The path where Kofax Search and Matching Server stores its data. The value for this setting is set to C:\ProgramData\Kofax\KSMS by default.

KsmsAdministratorsGroupName

The name of the group that a user must be a member of, in order to configure the services. The value for this setting is set to KSMSAdministrators by default.

You must change this value in both configuration files.

SecureSearchEnabled

Determines whether the network data that is transmitted for a search request is encrypted or not. The value for this setting is set to "true" by default.

You must change this value in both configuration files.

LogLevel

There are different levels that determine what kind of messages are written to the log file. The value for this setting is set to "WARN" by default. This means that only warnings and errors are logged, and no information messages.

LogfilePath

This setting defines the path where the log file is stored. The value for this setting is set to C:\ProgramData\Kofax\KSMS\Logs\KSMS.log by default.

Edit the path as necessary.

RollingLogfileSizeInMB

Defines the size of the log file when it is archived. The value for this setting is set to "10" by default. This means that when the log file has reached a size of 10 MB it is stored as an archive file in the same folder and a new log file is created.

RollingLogfileCount

Defines the number of archive files that are stored on the computer. The value for this setting is set to "10" by default. This means that the last 10 archive files are available.

LogThreaIDInfo

An optional setting that is used only for bug tracking. It writes the ID from the thread posting a message in the log file. The value for this setting is set to "false" by default.

LogMutexInfo

An optional setting used only for dead lock bug tracking. When set to true, an entry is added to the log each time internal mutexes are accessed. The value for this setting is set to "false" by default.

WcfThrottlingMaxConcurrentCalls

Indicates the maximum number of parallel connections allowed. The value for this setting must match the value for the WcfThrottlingMaxConcurrentSessions setting below. The value for this setting is set to "128" by default.

A large value for this setting when the service is already busy can decrease the server performance. Increase this number carefully so that the server does not use all of the machine resources.

WcfThrottlingMaxConcurrentSessions
Indicates the number of queries that are processed in parallel on the server. The value for this setting must match the value for the WcfThrottlingMaxConcurrentCalls setting above. The value for this setting is set to "128" by default.
McfThrottlingMaxConcurrentInstances
Analyzes the WCF communications. The value for this setting is set to "2147483647" by default. Do not modify the value for this option.