Documentation Center

relayr Edge Agent and the Cisco/Avnet/Intel IoT Starter Kit


The relayr Edge Agent is a Fog Computing software component that runs on edge devices that link sensor and/or actuator nodes to a public and/or private cloud. It runs on an IoT gateway and is intended for use by developers, industrial engineers, facility managers, system integrators, etc., who are working on enterprise IoT deployments.

This page describes how to set up the Edge Agent on a Cisco® IR809 Gateway.


  1. You have already completed the steps in the IR809 Setup Guide.
  2. The Cisco® IR809 has internet connectivity.

Deploying the relayr Application on IR809 Guest OS

  1. Open IOx Local Manager on a supported internet browser (works best on Google® Chrome or Mozilla Firefox) on your computer, open URL: https://<IOx IP Address>:8443
    IOx Local Manager Login Page
  2. Log in with the IOx Local Manager credentials you set up in the IOS CLI (step 2 of “Setting up the Cisco® IR809” > Basic Configuration).
  3. Download relayr application package tar from this Github repository to your computer.
  4. Deploy the relayr application on IOx Local Manager:
    1. Click on Add/Deploy button:
    2. Specify the application name as “relayr” (or another name of your choice). Click on the “Choose file” button and select the relayr application package tar file downloaded from Github in a prior step:
  5. Activate the relayr application:
    1. Click the Activate button:
    2. Choose “c1.large” Profile under Resource Profile and click the “Activate” button:
  6. Create a new relayr Developer Dashboard Account on
    1. Click on Log in link at the bottom-left, select the Create Account tab and follow the steps on the screen. A step-by-step procedure is available in the relayr Documentation for creating an account.
    2. Log in to the relayr Developer Dashboard ( with your account credentials. Go to the Account link on the left navigation.
    3. Note/Copy the Account Authentication Token (also known as Bearer Token) for the next step.
  7. The steps below are to apply Customer-specific Application Configuration before relayr application is started.
    1. Click on App-Config tab under “relayr” tab:
    2. Copy-paste the configuration parameters below:
      RELAYR_BEARER_TOKEN=<Bearer token from, excluding "Bearer " prefix>
      RELAYR_EDGE_AGENT_NAME=<Suitable name for your Edge Agent node - e.g. Edge-Compressor >
      RELAYR_EDGE_AGENT_LOCATION=<Suitable location for Edge Agent location - e.g. Boston Plant>
    3. Replace contents enclosed in <> above commands with Bearer Token without the “Bearer ” keyword, Edge Agent Name (enter text) and Edge Agent Location (enter text):
    4. Click Save.
  8. Start the relayr application by clicking Start link next to the application on the IOx Local Manager:
    Starting the relayr application starts the application components - relayr Edge Agent, relayr System Health Adapter and Node Red.
  9. Look up the IP address of the relayr application:
    1. Click on the App-info tab, then click on “interface-name” value:
    2. Copy IP Address of the relayr application shown on the pop-up:
  10. In accordance with Cisco’s recommended setup, Guest OS runs in a different subnet and may not be accessible from your computer. NAT settings on the IR809 CLI are needed to access relayr Application components (Node-Red on port 1880 and Vertex Broker on port 1883) from the web-browser:
    1. Log in to the IR-809 CLI, then go to privileged mode by running the IOS enable command.
    2. Then go to the configuration prompt by typing the command configure terminal.
    3. Run the following command to map port of node-red application, substituting the IP address obtained in the previous step:
      ip nat inside source static tcp _IP Address of relayr application_ 1880 interface GigabitEthernet0 1880   
      ip nat inside source static tcp <IP Address of relayr application> 1883 interface GigabitEthernet0 1883
  11. Go to Node-red UI from a supported web browser:
    1. Type http://<IP Address assigned to GigabitEthernet0 of IR-809>:1880
    2. The browser should bring up the node-red UI.
  1. Set up the sensors and IO-Link Master as per steps in the Setting Up the Hardware section.
  2. Set up the IO-Link Master as per steps in the Connecting and Configuring the IO-Link Master section.
  3. Skip the “Setting Up the Software” section. All the needed software is already pre-packaged in the relayr application and deployed in the prior steps.
  4. Create a Device in the Developer Dashboard, as per instructions.
  5. Refer to documentation on Reading Sensor Data via Modbus and Publishing to the relayr Cloud for node-red configuration to publish readings to the relayr cloud.

Next: Connect and Configure Intel® Edison Controller with Sensors

Now that you’ve set up the relayr software, proceed to the Intel® Edison Guide for information on how to connect the Intel® Edison controller with sensors.

© 2017 relayr · Imprint