Commands for WDS

19.1 AC configuration command

19.1.1 wds-group

Command: wds-group <1-8>
no wds-group <1-8>
Function: Adds a WDS AP group configuration based on WDS configuration. The no command deletes the WDS group.
Parameters:

  • <1-8>: the number of WDS AP group.

Command mode: Wireless Config
Default: None.
Usage guide: If the WDS AP group does not exist, add a WDS AP group configuration. Enter the WDS AP group configuration mode; it is a rewriteable parameter.
Example: Add WDS group 1.

active500EM(config)#wireless
active500EM(config-wireless)#wds-group 1

Delete WDS group 1.

active500EM(config-wireless)#no wds-group 1

 

19.1.2 group-name <name>

Command: group-name <name>
no group-name <name>
Function: Name the WDS AP configuration group. The no command resets the name of the particular WDS AP group to the default name.
Parameters:

  • <name>: represents the name of WDS AP group; the length is 1-32 characters, including numbers, letters, and special characters/symbols.

Command mode: WDS AP Group Config
Default: WDS-AP-Group-n; n represents the corresponding WDS AP group number.
Usage guide: Configuration of the name of the WDS AP group.
Example: Set the name of the WDS group 1 as abc.

active500EM(config-wireless)#wds-group 1
active500EM(config-wds-ap-group)#group-name abc

 

19.1.3 password

Command: password <password>
no password
Function: Set up the password to connect WDS in the AP of the WDS AP group. The no command resets the password to the default: AP-group-n.
Parameters:

  • <password>: represents the WDS AP group password. The length is between 8-63 characters, including numbers, letters, and special characters/symbols.

Command mode: WDS AP Group Config
Default: AP-Group-n; n represents the corresponding WDS AP group number.
Usage guide: This command sets the password to be used in the WDS connection to the WDS AP group.
Example: Set up password of 1234567890 when connecting WDS for the AP of WDS AP group 1.

active500EM(config-wireless)#wds-group 1
active500EM(config-wds-ap-group)#password 1234567890
The valid AP group entry is updated. The new password may disconnect the WDS links that are already connected.

 

19.1.4 password encrypted

Command: password encrypted <password>
Function: Create an encrypted password for connecting the AP in the WDS AP group.
Parameters:

  • <password>: the WDS AP group configuration encrypted password; the length is 128 characters.

Command mode: WDS AP Group Config
Default: None.
Usage guide: Set up the 128 digits encrypted password that is used to connect the WDS AP group.
Example: Set up the 128 digits encrypted password that is used to connect the WDS AP group.

active500EM(config-wds-ap-group)#password encrypted
188770c284ba7fcbe136f5b04f03803036e46608a73fedf2df578c78b99687bb7beb48e95bd2e01
a1a1a1d 11ddd 2f2f2f2f2 c2c2c5cdcdcfcaa855a8888e8aaa

 

19.1.5 spanning-tree

Command: spanning-tree
no spanning-tree
Function: Open the spanning tree function on the WDS AP group. The no command represents closing the spanning tree function on the WDS AP group.
Parameters: None.
Command mode: WDS AP Group Config
Default: Disabled.
Usage guide: This command enables/disables the spanning tree function and saves the configuration to the WDS configuration database.
Example: Enable/disable the spanning tree on the internet.
Open the spanning tree function on the WDS AP group.

active500EM(config-wds-ap-group)#spanning-tree

Close the spanning tree function on the WDS AP group.

active500EM(config-wds-ap-group)#no spanning-tree

 

19.1.6 ap [spanning-tree priority]

Command: ap <macaddr> [spanning-tree priority <0-61440>] no ap <macaddr>
Function: Add an AP to the WDS AP group. The no command deletes the existing AP in the particular WDS AP groups.
Parameters:

  • <macaddr>: MAC address to be added to the WDS AP group.
  • priority <0-61440>: the STP priority value that is added to the WDS AP group?s AP configuration.

Command mode: WDS AP Group Config
Default: spanning-tree priority default value is 36864.
Usage guide: Use this command to add an AP to the WDS group.
Example: Add 2 APs to WDS group 1. One has a spanning tree priority value of 5000.

active500EM(config-wds-ap-group)#ap f8-f7-d3-00-03-a0
active500EM(config-wds-ap-group)#ap f8-f7-d3-00-03-a0 spanning-tree priority 5000

 

