Commands for force-roaming

16.1 debug wireless client force-roaming internal-info

Command: debug wireless client force-roaming internal-info
no debug wireless client force-roaming internal-info
Function: Enable the debugging of force-roaming. The no command will disable the debugging.
Parameters: None.
Command mode: Admin Mode
Default: Disabled.
Usage guide: Use this command to debug force-roaming. It can debug in the AC force-roaming process.
Example: Run debug of force-roaming.

active500EM#debug wireless client force-roaming internal-info

 

16.2 force-roaming denial-count

Command: force-roaming denial-count <1-10>
no force-roaming denial-count
Function: Set the refusal times threshold of automatic force-roaming. The no command will restore the default value.
Parameters:

  • <1-10>: denial times.

Command mode: Wireless Global Configuration Mode
Default: Default is 3 times.
Usage guide: This command is used to set the refusal threshold of automatic force-roaming. If the client is forced roaming and it selects the connection of the original AP again, the original AP should reject this connection. If the number of refusal times has reached the threshold, the original AP no longer refuses the client?s connection request. If the client reconnects with the original AP successfully, then it will timeout, and will no longer be in forced roaming mode.
Example: Set the refusal times threshold to 10.

active500EM(config-wireless)#force-roaming denial-count 10

 

16.3 force-roaming denial-timeout

Command: force-roaming denial-timeout <1-12>
no force-roaming denial-timeout
Function: Set the timeout limit of the refusal times threshold for automatic force-roaming. The no command will restore the timeout limit to the default value.
Parameters:

  • <1-12>: the timeout of the denial threshold; unit is hour.

Command mode: Wireless Global Configuration Mode
Default: Default value is 1 hour.
Usage guide: Use this command to set the timeout of the automatic force-roaming denial threshold. When the client is in forced roaming mode, it selects the connection of the original AP again; the original AP should reject this connection. If the denial threshold is reached, the original AP no longer denies the client?s connection request. If the client reconnects with the original AP successfully, then the forced roaming mode will time-out.
Example: Set the timeout to 12 hours for the automatic force-roaming denial threshold.

active500EM(config-wireless)#force-roaming denial-timeout 12

 

16.4 force-roaming hysteresis

Command: force-roaming hysteresis <4-28>
no force-roaming hysteresis
Function: Configure the signal strength difference for force roaming. Unit is a percentage. The no command resets to default.
Parameters:

  • <4-28>: the difference of signal strength; unit is percentage.

Command mode: Wireless Global Configuration Mode
Default: Default value is 4%.
Usage guide: Use this command to set the signal strength difference for force roaming. Force the client to roam only if there is an AP with a stronger signal. Allow client roaming to this neighbor AP only when [(Neighbor AP?s RSSI ) ? (Home AP?s RSSI)] the signal is higher than the configured difference.
Example: Set the difference of signal strength as 28%.

active500EM(config-wireless)#force-roaming hysteresis 28

 

16.5 force-roaming mode auto

Command: force-roaming mode auto
no force-roaming mode auto
Function: Enable the automatic force-roaming function. The no command will disable this function.
Parameters: None.
Command mode: Wireless Global Configuration Mode
Default: Disabled.
Usage guide: Use this command to enable automatic force-roaming. Force the client with a weak signal to roam to the AP with a stronger signal.
Example: Enable the automatic force-roaming function.

active500EM(config-wireless)#force-roaming mode auto

 

16.6 force-roaming mode auto interval

Command: force-roaming mode auto interval <15-300>
no force-roaming mode auto interval
Function: Set the interval of automatic force-roaming function. The no command will restore the default value.
Parameters:

  • <15-300>: the interval of automatic force-roaming.

Command mode: Wireless Global Configuration Mode
Default: Default value is 30 minutes.
Usage guide: Use this command to set the automatic force-roaming interval. Set automatic force-roaming with the configured cycle parameters when the function is enabled.
Example: Set the interval to 15 minutes of automatic force-roaming.

active500EM(config-wireless)#force-roaming mode auto interval 15

 

16.7 force-roaming rssi-threshold

Command: force-roaming rssi-threshold <1-45>
no force-roaming rssi-threshold
Function: Set the RSSI threshold of force-roaming. Unit is a percentage. The no command will restore the default value.
Parameters:

  • <1-45>: the RSSI threshold of force-roaming; unit is percentage.

