目  录

1 分层AC

1.1 分层AC配置命令

1.1.1 backup-ac

1.1.2 delete file

1.1.3 display wlan ac-role

1.1.4 display wlan client

1.1.5 display wlan local-ac (Central AC)

1.1.6 display wlan local-ac connection-record

1.1.7 display wlan local-ac files

1.1.8 display wlan local-ac model

1.1.9 display wlan local-ac online-time

1.1.10 download file

1.1.11 echo-interval

1.1.12 firmware-upgrade

1.1.13 location (AP group view)

1.1.14 location (RRM holddown group view)

1.1.15 location (wlan service-template view)

1.1.16 priority

1.1.17 reset wlan local-ac

1.1.18 retransmit-count

1.1.19 retransmit-interval

1.1.20 roam central-ac-auth enable

1.1.21 serial-id

1.1.22 switch-back (Central AC)

1.1.23 wlan local-ac

1.1.24 wlan location

1.1.25 wlan tunnel-preempt

 

1 分层AC

1.1  分层AC配置命令

1.1.1  backup-ac

backup-ac命令用来在双链路模式下配置备份Central AC的IP地址。

undo backup-ac命令用来删除备份Central AC的IP地址。

【命令】

backup-ac { ip ipv4-address | ipv6 ipv6-address }

undo backup-ac { ip | ipv6 }

【缺省情况】

未配置备份Central AC的IP地址。

【视图】

Local AC视图

【缺省用户角色】

network-admin

【参数】

ip ip-address：备份Central AC的IPv4地址。

ipv6 ipv6-address：备份Central AC的IPv6地址。

【使用指导】

仅Central AC支持本功能。

最多只能配置一个备份Central AC的IPv4地址和一个IPv6地址。

若已经建立了备份隧道，删除备份Central AC的IP地址会导致备份隧道连接断开。

【举例】

# 配置Local AC的备份Central AC的IPv4地址。

<Sysname> system-view

[Sysname] wlan local-ac name bac

[Sysname-wlan-local-ac-bac] backup-ac ip 192.168.1.1

1.1.2  delete file

delete file命令用来删除Local AC上的文件。

【命令】

delete file filename

【视图】

Local AC视图

【缺省用户角色】

network-admin

【参数】

filename：要删除的文件名，为1～255个字符的字符串。

【使用指导】

仅Central AC支持本功能。

只有在Local AC和Central AC建立了CAPWAP隧道并且当前Central AC为主Central AC时，用户才能通过文件删除操作将Local AC上的文件删除。

【举例】

# 删除Local AC上的文件startup.cfg。

<Sysname> system-view

[Sysname] wlan local-ac name abc

[Sysname-wlan-local-ac-abc] delete file startup.cfg

【相关命令】

·     display wlan local-ac files

·     download file

1.1.3  display wlan ac-role

display wlan ac-role命令用来显示AC的角色信息。

【命令】

display wlan ac-role

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示AC的角色信息。

<Sysname> display wlan ac-role

Current AC role: Central AC

表1-1 display wlan ac-role命令显示信息描述表

字段	描述
Current AC role	AC的角色信息： ·     Common：AC的角色为普通AC ·     Central AC：AC的角色为Central AC ·     Local AC：AC的角色为Local AC ·     Unknown：AC的角色未知

 

1.1.4  display wlan client

display wlan client命令用来查看客户端的信息。

【命令】

