Login
| Title | Size | Download |
|---|---|---|
| 02-WLAN roaming center commands | 89.74 KB |
display wlan roaming-center history user
display wlan roaming-center statistics packet
display wlan roaming-center user
reset wlan roaming-center history user
reset wlan roaming-center statistics packet
WLAN roaming center commands
The following compatibility matrixes show the support of hardware platforms for WLAN roaming center:
|
Hardware series |
Model |
Product code |
WLAN roaming center compatibility |
|
WX1800H series |
WX1804H |
EWP-WX1804H-PWR-CN |
No |
|
WX2500H series |
WX2508H-PWR-LTE WX2510H WX2510H-F WX2540H WX2540H-F WX2560H |
EWP-WX2508H-PWR-LTE EWP-WX2510H-PWR EWP-WX2510H-F-PWR EWP-WX2540H EWP-WX2540H-F EWP-WX2560H |
No |
|
WX3000H series |
WX3010H WX3010H-X WX3010H-L WX3024H WX3024H-L WX3024H-F |
EWP-WX3010H EWP-WX3010H-X-PWR EWP-WX3010H-L-PWR EWP-WX3024H EWP-WX3024H-L-PWR EWP-WX3024H-F |
No |
|
WX3500H series |
WX3508H WX3510H WX3520H WX3520H-F WX3540H |
EWP-WX3508H EWP-WX3510H EWP-WX3520H EWP-WX3520H-F EWP-WX3540H |
Yes: · WX3510H · WX3520H · WX3540H · WX3520H-F No: WX3508H |
|
WX5500E series |
WX5510E WX5540E |
EWP-WX5510E EWP-WX5540E |
Yes |
|
WX5500H series |
WX5540H WX5560H WX5580H |
EWP-WX5540H EWP-WX5560H EWP-WX5580H |
Yes |
|
Access controller modules |
LSUM1WCME0 EWPXM1WCME0 LSQM1WCMX20 LSUM1WCMX20RT LSQM1WCMX40 LSUM1WCMX40RT EWPXM2WCMD0F EWPXM1MAC0F |
LSUM1WCME0 EWPXM1WCME0 LSQM1WCMX20 LSUM1WCMX20RT LSQM1WCMX40 LSUM1WCMX40RT EWPXM2WCMD0F EWPXM1MAC0F |
Yes: · LSUM1WCME0 · EWPXM1WCME0 · LSQM1WCMX40 · LSUM1WCMX40RT · EWPXM1MAC0F No: · LSQM1WCMX20 · LSUM1WCMX20RT · EWPXM2WCMD0F |
|
Hardware series |
Model |
Product code |
WLAN roaming center compatibility |
|
WX1800H series |
WX1804H WX1810H WX1820H WX1840H |
EWP-WX1804H-PWR EWP-WX1810H-PWR EWP-WX1820H EWP-WX1840H-GL |
No |
|
WX3800H series |
WX3820H WX3840H |
EWP-WX3820H-GL EWP-WX3840H-GL |
Yes |
|
WX5800H series |
WX5860H |
EWP-WX5860H-GL |
Yes |
control-access
Use control-access to specify a portal roaming center permitted by the WLAN roaming center.
Use undo control-access to restore the default.
Syntax
control-access { bas-ip ipv4-address | bas-ipv6 ipv6-address }
undo control-access{ bas-ip ipv4-address | bas-ipv6 ipv6-address }
Default
No permitted portal roaming center is specified.
Views
WLAN roaming center view
Predefined user roles
network-admin
Parameters
bas-ip ipv4-address: Specifies the IPv4 address of a portal roaming center.
bas-ipv6 ipv6-address: Specifies the IPv6 address of a portal roaming center.
Usage guidelines
This feature enables the WLAN roaming center to process packets only from the permitted portal roaming centers, enhancing network security. If no permitted portal roaming centers are specified, the WLAN roaming center processes packets from all portal roaming centers.
You can execute this command multiple times to specify several portal roaming centers.
You can specify both IPv4 addresses and IPv6 addresses of portal roaming centers.
Examples
# Specify the AC with an IP address of 111.8.33.72 as a portal roaming center permitted by the WLAN roaming center.
<Sysname> system-view
[Sysname] wlan roaming-center
[Sysname-wlan-roaming-center] control-access bas-ip 111.8.33.72
display wlan roaming-center history user
Use display wlan roaming-center history user to display offline client history on the WLAN roaming center.
Syntax
display wlan roaming-center history user { all | ip ipv4-address | ipv6 ipv6-address | mac mac-address }
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all: Specifies all offline clients.
ip ipv4-address: Specifies an offline client by its IPv4 address.
ipv6 ipv6-address: Specifies an offline client by its IPv6 address.
mac mac-address: Specifies an offline client by its MAC address.
Examples
# Display the history of all offline clients on the WLAN roaming center.
<Sysname> display wlan roaming-center history user all
MAC address: 000d-88f8-0eac
IP address: 192.168.0.123
Online BAS IP: 192.168.0.100
Online time: 12:01:12 01/02 2018
Offline time: 12:26:12 01/02 2018
Roaming information:
Roaming count: 3
BAS-IP Roam-in time
192.168.0.10 12:20:12 01/02 2018 UTC
192.168.0.11 12:18:12 01/02 2018 UTC
192.168.0.12 12:16:12 01/02 2018 UTC
MAC address: 000d-88f8-0ead
IP address: 192.168.0.123
Online BAS IP: 192.168.0.100
Online time: 12:01:12 01/02 2018
Offline time: 12:26:12 01/02 2018
Roaming information:
Roaming count: 3
BAS-IP Roam-in time
192.168.0.10 12:20:12 01/02 2018 UTC
192.168.0.11 12:18:12 01/02 2018 UTC
192.168.0.12 12:16:12 01/02 2018 UTC
Table 1 Command output
|
Field |
Description |
|
MAC address |
Client MAC address. |
|
IP address |
Client IPv4 or IPv6 address. |
|
Online BAS IP |
IP address of the AC from which the client first came online. |
|
Online time |
Time at which the client came online. |
|
Offline time |
Time at which the client went offline. |
|
Roaming information |
Client roaming entries. This field can display a maximum of ten entries, with the most recent one coming the first in the output. |
|
Roaming count |
Number of roamings performed by the client. |
|
BAS-IP |
IP address of the portal roaming center. |
|
Roam-in time |
Time at which the client roamed to the portal roaming center. |
Related commands
reset wlan roaming-center history user
wlan roaming-center enable
display wlan roaming-center statistics packet
Use display wlan roaming-center statistics packet to display packet statistics on the WLAN roaming center.
Syntax
display wlan roaming-center statistics packet [ bas-ip ipv4-address | bas-ipv6 ipv6-address ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
bas-ip ipv4-address: Specifies a portal roaming center by its IPv4 address.
bas-ipv6 ipv6-address: Specifies a portal roaming center by its IPv6 address.
Usage guidelines
If you do not specify the bas-ip ipv4-address or bas-ipv6 ipv6-address option, the command displays packet statistics about all portal roaming centers.
Examples
# Display packet statistics about the portal roaming center with an IP address of 192.168.0.100.
<Sysname> display wlan roaming-center statistics packet bas-ip 192.168.0.100
BAS-IP: 192.168.0.100
Total sent packets: 100
Total received packets: 101
Total invalid packets: 0
Pkt-Type Success Error Timeout
RC_REQ_INFO 1 1 0
RC_ACK_INFO 1 2 0
RC_REQ_ONLINE 1 2 0
RC_ACK_ONLINE 1 1 1
RC_REQ_OFFLINE 1 1 0
RC_ACK_OFFLINE 1 1 1
RC_REQ_DHCPINFO 1 1 1
RC_ACK_DHCPINFO 1 1 1
RC_REQ_NTY_OFFLINE 1 1 0
RC_ACK_NTY_OFFLINE 1 1 1
Table 2 Command output
|
Field |
Description |
||
|
BAS-IP |
IP address of the portal roaming center. |
|
|
|
Pkt-Type |
Type of the packet: · RC_REQ_INFO—User query request that the portal roaming center sends to the WLAN roaming center. · RC_ACK_INFO—User query response that the WLAN roaming center sends to the portal roaming center. · RC_REQ_ONLINE—User online request that the portal roaming center sends to the WLAN roaming center. · RC_ACK_ONLINE—User online response that the WLAN roaming center sends to the portal roaming center. · RC_REQ_OFFLINE—User offline request that the portal roaming center sends to the WLAN roaming center. · RC_ACK_OFFLINE—User offline response that the WLAN roaming center sends to the portal roaming center. · RC_REQ_DHCPINFO—User DHCP information request that the portal roaming center sends to the WLAN roaming center. · RC_ACK_DHCPINFO—User DHCP information response that the WLAN roaming center sends to the portal roaming center. · RC_REQ_NTY_OFFLINE—User offline notification request that the WLAN roaming center sends to the portal roaming center. · RC_ACK_NTY_OFFLINE—User offline notification response that the portal roaming center sends to the WLAN roaming center. |
|
|
|
Success |
Number of packets that have been transmitted successfully. |
|
|
|
Error |
Number of packets that failed to be transmitted. |
|
|
|
Timeout |
Number of packet transmission timeouts. |
|
|
display wlan roaming-center user
Use display wlan roaming-center user to display client information on the WLAN roaming center.
Syntax
display wlan roaming-center user { all | bas-ip ipv4-address | bas-ipv6 ipv6-address | ip ipv4-address | ipv6 ipv6-address | mac mac-address } [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all: Specifies all clients.
bas-ip ipv4-address: Specifies a portal roaming center by its IPv4 address.
bas-ipv6 ipv6-address: Specifies a portal roaming center by its IPv6 address.
ip ipv4-address: Specifies a client by its IPv4 address.
ipv6 ipv6-address: Specifies a client by its IPv6 address.
mac mac-address: Specifies a client by its MAC address.
verbose: Displays detailed client information. If you do not specify this keyword, the command displays brief client information.
Examples
# Display brief client information on the WLAN roaming center.
<Sysname> display wlan roaming-center user all
Total user: 5
MAC address IP address
000d-88f8-0eac 122.122.111.100
000d-88f8-0eaa 122.122.111.101
000d-88f8-0eab 122.122.111.102
000d-88f8-0eae 10::4
000d-88f8-0eaf 1002:1002:1002:1002:1002:
1002:1002:1002
# Display brief information about the client with an IP address of 122.122.111.100 on the WLAN roaming center.
<Sysname> display wlan roaming-center user ip 122.122.111.100
MAC address IP address
000d-88f8-0eac 122.122.111.100
# Display brief information about the client with an IPv6 address of 10::4 on the WLAN roaming center.
<Sysname> display wlan roaming-center user ipv6 10::4
MAC address IP address
000d-88f8-0eae 10::4
# Display brief information about the client with a MAC address of 000d-88f8-0eac on the WLAN roaming center.
<Sysname> display wlan roaming-center user mac 000d-88f8-0eac
MAC address IP address
000d-88f8-0eac 122.122.111.100
# Display detailed information about the client with a MAC address of 000d-88f8-0eac on the WLAN roaming center.
<Sysname> display wlan roaming-center user mac 000d-88f8-0eac verbose
MAC address: 000d-88f8-0eac
IP address: 2::1:21
Username: 1
Authorization information:
User profile: abc
ACL number/name: N/A
Inbound CAR: N/A
Outbound CAR: N/A
Session timeout period: N/A
Idle cut traffic threshold: N/A
Roaming information:
Online BAS IP: 192.168.0.100
Online time: 12:01:12 01/02 2018 UTC
Roaming count: 3
BAS-IP Roam-in time
192.168.0.10 12:20:12 01/02 2018 UTC
192.168.0.11 12:18:12 01/02 2018 UTC
192.168.0.12 12:16:12 01/02 2018 UTC
Table 3 Command output
|
Field |
Description |
|
MAC address |
Client MAC address. |
|
IP address |
Client IP address. |
|
User profile |
Authorized user profile. This field displays N/A if no user profile is authorized to the client. |
|
ACL number/name |
Number or name of the authorized ACL. This field displays N/A if no ACL is authorized to the client. |
|
Inbound CAR |
Authorized inbound CAR information: · CIR—Committed information rate in bps. · PIR—Peak information rate in bps. · CBS—Committed burst size in bits. If no inbound CAR is authorized, this field displays N/A. |
|
Outbound CAR |
Authorized outbound CAR information: · CIR—Committed information rate in bps. · PIR—Peak information rate in bps. · CBS—Committed burst size in bits. If no outbound CAR is authorized, this field displays N/A. |
|
Session timeout period |
Session timeout in seconds. This field displays N/A if no session timeout is authorized. |
|
Idle cut traffic threshold |
Session idle timeout in seconds and minimum traffic threshold in bytes. This field displays only the session idle timeout if the minimum traffic threshold failed to be obtained from the user online request. |
|
Online BAS IP |
IP address of the AC from which the client first came online. |
|
Online time |
Time at which the client first came online. |
|
Roaming count |
Number of roamings performed by the client. |
port
Use port to specify the port used by the WLAN roaming center to communicate with portal roaming centers.
Use undo port to restore the default.
Syntax
port port-number
undo port
Default
The WLAN roaming center uses port 1088 to communicate with portal roaming centers.
Views
WLAN roaming center view
Predefined user roles
network-admin
Parameters
port-number: Specifies a port number in the range of 1 to 65534. Make sure the specified port is not in use and does not use a well-known port number.
Usage guidelines
Make sure the port specified for the WLAN roaming center is the same as the port specified for portal roaming centers.
Changing the port number when portal clients are online might cause information synchronization failure between the WLAN roaming center and portal roaming centers. Portal clients might fail to roam and must be reauthenticated.
As a best practice to avoid data residual, disable the WLAN roaming center before you change the port number.
Examples
# Configure the WLAN roaming center to use port 60015 to communicate with portal roaming centers.
<Sysname> system-view
[sysname] wlan roaming-center
[Sysname-wlan-roaming-center] port 60015
Related commands
roaming-center enable
reset wlan roaming-center history user
Use reset wlan roaming-center history user to clear client history information on the WLAN roaming center.
Syntax
reset wlan roaming-center history user { all | ip ipv4-address | ipv6 ipv6-address | mac mac-address }
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
all: Specifies all clients.
ip ipv4-address: Specifies a client by its IPv4 address.
ipv6 ipv6-address: Specifies a client by its IPv6 address.
mac mac-address: Specifies a client by its MAC address.
Examples
# Clear history information about all clients on the WLAN roaming center.
<Sysname> reset wlan roaming-center history user all
Related commands
display wlan roaming-center history user
reset wlan roaming-center statistics packet
Use reset wlan roaming-center statistics packet to clear packet statistics on the WLAN roaming center.
Syntax
reset wlan roaming-center statistics packet [ bas-ip ipv4-address | bas-ipv6 ipv6-address ]
Views
User view
Predefined user roles
network-admin
Parameters
bas-ip ipv4-address: Specifies a portal roaming center by its IPv4 address.
bas-ipv6 ipv6-address: Specifies a portal roaming center by its IPv6 address.
Usage guidelines
If you do not specify the bas-ip ipv4-address or the bas-ipv6 ipv6-address option, the command clears all packet statistics on the WLAN roaming center.
Examples
# Clear all packet statistics on the WLAN roaming center.
<Sysname> reset wlan roaming-center statistics packet
reset wlan roaming-center user
Use reset wlan roaming-center user to clear client information on the WLAN roaming center.
Syntax
reset wlan roaming-center user { all | bas-ip ipv4-address | bas-ipv6 ipv6-address | ip ipv4-address | ipv6 ipv6-address | mac mac-address }
Views
User view
Predefined user roles
network-admin
Parameters
all: Specifies all clients.
bas-ip ipv4-address: Specifies a portal roaming center by its IPv4 address.
bas-ipv6 ipv6-address: Specifies a portal roaming center by its IPv6 address.
ip ipv4-address: Specifies a client by its IPv4 address.
ipv6 ipv6-address: Specifies a client by its IPv6 address.
mac mac-address: Specifies a client by its MAC address.
Examples
# Clear information about all clients on the WLAN roaming center.
<Sysname> reset wlan roaming-center user all
Related commands
display wlan roaming-center user
response-timeout
Use response-timeout to set the wait timer for user offline notification responses.
Use undo response-timeout to restore the default.
Syntax
response-timeout timeout
undo response-timeout
Default
The wait timer for user offline notification responses is 3 seconds.
Views
WLAN roaming center view
Predefined user roles
network-admin
Parameters
timeout: Specifies the timeout in the range of 1 to 10 seconds.
Usage guidelines
After sending a user offline notification request to an AC, the WLAN roaming center resends the request if it fails to receive a response before the wait timer expires. If it fails to receive any response after the maximum transmission attempt limit is reached, the WLAN roaming center deletes the timeout timer and removes the AC from the access device list of the client.
Examples
# Set the wait timer for user offline notification responses to 2 seconds.
<Sysname> system-view
[sysname] wlan roaming-center
[Sysname-wlan-roaming-center] response-timeout 2
retry
Use retry to set the maximum transmission attempts for user offline notification requests.
Use undo retry to restore the default.
Syntax
retry retries
undo retry
Default
The maximum number of transmission attempts for user offline notification requests is 5.
Views
WLAN roaming center view
Predefined user roles
network-admin
Parameters
retries: Specifies the maximum number of packet transmission attempts in the range of 1 to 10.
Usage guidelines
After sending a user offline notification request to an AC, the WLAN roaming center resends the request if it fails to receive a response before the wait timer expires. If it fails to receive any response after the maximum transmission attempt limit is reached, the WLAN roaming center deletes the timeout timer and removes the AC from the access device list of the client.
Examples
# Set the maximum transmission attempts for user offline notification requests to 4.
<Sysname> system-view
[Sysname] wlan roaming-center
[Sysname-wlan-roaming-center] retry 4
Related commands
response-timeout
roaming-center enable
Use roaming-center enable to enable the WLAN roaming center.
Use undo roaming-center enable to disable the WLAN roaming center.
Syntax
roaming-center enable
undo roaming-center enable
Default
The WLAN roaming center feature is disabled.
Views
WLAN roaming center view
Predefined user roles
network-admin
Usage guidelines
You can enable the WLAN roaming center on only one AC in a network.
Disabling the WLAN roaming center feature deletes all portal client information.
Examples
# Enable the WLAN roaming center.
<Sysname> system-view
[Sysname] wlan roaming-center
[Sysname-wlan-roaming-center] roaming-center enable
wlan roaming-center
Use wlan roaming-center to create a WLAN roaming center and enter its view, or enter the view of an existing WLAN roaming center.
Use undo wlan roaming-center to delete the WLAN roaming center.
Syntax
wlan roaming-center
undo wlan roaming-center
Default
No WLAN roaming center exists.
Views
System view
Predefined user roles
network-admin
Usage guidelines
A WLAN roaming center stores and updates client information and provides query services for the information.
Deleting a WLAN roaming center deletes all client roaming information.
Examples
# Create a WLAN roaming center and enter its view.
<Sysname> system-view
[Sysname] wlan roaming-center
[Sysname-wlan-roaming-center]
