Release Notes for Cisco IOx Release 1.4.0
Obtaining Documentation and Submitting a Service Request
These release notes provide information for Cisco IOx Release 1.4.0.
–Cisco IOx: Getting Started with the Cisco 809 or 829 Industrial Integrated Services Router
https://developer.cisco.com/site/iox/docs/index.gsp#getting-started-with-iox
–Cisco IOx Application Developer Guide
https://developer.cisco.com/site/iox/docs/#application-development-concepts
–Cisco IOx Services documentation
https://developer.cisco.com/docs/iox/#iox-services-architecture
https://developer.cisco.com/site/iox/docs/index.gsp#application-networking
https://developer.cisco.com/docs/iox/#what-is-ioxclient
–Cisco IR8x9 and Cisco IE4000 Docker Support
https://developer.cisco.com/site/iox/docs/index.gsp#docker-images-and-packages-repository
https://developer.cisco.com/site/iox/docs/index.gsp#usb-device-usage
https://developer.cisco.com/site/iox/docs/index.gsp#app-visualization-dashboard
https://developer.cisco.com/site/iox/docs/index.gsp#fog-director-api-documentation
https://www.cisco.com/c/en/us/products/collateral/cloud-systems-management/iox/datasheet-c78-736767.html
https://www.cisco.com/c/en/us/support/cloud-systems-management/fog-director/tsd-products-support-series-home.html
https://www.cisco.com/c/en/us/support/cloud-systems-management/iox/products-technical-reference-list.html
Learn how to develop, deploy, and manage applications at the network edge with Cisco IOx:
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.
This release provide new features, including the following:
The following features are not fully tested and may not be fully stable in Release 1.4.0:
Download the Cisco IOx images from the following DevNet page:
https://developer.cisco.com/docs/iox/#downloads
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 2 provides support information for Cisco Fog Director and CAF in the IOx releases.
You can upgrade Cisco Fog Director Release 1.3 to Cisco Fog Director Release 1.4. When you do so, your current Cisco Fog Director data is migrated to the new release.
1. Use the Cisco Fog Director 1.4 VM OVA to instantiate a Cisco Fog Director 1.4 VM.
Copy the file fd-util.deb from the /opt/cisco folder in the Cisco Fog Director 1.4 VM to a location of your choice in the Cisco Fog Director 1.3 VM.
2. Use an SSH client to access your Cisco Fog Director 1.3 VM and log in as the fogdir user.
3. On your Cisco Fog Director 1.3 VM, enter the following command to install the upgrade utility file:
[fogdir]# sudo dpkg -i d-util.deb
4. On your Cisco Fog Director 1.3 VM, take these actions to create an encrypted backup file that contains data and related information from your existing Cisco Fog Director:
a. Enter the following command, replacing backup-file with a name for the backup file. You can include a path with the file name if you want to place the backup file in a directory other than the directory from which you run this command. This command stops Cisco Fog Director release 1.3 if it is running.
[fogdir]# sudo fd-util export backup-file
b. When you see the “Encryption passphrase” prompt, enter a string of characters to be used for encryption and decryption of the backup file, and then press the Enter key.
Make sure to remember this passphrase.
c. When you see the “Enter the encryption passphrase again” prompt, re-enter the passphrase, and then press the Enter key.
The system creates the backup file and then displays the “Export completed” prompt.
5. Copy the backup file that you created to a client PC.
You can place the backup file in any location on the client PC and give it any name.
6. From a client PC, take these actions to obtain the VM OVA image for Cisco Fog Director 1.4:
a. Go to the following URL and click the IOx Fog Director Software link in the Select a Software Type box:
https://software.cisco.com/download/type.html?mdfid=286290097&catid=null
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.
7. Use the VM OVA image that you downloaded to deploy a VM for Cisco Fog Director 1.4.
8. Take these actions to update Cisco Fog Director 1.4 with the information in the backup file that you create:
a. Start and log in to Cisco Fog Director release 1.4.
b. Click the Settings tab and then click the Settings sub-tab.
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 copied to the client PC.
The system updates Cisco Fog Director 1.4 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.4 Log In page displays.
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.
1. Go to https://tools.cisco.com/bugsearch/.
2. Log in with your Cisco.com user ID and password.
3. Enter information in the Search For, Product, and Releases field as needed, then press Enter.
For more information about the Bug Search Tool, click Help on the main Bug Search Tool page.
Table 3 describes known caveats in this release.
Table 4 describes resolved caveats in this release.
Use the following resources if you have any questions or require assistance with Cisco IOx:
For information about obtaining documentation, using the Cisco Bug Search Tool (BST), submitting a service request, and gathering additional information, see What’s New in Cisco Product Documentation.
To receive new and revised Cisco technical content directly to your desktop, you can subscribe to the What’s New in Cisco Product Documentation RSS feed. The RSS feeds are a free service.