Page History

Prerequisites

• Ensure you have a platform that supports either Linux 64-bit Docker images or ARM HF images
• Hilscher provides a number of gateways that support 64-bit Linux containers and ARM HF containers
  • netIOT/netFIELD Edge 
  • netPi
• This tutorial will use Portainer to set up and configure the container.  However, this could all be done via the command line if you prefer.

Summary

This tutorial will cover the downloading, configuration, and starting of Ignition Edge MQTT IIoT as a Docker container using Portainer.

Upon completion of this tutorial you will have Ignition Edge IIoT installed as a Docker container which will be ready to configure and use.

Tutorial

Step 1: Start Portainer

Begin by ensure Portainer is running and you are set up to manager the target Docker environment.  Information on Portainer can be found here.  If using a Hilscher Edge device consult the Hilscher documentation for access to the Portainer Portal.

Step 2: Download the Ignition Edge IIoT image

Open a Web Browser to your Portainer instance and select 'Images' on the left.  In the name section enter one of the two following strings depending on your platform architecture:

• If Linux 64-bit is supported: cirruslink/ignition-edge-mqtt-linux-64:latest
• If Linux ARM HF is supported: cirruslink/ignition-edge-mqtt-linux-armhf:latest

The repositories can be viewed here:

...

Once the download is complete, you should see something similar to the following.

Step 3: Create the Volumes

Select 'Volumes' on the left and add two new ones by clicking the 'Add Volume' button.  Then type the name of the first volume as 'ignition-data' as shown below and click 'Create the volume'.  Ensure 'Access control' is also disabled.

Repeat the volume creation process described above to create a second volume called 'ignition-bin'.  When complete, the volumes should look as follows:

Step 4: Define and Start the Container

Now select 'Containers' on the left and click the 'Add Container' button.  Set the following parameters:

• Name = IgnitionEdgeMQTT
• Image Name = (the image downloaded dependent on your hardware platform architecture)
  
  • If Linux 64-bit is supported: cirruslink/ignition-edge-mqtt-linux-64:latest
  • If Linux ARM HF is supported: cirruslink/ignition-edge-mqtt-linux-armhf:latest
• Always pull the image = not selected
• Publish all exposed ports = selected
• Map the following additional ports
  • 22 → 22 (TCP)
  • 8000 → 8000 (TCP)
  • 8043 → 8043 (TCP)
  • 8060 → 8060 (TCP)
  • 8088 → 8088 (TCP)
• Enable access control = not enabled

...

After deploying you should see the new container now running as shown below.

Step 5: Connect to the

...

Ignition Edge Web UI and install MQTT Transmission

Download Install the latest MQTT Transmission from the Ignition download page here.  Now browse Module following the instructions here.

...

...

...

Browse to the Configure tab on the top and then the Modules link on the left as shown below.

...

Now click the 'Install or Upgrade a Module...' link near the bottom of the main panel.  Browse to the downloaded MQTT Transmission module and install it.  When complete, it should look similar to what is shown below.

Image RemovedAt this point you are ready to configure and use Ignition Edge MQTT.  See the following two links for information on how to configure and use Ignition Edge MQTT.IIoT and more information can be found in the links below.

• Igniton Edge IIoT Configuration
  • Configuration guide for Ignition Edge IIoT
• Igniton Edge IIoT Tutorials/Howtos
  • Tutorials and howtos covering installation, configurations, and usage of Ignition IIoT
  MT: Configuration
• Getting Started: Two Ignition Architecture
  • A simple architecture showing how MQTT Transmission and MQTT Engine interact via MQTT Distributor in two Ignition instances