TIBCO FTL-MQTT Bridge Configuration Reference

A complete sample configuration file is provided with the TIBCO FTL-MQTT Bridge package.

Option Name Description Default Value
ftl A pipe | separated list of realm server URLs.

Only two URLs are supported: a primary realm server URL and a secondary realm server URL.

http://localhost:8080
ftl_user The username to use when connecting to the realm server. ""
ftl_password The password to use when connecting to the realm server. ""
ftl_trustfile The trust file to use when connecting to the realm server. ""
ftl_trust_all If true, trust any realm server. false
name The FTL application name and the MQTT client ID of the bridge.
Important: The name has to be unique.
tibfmbridge
endpoint

The FTL application endpoint used by this TIBCO FTL-MQTT Bridge.

tibfmbridge_server_endpoint
transport

The FTL application transport used by this TIBCO FTL-MQTT Bridge.

tibfmbridge_server_transport
matchers A list of FTL matchers.

An FTL subscription is created for each matcher on the server endpoint.

"{}"

(null matcher)

discard_policy The discard policy is an integer 0,1, or 2.
  • 0: discard none
  • 1: discard old
  • 2: discard new
2
discard_policy_max_events The maximum depth of the FTL message queue before the discard policy takes effect. 1000
mqtt_broker_address

Connect to the MQTT broker at this host:port.

localhost:1883
mqtt_topics

A list of MQTT topics.

#
mqtt_user The username to use when connecting to the MQTT broker. ""
mqtt_password The password to use when connecting to the MQTT broker. ""
mqtt_trust_all If true, trust any MQTT broker. false
mqtt_trustfile

The trust file to use when connecting to the MQTT broker.

""
mqtt_qos The QoS setting of connection between bridge and MQTT broker. 0
ftl_payload_field

The FTL message field name used to store the MQTT payload.

Applies to inbound and outbound FTL messages.

_mqtt_pay
ftl_topic_field

The FTL message field name used to store the MQTT topic.

Applies to inbound and outbound FTL messages.

_mqtt_topic
ftl_qos_field

The FTL message field name used to store the QOS option.

Applies to inbound FTL messages.
_mqtt_qos
ftl_retained_field

The FTL message field name used to store the retained option.

Applies to inbound FTL messages.

_mqtt_ret
ftl_marshal_as_json

If true, convert the inbound FTL message into a JSON string and use as MQTT payload.

If true, the ftl_payload_field will be ignored.

true
mqtt_marshal_as_json

If true, inbound MQTT message payloads are JSON strings.

The JSON payload is converted directly into an FTL message.

If true the ftl_payload_field will be ignored.

false
override_topic If set all inbound FTL messages will be forwarded to MQTT with this topic.

Empty strings means not set.

""
override_qos

If set all inbound FTL messages will be forwarded to MQTT with this QOS setting.

The value -1 means not set.

-1
override_retained If set all inbound FTL messages will be forwarded to MQTT with this retained setting.

The value -1 means not set.

-1
split_topic

If true, inbound MQTT message topics will be split into separate FTL message fields.

FTL client applications can use these additional fields for matching.

false