Command: wds-ap-link srcap <macaddr> radio <1-2> dstap <macaddr> radio <1-2> [spanning-tree pathcost <0-255>] no wds-ap-link srcap <macaddr> radio <1-2> dstap <macaddr> radio <1-2> [spanning-tree pathcost <0-255>]
Function: Set up the WDS connection in the WDS AP group and set the pathcost value to particular devices. The no command has two functions:

1. When the parameter [spanning-tree pathcost <0-255>] is entered, it means that the STP pathcost value has been reset to default.
2. If a parameter is not entered, the no command deletes the WDS connection, which was already set up.
Parameters:

  • srcap <macaddr>: MAC address of the AP connected with WDS.
  • radio <1-2>: the radio signal that the AP uses to connect to WDS.
  • dstap <macaddr>: the MAC address that is the destination of the WDS connection.
  • radio <1-2>: radio signal of the AP connected with WDS.
  • [spanning-tree pathcost <0-255>]: configure particular WDS connection STP pathcost value; this parameter can be selected as a configuration parameter.

Command mode: WDS AP Group Config
Default: spanning-tree pathcost default value is 40.
Usage guide: Configure linkage on the WDS group.
Example: Both APs: f8-f7-d3-00-03-a0, f8-f7-d3-00-03-60 using radio 1 to build up linkage. The linkage value spanning-tree pathcost is 233.

active500EM(config-wds-ap-group)#wds-ap-link srcap f8-f7-d3-00-03-a0 radio 1 dstap f8-f7-d3-00-03-60 radio 1 spanning-tree pathcost 233

Delete the linkage that already exists.

active500EM(config-wds-ap-group)#no wds-ap-link srcap f8-f7-d3-00-03-a0 radio 1 dstap f8-f7-d3-00-03-60 radio 1

 

19.1.8 peer-switch configuration wds-group

Command: peer-switch configuration wds-group
no peer-switch configuration wds-group
Function: Send the configuration while the AC transmits. The no command represents not sending the WDS configuration during the transmission.
Parameters: None.
Command mode: Wireless Configuration Mode
Default: None.
Usage guide:? Send the configuration while the AC transmits.
Example: Transmit WDS on the configuration of the controller.

active500EM(config)#wireless
active500EM(config-wireless)#peer-switch configuration wds-group

 

19.2 Only configured on the controller

19.2.1 wireless wds-group network configure

Command: wireless wds-group network configure
Function: When using this function, save the local WDS configuration, send to the peer switch of the cluster, and send to the WDS AP in the cluster.
Parameters: None.
Command mode: Privileged EXEC Mode
Default: None.
Usage guide: This command is only saved on the cluster controller.
Example: WDS configuration will send to other peer switches in the cluster and will send to the WDS AP in the cluster.

active500EM#wireless wds-group network configure

 

19.2.2 wireless wds-group network change-password

Command: wireless wds-group <1-8> network change-password <password>
Function: Set up the new password to the particular cluster?s WDS group configuration.
Parameters:

  • <1-8>: the particular WDS AP group number.
  • <password>: the particular WDS group configuration new password; the length is 8-63 characters.

Command mode: Privileged EXEC Mode
Default: None.
Usage guide: This command only saves on the cluster controller.
Example: Change the new password to 87654321 in the WDS group 1.

active500EM#wireless wds-group 1 network change-password 87654321

 

19.2.3 wireless wds-group network change-password encrypted

Command: wireless wds-group <1-8> network change-password encrypted <password>
Function: Set a new encrypted password in the particular cluster of the WDS AP.
Parameters:

  • <1-8>: the particular WDS AP group number.
  • <password>: the particular WDS group configuration encryption password; the maximum length is 128 characters.

Command mode: Privileged EXEC Mode
Default: None.
Usage guide: This command only saves on the cluster controller.
Example: Change the 128 digits encrypted and password of WDS group 1.

active500EM#wireless wds-group 1 network change-password encrypted 8188770c284ba7fcbe136f5b04f03803036e46608a73fedf2df-578c78b99687bb7beb48e95bd2e0

 

19.2.4 wireless wds-group network change-password start

Command: wireless wds-group <1-8> network change-password start
Function: Trigger controller to send the new password and send the message to all facilities in the cluster.
Parameters:

  • <1-8>: the group number of the particular WDS AP group.

