PDF(387.5 KB) View with Adobe Reader on a variety of devices
ePub(77.9 KB) View in various apps on iPhone, iPad, Android, Sony Reader, or Windows Phone
Mobi (Kindle)(78.0 KB) View on Kindle device or Kindle app on multiple devices
Updated:January 11, 2018
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 various 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 Release 1.5.0
This release provide new features, including the following:
Overhaul debuggability from LM/FD
Run diagnostics from LM/FD
Docker templates with various programming languages run times and libraries using Docker tooling
App monitoring and troubleshooting
Smart Licensing for IOx Ordering—Available on the IR809 and IR829
Secure Storage—Available on the IR809, IR829, and IE4000
GPS over serial interface
Cisco provides micro services which are a set of pre-built protocol handlers that help provide data acquisition capabilities from various devices into the IOx Services ecosystem. Applications can be built for these services to do edge computing and to send data to the cloud.
These micro services
are built using the IOx Services SDK (only supported on IR8xx platforms).
provide RESTful APIs to configure the service.
can access normalized data from the configured device through REST and Web Socket URIs provided by the north bound interface (NBI) gateway.
The following services are supported:
Cisco IOx Release 1.5.0 is supported on the following platforms:
Enterprise—ISR4K running on Cisco Polaris network operating system
Utility—Pluggable CGR compute module for CGR1120 and CGR1240
Note: If you have a new production IR809 or IR829, ensure you reboot the system after adding the basic IOx configurations.
Note: Before attempting a bundle image installation, stop the guest operating system by using following command on IOS:
guest-os 1 stop
Download the Cisco IOx images from the following DevNet page:
b. Click the Download button that corresponds to the.ova file that you want.
c. Follow the on-screen instructions to download the file to your local drive.
6. Use the VM OVA image that you downloaded to deploy a VM for Cisco Fog Director 1.5.
7. Take these actions to update Cisco Fog Director 1.5 with the information in the backup file that you create:
a. Start and log in to Cisco Fog Director Release 1.5.
b. Click the Settings tab and then click the Settings sub-tab.
The Settings page displays.
c. In the Backup & Restore area on the Settings page, click the RESTORE button.
The Restore dialog box displays.
d. In the Decryption password field in the Restore dialog box, enter the passphrase that you created for the backup file.
e. Click SELECT BACKUP ARCHIVE in the Restore dialog box, and then navigate to and select the backup file that you downloaded to the client PC.
The system updates Cisco Fog Director 1.5 with the information in the backup file. This process can take some time, depending on how much data is in the backup file.
When the upgrade completes, the Cisco Fog Director 1.5 Log In page displays.
In Release 1.5 of Fog Director, there are a few IOx Services that are pre-packaged with Fog Director. When you upgrades from 1.4 to 1.5 using the above procedure, these pre-packaged services will no longer be present in the upgraded Fog Director.
To restore these pre-packaged services:
1. Go to the /opt/cisco/iox_services directory in the Fog Director 1.5 VM where the pre-packaged services are presented as tar files.
2. Copy these tar files to your computer.
3. Log in to the upgraded Fog Director, and click the Apps tab.
4. Complete the following tasks for each tar file that you copied in Step 1:
a. Click on Add New App, choose Upload from my computer, and select the tar file.
b. After the file finishes uploading, click Publish.
Limitations and Restrictions
Client ID configuration on IOS must be changed to dhclient format after migrating from the IOx 1.3.0 bundle image to IOx 1.4.0 or later versions of the Docker styled app. Without changing this format, the Docker app will not get an IP address in bridge networking mode after the migration.
Uploading and installing an app that requires more than one serial device is not supported.
If the IOx Core service bundle is corrupted and does not get into the RUNNING state, the bundle’s dependent services and apps also will not get into the RUNNING state. To resolve this issue, reactivate the dependent services.
To reflect the latest status of the IOx Core services container on the FD GUI, perform a device refresh. For example, if you install the GPS service, the core service automatically gets started. However, the status will not be reflected on FD GUI unless you refresh the device.
If you perform an FD Backup and Restore from FD 1.4.0 to FD 1.5.0, all of the prepackaged apps (IOx Core and IOx GPS) will be cleared and not available.
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.
The following sections provide information about caveats in this Cisco IOx release:
You can use the Bug Search Tool to find information about caveats for this release, including a description of the problems and available workarounds. The Bug Search Tool lists both open and resolved caveats.
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. (1110R)
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.