Commands for distributed forwarding

8.1 clear wireless detected-client roam-history

Command: clear wireless detected-client [<macaddr>] roam-history
Function: Clear the roaming information of roaming users.
Parameters:

  • <macaddr>: MAC address of the roaming client.

Command mode: Admin Mode
Default: None.
Usage guide: With no parameters, clear roaming information of all roaming users. When more than one AC makes up the cluster, this command can only be used in the AC controller of the cluster. If not, there will be a corresponding prompt when executing this command.
Example: Clear roaming information of the user with the MAC address of 08-10-74-ad-93-c8.

active500EM#clear wireless detected-client 08-10-74-ad-93-c8 roam-history
Process with clear the client roam-history? [Y/N] y

 

8.2 debug wireless dl2tunnel error

Command: debug wireless dl2tunnel error <FF-FF-FF-FF-FF-FF>
no debug wireless dl2tunnel error <FF-FF-FF-FF-FF-FF>

Function: Enable/disable distributed layer 2 interior tunnel error information.
Parameters:

  • <FF-FF-FF-FF-FF-FF>: MAC address of AP or wireless client.

Command mode: Admin Mode
Default: None.
Usage guide: Use this command to enable the distributed layer 2 interior tunnel error information of the specified AP or the wireless client.
Example: Enable the distributed layer 2 interior tunnel error information of the wireless client with MAC address of 08-10-74-ad-93-c8.

active500EM#debug wireless dl2tunnel error 08-10-74-ad-93-c8

 

8.3 debug wireless dl2tunnel internal-info

Command: debug wireless dl2tunnel internal-info <FF-FF-FF-FF-FF-FF>
no debug wireless dl2tunnel internal-info <FF-FF-FF-FF-FF-FF>

Function: Enable/disable the distributed layer 2 interior tunnel debugging information.
Parameters:

  • <FF-FF-FF-FF-FF-FF>: MAC address of the AP or wireless client.

Command mode: Admin Mode
Default: None.
Usage guide: Use this command to enable the distributed layer 2 interior tunnel debugging information of the specified AP or the wireless client.
Example: Enable the distributed layer 2 interior tunnel debugging information of the wireless client with the MAC address of 08-10-74-ad-93-c8.

active500EM#debug wireless dl2tunnel internal-info 08-10-74-ad-93-c8

 

8.4 dist-tunnel

Command: dist-tunnel
no dist-tunnel

Function: Enable the distributed tunnel. The no command will disable the distributed tunnel function.
Parameters: None.
Command mode: Network Configuration Mode
Default: Disable distributed tunnel.
Usage guide: In network configuration mode, enable distributed tunnel.
Example: Enable distributed tunnel function of network 34.

active500EM(config-wireless)#network 34
active500EM(config-network)#dist-tunnel

 

8.5 dist-tunnel idle-timeout

Command: dist-tunnel idle-timeout <30-3600>
no dist-tunnel idle-timeout

Function: Configure the tunnel idle timeout value of Home-AP. The no command will restore the default value as 120s.
Parameters:

  • <30-3600>: the tunnel idle timeout value for Home-AP; unit is seconds.

Command mode: Wireless Global Configuration Mode
Default: 120s.
Usage guide: Home-AP will inspect the client tunnel idle time to determine whether it is experiencing timeout once every 30 seconds; if so, then the AP sends a releasing tunnel message to the AC, the AC forwards it to the Assoc-AP to release the tunnel, and the client will obtain the IP address again. If idle timeout changed, the new value will be sent to the AP from the AC, and the AP will inspect the tunnel idle time to determine whether it is experiencing timeout after another 30 seconds. If it does, the process described above is repeated.
Example: Set the idle timeout value to be 1200s of Home-AP.

active500EM(config-wireless)#dist-tunnel idle-timeout 1200

 

8.6 dist-tunnel max-client

