IoT Module Management in the Controller

IoT module management in the controller

An IoT module is a hardware extension for APs that

  • connects to the controller via the USB interface for IoT integration, and

  • supports provisioning, deployment and life cycle management of of third-party containerized applications, that act as containers through Cisco Catalyst Center on the APs.

After connecting the USB modules to the APs, log in to the controller and run commands to enable the USB modules and the Cisco IOx application in the APs associated with an AP profile group.

Supported APs

The IoT Module Management feature uses the USB interface to connect to the Cisco Internet of Things (IoT) connector on these APs:

  • Cisco Catalyst 9105AXI

  • Cisco Catalyst 9105AXW

  • Cisco Catalyst 9115AX

  • Cisco Catalyst 9117AX

  • Cisco Catalyst 9120AX

  • Cisco Catalyst 9130AX

Table 1. Feature history for IoT module management in the controller

Feature Name

Release Information

Feature Description

IoT module management in the controller

Cisco IOS XE 17.3.x

From this release, IoT Module Management enables Cisco Catalyst Series APs to connect IoT hardware modules via the USB interface.

This feature allows provisioning, deployment, and lifecycle management of third-party containerized applications on the APs through Cisco Catalyst Center, using the Cisco IOx framework for seamless IoT integration and centralized management.

Enable a USB on the controller

To enable a USB for all the APs connected in an AP profile and to enable Cisco IOx on all the APs, follow this procedure using commands.

Procedure

Step 1

Enter the global configuration mode.

Example:

Device# configure terminal

Step 2

Configure an AP profile and enter the AP profile configuration mode.

Example:

Device(config)# ap profile ap-profile-test

Note

 

You can use the default AP profile (default-ap-profile) or create a named AP profile, as shown in the example in the adjacent column.

Step 3

Enable the apphost framework on Cisco APs.

Example:

Device(config-ap-profile)# apphost

Step 4

Enable a USB for Cisco APs.

Example:

Device(config-ap-profile)# usb-enable

Step 5

Exit the AP profile configuration mode.

Example:

Device(config-ap-profile)# exit

Step 6

Write running configuration to the memory.

Example:

Device(config)# copy running-config startup-config

Verify the USB modules

To verify the state of USB modules, run the command:

Device# show ap config general 
USB Module Type            : USB Module
USB Module State           : Enabled
USB Operational State      : Enabled
USB Override               : Disabled

To verify the apphost status, run the command:

Device# show ap apphost summary
AP Name                 AP Mac               Apphost Status            CAF Port        Apphost HW capable 
---------------------------------------------------------------------------------------------------------
SS-2027                 00xx.abXX.bXXX       Up                        8443             Yes
Axel-2036               04xx.40XX.aXXX       Up                        8443             Yes
Haida-PrePilot          0cxx.f8XX.0XXX       Up                        8443             Yes
Somer-infra-2022        3cxx.0eXX.0XXX       Up                        8443             Yes
AP5C71.0DEC.DB5C        3cxx.0eXX.0XXX       Up                        8443             Yes
AP5C71.0DEC.E3D8        3cxx.0eXX.4XXX       Up                        8443             Yes
Somer-WP-2021           3cxx.0eXX.5XXX       Up                        8443             Yes
AP5C71.0DEC.EC60        3cxx.0eXX.9XXX       Up                        8443             Yes
SS-2005                 6cXX.05XX.dXXX       Up                        8443             Yes
Vanc-2042               d4XX.bdXX.2XXX       Up                        8443             Yes

To verify the apphost status, run the command:

Device# show ap module summary
AP Name         External Module       External Module PID  External Module Description 
----------------------------------------------------------------------------------------------
Axel-2036       Enable 10xx/eaXX/100  CP2XXXX              USB to UART Bridge C 
Haxx-PrePilot   Enable 10xx/eaXX/100  CP2XXXX              USB to UART Bridge C 
APXXX.0XXX.EXX  Enable 10xx/eaXX/100  CP2XXXX              USB to UART Bridge C 
SS-2005         Enable 10xx/eaXX/100  CP2XXXX              USB to UART Bridge C 
Vaxx-2006       Enable 10xx/eaXX/100  CP2XXXX              USB to UART Bridge C