Command mode: Wireless Global Configuration Mode
Default: Default value is 8, unit is percentage.
Usage guide: Use this command to set the force-roaming RSSI threshold. If the user?s detected RSSI value is less than the threshold, then the user?s signal is not strong. Force the user to roam to the AP with a better signal.
Example: Set the force-roaming RSSI threshold to 15%.

active500EM(config-wireless)#force-roaming rssi-threshold 15

 

16.8 wireless force-roaming start

Command: wireless force-roaming start
Function: Manually initiate force-roaming.
Parameters: None.
Command mode: Admin Mode
Default: None.
Usage guide: Use this command to manually initiate force-roaming. If a client is not appointed, the system will pass by all clients; if client signal is poor and it can be forced to roam, the command will force the client to roam. If a client is appointed, the client will be directly disassociated by the system, and it will be marked as a force-roaming client.
Example: Manually initiate force-roaming.

active500EM#wireless force-roaming start

 

16.9 show wireless client force-roaming candidate ap status

Command: show wireless client [<macaddr>] force-roaming candidate ap status
Function: Show the neighbor AP status information of the force-roaming client.
Parameters:

  • <macaddr>: client MAC address.

Command mode: Admin Mode
Default: None.
Usage guide: Use this command to check the neighbor AP status of the force roaming client.
Example: Show the neighbor AP status information of the force-roaming client.

active500EM#show wireless client 00-22-43-8e-0f-e2 force-roaming candidate ap status
                               RSSI  Signal Noise
AP MAC Address    Status Radio (%)   (dBm)  (dBm) Detected Time
----------------- ------ ----- ----- ------ ----- -----------
f8-f7-d3-00-03-60 Managed 1    5     -87    -86   0d:01:05:53
f8-f7-d3-00-03-e0 Managed 1    4     -88    -74   0d:01:05:52

 

16.10 show wireless client force-roaming status

Command: show wireless client [<macaddr>] force-roaming status
Function: Show the force-roaming configuration parameters on AC and the history records of the client that is forced roaming.
Parameters:

  • <macaddr>: client MAC address.

Command mode: Admin Mode
Default: None.
Usage guide: Use this command to check the force-roaming configuration parameters on the AC and the history records of the client that is forced roaming. If the client is not appointed, show the force-roaming configuration parameters on the AC and the relevant statistic information. If the client is appointed, show the detailed force-roaming history information of this client.
Example: Show the parameter configured and the statistic information.

active500EM#show wireless client force-roaming status
Auto Force Roaming............................. Disable
Force Roaming Interval......................... 30
Force Roaming RSSI Threshold................... 8
Force Roaming Denial Count..................... 3
Force Roaming Denial Timeout................... 3
Force Roaming Hysteresis....................... 4
MAC Address       AP MAC Address
----------------- --------------------------------------------------------------
00-1d-0f-02-16-25 <- f8-f7-d3-00-03-60 <- f8-f7-d3-00-03-e0 <- f8-f7-d3-00-03-60
                  <- f8-f7-d3-00-03-60 <- f8-f7-d3-00-03-e0
00-1d-0f-31-f4-28 <- f8-f7-d3-00-03-60
00-22-43-8e-0f-e2 <- f8-f7-d3-00-03-60    f8-f7-d3-00-03-e0 <- f8-f7-d3-00-03-c0

Show the specified client force-roaming parameters.

active500EM#show wireless client 5c-ac-4c-3e-1b-6b force-roaming status
Client MAC Address............................. 5c-ac-4c-3e-1b-6b
SSID .......................................... icc_wlan_portal
Authenticated AP............................... f8-f7-d3-00-03-60
Denial Count................................... 3
AP MAC Addr(Radio)   VAP MAC Address   RSSI(%)  Time since
                                                Last Event
-------------------- ----------------- -------- -----------
f8-f7-d3-00-03-c0(1) f8-f7-d3-00-03-e0 80       0d:03:27:34
f8-f7-d3-00-03-60(1) f8-f7-d3-00-03-a0 70       0d:03:29:53
f8-f7-d3-00-03-60(1) f8-f7-d3-00-03-b0          0d:03:47:31