Command: dist-tunnel max-client <1-8000>
no dist-tunnel max-client

Function: Configure the maximum number of roaming users of Home-AP. The no command will restore the default value as 128.
Parameters:

  • <1-8000>: the number of roaming users of Home-AP.

Command mode: Wireless Global Configuration Mode
Default: 128.
Usage guide: If the roaming user?s max number is more than the Home-AP MaxClient setting, then a tunnel message sent from the AC will be unsuccessful. The AP will reply to the AC releasing a tunnel message to the AC. The AC then forwards it to the Assoc-AP or Peer-switch. If MaxClients has changed, the configuration will be sent to the AP. The AP will inspect the tunnel user?s number to determine whether it exceeds the limit; if it does exceed the limit, it will delete users from the user list one by one, starting with the first user, until it does not exceed the limit.
Example: Set the Home-AP MaxClient number to be 256.

active500EM(config-wireless)#dist-tunnel max-client 256

 

8.7 dist-tunnel max-timeout

Command: dist-tunnel max-timeout <30-86400>
no dist-tunnel max-timeout

Function: Configure Home-AP tunnel timeout value. The no command will reset to the default value of 7200s.
Parameters:

  • <30-86400>: for Home-AP tunnel timeout value.

Command mode: Wireless Global Configuration Mode
Default: 7200s.
Usage guide: Home-AP will inspect the wireless client to determine whether it is experiencing timeout once every 30 seconds. When the tunnel set-up time exceeds this value, Home-AP will send a releasing tunnel message to the AC, and the AC will forward it to the Assoc-AP to release the tunnel.
Example: Set the Home-AP tunnel timeout value as 36000s.

active500EM(config-wireless)#dist-tunnel max-timeout 36000

 

8.8 dist-tunnel mcast-repl

Command: dist-tunnel mcast-repl <1-1024>
no dist-tunnel mcast-repl

Function: Configure the number of multicast copying of the Home-AP. The no command will reset to the default value of 128.
Parameters:

  • <1-1024>: number of multicast copying of Home-AP.

Command mode: Wireless Global Configuration Mode
Default: 128.
Usage guide: If the roaming users exceed the MaxMcastRepl value, then the tunnel message sent from the AC will be unsuccessful. The AP will reply to the AC with a release tunnel message. The AC will then forward it to Assoc-AP or Peer-switch. If the MaxMcastRepl changes, the configuration will be sent to the AP from the AC. The AP will inspect the correlation tunnel number to determine whether it exceeds the limit; if it does exceed the limit, it will delete the tunnels one by one until it does not exceed the limit.
Example: Set the number of Home-AP multicast copying to 256.

active500EM(config-wireless)#dist-tunnel mcast-repl 256

 

8.9 show wireless ap dist-tunnel

Command: show wireless ap <macaddr> dist-tunnel {statistics | status}
Function: Display the AP distributed tunnel correlation information.
Parameters:

  • <macaddr>: MAC address of the AP.
  • statistics: AP distributed tunnel statistics.
  • status: AP distributed tunnel status.

Command mode: Admin Mode
Default: None.
Usage guide: Use this command to check the distributed tunnel statistics or tunnel status of the specified AP.
Example: Check the distributed tunnel statistics of the AP with MAC address of f8-f7-d3- 00-03-a0.

active500EM#show wireless ap f8-f7-d3-00-03-a0 dist-tunnel statistics
MAC address.................................... f8-f7-d3-00-03-a0
Distributed Tunnel Bytes Transmitted........... 2673289
Distributed Tunnel Packets Transmitted......... 18258
Distributed Tunnel Multicast Packets Transmit.. 1404
Distributed Tunnel Bytes Received.............. 11784659
Distributed Tunnel Packets Received............ 15099
Distributed Tunnel Multicast Packets Received.. 87894
Distributed Tunnel Roamed Clients of AP........ 33
Distributed Tunnel Roamed Clients Idle Timed... 0
Distributed Tunnel Roamed Clients Age Timed o.. 0
Distributed Tunnel Client Limit Denials........ 0
Distributed Tunnel Client Max Replication Den.. 0

 

