- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
04-WLAN Roaming Commands | 92.46 KB |
display wlan client
Syntax
display wlan client { roam-in | roam-out } [ member { ip ipv4-address | ipv6 ipv6-address } ] [ verbose ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
roam-in: Displays information about clients that have roamed in.
roam-out: Displays information about clients that have roamed out.
member ip ipv4-address: IPv4 address of the member Access Controller.
member ipv6 ipv6-address: IPv6 address of the member Access Controller.
verbose: Displays detailed information.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display wlan client to display information about clients that have roamed in or out.
If a member is included, the display wlan client roam-in command displays the MAC addresses and associated BSSIDs of all the clients that have roamed in from the specified member, and the display wlan client roam-out command displays the MAC addresses and associated BSSIDs of all the clients that have roamed out to the specified member.
If no member is included, the display wlan client roam-in command displays the MAC addresses, associated BSSIDs and Home AC IP address of all the roam-in clients, and the display wlan client roam-out command shows the MAC addresses, associated BSSIDs and Foreign AC IP address of all the roam-out clients.
Examples
# Display all roam-in client information.
<Sysname> display wlan client roam-in
Roam-In Table
--------------------------------------------------------------------------
Client-MAC-address BSSID Home-AC-IP-address
--------------------------------------------------------------------------
0012-f0cc-489d 000f-e25d-f3e0 202.0.0.13
--------------------------------------------------------------------------
# Display information about clients that have roamed in from member AC 202.0.0.13.
<Sysname> display wlan client roam-in member ip 202.0.0.13
Roam-In Table
--------------------------------------------------------------------------
Client-MAC-address BSSID
--------------------------------------------------------------------------
0012-f0cc-489d 000f-e25d-f3e0
--------------------------------------------------------------------------
# Display roam-in client information in detail.
<Sysname> display wlan client roam-in verbose
Roam-In Client Information
--------------------------------------------------------------------------
Client-MAC-address : 0012-f0cc-489d
BSSID : 000f-e25d-f3e0
Vlan-ID : 30
Home-AC-IP-address : 202.0.0.13
--------------------------------------------------------------------------
# Display roam-in client information from member AC 202.0.0.13 in detail.
<Sysname> display wlan client roam-in member ip 202.0.0.13 verbose
Roam-In Client Information
--------------------------------------------------------------------------
Client-MAC-address : 0012-f0cc-489d
BSSID : 000f-e25d-f3e0
Vlan-ID : 30
--------------------------------------------------------------------------
# Display all roam-out client information.
<Sysname> display wlan client roam-out
Roam-Out Table
--------------------------------------------------------------------------
Client-MAC-address BSSID Foreign-AC-IP-address
--------------------------------------------------------------------------
0012-f0cc-489d 000f-e25d-f3e0 202.0.0.101
--------------------------------------------------------------------------
# Display roam-out client information to member AC 202.0.0.101.
<Sysname> display wlan client roam-out member ip 202.0.0.101
Roam-Out Table
--------------------------------------------------------------------------
Client-MAC-address BSSID
--------------------------------------------------------------------------
0012-f0cc-489d 000f-e25d-f3e0
--------------------------------------------------------------------------
# Display roam-out client information in detail.
<Sysname> display wlan client roam-out verbose
Roam-Out Client Information
--------------------------------------------------------------------------
Client-MAC-address : 0012-f0cc-489d
BSSID : 000f-e25d-f3e0
Vlan-ID : 30
Online time (hh:mm:ss) : 00:00:29
Foreign-AC-IP-address : 202.0.0.101
--------------------------------------------------------------------------
# Display roam-out client information to member AC 202.0.0.101 in detail.
<Sysname> display wlan client roam-out member ip 202.0.0.101 verbose
Roam-Out Client Information
--------------------------------------------------------------------------
Client-MAC-address : 0012-f0cc-489d
BSSID : 000f-e25d-f3e0
Vlan-ID : 30
Online time (hh:mm:ss) : 00:03:27
--------------------------------------------------------------------------
Table 1 Command output
Field |
Description |
Client-MAC-address |
MAC address of the client. |
BSSID |
BSSID of the AP to which the client is associated. |
Vlan-ID |
VLAN ID of the client. |
Online-time |
How long the client has associated with the AP. |
Foreign-AC-IP-address |
IP address of the foreign access controller. |
display wlan client roam-track
Syntax
display wlan client roam-track mac-address mac-address [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
mac-address mac-address: Displays the roam-track information of a specified client.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display wlan client roam-track mac-address to display the roam-track information of a specified client on the client's HA.
Examples
# Display the roam-track information for client 0012-f0cc-489d.
<Sysname> display wlan client roam-track mac-address 0012-f0cc-489d
Roam Track Table
--------------------------------------------------------------------------
BSSID Online-time(d:h:m:s) AC-IP-address
--------------------------------------------------------------------------
000f-e25d-f3e0 0000:00:02:44 202.0.0.101
000f-e26c-2805 0000:00:02:11 -HOME AC-
--------------------------------------------------------------------------
# Display the roam-track information for client 1234-19af-cb39 (The configured mobility tunnel version is ipv6).
<Sysname> display wlan client roam-track 1234-19af-cb39
Roam Track Table
--------------------------------------------------------------------------
BSSID Online-time(d:h:m:s) AC-IP-address
--------------------------------------------------------------------------
0e45-38bd-4479 0000:10:30:01 3FFE:A6B0:AA00:16EF:122A:001A:F9E0:3BF4
0000-05b2-ac45 0001:09:00:04 -HOME AC-
Table 2 Command output
Field |
Description |
BSSID |
BSSID of the AP with which the client is associated. |
Online-time |
How long the client has associated with the AP. |
AC-IP-address |
IP address of the access controller with which the client is connected. If mobility tunnel version is set to IPv6, the IPv6 address of the access controller is present. |
IACTP configuration commands
authentication-mode
Syntax
authentication-mode authentication-method [ cipher | simple ] authentication-key
undo authentication-mode
View
Mobility group view
Default level
2: System level
Parameters
authentication-method: Authentication method to be used in IACTP control message exchange. At present, only 128-bit MD5 authentication method is supported.
cipher authentication-key: Specifies a cipher-text authentication key, which is displayed in cipher text. The key is a case-sensitive string of 24 characters.
simple authentication-key: Specifies a simple-text authentication key, which is displayed in simple text. The key is a case-sensitive string of 1 to 16 characters.
If the simple or cipher keyword is not specified, a simple-text key is specified and the key is displayed in cipher text. The value range of the key is a case-sensitive string of 1 to 16 characters.
Description
Use authentication-mode to configure an IACTP control message integrity authentication mode.
Use undo authentication-mode to restore the default.
When the authentication-mode command is configured, all control messages transmitted in the IACTP tunnel carry a digest (integrity code) which is calculated based on the message content. On receiving such a message, the member calculates the digest again and compare it against the digest present in the message to verify the integrity of the packet received.
By default, IACTP control message integrity authentication is disabled.
Examples
# Configure the IACTP control message integrity authentication mode as MD5. Specify an MD5 key as 12345 in simple text and the key is displayed in simple text.
<Sysname> system-view
[Sysname] wlan mobility-group office
[Sysname-wlan-mg-office] authentication-mode md5 simple 12345
[Sysname-wlan-mg-office] display this
#
wlan mobility-group office
authentication-mode MD5 simple 12345
#
return
# Configure the IACTP control message integrity authentication mode as MD5. Specify an MD5 key in cipher text and the key is displayed in cipher text.
<Sysname> system-view
[Sysname] wlan mobility-group office
[Sysname-wlan-mg-office] authentication-mode md5 cipher -_'PV5%9O`CQ=^Q`MAF4<1!!
[Sysname-wlan-mg-office] display this
#
wlan mobility-group office
authentication-mode MD5 cipher -_'PV5%9O`CQ=^Q`MAF4<1!!
#
return
# Configure the IACTP control message integrity authentication mode as MD5. Specify an MD5 key as 12345 in simple text and the key is displayed in cipher text.
<Sysname> system-view
[Sysname] wlan mobility-group office
[Sysname-wlan-mg-office] authentication-mode md5 12345
[Sysname-wlan-mg-office] display this
#
wlan mobility-group office
authentication-mode MD5 cipher -_'PV5%9O`CQ=^Q`MAF4<1!!
#
return
display wlan mobility-group
Syntax
display wlan mobility-group [ member { ip ipv4-address | ipv6 ipv6-address } ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
member ip ipv4-address: IPv4 address of a member AC whose information is displayed.
member ipv6 ipv6-address: IPv6 address of a member AC whose information is displayed.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display wlan mobility-group to display the mobility group name, source IP address, authentication method, and member information.
Use display wlan mobility-group member { ip ipv4-address | ipv6 ipv6-address } to display the specified member AC's IP address, IACTP state, local tunnel interface name and IACTP tunnel up time.
Examples
# Display WLAN mobility group information.
<Sysname> display wlan mobility-group
Mobility Group Information
--------------------------------------------------------------------------
Group Name : asd
Source IP Address : 196.168.1.4
Authentication Method : MD5
--------------------------------------------------------------------------
Member Information
--------------------------------------------------------------------------
IP-address State Interface
-------------------------------------------------------------------------
192.168.1.10 Run wlan-tunnel0
192.168.1.34 Idle wlan-tunnel1
--------------------------------------------------------------------------
# Display WLAN mobility group information (The configured mobility tunnel type is IPv6).
<Sysname> display wlan mobility-group
Mobility Group Information
--------------------------------------------------------------------------
Group Name : asd
Source IP Address : 55F2::1001
Authentication Method : MD5
--------------------------------------------------------------------------
Member Information
--------------------------------------------------------------------------
IPv6-address State Interface
--------------------------------------------------------------------------
3FFE:A6B0:AA00:16EF:122A:001A:F9E0:3BF4 Run wlan-tunnel0
4523::3345 Idle wlan-tunnel1
--------------------------------------------------------------------------
# Display the information of the AC with the address 192.168.1.10 in the WLAN mobility group.
<Sysname> display wlan mobility-group member ip 192.168.1.10
Member Information
----------------------------------------------------------------------
IP Address : 192.168.1.10
State : Run
Interface : WLAN-Tunnel0
Online Time (hh:mm:ss) : 00:16:05
----------------------------------------------------------------------
Table 3 Command output
Field |
Description |
Group Name |
WLAN mobility group name |
Source IP Address |
Tunnel source IP address |
Authentication Method |
Authentication method used for the WLAN mobility group |
IP Address |
IP address of the access controller |
State |
IACTP state of the access controller |
Interface |
WLAN tunnel interface name |
Online Time (hh:mm:ss) |
IACTP tunnel up time |
member
Syntax
member { ip ipv4-address | ipv6 ipv6-address } [ vlan vlan-id-list ]
undo member { all | ip ipv4-address | ipv6 ipv6-address }
View
Mobility group view
Default level
2: System level
Parameters
ip ipv4-address: IPv4 address of an AC to be included in or removed from the mobility group.
ipv6 ipv6-address: IPv6 address of an AC to be included in or removed from the mobility-group.
vlan vlan-id-list: VLANs to which the mobility group members belong. This argument is expressed in the format of vlan-id-list = { vlan-id1 [ to vlan-id2 ] }& <1-10>, where vlan-id ranges from 2 to 4094 and &<1-10> indicates that you can specify up to 10 VLAN IDs or VLAN ID ranges. If this parameter is not specified, local forwarding is enabled on all the VLANs.
all: Removes all the ACs from the mobility group.
Description
Use member to add an AC into the mobility group.
Use undo member to remove an AC or all ACs from the mobility group.
Members can be added dynamically irrespective of whether IACTP service is enabled or not.
Examples
# Add an IPv4 member to the mobility group, and configure the VLAN to which the member belongs.
<Sysname> system-view
[Sysname] wlan mobility-group abc
[Sysname-wlan-mg-abc] member ip 192.168.1.55 vlan 2 to 7
# Add an IPv6 member to the mobility group, and configure the VLAN to which the member belongs.
<Sysname> system-view
[Sysname] wlan mobility-group abc
[Sysname-wlan-mg-abc] member ipv6 3FFE:A6B0:AA00:16EF:122A:001A:F9E0:3BF4 vlan 2 to 7
mobility-group enable
Syntax
mobility-group enable
undo mobility-group enable
View
Mobility group view
Default level
2: System level
Parameters
None
Description
Use mobility-group enable to enable the IACTP service.
Use undo mobility-group enable to restore the default.
By default, the IACTP service is disabled.
The IACTP service can be enabled only when the IACTP source IP address is configured.
Examples
# Enable the IACTP service.
<Sysname> system-view
[Syaname] wlan mobility-group abc
[Sysname-wlan-mg-abc] mobility-group enable
mobility-tunnel
Syntax
mobility-tunnel { iactp | iactp6 }
View
Mobility group view
Default level
2: System level
Parameters
iactp: Selects IPv4 as the network protocol type. This is the default value.
iactp6: Selects IPv6 as the network protocol type.
Description
Use mobility-tunnel to configure the tunnel protocol type to be used for inter-AC communication.
By default, IPv4 is selected for inter-AC communication.
This can be done only when the mobility group is disabled.
IPv4 and IPv6 cannot work simultaneously.
Examples
# Choose IPv4 as the tunnel protocol type.
<Sysname> system-view
[Sysname] wlan mobility-group abc
[Sysname-wlan-mg-abc] mobility-tunnel iactp
# Choose IPv6 as the tunnel protocol type.
<Sysname> system-view
[Sysname] wlan mobility-group abc
[Sysname-wlan-mg-abc] mobility-tunnel iactp6
source
Syntax
source { ip ipv4-address | ipv6 ipv6-address }
undo source
View
Mobility group view
Default level
2: System level
Parameters
ip ipv4-address: Specifies the IACTP tunnel source IPv4 address.
Ipv6 ipv6-address: Specifies the IACTP tunnel source IPv6 address.
Description
Use source to specify the IACTP tunnel source IP address for the mobility group.
Use undo source to restore the default.
This command can be configured only when the IACTP service is disabled.
Examples
# Specify the IACTP tunnel source IP address as 192.168.1.66.
<Sysname> system-view
[Sysname] wlan mobility-group abc
[Sysname-wlan-mg-abc] source ip 192.168.1.66
wlan mobility-group
Syntax
wlan mobility-group name
undo wlan mobility-group name
View
System view
Default level
2: System level
Parameters
name: Mobility group name, a string of 1 to 15 characters.
Description
Use wlan mobility-group to create a mobility group and enter mobility group view.
Use undo wlan mobility-group to remove the mobility group and all its configurations.
In mobility group view, mobility group tunnel protocol type, tunnel source IP address, authentication mode, adding a mobility group, and enabling/disabling the IACTP service can be done. In this version, only one mobility group can be created.
ACs in the same mobility group must have the same mobility group name.
Examples
# Enter mobility group view.
<Sysname> system-view
[Sysname] wlan mobility-group abc
[Sysname-wlan-mg-abc]