Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

...

Property

Is Required

Default Value Description

Server configuration

The section is used in Standalone mode and Client-Server mode on the server side.

replication.server.port

Y1090Server listen port.

replication.server.password

Y-A password that must be used by the client to be able to log in to the server.

replication.server.login

Y-A client's login that must be used by the client to be able to log in to the server.

replication.server.folders

N-

A comma-separated list of aliases of folders to be monitored.

If not specified or empty, default settings are used.

If not empty "replication.server.folder.AAA.path" property for each folder from the list should be specified, where "AAA" is the folder alias.

replication.server.folder.default.recursive

Ytrue

If set to 'true' then sub-folders are recursively added to the monitor list for replication.

If set to 'false' then only files from the folder itself are replicated.

Valid values: true | false 

replication.server.folder.default.path

N-The default path to a folder to be monitored.

replication.server.folder.default.maxItemsPerUpdate

Y100

A maximum number of log records that can be transferred in one message for this folder.

Increasing this value may increase throughput but decrease response time and vice-versa.

replication.server.folder.default.filter

N.*

Used only if the replication.server.folder.default.recursive property is set to 'true'.

FIX session logs are added recursively to the monitoring list if the relative path matches this regexp. If not specified all FIX session logs are added.

Please refer to the page for more details.

replication.server.folder.default.checkMinimalIndexFileSizeJAVA

Y-
Info

The property is available since FIX Logs Replicator 1.4 release.

This property is applicable for Java logs only.

If set to 'true' the size of index files will be checked. Empty index files won't be replicated.

If set to 'false' the size of index files won't be checked.

Valid values: true | false

replication.server.folder.default.regexpConfFileBindingJAVA

Y-
Info

The property is available since FIX Logs Replicator 1.4 release.

Regexp postfix rule for matching config java files with log sessions.

Valid values: regexp expressions

Recommended value: -[0-9]{4}-[0-9]{2}-[0-9]{2}_[0-9]{2}-[0-9]{2}-[0-9]{2}

replication.server.folder.default.removeBackslashesInConfJAVA


Ntrue
Info

The property is available since FIX Logs Replicator 1.4 release.

This property defines whether backslashes must be kept or removed from JAVA configuration files during replication.

If set to 'true', all '\' backslashes will be removed from JAVA configuration files during replication.

Valid values: true | false

replication.server.folder.AAA.recursive

Nreplication.server.folder.default.recursive

If set to 'true' then all sub-folders of the folder AAA are recursively added to the monitor list for replication.

If set to 'false' then only files from the folder itself are replicated.

If not specified, replication.server.folder.default.recursive value is used for the folder.

Valid values: true | false

replication.server.folder.AAA.path

Required if alias AAA is specified in the replication.server.folders property

-Path to the monitored folder with alias AAA.

replication.server.folder.AAA.maxItemsPerUpdate

Nreplication.server.folder.default.maxItemsPerUpdate

A maximum number of log records that can be transferred in one message for this folder.

If not specified, the replication.server.folder.default.maxItemsPerUpdate value is used for the folder.

replication.server.folder.AAA.filter

N

-

Used only if replication.server.folder.AAA.recursive = true or if replication.server.folder.AAA.recursive is not specified and replication.server.folder.default.recursive = true.

Sub-folders of the folder AAA are added recursively to the monitoring list if the relative path matches this regexp. If not specified all sub-folders are added. Please find further information.

 replication.server.timeoutMs

N

10000 The time interval of milliseconds from the connection to the receiving invitation message from the client.

 replication.server.filePollingIntervalM

N 1Files poll interval. Server checks for new records in logs on this interval, milliseconds.

 replication.server.foldersPollIntervalS

N 10Folders poll interval. Server checks for folders' changes in this interval.

It is actual for *nix systems if the filesystem doesn't support Inotify functionality,

Otherwise and on the Windows platform server uses a notification mechanism to work on demand.

The value is in seconds.

replication.server.confsPollIntervalS

N 10Conf files poll interval. Server checks for modification of the .conf file on this interval, seconds.

replication.server.terminateOnOpenSessionError

Nfalse

If the parameter is true, then in case of a log session reader/writer creation error, the application logs a fatal error and stops immediately.

Valid values: true | false

Client configuration

The section is used in Standalone mode and Client-Server mode on the client side.

replication.client.host

Y-IP address or hostname to connect.

replication.client.port

Y-

Port to connect.

