smart-roam unable-roam-client expire-time

Function

The smart-roam unable-roam-client expire-time command sets the aging time of "unable to roam" record for a terminal.

The undo smart-roam unable-roam-client expire-time command restores the default aging time of "unable to roam" record for a terminal.

By default, the aging time of "unable to roam" record is 120 minutes.

Format

smart-roam unable-roam-client expire-time expire-time

undo smart-roam unable-roam-client expire-time

Parameters

Parameter	Description	Value
expire-time	Specifies the aging time of "unable to roam" record.	The value is an integer that ranges from 30 to 2880, in minutes.

Views

RRM profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After smart roaming is enabled, you can run the smart-roam unable-roam-client expire-time command to set the aging time of "unable to roam" record for terminals. When the device requests a terminal to roam but the terminal keeps sending association requests to the original AP or does not initiate an association request, the device records the terminal as unable to roam and does not trigger terminal roaming within the specified time. After the aging time is reached, "unable to roam" record of the terminal is automatically cleared, and the system can trigger roaming of the terminal.

A terminal is recorded as unable to roam due to the following reasons:

Due to different software configurations, some terminals preferentially send association requests to APs with which they have once associated.
In some environments, terminals cannot scan APs with strong signals.
Terminals enter dormancy state and do not roam once they are forcibly disconnected.

The aging time to configure varies for different reasons. A large aging time is used for the software configuration reason so that the AP will trigger roaming of the terminals as less as possible. However, a small aging time is used in other situations so that the AP will attempt to trigger roaming of the terminals marked unable to roam.

Prerequisites

The smart roaming function has been enabled using the undo smart-roam disable command.

Example

# Set the aging time of "unable to roam" record to 50 minutes.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] rrm-profile name huawei
[HUAWEI-wlan-rrm-prof-huawei] undo smart-roam disable
[HUAWEI-wlan-rrm-prof-huawei] smart-roam unable-roam-client expire-time 50