- Introduction to IOx
- IOx Edge Compute Devices
- IC3000-series
- IR 800-series
- IR 1100 Series
- IE 4000-series
- IE3x00 Series
- IE93xx Series
- CGR 1000 Compute Module
- ISR 800-series
- Catalyst 9000-series
- ISR 4000/ASR 1000-series
- Comparison of IOx Devices
- IOx Resource Downloads
- IOx Local Manager
- IOx Development Tools
- ioxclient Reference
- What is ioxclient?
- Profiles
- App management
- App file management
- App console
- Service management
- Platform management
- Getting CAF Metrics
- Manage devices
- Managing logical networks
- Manage platform log files
- Manage package signature validation
- Debuggability and Diagnostics
- Platform Certificates
- Smart License Management
- Cartridge management
- Messaging service
- Docker commands
- Docker Layers
- Docker Toolchain Setup
- ioxclient Reference
- IOx App Tutorials
- Docker Applications
- Overview
- Tutorial: Deploy Dockerhub Image
- Tutorial: Create Custom Package Descriptor for Docker Apps
- Tutorial: Build Sample Docker Type IOx app Using Docker Toolchain
- Tutorial: Build Sample Docker Type Python Simple App
- Tutorial: Build Sample Docker Type C Based Simple App
- Tutorial: Build Sample Docker Type Python with C App
- Tutorial:Build Sample Docker Type C++ Based Simple App
- Tutorial: Build Sample Docker Type nodejs Based HTTP Server Using Alpine Base Image
- Tutorial: Build Sample Docker Type IOx App That Consumes GPS Service
- VM Applications
- Legacy Styles
- Docker Applications
- IOx App Concepts
- Advanced Features
- Application Groups
- Remote Docker workflow
- OVA to IOx VM App Package Deployment
- Debuggability and Diagnostics
- USB Storage and Serial Device
- IOx Services
- Key Value Datastore
- Cisco Local Manager Based App Console Access
- Fog Director API Documentation
- IOx Smart Licensing
- Access GPS data from an IOx App via serial interface on IR1101
- Troubleshooting Guide
- Developer Resources
- Community and Support
CGR 1000 Compute Module
The CGR Compute Module is a modular, hardened server that can be installed in CGR 1000 routers. The compute module functions as a fog computing node at the edge of the network. See the following documents for more information about the compute module:
- Cisco CGR 1000 Compute Module Installation and Configuration Guide
- Release Notes for Cisco IOS CGR 1000 Compute Module
Note: In this and the above documents, the Compute Module is identified as a server module in Cisco IOS commands.
IOS Image
The minimum IOS version required for IOx support is 15.6(3)M2.
IOx Image
IOx functionality is part of the server module image. The minimum server module image version is 1.2.5.1.
Note: The server module image is NOT part of the CGR bundle image.
Getting Full Bandwidth to Your IOx App
Do not use the router’s virtual interface svcbr_0 -- GigabitEthernet/2 for anything other than low bandwidth management traffic. This interface is an emulated Ethernet via an internal shared USB that has a throughput of 4 Mbps and an MTU of 1492.
Instead, use the CGM-SRV-64 or CGM-SRV-128 external physical port with a cable that is plugged back into one of the Gigabit Ethernet ports on the CGR.
Physical Cabling
Interfaces
The server module has the following internal and external interfaces:
Internal Interfaces
- console: virtual console line to the server module’s Host-OS
- interface management interface: interface GigabitEthernet<slot#>/1 providing networking connectivity for IOx host
- internal interface to application: interface GigabitEthernet<slot#>/2 providing networking connectivity for IOx applications
Note: When sending traffic over the internal gig {slot}/2 interface, from the application to IOS or the external machine, we are rate-limited to 4 Mbps. For higher traffic, the external interface on the server module is the recommended option.
In addition, the MTU Setting must be 1492 on both sender and receiver interfaces. The MTU setting on the Server module interface can scale only to 1492 and does not support path discovery. If the external machine supports MTU path discovery, you can configure the CGR1000 gig{slot}/2 interface MTU to 1492, since IOS supports the feature. Using the above settings ensures fragmentation for any packet size will work.
External Interfaces
- front panel RJ45 Gigabit Ethernet Interface: providing IOx applications direct access to the external network
- USB0 and USB1: two USB2.0 ports. You can connect an external USB flash drive for extra storage. These ports cannot be used as power sources.
Compute Module Front Panel
Basic IOS and IOx Configuration
Configuring Networking for IOx Host
Configuring Local DHCP Pool for Server Module Host IP Address Assignment
To assign an IP address to an IOx host, configure a Local DHCP pool on IOS with interface GigabitEthernet<slot#>/1 as the default router.
Note: NAT rule to be configured for IOx host must be reachable from outside.
Configuring Networking for IOx Apps
Configuring Local DHCP Pool for IOx Apps
To assign an IP address to IOx Apps, configure a Local DHCP pool on IOS with interface GigabitEthernet<slot#>/2 as the default router.
Note: The applications can also connect to the outside via the front panel Ethernet port on the server module.
Configure NTP server for the router
Note: The Guest OS VM periodically compares its time with the Cisco IOS time. If the difference in times is more than 60 seconds, the Guest OS VM resynchronizes its time to the Cisco IOS time. No user configuration is required to initiate Guest OS VM clock synchronization or to modify clock settings. You can configure Cisco IOS to synchronize to an external NTP server.
In config terminal, use the following commands:
Getting IOX Details
Download and Upgrade Server Module Image
You can copy the server module image to flash using http, tftp, or scp protocols. Then, run the server-module install command to upgrade the server module image.
Verify the Host OS version after image upgrade.