Cisco IR1101 Container (Tutorial)) teaches you to:

  • Deploy FrameworX Docker container on Cisco routers using IOx App Hosting
  • Configure network settings for container communication
  • Connect Designer to remote container runtime
  • Upload and run EdgeConnect solutions
  • Set up MQTT SparkplugB data publishing

Prerequisites:

  • Cisco IR1101 router with IOx framework enabled
  • Docker image file: cisco-edge-gateway-[version]_Full.tar
  • Windows computer with FrameworX Designer installed
  • Network access to router (port 8443 for IOx, port 10108 for runtime)

In this page:


Container Deployment → Tutorial | Concept | How-to Guide | Reference

Prepare Router for App Hosting

  1. Access Cisco Local Manager at https://[router-ip]:8443
  2. Navigate to Configuration → Services → IOx
  3. Verify IOx Service is Enabled
  4. If VirtualPortGroup not configured:
    • See detailed steps in [Cisco IR1101 Connector (Reference)]
    • Must be completed before container deployment

Deploy Docker Container

  1. In IOx interface, click Applications tab
  2. Click Add New
  3. Select Docker image:
    • File: cisco-edge-gateway-[version]_Full.tar
    • Application Name: EdgeConnect
  4. Click Upload

Activate Container

  1. Click Activate button for EdgeConnect app
  2. Set resource allocation:
    • CPU: 1000
    • Memory: 800 MB
    • Disk: 300 MB
  3. Configure network:
    • Click Edit → Interface Settings
    • IPv4: Static
    • Container IP: 192.168.1.100 (example)
    • Gateway: 192.168.1.1
  4. Click OK twice
  5. Click Activate App

Start Container Runtime

  1. Return to Applications tab
  2. Find EdgeConnect in list
  3. Click Start
  4. Verify status shows Running
  5. Test connectivity:

cmd

   ping [container-ip]

Connect Designer to Container

  1. Open Solution Center on Windows
  2. Navigate to Server tab
  3. Configure remote connection:
    • Select Remote
    • URL: http://[container-ip]:10108
    • Click Connect
  4. Verify connection:
    • Status: Connected
    • License: EdgeConnect visible

Upload Solution

  1. In Solution Center, click Upload File...
  2. Select your .dbsln solution file
  3. Wait for upload completion
  4. Open the uploaded solution
  5. Go to Runtime → Startup
  6. Select Execution Profile
  7. Click Run Startup

Typical solution configuration 

Configure MQTT Publishing

  1. In Designer, go to Devices → Channels
  2. Add MQTT SparkplugB channel:
    • Name: MQTTSpB_Publisher
    • Protocol: MQTT SparkplugB
    • Broker: Your MQTT server
    • Client ID: CiscoEdge01
  3. Configure SparkplugB namespace:
    • Group ID: Plant01
    • Node ID: Router01
    • Device ID: PLC1


→ Details in [MQTT SparkplugB Publisher Connector]


Test Solution

  1. Open Runtime → Diagnostics
  2. Launch Property Watch:
    • Check tag values updating
    • Verify Quality = 192 (good)
  3. Launch Trace Window:
    • Filter by Devices
    • Look for "Command Success"
  4. Monitor MQTT broker for published messages


Step-by-step guide to deploy FrameworX EdgeConnect as a Docker container on Cisco IR1101 routers using IOx App Hosting framework for industrial edge computing.

In this section...