Try TT Now

TTM Network Administration

ttmd.cfg Parameters

Section: General

TTM Logging Parameters
ParameterDescription

LogFileHistory

ttmd.cfg installs with a default LogFileHistory setting of 10.

Sets the number of days of log files that TTM retains. TTM deletes log files with dates that are older than the setting of LogFileHistory.

TTM checks for expired log files and deletes them whenever it starts up and daily at 00:00:01.

LoggingType

Sets how TTM produces its log file according to the following values:

  • none: TTM does not produce a log file.
  • stderr: TTM produces its log output in a standard error stream. To see the stderr output, you must run TTM in a command window.
  • file: TTM writes its log information to a log file. TTM assigns the log file the value of the TTM_LOG_PATH environment variable (default).
  • both: TTM writes its log information to file and in a standard error stream. The log file is named according to the value of the TTM_LOG_PATH environment variable. To view the output of the standard error stream, you must have a command window open.

ttmd.cfg installs with a default LoggingType setting of file.

TracingLevel

Sets the level of detail that TTM logs. TracingLevel can have the following values:

  • normal: Logs whenever the TTM Daemon starts or stops, a client connects or disconnects, a session begins or ends, and errors occur (default).
  • trace1: In addition to the events logged in the normal trace level, trace1 logs client requests (when received and executed), whenever a listener or inbox is created, a messages is sent, and any advisories.
  • trace2: In addition to the events logged in the previous trace levels, trace2 logs the origination of inbound and outbound PGM sessions, and any PGM events.
  • trace3: In addition to the events logged in the previous trace levels, trace3 details the major points in the protocol chain.
  • trace4: In addition to the events logged in the previous trace levels, trace4 details the content of inbound and outbound packets in hexadecimal format.

ttmd.cfg installs with a default TracingLevel setting of normal.

RequestPort

Sets the local port over which TTM communicates. By default, ttmd.cfg installs with RequestPort set to 10200.

Warning

If you need to change the port over which TTM communicates, do so through the Guardian GUI. Do not edit the value directly in the ttmd.cfg file unless you run only TTM as a stand-alone application on this machine.

local

Sets TTM over PGM communication based on the following settings:

  • true: TTM communicates PGM only on the local machine. This effectively prevents PGM messages from being sent from this instance of TTM.
  • false: TTM communicates PGM over the network (default).

ttmd.cfg

installs with a default local setting of false.

tcp_window_size

Sets the quantity of data (in KB) that this TTM instance can receive in a single receive buffer. After sending the configured amount of data, the TTM peer waits for an acknowledgement (ACK) from this TTM instance. If the TTM peer does not receive an ACK, it begins queuing the data.

By default ttmd.cfg does not install with this parameter. If it is missing or set to an invalid value, TTM behaves as if set to 64.

For further details on this parameter, refer to Manually Configuring TCP Window Size.

compression_level

Sets whether the Host Daemon compresses its data before sending to its remote clients. To disable compression, set this value to false. To enable compression, set the value to true.

  • If a remote machine is not configured for compression, the Host Daemon does not compress its data when sending to that remote client.
  • If you set the Host Daemon to a value other than the remote client setting (true by default), TTM writes a Warning message to its log file.

By default

ttmd.cfg does not install with this parameter. If it is missing or set to an invalid value, TTM behaves as if set to true.

TcpNoDelay (also called tcp_no_delay)

Sets whether the TTM Daemon on a Host Daemon Nagles its price feed over a remote (TCP/IP) connection. Nagling better conserves bandwidth by consolidating price updates. If you do not set your TTM Daemon to Nagle price data, price-feed performance increases but the TTM Daemon consumes additional bandwidth.

Available values include:

  • true: Sets the Host Daemon to send its price data without Nagling.
  • false: Sets the Host Daemon to Nagle its price data.

By default ttmd.cfg does not install with this parameter. If it is missing or set to an invalid value, the TTM Daemon behaves as if set to true.

For Host Daemons, TT recommends that you set the value to false.

If you use accumulation rather than Nagling, set this value to true (disable Nagling). Refer to the accumulator_timeout and accumulator_mtu parameter descriptions in Section: LocalServices.

MaxClientTCPConnections

Sets the maximum number of remote TCP client connections that the Host Daemon will accept.

MaxClientTCPConnections applies to the number of TCP connections and not the number of TT Client Applications (e.g. X_TRADER) that remotely connect to the Host Daemon machine, for instance via a TTM Proxy connection.

By default ttmd.cfg does not install with this parameter. If it is missing or set to an invalid value, TTM behaves as if set to 0.

PGMBufferSize

Sets the size, in bytes, of the PGM buffer.

You must use a whole number to set a value for PGMBufferSize. Valid values range from 1024 - 67108864 (1KB-64MB). TTM 7.1.17 and higher contains an enhancement that allows the user to increase the PGM buffer up to 1073741824 (1GB).

By default ttmd.cfg does not install with this parameter. If it is missing or set to an invalid value, TTM behaves as if set to 4194304 (4 MB). TTM 7.1.17 and higher, the default behavior increases to 20 MB.

