PDF(217.2 KB) View with Adobe Reader on a variety of devices
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
Cisco IOx provides uniform and consistent hosting capabilities for various types of apps across Cisco platforms. This platform brings together Cisco IOS, the industry-leading networking operating system, and Linux, the leading open source platform. Linux-based applications can run on Cisco devices in the Cisco IOx framework, so using this platform, you can bring custom applications and interfaces to the network.
With Cisco IOx, developers can create a wide variety of IoT apps, such as data aggregation system and control systems.
New Features in this Release
This release provides new features, including the following:
Cisco Fog Director
–Amber app signed status icon—This new icon indicates that an app is signed but the signature verification with a developer certificate and the developer certificate verification with a Certificate Authority will occur during installation of the app on a device.
–TCP port mapping—Configuration fields that display depend on the package.yaml file for an app, and can include fields for configuring a single port and a range of ports.
–UDP port mapping—Configuration fields that display depend on the package.yaml file for an app, and can include fields for configuring a single port and a range of ports.
–Mirroring—You can enable port mirroring for an app if supported by the app and device.
–VLAN ID—You can configure a VLAN on which an internal network operates.
–Dynamic addition/removal of network interfaces—You can add network interfaces during app install or edit workflow. The total number of interfaces can be a maximum of three unless the package.yaml file for the app asks for more than three interfaces, in which case you can configure as many as that file asks for. You can also remove the dynamically added network interfaces but not the interfaces asked by the package.yaml.
Cisco Local Manager
–Mirroring—You can enable port mirroring for an app if supported by the app and host system.
–VLAN ID—You can configure a VLAN on which an internal network operate.
Cisco IOx Release is supported on the following platforms:
IR809 (supported for release 1.10.0)
IR829 (supported for release 1.10.0)
IR1101 (supported for release 1.10.0)
ESR6300 (supported for release 1.10.0)
IE3400/IE3400H (supported for release 1.10.0)
ESS3300 (supported for release 1.10.0)
CGR 1000 Compute Module (supported for release 1.10.0)
IC3k (supported for release 2.0)
Download the Cisco IOx images from the following DevNet page:
Note: IOx Fog Node images cannot be randomly loaded with any IOS images. Please do not make any changes without the guidance of a Cisco Technical Support representative.
Table 1 provides information about the available Cisco IOx images.
Table 1 Cisco IOx Images
Cisco IOx Fog Director software.
IOxClient, which is a command line tool provided as part of the Cisco IOx SDK and which is meant primarily to assist with app development for Cisco IOx platforms.
IOxClient is available for Linux 32/64 bit, MAC OS 32/64bit, and Microsoft Windows 32/64bit platforms.
Table 2 provides support information for Cisco Fog Director and CAF in the IOx releases.
Table 2 Cisco Fog Director and CAF Support Matrix
Fog Director 1.10
Fog Director 1.9
Fog Director 1.8
Fog Director 1.7
Note: App files that should persist when the app container reboots should be uploaded to the /data directory for that app. You can use Cisco Local Manager, Cisco Fog Director, or an SSH connection to upload the files.
Limitations and Restrictions
Upgrades of platform images must be performed from n -1’ to n release only ( n = the latest release).
If CAF crashes abruptly, CAF comes back up with limited functionality. If app management services are down you can download the tech support logs and verify the reason from the CAF logs or in syslog files. An example for app management going down is a CAF abrupt crash.
The workaround is to reboot the device. If the app management services are down after the device reboots, collect the tech support logs from the device before contacting the support team.
App asking for multiple USB ports and devices is not supported. This restriction applies only to FD.
USB device hot swap-out and swap-in are not supported. You must plug in the USB device before installation the application on the IOx device.
You can use the Bug Search Tool to find information about caveats, including a description of the problems and available workarounds. The Bug Search Tool lists both open and resolved caveats.
Call Cisco Support at 1.408.526.7209 or 1.800.553.2447.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1721R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.