display wlan client distributed-sys [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

distributed-sys：应用于分层AC环境下，在Central AC上显示Central AC上关联的客户端信息，在Local AC上显示该Local AC上关联的客户端信息。

verbose：显示客户端的详细信息。如果未指定本参数，表示显示客户端的简要信息。

【举例】

# 显示全部客户端简要信息。

<Sysname> display wlan client distributed-sys

Total number of clients: 3

 

MAC address    Username         AP name       RID   IPv4 address        VLAN

000f-e265-6400 N/A              ap1           1     1.1.1.1             100

000f-e265-6401 user             ap2           1     3.0.0.3             200

84db-ac14-dd08 N/A              ap1           1     5.5.5.3             1

表1-2 display wlan client distributed-sys命令显示信息描述表

字段	描述
MAC address	客户端的MAC地址
Username	客户端的用户名，若客户端采用802.1X认证或MAC地址认证，则显示认证使用的用户名，若客户端不进行802.1X认证或MAC地址认证，则显示为N/A 需要注意的是，如果客户端采用Portal认证方式，Username字段不会显示客户端的Portal用户名，显示为N/A
AP name	客户端关联AP的名称
RID	客户端关联的Radio ID
IPv4 address	客户端的IPv4地址
VLAN ID	客户端所属VLAN

‌

#显示全部客户端详细信息。

<Sysname> display wlan client distributed-sys verbose

Total number of clients: 1

 

MAC address                        : 000f-e265-6400

IPv4 address                       : 10.1.1.114

IPv6 address                       : 2001::1234:5678:0102:0304

Username                           : N/A

AID                                : 1

AP ID                              : 1

AP name                            : ap1

Radio ID                           : 1

SSID                               : office

BSSID                              : 0026-3e08-1150

VLAN ID                            : 3

Sleep count                        ：3

Wireless mode                      : 802.11ac

Channel bandwidth                  : 80MHz

SM power save                      : Enabled

SM power save mode                 : Dynamic

Short GI for 20MHz                 : Supported

Short GI for 40MHz                 : Supported

Short GI for 80MHz                 : Supported

Short GI for 160/80+80MHz          : Not supported

STBC RX capability                 : Not supported

STBC TX capability                 : Not supported

LDPC RX capability                 : Not supported

SU beamformee capability           : Not supported

MU beamformee capability           : Not supported

Beamformee STS capability          : N/A

Block Ack                          : TID 0 In

Supported VHT-MCS set              : NSS1 0, 1, 2, 3, 4, 5, 6, 7, 8

                                     NSS2 0, 1, 2, 3, 4, 5, 6, 7, 8

Supported HT MCS set                 : 0, 1, 2, 3, 4, 5, 6, 7,

                                     8, 9, 10, 11, 12, 13, 14,

                                     15, 16, 17, 18, 19, 20,

                                     21, 22, 23

Supported rates                    : 6, 9, 12, 18, 24, 36,

                                     48, 54 Mbps

QoS mode                           : WMM

Listen interval                    : 10

RSSI                               : 62

Rx/Tx rate                         : 130/195 Mbps

Authentication method              : Open system

Security mode                      : PRE-RSNA

AKM mode                           : Not configured

Cipher suite                       : N/A

User authentication mode           : Bypass

Authorization ACL ID               : 3001(Not effective)

Authorization user profile         : N/A

Roam status                        : N/A

Key derivation                     : SHA1

PMF status                         : Enabled

Forward policy name                : Not configured

Online time                        : 0days 0hours 1minutes 13seconds

FT status                          : Inactive

表1-3 display wlan client distributed-sys verbose命令显示信息描述表

字段	描述
MAC address	客户端的MAC地址
IPv4 address	客户端的IPv4地址
IPv6 address	客户端的IPv6地址
Username	客户端的用户名，若客户端采用802.1X认证或MAC地址认证，则显示认证使用的用户名，若客户端不进行802.1X认证或MAC地址认证，则显示为N/A 需要注意的是，如果客户端采用Portal认证方式，Username字段不会显示客户端的Portal用户名，显示为N/A
AID	关联标识符
AP ID	客户端关联的AP ID
AP name	客户端关联AP的名称
Radio ID	客户端关联的Radio ID
SSID	客户端关联的SSID
BSSID	基本服务集识别码
VLAN ID	客户端所属的VLAN
Sleep count	客户端睡眠次数
Wireless mode	客户端工作的模式： ·     802.11a：工作模式为 802.11a ·     802.11b：工作模式为 802.11b ·     802.11g：工作模式为 802.11g ·     802.11gn：工作模式为 802.11gn ·     802.11an：工作模式为 802.11an ·     802.11ac：工作模式为802.11ac
Channel bandwidth	客户端的工作带宽模式： ·     20MHz：工作带宽为20MHz ·     40MHz：工作带宽为40MHz ·     80MHz：工作带宽为80MHz ·     160MHz：工作带宽为160MHz
SM Power Save	省电模式状态： ·     Enabled：省电模式处于开启状态，省电模式开启后客户端上只有一个天线处于工作状态，其余天线均处于休眠状态，从而达到节电的目的 ·     Disabled：省电模式处于关闭状态
SM power save mode	省电模式： ·     Dynamic：动态模式 ·     Static：静态模式
Short GI for 20MHz	客户端工作带宽为20MHz时，对于Short GI的支持情况： ·     Supported：客户端支持Short GI ·     Not supported：客户端不支持Short GI
Short GI for 40MHz	客户端工作带宽为40MHz时，对于Short GI的支持情况： ·     Supported：客户端支持Short GI ·     Not supported：客户端不支持Short GI
Short GI for 80MHz	客户端工作带宽为80MHz时，对于Short GI的支持情况： ·     Supported：客户端支持Short GI ·     Not supported：客户端不支持Short GI
Short GI for 160/80+80MHz	客户端工作带宽为160或80+80MHz时，对于Short GI的支持情况： ·     Supported：客户端支持Short GI ·     Not supported：客户端不支持Short GI
STBC RX capability	客户端STBC接收能力情况： ·     Supported：客户端支持STBC接收 ·     Not Supported：客户端不支持STBC接收
STBC Tx capability	客户端STBC发送能力情况： ·     Supported：客户端支持STBC发送 ·     Not Supported：客户端不支持STBC发送
LDPC Rx capability	客户端LDPC接收能力情况： ·     Supported：客户端支持LDPC接收 ·     Not Supported：客户端不支持LDPC接收
SU beamformee capability	客户端单用户波束成形能力情况： ·     Supported：客户端支持单用户波束成形 ·     Not Supported：客户端不支持单用户波束成形 （仅802.11ac模式支持该字段）
MU beamformee capability	客户端多用户波束成形能力情况： ·     Supported：客户端支持多用户波束成形 ·     Not Supported：客户端不支持多用户波束成形 （仅802.11ac模式支持该字段）
Beamformee STS capability	客户端波束成形空间流接收的能力值，显示N/A时表示客户端不支持波束成形空间流接收
Block Ack	QoS TID的Block Ack协商结果： ·     TID 0 In：表示上行数据报文支持Block Ack ·     TID 0 Out：表示下行数据报文支持Block Ack ·     TID 0 Both：表示上行和下行数据报文都支持Block Ack ·     N/A：表示上行和下行数据报文都不支持Block Ack
Supported VHT-MCS set	客户端支持VHT-MCS
Supported HT MCS set	客户端支持MCS
Supported rates	客户端支持的速率
QoS mode	QoS模式： ·     N/A：不支持WMM协议 ·     WMM：支持WMM协议 对于WMM的支持情况，AP和客户端会进行协商。对于只有AP和客户端同时支持WMM时，才能协商成功
Listen interval	处于睡眠模式的客户端定期醒来，接收缓存在AP中的数据帧的时间间隔，间隔时间单位为信标发送时间间隔
RSSI	客户端信号强度指示，该值表明了AP检测到客户端的信号强度
Rx/Tx rate	客户端发送/接收报文的速率（包括数据、管理和控制报文）
Authentication method	链路层认证方法： ·     Open system：开放系统认证 ·     Shared key：共享密钥认证
Security mode	安全模式： ·     RSN：信标和探查响应帧携带RSN IE ·     WPA：信标和探查响应帧携带WPA IE ·     PRE-RSNA：信标和探查响应帧不携带RSN IE或WPA IE
AKM mode	身份认证与密钥管理模式： ·     802.1X：表示身份认证与密钥管理模式是802.1X方式 ·     PSK：表示身份认证与密钥管理模式是PSK方式 ·     Not configured：未配置身份认证与密钥管理模式
Cipher suite	加密套件： ·     N/A：明文方式，不加密 ·     WEP40：使用WEP40加密套件 ·     WEP104：使用WEP104加密套件 ·     WEP128：使用WEP128加密套件 ·     CCMP：使用AES-CCMP加密套件 ·     TKIP：使用TKIP加密套件
User authentication mode	用户认证模式： ·     Bypass：不做用户认证 ·     MAC：MAC认证 ·     802.1X：802.1X认证 ·     OUI ：OUI认证
Authorization ACL ID	授权ACL对应的ACL编号： ·     授权ACL生效，则显示ACL编号 ·     授权ACL未生效，则显示ACL编号 + Not effective ·     不配置授权ACL，显示N/A
Authorization user profile	授权User profile名称： ·     如果下发授权User Profile生效，显示Authorization User Profile名称 ·     如果下发授权User Profile未生效，显示Authorization User Profile名称+Not effective ·     不配置授权User profile，显示N/A
Roam status	漫游状态： ·     Roaming in progress：漫游切换中 ·     Inter-AC slow roam：AC间慢速漫游 ·     Inter-AC fast roam：AC间快速漫游 ·     Intra-AC slow roam：AC内慢速漫游 ·     Intra-AC fast roam：AC内快速漫游 ·     N/A：客户端正常上线
Key derivation	密钥衍生类型，包括以下几种： ·     SHA1：SHA1 Key Derivation ·     SHA256：SHA256 Key Derivation ·     N/A：不涉及密钥衍生算法
PMF status	保护管理帧状态，包括以下几种： ·     Enabled：保护管理帧功能开启 ·     Disabled：保护管理帧功能关闭 ·     N/A：不涉及保护管理帧功能
Forward policy name	无线转发策略： ·     Not configured：未配置无线转发策略 ·     policy-name：无线转发策略名称
Online time	客户端在线的时间
FT status	快速BSS切换功能状态： ·     Active：开启状态 ·     Inactive：关闭状态

‌

1.1.5  display wlan local-ac (Central AC)

display wlan local-ac命令用来在Central AC上显示Local AC的信息。

【命令】

display wlan local-ac { all | name local-ac-name } [ address | verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

all：显示所有Local AC的信息。

name local-ac-name：显示指定Local AC的信息，local-ac-name表示Local AC的名称，为1～64个字符的字符串，可以包含字母、数字、下划线、“[”、“]”、“/”及“-”，区分大小写。

address：显示Local AC的IP地址信息。

verbose：显示Local AC的详细信息。如果未指定本参数，则显示Local AC的概要信息。

【使用指导】

仅Central AC支持本功能。

【举例】

# 在Central AC上显示所有Local AC的概要信息。

<Sysname> display wlan local-ac all

Total number of local ACs: 2

Total number of connected local ACs: 2

 

                               Local AC Information

 State : I = Idle,       J  = Join,       JA = JoinAck,    IL = ImageLoad

         C = Config,     DC = DataCheck,  R/M  = Run,    M = Master,    B = Backup

 

AC name                        ACID  State Model           Serial ID

lac1                           1     I     WX5510E         210235A1BSC123000050

lac2                           2     R/M   WX5510E         210456B9CEN238400040

表1-4 display wlan local-ac all命令显示信息描述表

字段	描述
AC name	Local AC名称
ACID	Local AC的ID号，由Central AC自动分配，用于在Central AC上唯一标识一个Local AC
State	Local AC当前状态解释如下： ·     I：空闲状态 ·     J：管理通道建立状态 ·     JA：管理通道建立确认阶段 ·     IL：版本下载状态 ·     C：初始化配置下载状态 ·     DC：数据校验状态 ·     R：运行状态，表示Local AC与Central AC成功建立通道 ·     M: 隧道类型，主隧道 ·     B：隧道类型，备隧道
Model	Local AC型号信息
Serial ID	Local AC序列号，如果未指定，则显示为Not configured

‌

# 显示名称为bac的Local AC的详细信息。

<Sysname> display wlan local-ac name bac verbose

Local AC name                 : bac

Local AC ID                   : 1

State                         : Run

Online time                   : 0 days 0 hours 0 minutes 24 seconds

System up time                : 0 days 0 hours 5 minutes 24 seconds

Model                         : WX5510E

Serial ID                     : 332135A0N701

MAC address                   : 00EF-003C-0001

IP address                    : 1.2.3.3

UDP port number               : 60225

H/W version                   : Ver.A

S/W version                   : A7164

Boot version                  : 2.17

Description                   : Not configured

Priority                      : 4

Echo interval                 : 10 seconds

Fragment size (data)          : 65535

Fragment size (control)       : 1450

Discovery type                : Static Configuration

Retransmission count          : 3

Retransmission interval       : 3 seconds

Firmware upgrade              : Enabled

Sent control packets          : 66

Received control packets      : 66

Last reboot reason            : User reboot

Latest IP address             : 1.2.3.3

Tunnel down reason            : N/A

Connected AP count            : 2

Tunnel encryption             : Enabled

Tunnel-data encryption        : Disabled

表1-5 display wlan local-ac name verbose命令显示信息描述表

字段	描述
Local AC name	Local AC名称
Local AC ID	Local AC的ID号，用于唯一标识一个Local AC
State	Local AC当前状态： ·     Idle：空闲状态 ·     Join：CAPWAP连接建立状态 ·     JoinAck：CAPWAP连接确认状态 ·     Image Download：版本下载状态 ·     Config：初始化配置下载状态 ·     Data Check：数据校验状态 ·     Run：运行状态，表示Local AC与Central AC成功建立CAPWAP隧道
Online time	Local AC在线时长
System up time	Local AC系统启动时长
Model	Local AC型号信息
Serial ID	Local AC序列号。如果未配置序列号，显示为Not configured
MAC address	Local AC的MAC地址。如果未配置MAC地址，显示为Not configured
IP address	Local AC当前连接的IP地址
UDP port number	Local AC建立CAPWAP控制隧道的端口号
H/W version	Local AC当前硬件信息
S/W version	Local AC当前软件信息
Boot version	Local AC当前引导程序版本
Description	Local AC描述信息。如果未配置描述信息，显示为Not configured
Priority	Central AC配置的Local AC连接的优先级
Echo interval	Local AC的两次回声请求的时间间隔
Fragment size (data)	CAPWAP数据报文最大长度
Fragment size (control)	CAPWAP控制报文最大长度
Discovery type	Local AC的发现方式： ·     Static Configuration：Local AC使用静态配置的IP地址发现Central AC ·     Unknown：未知的发现方式
Retransmission count	Central AC重传请求报文的重传次数
Retransmission interval	Central AC重传请求报文的重传间隔
Firmware upgrade	Local AC的版本下载： ·     Enabled：开启Local AC的版本下载 ·     Disabled：关闭Local AC的版本下载
Sent control packets	Local AC在Run状态之后发送的控制报文的个数（包含Change State Event Response报文）
Received control packets	Local AC在Run状态之后接收的控制报文的个数（包含Change State Event Request报文）
Last reboot reason	Local AC上一次重启的原因： ·     Power on：Local AC设备上电重启 ·     Hard reboot：硬重启，即使用reset按钮重启Local AC设备 ·     Watchdog reboot：看门狗重启 ·     Unknown reboot：未知原因重启 ·     User soft reboot：通过命令行、SNMP、Web等管理手段重启设备 ·     Kernel exception soft reboot：内核异常重启 ·     Kernel deadloop soft reboot：内核死循环重启 ·     Auto update soft reboot：版本自动升级 ·     Unknown soft reboot：未知软件原因 ·     Memory exhausted：内存耗尽 ·     Other unknown soft reboot：其他原因
Latest IP address	Local AC最近一次使用的IP地址
Tunnel down reason	CAPWAP隧道关闭的原因： ·     N/A：无 ·     Failed to create timer：创建定时器失败 ·     Neighbor dead timer expired：邻居报告定时器超时 ·     Request wait timer expired：等待请求消息定时器超时 ·     Data check timer expired：数据检测定时器超时 ·     Failed to process data channel keep-alive message：处理数据隧道保活报文失败 ·     Failed to process request：请求报文处理失败 ·     Failed to come online：Local AC上线失败 ·     Serial number changed：Local AC的Serial ID改变 ·     MAC address changed：Local AC的MAC地址改变 ·     Number of APs exceeded the limit：Local AC数量超出Central AC能力集 ·     Processed join request in Run state：在Run状态处理join request ·     Received failure result code：CAPWAP状态机状态变迁时收到错误结果码 ·     Failed to retransmit message：报文重传失败 ·     Failed to download image file：下载Local AC镜像失败 ·     Image file downloaded successfully：Local AC下载镜像成功重启系统 ·     File operation timer expired：文件操作定时器超时 ·     Failed to add tunnel：添加隧道失败 ·     Failed to inherit configuration：继承配置失败
Connected AP count	Local AC上关联的AP数量
Tunnel encryption	CAPWAP隧道加密功能： ·     Enabled：开启状态 ·     Disabled：关闭状态
Tunnel-data encryption	CAPWAP数据隧道加密功能： ·     Enabled：开启状态 ·     Disabled：关闭状态

‌

# 在Central AC上显示所有Local AC的IP地址信息。

<Sysname> display wlan local-ac all address

Total number of local ACs: 2

 

Total number of connected local ACs: 2

 

AC name                          IP address                     MAC address

lac1                             1.1.1.5                        000b-6b8f-fc6a

lac2                             1.1.1.6                        000b-6b8f-fc7b

表1-6 display wlan local-ac address命令显示信息描述表

字段	描述
AC name	Local AC名称
IP address	Local AC的IP地址信息
MAC address	Local AC的MAC地址信息

‌

1.1.6  display wlan local-ac connection-record

display wlan local-ac connection-record命令用来在Central AC上查看Local AC的连接记录。

【命令】

display wlan local-ac { all | name local-ac-name } connection-record

【视图】

系统视图

【缺省用户角色】

network-admin

network-operator

【参数】

all：显示所有Local AC的连接记录。

name local-ac-name：显示指定Local AC的连接记录，local-ac-name表示Local AC的名称，为1～64个字符的字符串，可以包含字母、数字、下划线、“[”、“]”、“/”及“-”，区分大小写。

【使用指导】

仅Central AC支持本功能。

【举例】

# 在Central AC上查看所有Local AC的连接记录。

<Sysname> display wlan local-ac all connection-record

Local AC Information

 State : D = Discovery,       J  = Join,       O = Offline,    R = Run

 

AC name                         IP address       State      State changed at

bac                             192.168.100.27 R          01-06 09:06:40

表1-7 display wlan local-ac connection-record命令显示信息描述表

字段	描述
Local AC name	Local AC名称
IP address	Local AC的IP地址
State	Local AC当前状态： ·     D：Local AC发现Central AC ·     J：管理通道建立状态 ·     O：下线状态，表示Local AC与Central AC断开连接 ·     R：运行状态，表示Local AC与Central AC建立了CAPWAP隧道通道
State changed at	Local AC与Central AC最后一次状态发生变化的时间

‌

1.1.7  display wlan local-ac files

display wlan local-ac files命令用来在Central上显示Local AC上的文件及文件夹信息。

【命令】

display wlan local-ac name local-ac-name files

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

name local-ac-name：指定Local AC的名称，local-ac-name表示Local AC的名称，为1～64个字符的字符串，可以包含字母、数字、下划线、“.”、“[”、“]”、“/”及“-”，区分大小写。

【使用指导】

仅Central AC支持本功能。

【举例】

# 显示Local AC abc的文件及文件夹信息。

<Sysname> display wlan local-ac name abc files

Directory of flash:

   0   13638656  system.bin

   1   2573312   boot.bin

131072 KB total (114208 KB free)

表1-8 display wlan local-ac files命令显示信息描述表

字段	说明
Directory of	当前显示的Local AC目录
0   13638656  xx.xx	Local AC文件夹的信息： ·     0表示编号，由系统自动分配 ·     13638656表示文件大小，单位为B。如果显示为“-”，则表示它是文件夹 ·     xx.xx表示名称

‌

1.1.8  display wlan local-ac model

display wlan local-ac model命令用来在Central AC上显示Local AC型号的信息。

【命令】

display wlan local-ac model { all | name model-name }

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

all：显示所有Local AC型号的信息。

name model-name：显示指定Local AC型号的信息。

【使用指导】

仅Central AC支持本功能。

【举例】

<Sysname> display wlan local-ac model name WX3540H

Local AC model    : WX3540H

Alias             : WX3540H

Vendor name       : H3C

Vendor ID         : 25506

Version Support List:

 Hardware Version Ver.A:

  Software Version         : C5419

  Default Software Version : C5419

  Image Name               : wx3540h.ipe

 Hardware Version Ver.B:

  Software Version         : C5419

  Default Software Version : C5419

  Image Name               : wx3540h.ipe

 Hardware Version Ver.C:

  Software Version         : C5419

  Default Software Version : C5419

  Image Name               : wx3540h.ipe

 Hardware Version Ver.D:

  Software Version         : C5419

  Default Software Version : C5419

  Image Name               : wx3540h.ipe

 Hardware Version Ver.E:

  Software Version         : C5419

表1-9 display wlan local-ac model命令显示信息描述表

字段	描述
Local AC model	Local AC型号名
Alias	Local AC型号别名
Vendor name	厂商名
Vendor ID	厂商ID
Version Support List	版本支持列表
Hardware Version	Local AC的硬件版本
Software Version	Local AC的软件版本，用于和Local AC上报的软件版本号进行比较，缺省值为APDB中保存的Local AC软件版本
Default Software Version	APDB中保存的Local AC软件版本
Image Name	Local AC镜像文件

‌

1.1.9  display wlan local-ac online-time

display wlan local-ac online-time命令用来显示已上线Local AC的在线时长。

【命令】

display wlan local-ac { all | name local-ac-name } online-time

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

all：显示所有已上线的Local AC的在线时长。

name local-ac-name：指定Local AC的名称，local-ac name表示Local AC的名称，为1～64个字符的字符串，可以包含字母、数字、下划线、“.”、“[”、“]”、“/”及“-”，区分大小写。

【使用指导】

仅Central AC支持本功能。

【举例】

# 显示所有Local AC的在线时长。

<Sysname> display wlan local-ac all online-time

AC name              IP address         Time

bac1                 1.1.1.10           1 days 2 hours 13 minutes 39 seconds

bac2                 100：100：100：：12  0 days 3 hours 10 minutes 20 seconds

表1-10 display wlan local-ac all online-time命令显示信息描述表

字段	描述
AC name	在线的Local AC的名称
IP address	在线的Local AC的IPv4或IPv6地址
Time	Local AC的在线时长

‌

1.1.10  download file

download file命令用来下发指定的文件到Local AC。

【命令】

download file filename

【视图】

Local AC视图

【缺省用户角色】

network-admin

【参数】

filename：文件名，为1～255个字符的字符串。

【使用指导】

仅Central AC支持本功能。

只有在Local AC和Central AC建立了CAPWAP隧道并且当前AC为主Central AC时，用户才能通过文件下载操作将Central AC上存储的文件下发给Local AC。

【举例】

# 将版本文件main.ipe下发到Local AC abc。

<Sysname> system-view

[Sysname] wlan local-ac name abc

[Sysname-wlan–local-ac-abc] download file main.ipe

1.1.11  echo-interval

echo-interval命令用来配置Local AC发送回声请求的时间间隔。

undo echo-interval命令用来恢复缺省情况。

【命令】

echo-interval interval

undo echo-interval

【缺省情况】

Local AC发送回声请求的时间间隔为10秒。

【视图】

Local AC视图

【缺省用户角色】

network-admin

【参数】

interval：指定Local AC发送回声请求的时间间隔，取值范围为0、5～255，单位为秒。

【使用指导】

仅Central AC支持本功能。

Local AC和Central AC之间通过保活机制来检查管理通道是否正常工作。Local AC周期性地向Central AC发送回声请求Echo request报文，若一定时间内没有收到Central AC回复的Echo response报文，则Local AC断开管理通道；若Central AC在一定时间内没有收到Echo request报文，则Central AC断开管理通道。保活时间为Echo request报文的发送时间间隔乘以最大发送次数3次。

关闭保活机制仅适用于特殊测试场合。在非测试场合中，为了保证控制隧道的正常运行，请勿将interval参数配置为0。

【举例】

# 配置Local AC向Central AC发送的回声请求时间间隔为15秒。

<Sysname> system-view

[Sysname] wlan local-ac name lac model WX3540H

[Sysname-wlan-local-ac-lac] echo-interval 15

1.1.12  firmware-upgrade

firmware-upgrade enable命令用来开启Local AC版本升级功能。

firmware-upgrade disable命令用来关闭Local AC版本升级功能。

undo firmware-upgrade命令用来恢复缺省情况。

【命令】

firmware-upgrade { disable | enable }

undo firmware-upgrade

【缺省情况】

Local AC版本升级功能处于开启状态。

【视图】

Local AC视图

【缺省用户角色】

network-admin

【使用指导】

仅Central AC支持本功能。

开启本功能前，请在Local AC上使用save命令进行配置保存，否则会导致Local AC配置丢失。

Local AC与Central AC建立管理通道过程中，如果Local AC版本升级功能处于开启状态，且Local AC的软件版本与APDB中保存的软件版本不一致，则Local AC必须从Central AC上下载对应的软件版本文件进行版本升级后才能与Central AC建立管理通道；如果Local AC版本升级功能处于关闭状态，则Central AC不比较Local AC当前的软件版本和APDB中保存的软件版本是否一致，直接与Local AC建立管理通道。

【举例】

# 开启Local AC版本升级功能。

<Sysname> system-view

[Sysname] wlan local-ac name lac model WX3540H

[Sysname-wlan-local-ac-lac] firmware-upgrade enable

1.1.13  location (AP group view)

location命令用来标记AP组的地区标识。

undo location命令用来恢复缺省情况。

【命令】

location location-name

undo location

【缺省情况】

AP组被标记默认地区标识。

【视图】

AP组视图

【缺省用户角色】

network-admin

【参数】

location-name：地区标识名称，为1～31个字符的字符串，可以包含字母、数字、下划线、“[”、“]”、“/”及“-”，不区分大小写。

【使用指导】

为AP组标记指定的地区标识后，该AP组将在逻辑上被划分到地区标识所标识的地域。

在Web页面上，系统将根据管理员的用户角色过滤AP组，管理员只能查看并管理与用户角色的地区标识相同的AP组和标记了default-location的AP。

【举例】

# 为AP组g1标记地区标识area1。

<Sysname> system-view

[Sysname] wlan ap-group g1

[Sysname-wlan-ap-group-g1] location area1

【相关命令】

·     wlan location

1.1.14  location (RRM holddown group view)

location命令用来标记RRM保持调整组的地区标识。

undo location命令用来恢复缺省情况。

【命令】

location location-name

undo location

【缺省情况】

RRM保持调整组标记默认地区标识。

【视图】

RRM保持调整组视图

【缺省用户角色】

network-admin

【参数】

location-name：无线服务地区标识，为1～31个字符的字符串，可以包含字母、数字、下划线、“[”、“]”、“/”及“-”，不区分大小写。

【使用指导】

为RRM保持调整组标记指定的地区标识后，该调整组将在逻辑上被划分到地区标识所标识的地域。

在Web页面上，系统将根据管理员的用户角色过滤RRM保持调整组。管理员只能查看并管理与用户角色的地区标识相同的RRM保持调整组和标记了默认地区标识的RRM保持调整组。

【举例】

# 指定RRM保持调整组1的地区标识为area1。

<Sysname> system-view

[Sysname] wlan rrm-calibration-group 1

[Sysname-wlan-rrm-calibration-group-1] location area1

【相关命令】

·     wlan location

1.1.15  location (wlan service-template view)

location命令用来标记无线服务模板的地区标识。

undo location命令用来恢复缺省情况。

【命令】

location location-name

undo location

【缺省情况】

无线服务模板被标记默认地区标识。

【视图】

无线服务模板视图

【缺省用户角色】

network-admin

【参数】

location-name：无线服务模板的地区标识，为1～31个字符的字符串，可以包含字母、数字、下划线、“[”、“]”、“/”及“-”，区分大小写。

【使用指导】

为无线服务模板标记指定地区标识后，该无线服务模板将在逻辑上被划分到地区标识所标识的地域。

在Web页面上，系统将根据管理员的用户角色过滤无线服务模板，管理员只能查看并管理与用户角色的地区标识相同的无线服务模板和标记了default-location的无线服务模板。

【举例】

# 指定无线服务service1地区标识为area1。

<Sysname> system-view

[Sysname] wlan service-template service1

[Sysname-wlan-st-service1] location area1

【相关命令】

·     wlan location

1.1.16  priority

priority命令用来配置Central AC上Local AC连接的优先级。

undo priority命令用来恢复缺省情况。

【命令】

priority priority

undo priority

【缺省情况】

Local AC连接的优先级为4。

【视图】

Local AC视图

【缺省用户角色】

network-admin

【参数】

priority：Local AC连接的优先级，取值范围为0～7。该数值越大，优先级越高。

【使用指导】

仅Central AC支持本功能。

建立CAPWAP隧道的过程中，Local AC会优先选择优先级高的Central AC建立隧道连接。

本命令配置的优先级，仅在Local AC建立CAPWAP隧道连接前生效。

【举例】

# 配置Local AC连接的优先级为7。

<Sysname> system-view

[Sysname] wlan local-ac name lac model WX5510E

[Sysname-wlan-local-ac-lac] priority 7

1.1.17  reset wlan local-ac

reset wlan local-ac命令用来重启Local AC。

【命令】

reset wlan local-ac { all | name ac-name }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

all：重启连接到当前Central AC的所有Local-AC。

name ac-name：重启指定名称的Local-AC。ac-name为Local AC的名称，为1～64个字符的字符串，可以包含字母、数字、下划线、“.”、“[”、“]”、“/”及“-”，区分大小写。

【使用指导】

仅AC角色为Central AC时支持此功能。

重启Local AC会导致在该Local AC上上线的AP掉线，如果存在其它可上线的Local AC，那么AP将会在其它Local AC上上线。

【举例】

# 重启local-ac1。

<Sysname> reset wlan local-ac name local-ac1

【相关命令】

·     wlan local-ac name

1.1.18  retransmit-count

retransmit-count命令用来配置Central AC发送给Local AC的请求报文重传次数。

undo retransmit-count命令用来恢复缺省情况。

【命令】

retransmit-count value

undo retransmit-count

【缺省情况】

请求报文重传次数为3次。

【视图】

Local AC视图

【缺省用户角色】

network-admin

【参数】

value：请求报文重传次数，取值范围为2～5。

【使用指导】

仅Central AC支持本功能。

为了使Central AC的请求报文尽可能的发送到Local AC，提高报文的可靠传输能力，Central AC会对请求报文进行重传，重传次数为配置的请求报文重传次数。

【举例】

# 配置Central AC发往Local AC的请求报文重传次数为4。

<Sysname> system-view

[Sysname] wlan local-ac name lac model WX3540H

[Sysname-wlan-local-ac-lac] retransmit-count 4

【相关命令】

·     retransmit-interval

1.1.19  retransmit-interval

retransmit-interval命令用来配置请求报文重传的时间间隔。

undo retransmit-interval命令用来恢复缺省情况。

【命令】

retransmit-interval interval

undo retransmit-interval

【缺省情况】

请求报文重传的时间间隔为5秒。

【视图】

Local AC视图

【缺省用户角色】

network-admin

【参数】

interval：指定请求报文重传的时间间隔，取值范围为3～8，单位为秒。

【使用指导】

仅Central AC支持本功能。

为了使Central AC的请求报文尽可能的发送到Local AC，提高报文的可靠传输能力，Central AC会对请求报文进行重传,重传时间间隔为配置的请求报文重传时间。

【举例】

# 配置Central AC发往Local AC的请求报文重传的时间间隔为6秒。

<Sysname> system-view

[Sysname] wlan local-ac name lac model WX3540H

[Sysname-wlan-local-ac-lac] retransmit-interval 6

【相关命令】

·     retransmit-count

1.1.20  roam central-ac-auth enable

roam central-ac-auth enable命令用来开启认证位置在Central AC上时的Local AC内或Local AC间的漫游功能。

undo roam central-ac-auth enable命令用来关闭认证位置在Central AC上时的Local AC内或Local AC间的漫游功能。

【命令】

roam central-ac-auth enable

undo roam central-ac-auth enable

【缺省情况】

认证位置在Central AC上时的Local AC内或Local AC间的漫游功能处于开启状态。

【视图】

无线服务模板视图

【缺省用户角色】

network-admin

【使用指导】

仅Central AC支持本功能。

当WLAN用户接入认证位置在Central AC上，客户端初始上线时，仅Central AC上会创建客户端漫游表项，客户端关联的Local AC上没有创建对应的漫游表项，因此无法实现客户端漫游。

开启本功能后，当客户端初始上线时，Central AC和客户端关联的Local AC上会同时创建客户端漫游表项，Local AC可以根据该漫游表项信息实现客户端Local AC内或者Local AC间漫游。

当客户端采用RSN+802.1X认证方式上线时，由于客户端信息（例如802.1X认证用户名、MAC地址等）保存在Central AC上，Local AC无法从Central AC获取客户端信息，所以开启本功能后无法支持快速漫游。

本命令只能在无线服务模板处于关闭状态时配置。

【举例】

# 开启认证位置在Central AC上时的Local AC内或Local AC间的漫游功能。

<Sysname> system-view

[Sysname] wlan service-template service1

[Sysname-wlan-st-service1] roam central-ac-auth enable

1.1.21  serial-id

serial-id命令用来在Central AC上配置Local AC的序列号。

undo serial-id命令用来恢复缺省情况。

【命令】

serial-id serial-id

undo serial-id

【缺省情况】

未配置Local AC的序列号。

【视图】

Local AC视图

【缺省用户角色】

network-admin

【参数】

serial-id：Local AC的序列号，即每个Local AC的唯一标识，为1～63个字符的字符串，不区分大小写。

【使用指导】

仅Central AC支持本功能。

如果Local AC已经与Central AC建立管理通道连接，在Central AC上改变或删除该Local AC的序列号，会导致与该Local AC之间的通道被拆除。Local AC需要重新发现Central AC并与Central AC建立通道。

【举例】

# 在Central AC上配置Local AC的序列号210235A1BSC123000050。

<Sysname> system-view

[Sysname] wlan local-ac name lac model WX3540H

[Sysname-local-ac-lac] serial-id 210235A1BSC123000050

【相关命令】

·     wlan local-ac

1.1.22  switch-back (Central AC)

switch-back enable命令用来开启自动回切功能。

switch-back disable命令用来关闭自动回切功能。

undo switch-back命令用来恢复缺省情况。

【命令】

switch-back { disable | enable }

undo switch-back

【缺省情况】

AP视图：继承AP组配置。

AP组视图：自动回切功能处于关闭状态。

【视图】

AP视图

AP组视图

【缺省用户角色】

network-admin

【使用指导】

仅Central AC支持本功能。

在分层组网中，当Local AC发生故障无法提供服务时，其上上线的AP将会自动上线到Central AC，并由Central AC继续提供服务。但是当Local AC故障恢复后，AP仍然在Central AC上，这样给Central AC带来了极大的负载问题，影响Central AC处理事务。如果手动将AP切换回Local AC上，处理工作庞大且容易影响现网环境的运行。

在Central AC上开启本功能后，在检测到Local AC故障恢复可以继续提供服务时，迁移至Central AC上的AP将会在短时间内自动回切到原来上线的Local AC，降低了Central AC的负载问题，并且不会对现网环境的运行造成影响。

【举例】

# 开启自动回切功能。（AP视图）

<Sysname> system-view

[Sysname] wlan ap ap1 model WA6320

[Sysname-wlan-ap-ap1] switch-back enable

# 开启自动回切功能。（AP组视图）

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-ap-group-10] switch-back enable

1.1.23  wlan local-ac

wlan local-ac命令用来在Common AC或Central AC上创建Local AC，并进入Local AC视图。如果指定的Local AC已经存在，则直接进入Local AC视图。

undo wlan local-ac命令用来删除指定的Local AC。

【命令】

wlan local-ac name local-ac-name [ model model-name ]

undo wlan local-ac name local-ac-name

【缺省情况】

不存在Local AC。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

name local-ac-name：Local AC的名称，为1～64个字符的字符串，区分大小写。

model model-name：Local AC的型号。在创建Local AC时，该参数必须配置。

【使用指导】

仅当AC角色为Common或者Central时支持本功能。

对于仅支持做Local AC的Commen角色AC不支持本功能。

当AC角色为Common时，执行本命令会创建Local AC，并将当前AC角色切换为Central角色；当AC角色为Central时，执行本命令仅用于创建或进入Local AC。

执行undo wlan local-ac命令时，会将Central AC上指定的Local AC删除并断开管理通道；当Central AC上的所有Local AC都被删除后，设备角色会切换为Common。

Central AC上需要开启二次发现AC功能，才能将当前负载最轻的Local AC的IP地址下发给AP。有关二次发现AC功能的详细介绍请参见“AP管理配置指导”中的“AP管理”。

【举例】

# 创建名称为lac的Local AC，并进入Local AC视图。

<Sysname> system-view

[Sysname] wlan local-ac name lac model WX3540H

[Sysname-wlan-local-ac-lac]

【相关命令】

·     control-address enable

·     serial-id

1.1.24  wlan location

wlan location命令用来创建地区标识。

undo wlan location命令用来删除指定的地区标识。

【命令】

wlan location location-name

undo wlan location location-name

【缺省情况】

系统只存在默认地区标识。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

location-name：地区标识名称，为1～31个字符的字符串，可以包含字母、数字、下划线、“[”、“]”、“/”及“-”，不区分大小写。

【使用指导】

设备上存在一个名称为default-location的默认地区标识，标记该标识的AP组/无线服务模板可被所有管理员管理。管理员新建的所有AP组/无线服务模板都会标记默认地区标识，且该标识不能被删除。

设备上最多可以创建512个地区标识。

【举例】

# 创建地区标识area1。

<Sysname> system-view

[Sysname] wlan location area1

1.1.25  wlan tunnel-preempt

wlan tunnel-preempt enable命令用来开启CAPWAP主隧道抢占功能。

wlan tunnel-preempt disable命令用来关闭CAPWAP主隧道抢占功能。

undo wlan tunnel-preempt命令用来恢复缺省情况。

【命令】

wlan tunnel-preempt { disable | enable }

undo wlan tunnel-preempt

【缺省情况】

CAPWAP主隧道抢占功能处于关闭状态。

【视图】

Local AC视图

【缺省用户角色】

network-admin

【使用指导】

仅Central AC支持本功能。

缺省情况下，在双链路备份组网环境中，当Local AC连接的主Central AC故障时，备份Central AC才会将CAPWAP备份隧道转换为主隧道。当备份Central AC开启了CAPWAP主隧道抢占功能后，如果备份Central AC配置的Local AC连接Central AC的优先级高于主Central AC上配置的优先级，则备份Central AC将CAPWAP备份隧道切换为主隧道。

【举例】

# 开启CAPWAP主隧道抢占功能。

<Sysname> system-view

[Sysname] wlan local-ac name bac

[Sysname-wlan-local-ac-bac] wlan tunnel-preempt enable