It should be the same as the replication.server.port value from the server configuration file.

replication.client.login

Y-

Client login.

It should be the same as the replication.server.login value from the server configuration file.

replication.client.password

Y-

Password.

It should be the same as the replication.server.password value from the server configuration file.

replication.client.folders

N-

A comma-separated list of aliases of folders to be accepted.

Folders' aliases should match the ones from the replication.server.folders list from the server configuration file.

The client ignores any folder represented by the server if their alias is not listed here, except the case when the property is empty or not specified at all. In this case, all folders represented by the server are accepted and replicated into the default destination folder.

replication.client.folder.default.path

N-Default destination folder path.

replication.client.folder.default.filter

N.*

Replicated FIX session logs filter. If specified, only FIX session logs from this folder and all sub-folders that correspond to the regexp are accepted.

If not specified, all FIX session logs represented by the server are accepted by the client. Please find further information.

replication.client.folder.default.recursive

Ntrue

If set to  'true', the client will accept sub-folders of the folder recursively.

Valid values: true | false

replication.client.folder.AAA.path

Required if alias AAA is specified in the replication.client.folders property-

Path to store folder with alias AAA.

replication.client.timeoutMs

N 10000Timeout for reconnecting try.

replication.client.foldersPollIntervalS

N 10This value overrides the same value in the server configuration.

replication.client.confsPollIntervalS

N 10This value overrides the same value in the server configuration.

replication.client.heartBeatIntervalS

 5

Heartbeat interval. This is the heartbeat interval used in TCP/IP communication (non-standalone mode) to detect connection breaks.

The value is in seconds.

replication.client.postStatsIntervalM

N 5

Statistics post interval. The client posts statistics information into the log on this interval.

Setting this value to '0' disables statistics posting. This value is in minutes.

For more information on logging, check the Logging section.

replication.client.folder.default.maxItemsPerUpdate

N 100This value overrides the same value in the server configuration.

replication.client.terminateOnOpenSessionError

Nfalse

If the parameter is true the application stops working with a FATAL error if there are issues during files creation.

Valid values: true | false

Admintool configuration

This section is used in Admintool and Client mode.

replication.admintool.host

Y-

IP address or hostname to connect.

Note: Admintool connects to the client instance, not the server one.

replication.admintool.port

Y-

For Client mode: port to open listener for administrative commands from Admintool.

For Admintool mode: port to connect.

replication.admintool.login

Y-

For Client mode: admintool login which must be used by admintool to be able to login to the client.

For Admintool mode: admintool login.

replication.admintool.password

Y-

For Client mode: admintool password which must be used by admintool to be able to login to the client.

For Admintool mode: admintool password.

replication.admintool.heartBeatIntervalS

N 50This value has the same meaning as for client

Logger configuration

This section is used for all modes.

Log.File.RootDir

Y./

Log.Device

Y-

Target device. Supported values are:

  • File
  • Console
  • File Console

Log.DebugIsOn

YfalseTurns on/off logging on a certain level.

Log.NoteIsOn

YfalseTurns on/off logging on a certain level.

Log.WarnIsOn

YfalseTurns on/off logging on a certain level.

Log.ErrorIsOn

YfalseTurns on/off logging on a certain level.

Log.FatalIsOn

YfalseTurns on/off logging on a certain level.

Log.Cycling

Y-Turns cycling on/off.

Log.File.Name

Y-Log file name.

Log.File.Recreate

Y-

If true, then the file will be recreated on each start.
If false, then new records will be appended to the existing file.

Log.File.AutoFlush

Ytrue

If set to true, then the buffer will be flushed after each logging call.
If set to false, then a flush is not called.
Setting to true decreases program performance; setting to false increases the risk of records loss in case of program failure.

...

Specific commands to configure Replication tool as Windows service 
-i [--installService]Installs the tool as a Windows service.

-u [--uninstallService]

Uninstalls Windows service installed for the tool.
-n [--serviceName] argSpecifies service name to use for --installService and --uninstallService commands. The default value is “ReplicationService”.
-d [--dependService] argUsed with “–installService”, specifies service the service being installed depends on. Can be used more than once if more than one service must be added to the dependency list.
--serviceStartArgs argUsed with “–installService”, specifies command line options to be passed when service being installed is started by Windows Service Manage.

...

Configuring the parameter replication.client.postStatsIntervalM, allows the client to modify the interval with which stats messages are recorded. The value of this parameter is in minutes.

...