...
Additional or alternative MQTT Servers can be configured in MQTT Engine. Often times more than one will be configured to handle fail-over or in redundant or geographically distributed systems. The configuration options for servers are listed below.
- Name -
- This is the friendly name of the MQTT Server used to easily identify it
- URL -
- This is the URL of the MQTT server. Its format is as follows: [protocol]://[location]:[port]. Each of these are shown below
- protocol - Either tcp or ssl
- location - The server location. e.g. localhost, myserver.chariot.io, mydomain.com, etc
- port - The port the MQTT Server is listening on. Generally this is 1883 if using TCP or 8883 if using SSL
- ServerType -
- This is the type of MQTT Server to connect to
- Chariot - If connecting to a Cirrus Link Chariot on-premise or Chariot cloud based MQTT Server
- MQTT_Distributor - If connecting to a Ignition MQTT Distributor server
- Third_Party - If connecting to a third party 3.1.1 compliant MQTT Server
- ClientID -
- Optional MQTT client ID to use. If specified this will be used in the MQTT Engine connect packet when connecting to the server. If left blank, a random client ID will be create of the form 'IgnitionTarget-xxxxxxxx-xxxx-xxxx
- Username -
- The MQTT username to use in the MQTT connect packet. This is required if the MQTT Server to connect to requires it
- Password -
- The MQTT password to use in the MQTT connect packet. This is required if the MQTT Server to connect to requires it
- Certificates -
- The server certificates to use if required. These are generally only required when connecting using TLS and the MQTT server does not have a genuine certificate issued by a trusted certificate authority.
Clicking on the 'Create new MQTT Server...' link will bring up the following form to add a new Server.
...