MDC Gateway Configuration

You can use the configuration parameters in create_config.py to configure MATRIXX MDC Gateway.

MDC Gateway Configuration Parameters lists the information required to configure MDC Gateway.

For more information about the MATRIXX environment variables, see the discussion about container directories and environment variables in MATRIXX Installation and Upgrade.

Table 1. MDC Gateway Configuration Parameters
Parameter Description Default Value
Error MDC Logging Determines whether to log message MATRIXX Data Containers (MDCs) sent from MDC Gateway to a network application that report a non-successful result (a nonzero Result field value). The MDCs are typically SubMan API messages, but they can also be any MDC based on the MtxMsg MDC. Error logs are in compact MDC format and are written to the ${MTX_ERROR_MDC_LOG_DIR}.

create_config.info question: MdcGw:Do you want to log the MDCs that report a non-successful result (y/n)?

Yes
Error MDC Log Closing The closing of an error MDC log is triggered by either the log batch size, an amount of logging time, or an amount of idle time that has elapsed, whichever occurs first. Each parameter value is configurable and can be disabled by setting its value to 0, which removes it from the log-closing equation.
create_config.info questions:
  • MdcGw:What is the size in MBytes that you want to use to trigger a file close for error-MDC logs?
  • MdcGw:What is the time in seconds that you want to use to trigger a file close for error-MDC logs?
  • MdcGw:What is the idle time in milliseconds that you want to use to trigger a file close for error-MDC logs?
  • Batch Size: 10 MB
  • Exceeded Time: 60 seconds
  • Idle Time: 60000 milliseconds
MDC Gateway Transporter TCP Port Specifies the port for TCP communication. Out-of-the-box, the TCP listener is enabled. Answer 0 to disable the listener.

create_config.info question: What port number do you want to use for MDC gateway transporter TCP communication?

 24060
MDC Gateway Transporter TLS Port Specifies the port for TLS communication. Out-of-the-box, the TLS listener is disabled. The recommended port for TLS communication is 24061.

create_config.info question: What port number do you want to use for MDC gateway transporter TLS communication?

 0
MDC Gateway Transporter HTTP2 Port Specifies the port for HTTP2 communication. Out-of-the-box, the HTTP2 listener is disabled. The recommended port for HTTP2 communication is 24068. If you specify a port, answer the next three questions in this table.

create_config.info question: What port number do you want to use for MDC gateway transporter HTTP2 communication?

 0
MDC Gateway Transporter HTTP2 Specifies whether secured HTTP2 is used by the MDC Gateway transporter HTTP2 listener.

create_config.info question: Should the MDC gateway transporter HTTP2 listener use secured HTTP2 (y/n)?

 y
MDC Gateway Transporter HTTP2 Certificate Specifies the location of the MDC Gateway transporter HTTP2 server certificate file if secured HTTP2 is used.

create_config.info question: What is the location of the MDC gateway transporter HTTP2 server certificate file?

Note: You must ensure that certificate files are placed in the correct location in the MATRIXX Engine and CAMEL Gateway pods.
 cert/server-cert.pem
MDC Gateway Transporter HTTP2 Key Certificate Specifies the location of the MDC Gateway transporter HTTP2 key certificate file if secured HTTP2 is used.

create_config.info question: What is the location of the MDC gateway transporter HTTP2 server key file?

Note: You must ensure that key files are placed in the correct location in the MATRIXX Engine and CAMEL Gateway pods.
 cert/server-key.pem