encryption_algorithm

The algorithm to use (3DES or AES). The default is AES.

key_exchange_method

The type of authentication used. X_TRADER Remote Hosts typically use anonymous authentication (sts_half), but can be configured for peer-to-peer authentication as well (sts_full). The default is sts_half.

encryption_key_length

The length of the key, in bits (128 or 256). The default is 128 bits.

Note: If the encryption_algorithm is 3des, the encryption_key_length must be 256.

allow_insecure_connections

If your environment must also support Remote Clients running TTM 3.2.0 or earlier, you can allow the older clients to connect by adding the allow_insecure_connections=true parameter. If this parameter is omitted, it defaults to false.

encryption_enabled

Enables or disables encryption for all the services. For Remote Host Daemons, if the Remote Host Daemon has encryption enabled, client connections are encrypted, even if the Remote Client has encryption disabled. If the Remote Host Daemon has encryption disabled, connections will not be established to clients that have encryption enabled. By default encryption_enabled is set to false.

RemoteHostServer

Specifies if TTM is running in Remote Host Server mode (i.e. running on a Gateway or as a Remote Host Daemon). When set to true, the daemon runs in Remote Host Server mode; TTM launches the appropriate number of threads, based on the number of threads on the machine.

Note: When the RemoteHostServer parameter is incorrect or omitted, it defaults to true.

TTMCMDRequestPort

The port on which the daemon listens for the ttm_cmd connection.

Note: When the TTMCMDRequestPort parameter is incorrect or omitted, it defaults to 10600.

Section: MulticastGroups

The <MulticastGroups> section contains either a single multicast group address, or multiple muliticast addresses assigned to individual subjects, followed by > = MulticastGroupAddress. Refer to Multiple Multicasts for detailed information about configuring multicast group addresses.

Section: LocalServices

TTM Logging Parameters
ParameterDescription

accumulator_timeout

The number of microseconds that TTM collects packets into a single message (range: 0 to 5000000 microseconds, default: 0, disabled). The message is sent when either the accumulator_timeout or accumulator_mtu is reached.

If accumulator_timeout is set to a value greater than 5000000 microseconds (5 seconds), accumulation is disabled and the system generates the following message:

WARNING - Disabling accumulation. AccumulatorTimeout out of range (X). Valid range 0 - 5000000 µs.

To disable accumulation, set accumulator_timeout or accumulator_mtu to 0. For more information about accumulation refer to Accumulation.

By default ttmd.cfg does not install with this parameter. If it is missing or set to an invalid value, TTM behaves as if set to 0.

Note

accumulator_timeout is set per service in the <LocalService> section.

accumulator_mtu

The number of bytes of data the system will collect into a single message before sending the message out (range: 0 to 32000 bytes, default: 1460 bytes). The message is sent when either the accumulator_timeout or accumulator_mtu is reached. To disable accumulation, set accumulator_timeout or accumulator_mtu to 0. For more information about Accumulation refer to Accumulation.

By default ttmd.cfg does not install with this parameter. If it is missing or set to an invalid value, TTM behaves as if set to 1460.

Note

accumulator_mtu is set per service in the <LocalService> section.

encryption_enabled

Enables or disables encryption for the specified service. For Remote Host Daemons, if the Remote Host Daemon has encryption enabled, client connections are encrypted, even if the Remote Client has encryption disabled. If the Remote Host Daemon has encryption disabled, connections will not be established to clients that have encryption enabled. By default encryption_enabled is set to false.

Section: Proxy

Note

The Proxy Section is only available on X_TRADER Remote Clients after setting the Remote Proxy Daemon address and restarting the processes as needed. Refer to Configuring the Remote Client, if needed.

TTM Logging Parameters
ParameterDescription

compression_level

Sets whether the remote client compresses its data. To disable compression, set this value to false. To enable compression, set this value to true.

TcpNoDelay

Sets whether the TTM Daemon on a Remote Client Nagles its TCP/IP communications to the Remote Host Daemon (true or false).

RemoteTcpNoDelay

Overrides the TcpNoDelay setting on the Remote Host Daemon. Valid values are: None, True, and False.

To enable Nagling for a specific service, on the Remote Client (Remote Host Proxy), add RemoteTcpNoDelay=false to the proxy service section that requires nagling. To disable Nagling for a specific service, add RemoteTcpNoDelay=true to the proxy service section that will not use Nagling.

If the RemoteTcpNoDelay parameter is omitted or set incorrectly, the setting defaults to none.

Host

The IP address of the Remote Client.

Port

The port on which TT applications communicate with the TTM Daemon. The default is 10200.

tcp_window_size

Sets the quantity of data (in KB) that this TTM instance can receive in a single receive buffer. After sending the configured amount of data, the TTM peer waits for an acknowledgement (ACK) from this TTM instance. If the TTM peer does not receive an ACK, it begins queuing the data.

You must use a whole number to set a value for tcp_window_size.

By default ttmd.cfg does not install with this parameter. If it is missing or set to an invalid value, TTM behaves as if set to 64.

For further details on this parameter, refer to Manually Configuring TCP Window Size.