display access-user roam-table

Function

The display access-user roam-table command displays the roaming table information of a roaming user.

Only the S5730-HI, S5731-H, S5731S-H, S6730-H, S6730S-H, S5732-H, S6720-HI, and S5720-HI support this command.

Format

display access-user roam-table [ mac-address mac-address | ip-address ip-address [ vpn-instance vpn-instance-name ] | acct-session-id acct-session-id ]

Parameters

Parameter	Description	Value
mac-address mac-address	Displays the roaming table information of a roaming user with a specified MAC address.	The value is in H-H-H format. H contains 4 hexadecimal digits.
ip-address ip-address	Displays the roaming table information of a roaming user with a specified IP address.	The value is in dotted decimal notation.
vpn-instance vpn-instance-name	Displays the roaming table information of a roaming user with a specified IP address in a specified VPN instance.	The value must be an existing VPN instance name on the device.
acct-session-id acct-session-id	Displays the roaming table information of a roaming user with a specified accounting ID.	The value must be the current accounting ID of the user. For details, run the display access-user user-id user-id command to check the User accounting session ID field.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

When a user roams between different ACs, the user roaming table is generated on the AC (authentication point) before the user is re-authenticated. You can run this command to view the user roaming table information.

Precautions

In 802.1X authentication and MAC address authentication, roaming tables are generated only for accounting users, not non-accounting users.

Example

# Display the roaming table information of a roaming user.

<HUAWEI> display access-user roam-table
 ------------------------------------------------------------------------------
 MAC             IP address                       FAC address
------------------------------------------------------------------------------
 7c7d-3dad-aed8  10.1.1.2                         10.137.213.119 
 ------------------------------------------------------------------------------

<HUAWEI> display access-user roam-table ip-address 10.1.1.2
  User MAC                                 : 7c7d-3dad-aed8
  User accounting session ID               : AP6050-00000000000102fa****0000023
  User IP address                          : 10.1.1.2
  IP address of foreign AC                 : 10.137.213.119

**Table 1** Description of the display access-user roam-table command output
Item	Description
User accounting session ID	User accounting ID.
IP address/User IP address	User IP address.
MAC/User MAC	User MAC address.
FAC address/IP address of foreign AC	IP address of the AC where the user roams.