Cisco Catalyst 9800 Series Wireless Controller Software Configuration Guide, Cisco IOS XE 26.1.x

PDF

Cisco Catalyst 9800 Series Wireless Controller Software Configuration Guide, Cisco IOS XE 26.1.x

URWB recovery

Updated: April 10, 2026

Want to summarize with AI?

Log in

URWB recovery enables access points to automatically troubleshoot and restore their connection to the network controller, ensuring seamless connectivity and efficient operations in wireless networks.

The URWB recovery commands are supported on access point (APs) to troubleshoot and restore connectivity when communication with the controller is lost. These commands facilitate the recovery process and ensure that APs can reconnect and resume normal operations.

URWB recovery includes these main features:

  • Helps APs troubleshoot connectivity issues.

  • Automatically downloads the correct configuration after the connection is restored and eliminates the need for manual intervention.

  • Returns the AP to a fully functional state after recovery.

Configure URWB recovery to maintain network efficiency and seamless connectivity.

Prerequisites

  • If the device has a CAPWAP connection, the URWB recovery commands are rejected.

  • Ensure you have physical access to the AP's console.

  • Know the correct alpha-2 country code for the AP's deployment location.

Configure the URWB recovery using AP CLI

Complete these steps to configure the URWB recovery using AP commands.

Procedure

1.

Use the configure urwb recovery conf-reset command to reset the URWB configuration and disable the URWB mode.

Example:

Device#configure urwb recovery conf-reset
Warning

In URWB mode, this command erases all configurations and resets the device to factory default settings in CAPWAP mode.
2.

Use the configure urwb country-code country-code command to configure the country code for initial provisioning.

Example:

Device#configure urwb recovery country-code US
Note

  • Enter the correct Alpha-2 country code (for example, US, IN, GB).

  • Set the country code before changing the radio slot to ensure correct application of the parameters.

  • For WiFi-7 PIDs, the device will prompt you to reload the AP.
3.

Use the configure urwb recovery network-key key command to configure the network-key on the radio interface.

Example:

Device#configure urwb recovery network-key 123456789
Note

The network-key must contain at least 8 characters and can be up to 64 characters. Special characters such as "~|;$<>&^`?/ and "" are not permitted.
4.

Use the configure urwb recovery dot11Radio interface role {fixed | mobility-client } command to configure the role on the radio interface. It can be either fixed or mobility-client.

Example:

Device#configure urwb recovery dot11Radio 1 role fixed
Note

If you need to change both the country code and the radio slot role, set the country code first to ensure the correct application of the parameters.

5.

Use the configure urwb recovery dot11Radio interface band band channel channel bandwidth bandwidth command to configure the radio interface settings.

Example:

Device#configure urwb recovery dot11Radio 1 band 5ghz channel 36 bandwidth 20

  • The radio interface supports 5 GHz and 6 GHz bands. Set the band ID is correctly before configuration.

  • Operating channel range is 1 to 256.

  • Supported radio bandwidth options are 20 MHz, 40 MHz, 80 MHz, and 160 MHz.

6.

Use the configure urwb recovery dot11Radio interface encryption {aes-fixed-key | aes-rotating-key | disable} command to assign an encryption to the selected radio interface.

Example:

Device#configure urwb recovery dot11Radio 1 encryption aes-fixed-key
7.

Use the reload command to apply the changes.

Example:

Device#reload
Note

The configuration is saved automatically.
8.

Use configure urwb recovery dot11Radio interface dual-band band {5GHz | 6GHz | 24GHz} command to configure the URWB dual-band mode.

Example:

Device#configure urwb recovery dot11Radio 1 dual-band 5ghz
9.

Use configure urwb recovery dot11Radio interface dual-radio mode mode {enable| disable} command to configure the URWB dual-radio mode.

Example:

Device#configure urwb recovery dot11Radio 1 dual-radio mode enable

Country code behavior on AP models

Country code behavior on WiFi-6 PIDs (IW916x -ROW models)

Note

The recovery CLI does not support country code configuration for non-ROW Wi-Fi 6 PIDs.

  • Country code configuration is applicable for ROW PIDs.

  • The system prevents configuration for non-ROW PIDs.

  • The country code you configure determines the valid frequencies and bandwidths allowed in the regulatory domain.

Country code behavior on WiFi-7 PIDs

Note

For WiFi-7 PIDs, reboot the AP after configuring the country code through the recovery CLI. This ensures the changes take effect.

  • The configured country code is used only for the initial connection.

  • After the AP joins the controller, the regulatory configuration received from the controller is automatically applied to the AP.

  • If the country code has already been programmed through the controller, this initial configuration step is not necessary.

URWB recovery configuration example

Procedure

1.

Use the configure urwb recovery dot11Radio 1 command to select the radio interface for configuration.

Example:

Device#configure urwb recovery dot11Radio 1
2.

Use the configure urwb recovery dot11Radio 1 role radio-role command to set the radio role.

Example:

Device#configure urwb recovery dot11Radio 1 role ptmp

The radio role is set to Point-to-Multipoint (PtMP)
3.

Use the configure urwb recovery dot11Radio 1 role radio-role cluster-id id command to assign a cluster ID to the radio interface.

Example:

Device#configure urwb recovery dot11Radio 1 role ptmp cluster-id test
4.

Use the configure urwb recovery dot11Radio 1 band band channel channel bandwidth bandwidth command to configure the frequency and channel parameters.

Example:

Device#configure urwb recovery dot11Radio 1 band 5ghz channel 36 bandwidth 20
5.

Use the reload command to apply the configuration and restart the access point.

Example:

Device#reload

The access point restarts and the new recovery settings take effect.