8.10 show wireless client detected-client roam-history

Command: show wireless client [<macaddr>] detected-client roam-history
Function: Display roaming information of roaming users. If no parameters are entered, display the roaming information of all roaming users.
Parameters:

  • <macaddr>: MAC address of the roaming user.

Command mode: Admin Mode
Default: None.
Usage guide: This command can only be for the AC controller of the cluster. If the AC Controller does not exist, there will be a corresponding prompt when executing this command.
Example: Check the client roaming information of the AC controller for the cluster with MAC address of e0-05-c5-90-1c-54.

active500EM#show wireless client e0-05-c5-90-1c-54 detected-client roam-history
Client MAC Address............................. e0-05-c5-90-1c-54
AP MAC Addr(Radio)   VAP MAC Address   SSID                 Auth     Time since Status Event
-------------------- ----------------- -------------------- -------- -----------
f8-f7-d3-00-03-a0(1) f8-f7-d3-00-03-10 ax_ac1_34            New Auth 1d:23:31:49
f8-f7-d3-00-03-60(1) f8-f7-d3-00-03-20 ax_ac1_34            Roam     1d:23:34:14

 

8.11 show wireless client dist-tunnel status

Command: show wireless client <macaddr> dist-tunnel status
Function: Display distributed tunnel roaming user information.
Parameters:

  • <macaddr>: MAC address of roaming user.

Command mode: Admin Mode
Default: None.
Usage guide: Use this command to check distributed tunnel status information of the roaming user. When the roaming user associates with Home-AP before roaming, distributed tunnel client roam status shows Home; when the roaming user associates with Assoc-AP after roaming, distributed tunnel client roam status shows roaming.
Example: Check the distributed tunnel roaming user status whose MAC address is 08-10-74-ad-93-c8.

active500EM#show wireless client 08-10-74-ad-93-c8 dist-tunnel status
MAC address.................................... 08-10-74-ad-93-c8
VAP MAC Address................................ f8-f7-d3-00-03-10
AP MAC Address................................. f8-f7-d3-00-03-a0
Associating Switch............................. Peer Switch
Switch MAC Address............................. f8-f7-d3-00-03-F0
Switch IP Address.............................. 192.168.1.1
Distributed Tunneling Status................... Enable
Distributed Tunnel Client Roam Status.......... Roaming
Distributed Tunnel Home AP MAC Address......... f8-f7-d3-00-03-D0
Distributed Tunnel Associated AP MAC Address... f8-f7-d3-00-03-a0

 

8.12 show wireless dist-tunnel

Command: show wireless dist-tunnel
Function: Display the distributed tunnel configuration information.
Parameters: None.
Command mode: Admin Mode
Default: None.
Usage guide: Check: Home-AP tunnel max clients, tunnel idle timeout, tunnel timeout, tunnel max multicast replications.
Example Check the distributed tunnel information.

active500EM#show wireless dist-tunnel
Distributed Tunnel Max Clients................. 128
Distributed Tunnel Idle Timeout................ 120
Distributed Tunnel Timeout..................... 7200
Distributed Tunnel Max Multicast Replications.. 128

 

8.13 show wireless dist-tunnel statistics

Command: show wireless dist-tunnel statistics
Function: Display distributed tunnel statistics.
Parameters: None.
Command mode: Admin Mode
Default: None.
Usage guide: Check the statistics: tunnel packets transmitted, tunnel roamed clients, tunnel client denials.
Example: Display distributed tunnel statistics.

active500EM#show wireless dist-tunnel statistics
Distributed Tunnel Packets Transmitted......... 33350
Distributed Tunnel Roamed Clients.............. 64
Distributed Tunnel Client Denials.............. 0