Quickstart Guide

While each app has its own page in the User Guide, this page will walk you through the minimum requirements for getting an app up and running.

Installation

Although the Edge ACM software may already installed, it may be necessary to perform the initial installation or upgrade the existing installation on a piece of hardware. Follow the instructions in the Dealing with software packages to configure the hardware.

Licensing

Before devices can be polled, a License must exist on the hardware.

With Edge Manager installed:

1. Go to http://{EdgeDeviceIP}:8080

2. Select App Manager on the left pane

3. Expand the node at the top of the Explorer pane

4. Right click Edge ACM

5. Select Properties

6. Download a License Request and send that file to your AUTOSOL contact.

7. When you receive a License file, return to Edge ACM properties

8. Use Choose File to select your License

9. Press the Submit button

Congratulations! Your hardware is now licensed and can be used to poll devices!

Edge ACM

https://autosoln.atlassian.net/wiki/pages/resumedraft.action?draftId=298746247 is the the polling engine that collects data from the field device using native protocols and provides that data to other apps for publication, eg. AUTOSOL MQTT, Azure.

In order to poll data, the following objects must be created in Edge ACM:

• One or more Folder objects to hold the other objects

  • Add by right clicking Edge ACM or a folder, selecting Add, then selecting Folder.

• One or more Connection Settings objects to establish the IP and port.

  • Add by right clicking a folder, selecting Add, then selecting Connection Settings

• One or more Schedule objects to configure how frequently Edge ACM will poll its associated Tag Groups

  • Add by right clicking a folder, selecting Add, then selecting Schedule

• One or more Tag Group objects to identify the Tags to be polled

  • Add by right clicking a folder, selecting Add, then selecting Tag Group

• One or more Tag objects in each Tag Group to establish which tags/registers are polled in the end device, and the rules by which it is published.

  • Add by right clicking a Tag Group, selecting Add, then selecting Tag

• One or more Device objects (ControlLogix, Modbus, Roc, TotalFlow).

  • Add by right clicking a folder, selecting Add, then selecting the appropriate Device object.

At least one device object must be Enabled, linked to a Connection Settings object, and have a Tag Group that contains at least one Tag selected in order for communications to occur.

To start Edge ACM, right click Edge ACM, select Commands, and select Start. If the app is Licensed and the above steps have been taken, the indicator circle will turn Green and files will be generated in the Log Viewer

Priority Forward

Priority Forward is the app that allows the App Manager to control access to a device, allowing a primary connection to override all other communications.

In order to control communications, the following objects must be configured in Priority Forward:

• One or more folder objects to hold the other objects

  • Add by right clicking Priority Forward, selecting Add, then selecting Folder

• One or more Advanced Channel Settings object to establish rules for the Channel

  • Add by right clicking a folder, selecting Add, then selecting Advanced Channel Settings

• One or more Channel object to establish the IP and port of the end Device and the local ports used for Primary and Secondary connections

  • Add by right clicking a folder, selecting Add, then selecting Channel

Once these objects exist, right click Priority Forward, select Commands, and select Start

Azure

Azure is the app that publishes data from Edge ACM to your Azure IoT Hub

In order to communicate with your Azure IoT Hub:

• Right click the Azure app and select Properties

• Set the Connection String to match the Primary or Secondary Connection String you have configured within Azure IoT Hub.

  • Each instance of Edge Manager should be configured to publish to a separate Device in Azure IoT Hub

Once the Connection String is configured and the other settings established, right click Azure, select Commands, and select Start to begin publishing to Azure IoT Hub.

AUTOSOL MQTT

AUTOSOL MQTT is the app that publishes polled data from Edge ACM to an MQTT Broker

In order to communicate with an MQTT Broker the following objects must be configured within AUTOSOL MQTT:

• One or more folder objects to hold the other objects

  • Add by right clicking AUTOSOL MQTT or a folder, selecting Add, then selecting Folder

• One or more Broker Connection objects to establish a connection within your MQTT Broker

  • Add by right clicking a folder, selecting Add, then selecting Broker Connection

• One or more Publisher object (Standard Publisher, Sparkplug B Publisher) to establish how data from Edge ACM will be sent to your MQTT Broker through your Broker Connection

  • Add by right clicking a folder, selecting Add, then selecting the appropriate Publisher object

Once the objects have been created, right click AUTOSOL MQTT, select Commands and select Start

Common Issues

If newly saved changes haven’t shown up in your client software, verify that you have issued a Restart or a Stop then Start command to apply the changes..