capwap Commands

capwap ap

To configure the primary, secondary and tertiary controllers for the AP, use the capwap ap command.

capwap ap {primary-base | secondary-base | tertiary-base}controller-name controller-ip-address

Syntax Description

primary-base

Configure AP's primary controller
secondary-base

Configure AP's secondary controller
tertiary-base

Configure AP's tertiary controller
controller-name

Name of the controller
controller-ip-address

IP address of the controller.

Command Modes

Privileged EXEC (#)

Command History

Release Modification

8.1.111.0

This command was introduced.

Examples

The following example shows how to configure the primary controller for the AP:

cisco-ap# capwap ap primary-base wlc-5520 209.165.200.224

capwap ap auth-token

To configure authentication token, use the capwap ap auth-token command.

capwap ap auth-token ssc-token

Syntax Description

ssc-token

SSC token; valid range is 8 to 32 characters

Command Modes

Privileged EXEC (#)

Command History

Release Modification

8.1.111.0

This command was introduced.

Examples

The following example shows how to configure authentication token,:

cisco-ap# capwap ap auth-token myauthtoken

capwap ap erase

To erase CAPWAP configuration, use the capwap ap erase command.

capwap ap erase { all | static-ip}

Syntax Description

all

Erases all CAPWAP configuration

Note 

If the AP is in Bridge mode, then the same Bridge mode is retained after the factory reset of the AP; if the AP is in FlexConnect, Local, Sniffer, or any other mode, then the AP mode is set to Local mode after the factory reset of the AP. If you press the Reset button on the AP and perform a true factory reset, then the AP moves to a cookie configured mode.

static-ip

Erase static IP or DNS configuration

Command Modes

Privileged EXEC (#)

Command History

Release Modification

8.1.111.0

This command was introduced.

Examples

The following example shows how to erase all the CAPWAP configuration on the AP:

cisco-ap# capwap ap erase all

capwap ap ethernet

To configure AP Ethernet parameters, use the capwap ap ethernet command.

capwap ap ethernet tag ethernet-vlan-id

Syntax Description

ethernet-vlan-id

Ethernet VLAN ID; valid range is 0 to 4094. If you enter the VLAN ID value as 0, the VLAN tagging is disabled.

Command Modes

Privileged EXEC (#)

Command History

Release Modification

8.1.111.0

This command was introduced.

Examples

The following example shows how to configure Ethernet VLAN tagging on the AP:

cisco-ap# capwap ap ethernet tag 2

capwap ap hostname

To configure AP hostname, use the capwap ap hostname command.

capwap ap hostname ap-name

Syntax Description

ap-name

AP name

Command Modes

Privileged EXEC (#)

Usage Guidelines

If the AP is already associated with a Cisco WLC, the new hostname is reflected on the Cisco WLC only after the AP dissociates and reassociates with the Cisco WLC.

Command History

Release Modification

8.1.111.0

This command was introduced.

Examples

The following example shows how to configure a hostname for the AP:

cisco-ap# capwap ap hostname cisco-wave2-ap-2802

capwap ap ip

To configure static IP address and DNS for the CAPWAP AP, use the capwap ap ip command.

capwap ap ip static-ip-addr static-netmask ip-addr-default-gateway [ ip-addr-dns1 | ip-addr-dns2] [ domain-name]

Syntax Description

static-ip-addr

Static IP address of the AP
static-netmask

Static netmask
ip-addr-default-gateway

IP address of the default gateway
[ip-addr-dns1 | ip-addr-dns2]

(Optional parameters) IP address(es) of the DNS

[domain-name]

(Optional parameter) Domain name

Command Modes

Privileged EXEC (#)

Command History

Release Modification

8.1.111.0

This command was introduced.

Examples

The following example shows how to configure static IP address and DNS for the CAPWAP AP:

cisco-ap# capwap ap ip 209.165.200.225 255.255.255.224 209.165.200.227 209.165.200.226 example.org

capwap ap lag

To configure CAPWAP lag, use the capwap ap lag command.

capwap ap lag { enable | disable}

Syntax Description

enable

Enables LAG
disable

Disables LAG

Command Modes

Privileged EXEC (#)

Command History

Release Modification

8.1.111.0

This command was introduced.

Examples

The following example shows how to enable LAG on the AP:

cisco-ap# capwap ap lag enable

capwap ap mesh strict-wired-uplink

To configure the root access points (RAPs) to stay as persistent RAPs even if the wired uplink is lost, use the capwap ap mesh strict-wired-uplink command.

capwap ap mesh strict-wired-uplink {enable | disable}

Syntax Description

enable

Enables strict wired uplink on the Cisco AP.

disable

Disables strict wired uplink on the Cisco AP.

Command Modes

Privileged EXEC (#)

Command History

Release Modification

8.9

Cisco IOS XE Gibraltar 16.11.1

This command was introduced.

Examples

The following example shows how to enable the root access points (RAPs) to stay as persistent RAPs even if the wired uplink is lost: 

cisco-ap# capwap ap mesh strict-wired-uplink enable

capwap ap mode

To configure AP mode, use the capwap ap mode command.

capwap ap mode { bridge | local}

Syntax Description

bridge

Enables bridge mode
local

Enables local mode

Command Modes

Privileged EXEC (#)

Command History

Release Modification

8.1.111.0

This command was introduced.

Examples

The following example shows how to configure the AP to operate in local mode:

cisco-ap# capwap ap mode local

capwap ap restart

To restart the CAPWAP protocol, use the capwap ap restart command.

capwap ap restart

Syntax Description

restart

Restart the CAPWAP protocol

Command Modes

Privileged EXEC (#)

Command History

Release Modification

8.1.111.0

This command was introduced.

Examples

The following example shows how to restart CAPWAP protocol:

cisco-ap# capwap ap restart