10-WLAN Roaming Command Reference

HomeSupportReference GuidesCommand ReferencesH3C Access Controllers Command References(R5426P02)-6W10410-WLAN Roaming Command Reference
02-WLAN roaming center commands
Title Size Download
02-WLAN roaming center commands 89.74 KB

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]

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become a Partner
  • Partner Resources
  • Partner Business Management
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网