Application Hosting on Cisco Catalyst Access Points

Configure and Verify IOx on Cisco Controller

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.

Code Snippet
CopyController(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:

Code Snippet
CopyController# 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:

Code Snippet
CopyController# 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:

Code Snippet
CopyController# 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.

Code Snippet
CopyController# 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:

Code Snippet
CopyController# 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
Next