Command mode: Privileged EXEC Mode
Default: None.
Usage guide: This command only saves on the cluster controller.
Example: Start to use the new password of WDS group 1 configuration.

active500EM# wireless wds-group 1 network change-password start

 

19.3 show command

19.3.1 show wireless wds-group

Command: show wireless wds-group [<1-8>] Function: Show the configuration message in the particular group of the WDS AP.
Parameters:

  • <1-8>: the particular WDS AP group number, the parameter is optional.

Command mode: Privileged EXEC Mode
Default: None.
Usage guide: Show the particular group configuration information as if the group number of WDS AP is set.
Example: Check the configuration message of WDS 1 group.

active500EM#show wireless wds-group 1
WDS Managed AP Group ID........................ 1
Group Name..................................... WDS-AP-Group-1
Spanning Tree Status........................... Disabled

 

19.3.2 show wireless wds-group ap

Command: show wireless wds-group <1-8> ap
Function: Display AP related messages that are added to a particular WDS AP.
Parameters:

  • <1-8>: the particular WDS AP group number.

Command mode: Privileged EXEC Mode
Default: None.
Usage guide: Display AP related messages that are added to a particular WDS AP.
Example:?Show the AP of WDS 1 group.

active500EM#show wireless wds-group 1 ap
WDS Managed AP Group ID........................ 1
AP MAC Address    STP Priority
----------------- ------------
f8-f7-d3-18-ee-e0 36864
f8-f7-d3-aa-aa-00 36864

 

Command: show wireless wds-group <1-8> link
Function: Display the WDS connection that has already been configured on the particular WDS AP group.
Parameters:

  • <1-8>: the WDS AP group number.

Command mode: Privileged EXEC Mode
Default: None.
Usage guide:?Display the particular WDS group connection.
Example:?Display the wds 1 group linkage.

active500EM#show wireless wds-group 1 link
WDS Managed AP Group ID........................ 1
Source AP MAC     Source Dest AP MAC       Dest   Path Cost
                  Radio                    Radio
----------------- ------ ----------------- ------ ---------
f8-f7-d3-00-03-a0 1      f8-f7-d3-00-03-60 1      255

 

19.3.4 show wireless wds-group status

Command: show wireless wds-group [<1-8>] status
Function: Display the WDS AP group status and statistics message. If designating a particular WDS group, only the designated WDS group status and statistics message will show.
Parameters:

  • <1-8>: the designated WDS AP group number. This parameter is optional.

Command mode: Privileged EXEC Mode
Default: None.
Usage guide:?Display particular WDS group status.
Example:?Display WDS group 1 status.

active500EM#show wireless wds-group 1 status
Group ID....................................... 1
Configured AP Count............................ 0
Connected AP Count............................. 0
Connected Root AP Count........................ 0
Connected Satellite AP Count................... 0
Spanning Tree Root Bridge...................... 00-00-00-00-00-00
STP Root Device Type........................... None
Configured WDS Link Count...................... 0
Detected WDS Links Count....................... 0
Blocking WDS Links Count....................... 0
WDS Group Password Change Status............... Not Started

 

19.3.5 show wireless wds-group ap status

Command: show wireless wds-group {[<1-8>] ap| <1-8> ap [<macaddr>]} status
Function: If both the group WDS AP and the identified AP are not appointed, it will display the associated WDS AP. If it only designates the WDS AP but not the identified AP, it will display all the WDS AP messages in the WSD group. If both of the WDS AP group and identified AP are appointed, it will show the particular WDS AP status message.
Parameters:

  • <1-8>: the particular WDS AP group number. This parameter is optional.
  • <macaddr>: MAC address can be selected; if the MAC address is appointed, it will display the message for the designated WDS AP.

Command mode: Privileged EXEC Mode
Default: None.
Usage guide: Query the status of the designated WDS AP; if the MAC address is not included, it will display the status of all APs.
Example: Query the AP status of MAC address f8-f7-d3-00-03-a0 in the WDS 1 group.

active500EM#show wireless wds-group 1 ap f8-f7-d3-00-03-a0 status
Group ID....................................... 1
AP MAC Address................................. f8-f7-d3-00-03-a0
AP Connection Status........................... Connected
Satellite Mode................................. Wired
Spanning Tree Root Mode........................ STP Root
Root Path Cost................................. 0
Ethernet Port STP Status....................... Forwarding
Ethernet Port Mode............................. Disabled
Ethernet Port Link State....................... Up

