These configuration steps require access to the KEPServerEX Configuration program.
Step 0:
Create a new device in the ioTORQ Lean admin portal, selecting either KepserverEX or Fault device (sensor readings or fault codes). Note the automatically generated "serial number" for the device.
Step 1:
In KepserverEX, add a new IoT Gateway (in the left hand panel)
Step 2:
Enter the configuration details as follows, replacing the topic with KEPServerEX/device_id where "device_id" is the automatically generated device "serial number" from the admin portal
*****VERY IMPORTANT*****
Note: Please use the following URL:
ssl://mqtt.iotorq-lean.com:8883
Step 3:
Enter the MQTT client ID, MQTT client username, MQTT client password
Step 4:
Right click on the new IoT Gateway in the left panel. In the window which pops up, click on "Message" in the left panel and enter the message template as below:
*****VERY IMPORTANT*****
The templates to use are shown below. These need to be exactly correct.
Template:
- timestamp: |SERVERTIMESTAMP| readings: |VALUES|
Expansion of |VALUES|:
- param: |TAGNAME| value: |TAGVALUE| timestamp: |TAGTIMESTAMP| quality:|TAGQUALITY|
Step 5:
- Enable SSL in Security section
- Generate CA, CERT and Key file from the admin portal and copy to virtual machine
- On VM, search and open "Manage Computer Certificates"
- Expand Trusted Root Certificate Authorities
- Right click on Certificates, click All Tasks - Import...
- Follow Wizard prompts, browsing to certificate location
- Close KepServerEx Admin and Configuration
- Re-open KepServerEx Configuration and Admin
- Right click on KepServerEx Admin - choose Settings - IoT Gateawy Panel - MQTT Agent - Manage Certificate...
- Import certificate
Step 6:
After setting the message template, you may now add the required IoT items (tags) which will immediately begin publishing to the MQTT topic
Adding "sensor" tags:
- A list of tags (ie "sensors"), which asset they correspond to, and what type of "sensor" it is (gross, net, reject) is needed
- For each tag in the list, create a sensor in the admin portal and set the sensor ID to:
<device_id>.<tag>where<device_id>is the device id generated in step 0 and<tag>is the tag name as identified above - Add the tag to the IoT Agent in KEPServerEX by clicking "Add IoT items..." and selecting the matching tag name
Adding fault tags:
- A list of tags that emit fault codes and what assets they provide causation information for is needed
- For each tag in the list, create a fault tag in the ioTORQ Lean admin portal and set the tag to:
<tag>where<tag>is the tag name as identified above - Add the tag to the IoT Agent in KEPServerEX by clicking "Add IoT items..." and selecting the matching tag name
*** IMPORTANT NOTES FOR ABOVE SET UP ***
Please use separate devices for sensors and fault tags.
Please keep the number of tags per IoT agent to about 8-10
Therefore, create additional Kepserver devices in the admin portal and corresponding IoT agents in Kepware if necessary.
With this note in mind, you may count the number of tags and estimate how many devices must be created.