Configuring other FIXEdge properties
- 1 Overview
- 2 TCP Protection parameters
- 3 Transport Adaptors common parameters
- 4 Control Centre parameters
- 5 Settings of FIXICC Functionality Availability
- 5.1 FIXICC.Schedules
- 6 Monitoring Memory Usage
- 6.1 MemoryWatch.Limit
- 6.2 MemoryWatch.Interval
- 6.2.1 Example
- 7 Logging for lifecycle FIXEdge events
- 8 Postponed FIXEdge initialization (Hot/Warm activation modes)
Overview
The settings in this section describe only FIXEdge parameters. These parameters don't belong to FIX sessions parameters or FIX Engine parameters.
These settings of the FIXEdge are defined into 'FIXEdge.properties' configuration file.
TCP Protection parameters
This section describes properties in FIXEdge.properties file which are responsible for TCP protection.
ProtectionTCP.Enabled
The property enables TCP protection.
Valid values: true/false. Default value: ProtectionTCP.Enabled = false.
Example: ProtectionTCP.Enabled = true
ProtectionTCP.WaitLogon
The property to specify connection timeout (in milliseconds) of waiting for logon. When the time comes out, the connection is closed with corresponding reason:
|
Disable when equal to 0. Default value: ProtectionTCP.WaitLogon = 10000
Icon
The property will be enabled only if ProtectionTCP.Enabled = true
ProtectionTCP.SizeWaitHostMax
The property to specify maximum of connections waiting for logon from one host. When the number of connections from the same host exceeds specified value of the property, new connections will be rejected with corresponding reason.
|
Disable when equal to 0. Default value: ProtectionTCP.SizeWaitHostMax = 5
Icon
The property will be enabled only if ProtectionTCP.Enabled = true
ProtectionTCP.SizeBufferMax
Specifies the maximum size (in bytes) of the buffer to be able to avoid the situation when user sends high-loaded garbage.
When the limit is exceeded, connection will be closed and corresponding reason will be written to the log.
|
Icon
When connection is re-established after closure, Client will send Logon message with MsgSeqNum = <last outgoing sequence number> + 1. As a result, FIXEdge will send ResendRequest and will receive the same message which caused disconnection. Thus, connection will be closed again.
The minimum size of the property which can be specified is 262144. If a lower value is specified in the property, it will be replaced with 262144 on the start of the FIXEdge.
If 0 is specified, there is no limit for the size of the buffer.
Default value: ProtectionTCP.SizeBufferMax = 0.
Icon
The property will be enabled only if ProtectionTCP.Enabled = true
For more information please read the article How to configure TCP protection in FIXEdge.
Transport Adaptors common parameters
The section contains fields which are common for all Transport Adaptors.
FIXEdge.AllowNGTStatusNotifications4TAClient
Valid values: true|false.
When the option is true, FIX Edge uses the latest Client's status in Status Notification message. When option is false, FIX Edge sends Client's status 'Terminated Correctly' in Status Notification message;
Default value is false.
TransportLayer.UnknownClientsAllowed
Valid values: true|false.
When the option is true, Transport Layer allows to call onLogout() callback for the TA Clients without onLogon() call. When the option is false, Transport Layer ignores onLogout() callbacks for the client that didn't call onLogon() before.
Default value is false.
TransportLayer.TransportAdapters.Path
The parameter is an enumeration of transport adapters' directory names separated by ','
Default value is: the path of the folder where the application's executive file is located
This parameter is applicable since FIXEdge C++ version 6.14.0
Control Centre parameters
ControlCentre.XMLSockMonitor.Port
XML Sock monitoring port to accept requests from the special tool FEAdminConsole.
Example: ControlCentre.XMLSockMonitor.Port = 8902
ControlCentre.Lock.File.Name
File that prevents from starting multiple FIXEdge instances at the same directory.
Example: ControlCentre.Lock.File.Name = FIXEdge1/log/_fixedge.lock
Starting several FIXEdge instances at the same directory will cause an error:
ERROR: Cannot create lock file '../FIXEdge1/log/_fixedge.lock'. Possibly another instance of the application is running using the same directory.
Settings of FIXICC Functionality Availability
FIXICC.Schedules
Optional. Defines if the new schedule management functionality should be available in FIXICC or not.
If FIXICC.Schedules = true, new schedule management functionality is available in FIXICC
If FIXICC.Schedules = false or FIXICC.Schedules is not specified, new schedule management functionality is not available in FIXICC.
Default value: false.
Monitoring Memory Usage
MemoryWatch.Limit
Optional. Enable this parameter to force engine to monitor RAM capacity occupied by FIXEdge.
Once value is reached and exceeded FIXEdge generates OnNotificationEvent to notify about exceeding the available memory.
Value set in Mb.
MemoryWatch.Interval
Optional. Frequency of checking occupied memory.
Value set in seconds.
Example
FIXEdge.MemoryWatch.Limit = 100
FIXEdge.MemoryWatch.Interval = 60Described functionality is implemented in FIXEdge Windows version only.
Logging for lifecycle FIXEdge events
Since FIXEdge version 6.7.0 the following lifecycle events are supported:
Name | Description |
|---|---|
AppStarting | Application is being to be started and log system is initialized |
AppStarted | Properties are loaded and sessions are runned |
AppReady | All components of application was started |
AppFailed | Application is crashed |
AppSigTermDetected | Signal SIGINT or SITERM is detected |
AppShutdown | Application is being to shut down (stop sessions / destroy objects) |
AppComplete | All work is done, stopped as planned |
The events are logged and FIXEdge can notify other system about events
Parameters for setting up logging of these events are described in this section.
Events can be forwared to ArcSight
See How to configure forwarding FIXEdge lifecycle events to ArcSight for more information
Log.Events.LogCategory
Mandatory. Default category for all events
Log.Events.LogLevel
Optional. Default log level for all events
Valid values: TRACE, DEBUG, INFO, ERROR, FATAL
Default value: INFO
Log.Events.Event.<NameOfEvent>
Optional. Defines the logging format (pattern).
if the parameter is not defined, the event logs will not be generated
See Format of event entries for transfer to ArcSight for more information
Log.Events.Event.<NameOfEvent>.LogCategory
Optional. Log category for a single event
Default value: value of Log.Events.LogCategory parameter
Log.Events.Event.<NameOfEvent>.LogLevel
Optional. Log level for a single event
Valid values: TRACE, DEBUG, INFO, ERROR, FATAL
Default value: value of Log.Events.LogCategory parameter
Postponed FIXEdge initialization (Hot/Warm activation modes)
These parameters are applicable since FIXEdge C++ version 7.1.0
Key name | Value | Remarks |
|---|---|---|
ControlCentre.Activation.Mode | FIXEdge activation mode to start with. Possible values are: Hot, Warm, TryLock, TryHeartbeat | Optional. Default is Hot. |
ControlCentre.Activation.LockName | A URI of a lock that FIXEdge will try locking when starting. When TryLock or TryHeartbeat activation modes are chosen, a LockName should be a valid file system file name what FIXEdge will try locking before switching to Hot. | Mandatory for TryLock, TryHeartbeat. |
ControlCentre.Activation.TryHeartbeat.Delay | A delay in second since last written heartbeat that FIXEdge during which FIXEdge will start in Hot mode. | Mandatory for TryHeartbeat. |