You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

Prerequisites

  • Have two machines to run Ignition Gateway and Ignition Edge MQTT
    • Ignition Gateway can run on a laptop, in the cloud via an AWS EC2 instance or some other development computer
    • Ignition Edge MQTT can run on one of many supported embedded edge of network gateways, a laptop or development computer, or also in a cloud service

Summary

In conjunction with the Sparkplug specification, it is very useful to set up a working system that uses the MQTT Sparkplug specification in order to observe a simple but fully functional system.  This section of the tutorial will provide step by step instructions for installing and configuring Ignition Edge MQTT and an Ignition Gateway to show tags being published from Ignition Edge to the Ignition Gateway running MQTT Distributor and MQTT Engine.

  • Ignition Gateway Installation
    • MQTT Distributor – An MQTT Server that runs as an Ignition module.
    • MQTT Engine – Engine is an MQTT Client that implements the Sparkplug specification and automatically creates Ignition tag structures for Edge Node and Device metadata and process variables.
  • Ignition Edge MQTT
    • MQTT Transmission – Transmission is an MQTT Client that implements the Sparkplug specification to bridge local Ignition tags (OPC-UA and Memory tags) and publish the resulting structure to an MQTT infrastructure.

Upon completion of this tutorial you will have all of the required components to configure, deploy, and observe the Sparkplug MQTT specification in action.

Architecture

Tutorial

Step 1: Download and Install Ignition Gateway

Ignition is an Industrial Application Platform that can be used to create SCADA and HMI solutions. A fully functional Ignition system can be downloaded and run in trial mode. Using Ignition as a tool in this way, we can install the Sparkplug MQTT Modules and observe everything working.

Go to the Inductive Automation download page and download the desired Ignition installer for Windows, Linux or MacOS;
https://inductiveautomation.com/downloads/ignition

Once the Ignition installer has been downloaded, follow the instructions provided by Inductive Automation to install and start Ignition.

Important Note: For this test infrastructure, MQTT Distributor will be installed as an Ignition module. Remember to either turn off firewalls or at a minimum allow inbound connections to TCP/IP port #1883 and port #8883, as remote MQTT Clients will need to be able to establish a TCP/IP socket connection to these ports.

Step 2: Download and Install Ignition Edge MQTT

Ignition Edge MQTT is a new stripped down version of Ignition that is specifically designed for use as an Edge of Network device.

See the Ignition Edge installation guide here.  Follow the sections for Ignition Edge MQTT and for your specific Operating System.  Make sure this is being installed on a different machine than was used to install Ignition in step 1.
https://docs.inductiveautomation.com/display/DOC79/Installing+Edge

Step 3: Download and Install the Cirrus Link MQTT Modules

Go to the Inductive Automation download page again and scroll down to the Third Party modules section. Find the Cirrus Link modules section and download the MQTT Distributor, MQTT Engine, MQTT Transmission modules.
https://inductiveautomation.com/downloads/ignition.  The download links should look similar to what is shown below.

  • Install MQTT Distributor and MQTT Engine into the Ignition Gateway installed in step 1.
  • Install MQTT Transmission into Ignition Edge MQTT that was installed in step 2.

Step 4: Configure the MQTT Modules

Once you have Ignition installed and running, and the MQTT Distributor, MQTT Engine and MQTT Transmission modules downloaded, browse to the Ignition Gateway console (e.g. http://localhost:8088).  Login using the default credentials of admin/password.  Click on Configuration tab and then click on the Modules tab on the left side of the page.  Scroll to the bottom of the Modules section and click on the Download/Upgrade modules button.  When prompted, select the MQTT Distributor module from the file browser and install it.  Do the same for the MQTT Engine and MQTT Transmission modules.  When complete, the Ignition Gateway Web UI module section should look similar to what is shown below.








  • No labels