Check the AP status of WDS 1 group:

active500EM#show wireless wds-group 1 ap status
AP MAC Address    Connection    Satellite Ethernet Port
                  Status        Mode      STP Status
----------------- ------------- --------- -------------
f8-f7-d3-00-03-a0 Connected     Wired     Forwarding
f8-f7-d3-00-03-60 Not Connected None      Disabled

Check the WDS group status:

active500EM#show wireless wds-group status
Group Configured Conn. Root Conn. Satellite Config. WDS Detected WDS
Group Id        Configured AP     Conn. Root AP    Conn. Satellite  Config. WDS     Detected WDS
                Count             Count            AP Count         Link Count      Link Count
--------------- ----------------- ---------------- ---------------- --------------- -----------------
1               2                 1                0                1               0
2               0                 0                0                0               0
3               0                 0                0                0               0

 

Command: show wireless wds-group [<1-8>] link status
Function: Show the WDS connection with all group configuration.
Parameters:

  • <1-8>: the particular WDS AP group number. This parameter is optional.

Command mode: Privileged EXEC Mode
Default: None.
Usage guide: When the group number of WDS APs in the cluster cannot be appointed, display the WDS connection for all the configurations in the group. Otherwise, only display the WDS connection for a particular group.
Example: Check the WDS 3 Group link status.

active500EM#show wireless wds-group 3 link status
WDS AP Groupd ID............................... 3
WDS AP Group Name.............................. abc
Source MAC Address............................. f8-f7-d3-00-03-a0
Source Radio .................................. 2
Destination MAC Address........................ f8-f7-d3-00-03-60
Destination Radio.............................. 2
Source End Point Detected...................... Yes
Destination End Point Detected................. Yes
Aggregation Mode............................... Yes
Source STP State............................... Forwarding
Destination STP State.......................... Blocking
Source MAC Address............................. f8-f7-d3-00-03-a0
Source Radio................................... 2
Destination MAC Address........................ f8-f7-d3-00-03-60
Destination Radio.............................. 2
Source End Point Detected...................... Yes
Destination End Point Detected................. Yes
Aggregation Mode............................... Yes
Source STP State............................... Blocking
Destination STP State.......................... Forwarding
Source MAC Address............................. f8-f7-d3-00-03-60
Source Radio................................... 2
Destination MAC Address........................ f8-f7-d3-00-03-a0
Destination Radio.............................. 2
Source End Point Detected...................... Yes
Destination End Point Detected................. Yes
Aggregation Mode............................... Yes
Source STP State............................... Forwarding
Destination STP State.......................... Forwarding

 

Command: show wireless wds-group <1-8> link statistics
Function: Display the statistics message for the WDS connection for a designated WDS AP group.
Parameters:

  • <1-8>: the designated WDS AP group.

Command mode: Privileged EXEC Mode
Default: None.
Usage guide:?Display the statistics message for the WDS connection for the designated WDS AP group.
Example:? Display the statistics message for the WDS connection for the designated WDS AP group.

active500EM#sho wireless wds-group 1 link statistics
WDS AP Groupd ID............................... 1
WDS AP Group Name.............................. WDS-AP-Group-1
Source MAC Address............................. f8-f7-d3-00-03-a0
Source Radio................................... 1
Destination MAC Address........................ f8-f7-d3-00-03-60
Destination Radio.............................. 1
Source AP Packets Sent......................... 0
Source AP Bytes Sent........................... 0
Source AP Packets Received..................... 0
Source AP Bytes Received. ..................... 0
Destination AP Packets Sent.................... 0
Destination AP Bytes Sent...................... 0
Destination AP Packets Received. .............. 0
Destination AP Bytes Received.................. 0

 

19.4 Debug Command

19.4.1 debug wireless wds-group {info | error | packet-receive | packet-send}

Command: debug wireless wds-group {info | error | packet-receive | packet-send}
no debug wireless wds-group {info | error | packet-receive | packet-send}
Function: Open debugging on the WDS module. The no command represents closing debugging on the WDS module.
Parameters:

  • info: open/close the debugging on the WDS function on the AC.
  • error: open/close the error debugging on the WDS function on the WDS.
  • packet-receive: open/close debugging while the AC processes the data package that is received from WDS.
  • packet-send: open/close debugging while the AC processes the data package that is sent from WDS.

