Configure and Verify IOx on Cisco Controller

Configure IOx app from Cisco Catalyst 9800 series and AireOS wireless controllers

Learn how to configure and verify the IOx application on Cisco Catalyst 9100 Family of APs from the Cisco Catalyst 9800 series and Cisco AireOS wireless controllers.

This section contains configuration and verification commands for controllers.

Cisco AireOS Controller CLI

This section lists the commands that are applicable to the Cisco AireOS series controller.

Configure IOx on AP

To configure IOx on the AP from a Cisco AireOS series wireless controller, use the below command:

Note: Ensure that the AP is added to a non-default ap-group.

Controller(config-ap-profile)# config ap apphost apgroup apphost-test enable

Here, apphost-test is the AP group. The config ap apphost apgroup command enables IOx on all APs in this AP group.

Verify IOx Status on AP

Use the below command on a Cisco AireOS series wireless controller to check if IOx application hosting is enabled on your Cisco Catalyst series AP:

Controller# show ap apphost ap-name APA03D.6F5E.48C8

App Host configuration:

App Host Status.............: Enabled

Cisco Catalyst 9800 series Controller CLI

This section lists the commands that are applicable to the Cisco Catalyst 9800 series controller.

Configure IOx on AP

Use the below commands on a Cisco Catalyst 9800 series wireless controller to enable application hosting framework on your Cisco Catalyst 9100 family of APs:

Controller# conf t

Enter configuration commands, one per line.  End with CNTL/Z.

Controller(config)# ap profile default-ap-profile

Controller(config-ap-profile)# apphost

Note: The default-ap-profile is an AP profile on the controller. The apphost command enables IOx on all APs in this AP profile.

View Status of USB Module

To view the status of the USB modules connected to all joined access points, use the show ap module summary command:

Controller# show ap module summary

Output of show ap module summary:


AP Name       External Module      External Module PID      External Module Description   
----------------------------------------------------------------------------------------
AP1             Enable                10c4/ea60/100         CP2102N USB to UART Bridge C  
AP2             Enable                10c4/ea60/100         CP2102N USB to UART Bridge C  

To view details of an access point that has joined the Cisco Catalyst 9800 series wireless controller along with the status of the access point's USB module(s), use the show ap config general command:

Note: The output below is only a snippet of the actual command output.

Controller# show ap config general

USB Module Type                                 : USB Module
USB Module State                                : Enabled
USB Operational State                           : Enabled
USB Override                                    : Disabled

View IOx Application Hosting Status on the AP

To view the status of IOx Application Hosting on a Cisco Catalyst 9100 family of APs that has joined the Cisco Catalyst 9800 series wireless controller, use the show ap apphost summary command:

Controller# show ap apphost summary 

AP Name           IOx status    IOx HW capable      IOx FW capable

------------------------------------------------------------------

AP1               Up            Yes                 Yes           

AP2               Down          Yes                 Yes           

AP3               Down          Yes                 No