ExositeReady™ Gateway Engine Solution App

This guide provides an example solution displaying all the telemetric data from ExositeReady™ Gateway Engine (GWE) as well as showing a custom gateway application: "gmq-sine-demo." For additional information and resources, please refer to the GWE documentation home page.

Requirements

This guide requires the installation of GWE on your gateway hardware device. These installation instructions can be found in the GWE Getting-started Guide.

NOTE: This is a technical tutorial. You will need some familiarity with your operating system’s terminal.

Getting Started

Configure Murano

  1. Create a Murano account or log in to your existing account.

  2. In your browser, navigate to the Products tab.

    1. Click "NEW PRODUCT."
    2. In the popup box, name your product whatever you like.
    3. Select Start from scratch from the Choose starting point drop-down menu.
    4. Click "ADD."

      Step 2

  3. Click to open your new product and navigate to the DEVICES tab.

    1. Click "NEW DEVICE."
    2. In the popup box, name your device "Gateway".
    3. Use your gateway's MAC address as the Identity. (Example format "00:08:00:4A:02:25".)
    4. Click "CREATE."

      Step 3

  4. Refer back to the previous step to add another new device called "Test Data", using "12345" as the Identity.

    Step 4

  5. Click to open your Test Data device.

    1. Click "NEW RESOURCE."
    2. In the popup box, input the Alias as “Test” and Data format as float.
    3. Click "CREATE."

      Step 5

  6. Add additional new resources to your "Gateway" device with the Aliases "usage_report", "engine_report", "device_info", "update_interval", "engine_fetch", and "fetch_status". Use string as the Data format for each.

    Step 6

  7. Navigate to the Solutions tab.

    1. Click "NEW SOLUTION."
    2. In the popup box, name the domain whatever you like.
    3. Select Start from scratch from the Choose starting point drop-down menu.
    4. Click "ADD."

      Step 7

  8. Open your terminal to install the Murano CLI tool.

     gem install MuranoCLI
    
  9. Clone the GWE Seed App repository to your machine.

     git clone https://github.com/exosite/GWE-Seed-App
    
  10. Configure MuranoCLI to your business and new solution.

    cd GWE-Seed-App
    murano config business.id <BUSINESS_ID>
    murano config solution.id <SOLUTION_ID>
    
  11. Deploy the solution.

    murano syncup -V --no-specs
    

Configure the Gateway

  1. Ensure GWE has been properly installed on your gateway following the GWE Getting-started guide.

  2. Set the update interval to post data every minute.

     gwe -t 60
    
  3. Install the gmq-sine-demo onto the gateway using the documentation. Use the device identity as the Serial when prompted (12345).

  4. Navigate to your solution page and check to see the data is flowing.

If you encounter any issues, please contact the dedicated GWE support team at gwesupport@exosite.com.