Command mode: Privileged EXEC Mode
Default: Debug information is not open
Usage guide: Open/close debugging on the WDS module.
Example: Open/close debugging on the WDS module.

active500EM#debug wireless wds-group error
error WD_LEVEL_WDS_GROUP_ERROR debug is on
active500EM# debug wireless wds-group info
internal WD_LEVEL_WDS_GROUP_INFO debug is on
active500EM# debug wireless wds-group packet-receive
packet WD_LEVEL_WDS_GROUP_PKT_RX debug is on
active500EM# debug wireless wds-group packet-send
packet WD_LEVEL_WDS_GROUP_PKT_TX debug is on
active500EM# no debug wireless wds-group packet-receive
active500EM# no debug wireless wds-group error

 

19.4.2 debug wireless wds-group {packet-receive | packet-send} <macaddr>

Command: debug wireless wds-group {packet-receive | packet-send} <macaddr>
no debug wireless wds-group {packet-receive | packet-send} <macaddr>
Function: Open debugging on the WDS module, which can show the WDS debug information that the AC receives and sends to a particular MAC address.
Parameters:

  • packet-receive: open/close debugging while the AC processes the data packets that are received from the WDS.
  • packet-send: open/close debugging while the AC processes the data packets that are sent from the WDS.
  • <macaddr>: the MAC address of the unit that is sending and receiving the message.

Command mode: Privileged EXEC Mode
Default: Disabled.
Usage guide: Open/close WDS debug information.
Example: Open/close WDS debug information as f8-f7-d3-00-03-a0.

active500EM#debug wireless wds-group packet-send f8-f7-d3-00-03-a0
MAC: f8-f7-d3-00-03-a0 packet WD_LEVEL_WDS_GROUP_PKT_TX debug is on
active500EM#debug wireless wds-group packet-receive f8-f7-d3-00-03-a0
MAC: f8-f7-d3-00-03-a0 packet WD_LEVEL_WDS_GROUP_PKT_RX debug is on
active500EM#no debug wireless wds-group packet-receive f8-f7-d3-00-03-a0
active500EM#no debug wireless wds-group packet-send f8-f7-d3-00-03-a0

 

19.4.3 no debug all

Command: no debug all
Function: The no debug all function will close debugging on the WDS simultaneously.
Parameters: None
Command mode: Privileged EXEC Mode
Default: Disabled.
Usage guide: Close debugging on all ACs.
Example: Close debugging on all ACs.

active500EM#no debug all
all possible debugging has been turned off

 

19.5 Configuration command on AP

19.5.1 set managed-ap wds-satellite-mode

Command: set managed-ap wds-satellite-mode {up | down}
Function: Setting WDS as satellite status or root AP mode on AP configuration.
Parameters:

  • up: represent changing AP status as satellite ap.
  • down:

Command mode: Privileged EXEC Mode
Default: Down.
Usage guide: Set the WDS-satellite-mode on the satellite AP to open, and set WDS-satellite-mode to closed on the root AP. Throughout the set managed-ap wds-satellite-mode, the configuration is WDS on APs as satellite or root AP mode.
Example: Set satellite AP?s wds-satellite-mode as up.

active500EM#set managed-ap wds-satellite-mode up

 

19.5.2 set managed-ap wds-eth0-port-mode

Command: set managed-ap wds-eth0-port-mode {up|down}
Function: Configure eth0 as enabled or disabled on the AP.
Parameters: None.
Command mode: Privileged EXEC Mode
Default: Down.
Usage guide: Configure etho as enabled or disabled on the AP.
Example: Configure the satellite AP.

active500EM#

 

19.5.3 set managed-ap wds-group-password

Command: set managed-ap wds-group-password <password>
Function: Set the password on the fat satellite AP for WDS authentication.
Parameters: None.
Command mode: Privileged EXEC Mode
Default: Down.
Usage guide: Create the password on the satellite AP for the connection. The root AP password is sent by the AC. The password needs to be the same as the WDS group to create the connection.
Example: Create the password as 12345678 that is used for connecting WDS on the satellite AP.

active500EM#set managed-ap wds-group-password 12345678