选择区域语言: EN CN HK

02-WLAN命令

21-无线探针命令

本章节下载  (166.03 KB)

docurl=/cn/Service/Document_Software/Document_Center/Wlan/WiNet_WX/WX2500H-WiNet/Command/Command_Manual/H3C_WiNet_CR(R5223)-5W100/02/201807/1094298_30005_0.htm

21-无线探针命令


1 无线探针

1.1  无线探针配置命令

1.1.1  client-proximity-sensor

client-proximity-sensor enable命令用来开启探针功能。

client-proximity-sensor disable命令用来关闭探针功能。

undo client-proximity-sensor命令用来恢复缺省情况。

【命令】

client-proximity-sensor { disable | enable }

undo client-proximity-sensor

【缺省情况】

Radio视图下,继承AP组配置。

AP组Radio视图下,探针功能处于关闭状态。

【视图】

Radio视图

AP组Radio视图

【缺省用户角色】

network-admin

【举例】

# 开启探针功能。(Radio视图)

<Sysname> system-view

[Sysname] wlan ap ap1 model WA5320E-WiNet

[Sysname-wlan-ap-ap1] radio 1

[Sysname-wlan-ap-ap1-radio-1] client-proximity-sensor enable

# 开启探针功能。(AP组Radio视图)

<Sysname> system-view

[Sysname] wlan ap-group aaa

[Sysname-wlan-ap-group-aaa] ap-model WA5320E-WiNet

[Sysname -wlan-ap-group-aaa-ap-model-WA5320E-WiNet] radio 1

[Sysname -wlan-ap-group-aaa-ap-model-WA5320E-WiNet-radio-1] client-proximity-sensor enable

1.1.2  client-proximity-sensor ap-timer

client-proximity-sensor ap-timer命令用来配置AP表项的时间参数。

undo client-proximity-sensor ap-timer命令用来恢复缺省情况。

【命令】

client-proximity-sensor ap-timer inactive inactive-value aging aging-value

undo client-proximity-sensor ap-timer

【缺省情况】

AP表项的非活跃时间为300秒,老化时间为600秒。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

inactive inactive-value:AP表项的非活跃时间,取值范围为60~1200,单位为秒。

aging aging-value:AP表项的老化时间,取值范围为120~86400,单位为秒。

【举例】

# 配置AP表项的时间参数,非活跃时间为120秒,老化时间为360秒。

<Sysname> system-view

[Sysname] client-proximity-sensor ap-timer inactive 120 aging 360

1.1.3  client-proximity-sensor ap-udp-server

client-proximity-sensor ap-udp-server命令用来配置探针AP上报无线设备信息的UDP服务器。

undo client-proximity-sensor udp-server命令用来恢复缺省情况。

【命令】

client-proximity-sensor ap-udp-server ip-address port port-number [ interval interval | preshared-key [ cipher | simple ] key-string ] *

undo client-proximity-sensor ap-udp-server

【缺省情况】

未配置探针AP上报无线设备信息的UDP服务器。

【视图】

AP视图

【缺省用户角色】

network-admin

【参数】

ip-address:指定上报无线设备信息的UDP服务器的IPv4地址。

port port-number:指定UDP服务器的端口号,取值范围为1~65534。

interval interval:指定上报无线设备信息到UDP服务器的周期,取值范围为1~600,单位为秒,缺省值为30。

preshared-key:指定预共享密钥。

cipher:表示以密文方式设置共享密钥。

simple:表示以明文方式设置共享密钥。

key-string:设置的明文密钥或密文密钥,区分大小写。明文密钥字符串为8~63个字符的字符串,密文密钥为41~117个字符的字符串。

【举例】

# 配置探针AP上报无线设备信息的UDP服务器,IP地址为10.152.3.209,UDP服务器的端口号为443。

<Sysname> system-view

[Sysname] wlan ap ap1 model WA5320E-WiNet

[Sysname-ap-ap1] client-proximity-sensor ap-udp-server 10.152.3.209 port 443

1.1.4  client-proximity-sensor client-timer

client-proximity-sensor client-timer命令用来配置客户端表项的时间参数。

undo client-proximity-sensor client-timer命令用来恢复缺省情况。

【命令】

client-proximity-sensor client-timer inactive inactive-value aging aging-value

undo client-proximity-sensor client-timer

【缺省情况】

客户端表项的非活跃时间为300秒,老化时间为600秒。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

inactive inactive-value:客户端表项的非活跃时间,取值范围为60~1200,单位为秒。

aging aging-value:客户端表项的老化时间,取值范围为120~86400,单位为秒。

【举例】

# 配置客户端表项的时间参数,非活跃时间为120秒,老化时间为360秒。

<Sysname> system-view

[Sysname] client-proximity-sensor client-timer inactive 120 aging 360

1.1.5  client-proximity-sensor coordinates

client-proximity-sensor coordinates命令用来配置探针AP的经纬度。

undo client-proximity-sensor coordinates命令用来删除探针AP的经纬度。

【命令】

client-proximity-sensor coordinates longitude longitude-value latitude latitude-value

undo client-proximity-sensor coordinates

【缺省情况】

未配置探针AP的经纬度。

【视图】

AP视图

【缺省用户角色】

network-admin

【参数】

longitude longitude-value:配置探针AP坐标的经度,格式为XXX-XX-XX.X,XXX的取值范围为0~180,XX的取值范围为0~60,.X的取值为e或者w,不区分大小写。

latitude latitude-value:配置探针AP坐标的纬度,格式为XXX-XX-XX.X,XXX的取值范围为0~90,XX的取值范围为0~60,.X的取值为s或者n,不区分大小写。

【使用指导】

用户可以根据探针AP的安装位置,手动配置探针AP的经纬度,探针AP会将收集到的无线设备信息与经纬度信息一同上传至指定的服务器。

【举例】

# 配置探针AP的坐标为东经123°40’40’’,北纬80°30‘30’’。

<Sysname> system-view

[Sysname] wlan ap ap1 model WA5320E-WiNet

[Sysname-ap-ap1] client-proximity-sensor coordinates longitude 123-40-40.e latitude 80-30-30.n

1.1.6  client-proximity-sensor filter-list

client-proximity-sensor filter-list命令用来配置上报服务器的MAC地址过滤列表。

undo client-proximity-sensor filter-list命令用来删除上报服务器的MAC地址过滤列表。

【命令】

client-proximity-sensor filter-list list

undo client-proximity-sensor filter-list { list | all }

【缺省情况】

未配置上报服务器的MAC地址过滤列表。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

list:上报服务器的MAC地址过滤列表,格式为H-H-H。可以指定MAC地址加入过滤列表,也可以根据MAC地址的特征进行过滤,比如过滤首个字节的3个比特为1的MAC地址,就配置过滤MAC地址为0400-0000-0000。

all:所有MAC地址过滤列表。

【举例】

# 配置上报服务器的MAC地址过滤列表,过滤首字节的第3比特为1的MAC地址。

<Sysname> system-view

[Sysname] client-proximity-sensor filter-list 0400-0000-0000

1.1.7  client-proximity-sensor random-mac-report enable

client-proximity-sensor random-mac-report enable 命令用来开启上报苹果终端随机伪MAC地址功能。

undo client-proximity-sensor random-mac-report enable命令用来关闭上报苹果终端随机伪MAC地址功能。

【命令】

client-proximity-sensor random-mac-report enable

undo client-proximity-sensor random-mac-report enable

【缺省情况】

上报苹果终端随机伪MAC地址功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

苹果终端的随机MAC地址特征为首字节的第2比特为1。当苹果终端作为无线客户端时,会使用随机MAC地址发送无线探测请求帧,从而造成探针AP检测到实际上并不存在的设备。关闭该功能后,苹果终端的随机MAC地址不会被上报到服务器。

【举例】

# 开启上报苹果终端随机伪MAC地址功能。

<Sysname> system-view

[Sysname] client-proximity-sensor random-mac-report enable

1.1.8  client-proximity-sensor report-ac enable

client-proximity-sensor report-ac enable命令用来开启探针AP将无线设备表项上报AC功能。

undo client-proximity-sensor report-ac enable命令用来关闭探针AP将无线设备表项上报AC功能。

【命令】

client-proximity-sensor report-ac enable

undo client-proximity-sensor report-ac enable

【缺省情况】

探针AP将无线设备表项上报AC功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【举例】

# 配置探针AP将无线设备表项上报AC。

<Sysname> system-view

[Sysname] client-proximity-sensor report-ac enable

1.1.9  client-proximity-sensor report-ac-interval

client-proximity-sensor report-ac-interval命令用来配置探针AP将无线设备表项上报AC的周期。

undo client-proximity-sensor report-ac interval命令用来恢复缺省情况。

【命令】

client-proximity-sensor report-ac interval interval

undo client-proximity-sensor report-ac interval

【缺省情况】

探针AP将无线设备表项上报AC的周期为3000毫秒。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interval:上报时间间隔,取值范围为100~60000, 单位为毫秒。

【举例】

# 配置探针AP将无线设备表项上报AC的周期为2000毫秒。

<Sysname> system-view

[Sysname] client-proximity-sensor report-ac interval 2000

1.1.10  client-proximity-sensor report-ap enable

client-proximity-sensor report-ap enable命令用来开启AP设备信息上报UDP服务器功能。

undo client-proximity-sensor report-ap enable 命令用来关闭AP设备信息上报UDP服务器功能。

【命令】

client-proximity-sensor report-ap enable

undo client-proximity-sensor report-ap enable

【缺省情况】

AP设备信息上报UDP服务器功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【举例】

# 开启AP设备信息上报UDP服务器功能。

<Sysname> system-view

[Sysname] client-proximity-sensor report-ap enable

1.1.11  client-proximity-sensor rssi-change-threshold

client-proximity-sensor rssi-change-threshold命令用来配置探针AP上报AC的设备信号强度变化阈值。

undo client-proximity-sensor rssi-change-threshold命令用来恢复缺省情况。

【命令】

client-proximity-sensor rssi-change-threshold threshold-value

undo client-proximity-sensor rssi-change-threshold

【缺省情况】

探针AP上报AC的设备信号强度变化阈值为100。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

threshold-value:探针AP上报AC的设备信号强度变化阈值,取值范围为1~100。

【参数】

当同一设备再次被探针AP检测到后,信号强度的变化小于阈值则不上报AC。

【举例】

# 配置设备上报AC的信号强度变化阈值为50。

<Sysname> system-view

[Sysname] client-proximity-sensor rssi-threshold 50

1.1.12  client-proximity-sensor rssi-threshold

client-proximity-sensor rssi-threshold命令用来配置探针AP根据信号强度对无线设备进行检测。

undo client-proximity-sensor rssi-threshold命令用来恢复缺省情况。

【命令】

client-proximity-sensor rssi-threshold { ap ap-rssi-value | client client-rssi-value }

undo client-proximity-sensor rssi-threshold { ap | client }

【缺省情况】

未配置探针AP根据信号强度对无线设备进行检测。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

ap ap-rssi-value:探针AP检测AP设备信号强度阈值,取值范围为1~100。

client client-rssi-value:探针AP检测客户端信号强度阈值,取值范围为1~100。

【使用指导】

缺省情况下,探针AP会检测任意信号强度的无线设备,配置该功能后,探针AP仅检测信号强度大于或等于阈值的无线设备。

【举例】

# 配置探针AP检测信号强度大于30的AP设备。

<Sysname> system-view

[Sysname] client-proximity-sensor rssi-threshold ap 30

1.1.13  client-proximity-sensor rt-report enable

client-proximity-sensor rt-report enable命令用来开启快速上报UDP服务器功能。

undo client-proximity-sensor rt-report enable命令用来关闭快速上报UDP服务器功能。

【命令】

client-proximity-sensor rt-report enable

undo client-proximity-sensor rt-report enable

【缺省情况】

快速上报UDP服务器功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

缺省情况下,探针AP和AC会在指定的上报周期上报UDP服务器,开启该功能后,探针AP和AC在获取到无线设备信息后会立即进行上报。

【举例】

# 开启快速上报UDP服务器功能。

<Sysname> system-view

[Sysname] client-proximity-sensor rt-report enable

1.1.14  client-proximity-sensor server

client-proximity-sensor server命令用来配置上报无线设备信息的HTTPS服务器。

undo client-proximity-sensor server命令用来恢复缺省情况。

【命令】

client-proximity-sensor server string [ window-time window-time-value | partner partner-value ] *

undo client-proximity-sensor server

【缺省情况】

未配置上报无线设备信息的HTTPS服务器。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

string:指定上报无线设备信息的HTTPS服务器地址,为8~127个字符的字符串,区分大小写。必须以“https://”作为前缀。

window-time window-time-value:统计周期,取值范围为10~60,单位为秒。在配置了HTTPS服务器地址后,缺省统计周期为30秒。

partner partner-value:上传给服务器的报文中partner flag字段的取值,在配置了HTTPS服务器地址后,缺省值为11。

【举例】

# 配置上报无线设备信息的HTTPS服务器地址为https://10.152.3.209:443/xxx/yy。

[Sysname] client-proximity-sensor server https://10.152.3.209:443/xxx/yy

1.1.15  client-proximity-sensor udp-server

client-proximity-sensor udp-server命令用来配置上报无线设备信息的UDP服务器。

undo client-proximity-sensor udp-server命令用来恢复缺省情况。

【命令】

client-proximity-sensor udp-server ip-address port port-number [ interval interval | preshared-key [ cipher | simple ] key-string ] *

undo client-proximity-sensor udp-server

【缺省情况】

未配置上报无线设备信息的UDP服务器。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

ip-address:指定上报无线设备信息的UDP服务器的IPv4地址。

port port-number:指定UDP服务器的端口号,取值范围为1~65534。

interval interval:指定上报无线设备信息到UDP服务器的周期,取值范围为1~600,单位为秒,缺省值为30。

preshared-key:指定预共享密钥。

cipher:表示以密文方式设置共享密钥。

simple:表示以明文方式设置共享密钥。

key-string:设置的明文密钥或密文密钥,区分大小写。明文密钥字符串为8~63个字符的字符串,密文密钥为41~117个字符的字符串。

【举例】

# 配置上报无线设备信息的UDP服务器,IP地址为10.152.3.209,UDP服务器的端口号为443。

<Sysname> system-view

[Sysname] client-proximity-sensor udp-server 10.152.3.209 port 443

1.1.16  display client-proximity-sensor device

display client-proximity-sensor device命令用来显示探针AP检测到的无线设备信息。

【命令】

display client-proximity-sensor device [ ap | client | mac-address mac-address ] [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

ap:显示探针AP检测到的AP设备。

client:显示探针AP检测到的客户端设备。

mac-address mac-address:显示指定MAC地址的无线设备,格式为H-H-H。

verbose:显示详细信息,若不指定该参数,则显示探针AP检测到的所有无线设备的简要信息。

【举例】

# 显示探针AP检测到的所有无线设备的信息。

<Sysname> display client-proximity-sensor device

Total 3 detected devices

 

MAC address    Type      Duration    Sensors Channel Status

0AFB-423B-893C AP        00h 10m 46s 1       11      Active

0AFB-423B-893D AP        00h 10m 46s 1       6       Active

0AFB-423B-893E AP        00h 10m 46s 1       1       Active

表1-1 display client-proximity-sensor device命令显示信息描述表

字段

描述

MAC address

检测到的无线设备的MAC地址

Type

无线设备的类型:

·     AP:AP设备

·     Client:无线客户端

Duration

无线设备当前状态的持续时间

Sensors

检测到该无线设备的Sensor的数量

Channel

最后一次检测到该无线设备的信道

Status

无线设备的工作状态:

·     Active:无线设备处于活跃状态

·     Inactive:无线设备处于非活跃状态

 

# 显示探针AP检测到的所有无线设备的详细信息。

<Sysname> display client-proximity-sensor device verbose

Total 2 detected devices

 

 AP: 0AFB-423B-893C

   Status: Active

   Status duration: 00h 27m 57s

   Vendor: Not found

   SSID: service

   Radio type: 802.11ac

   Security: None

   Encryption method: None

   Authentication method: None

   Broadcast SSID: Yes

   QoS supported: No

   Beacon interval: 100 TU

   Up duration: 00h 27m 57s

Channel bandwidth supported: 20/40/80MHz

   Total number of reported APs: 1

     AP 1:

       AP ID: 3

       AP name: 1

       Radio ID: 1

       RSSI: 15

       Channel: 419

       First reported time: 2016-04-03/09:05:51

       Last reported time: 2016-04-03/09:05:51

   Total number of associated clients: 1

     01: 80EA-9656-AAAB

Client: 80EA-9656-AAAB

  Last detected associated AP: 0AFB-423B-893C

  Last associated AP (not detected): None

  Status: Active

  Status duration: 00h 00m 02s

  Vendor: Not found

  Radio type: 802.11a

  Total number of reported APs: 1

     AP 1:

       AP ID: 2

       AP name: 1

       Radio ID: 1

       RSSI: 50

       Channel: 116

       First reported time: 2016-04-03/14:52:56

       Last reported time: 2016-04-03/14:52:56

       Reported associated AP: 0AFB-423B-893C

表1-2 display client-proximity-sensor device verbose命令显示信息描述表

字段

描述

Total number detected devices

检测到无线设备的总数

AP

检测到AP的MAC地址

Client

检测到Client的MAC地址

Last detected associated AP

客户端最近一次上报关联AP的MAC地址,此MAC地址为实际检测到的AP的BSSID

Last associated AP (not detected)

客户端最近一次通信AP的MAC地址,此MAC地址为客户端和关联AP进行数据通信时报文里携带的MAC地址,且关联AP未检测到。

Status

AP或客户端表项的状态:

·     Active:AP或客户端表项处于活跃状态

·     Inactive:AP或客户端表项处于非活跃状态

Status duration

无线设备当前状态的持续时间

Vendor

无线设备厂商信息。如果该无线设备的OUI能够匹配import oui命令导入配置文件中的OUI,则显示设备厂商,没有配置或者没有匹配到显示为Not found

SSID

AP提供的SSID

Radio Type

无线设备使用的射频模式

Security

无线服务使用的安全模式:

·     WEP:WEP模式

·     WPA:WPA模式

·     WPA2:WPA2模式

·     None:明文方式

Encryption method

无线数据的加密方式:

·     TKIP:使用TKIP加密套件

·     CCMP:使用AES-CCMP加密套件

·     WEP:使用WEP加密套件

·     None:明文方式,不加密

Authentication method

AP提供的接入无线网络的认证方式:

·     PSK:使用PSK认证方式

·     802.1X:使用802.1X认证方式

·     Others:使用除PSK和802.1X之外的认证方式

·     None:不认证

Broadcast SSID

AP是否是广播SSID,如果AP不广播SSID,则SSID字段取值为空

QoS supported

是否支持QoS

Beacon interval

信标间隔,单位为TU,1TU等于1024微秒

Up duration

AP设备从启动到当前的持续时间

Channel bandwidth supported

AP支持的信道带宽:

·     20/40MHZ:AP支持20MHz和40MHz的信道带宽

·     20MHZ:AP支持20MHz的信道带宽

Total number of reported APs

上报该无线客户端的AP总数

AP n

发现该设备的Sensor,n为系统自动的编号

AP ID

Sensor的ID,即Sensor的AP ID

AP name

检测到该无线设备的Sensor的名字

Radio ID

发现该设备的Sensor上的Radio ID

RSSI

Sensor的信号强度

Channel

该Sensor最近一次探测到该AP或无线客户端设备的信道

First reported time

该Sensor第一次检测到该AP或无线客户端的时间

Last reported time

该Sensor最近一次检测到该AP或无线客户端的时间

Total number of associated clients

关联该设备的无线客户端的数量

n:H-H-H

AP上关联的无线客户端的MAC地址,n为系统自动的编号

Reported associated AP

该Sensor上报关联AP的MAC地址

 

1.1.17  display client-proximity-sensor sensor

display client-proximity-sensor sensor命令用来显示所有探针AP的信息。

【命令】

display client-proximity-sensor sensor

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示所有探针AP的信息。

<Sysname> display client-proximity-sensor sensor

Total number of sensors: 1

Sensor ID    Sensor name                Radio ID

3            ap1                        1        

表1-3 display client-proximity-sensor sensor命令显示信息描述表

字段

描述

Total number of sensors

探针AP的总数

Sensor ID

探针AP的ID

Sensor name

探针AP的设备名称

Radio ID

开启探针功能的射频

 

1.1.18  display client-proximity-sensor statistics receive

display client-proximity-sensor statistics receive命令用来显示探针AP上报的检测统计信息。

【命令】

display client-proximity-sensor statistics receive

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示探针AP上报的检测统计信息。

<Sysname> display client-proximity-sensor statistics receive

Information from sensor 1

 Statistics information for received messages:

   Detected AP updated messages: 7

   Detected client updated messages: 5

   Detected AP deleted messages: 3

   Detected client deleted messages: 0

   Detected all device deleted messages: 0

Information from sensor 2

 Statistics information for received messages:

   Detected AP updated messages: 6

   Detected client updated messages: 5

   Detected AP deleted messages: 3

   Detected client deleted messages: 2

   Detected all device deleted messages: 0

表1-4 display client-proximity-sensor statistics receive命令显示信息描述表

字段

描述

Information from sensor n

Sensor n发送的消息,n表示Sensor ID

Statistics information for received messages

检测信息的统计信息

Detected AP updated messages

AC收到AP设备更新事件的计数

Detected client updated messages

AC收到客户端更新事件的计数

Detected AP deleted messages

AC收到AP设备删除事件的计数

Detected client deleted messages

AC收到客户端删除事件的计数

Detected all device deleted messages

AC收到所有设备删除事件的计数

 

【相关命令】

·     reset client-proximity-sensor statistics

1.1.19  reset client-proximity-sensor device

reset client-proximity-sensor device命令用来清除无线设备表项。

【命令】

reset client-proximity-sensor device { ap | client | mac-address mac-address | all }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

ap:清除所有检测到的AP信息。

client:清除所有检测到的客户端信息。

mac-address mac-address:清除指定MAC地址的信息,格式为H-H-H。

all:清除所有检测到的设备信息。

【举例】

# 清除所有检测到的客户端信息。

<Sysname> reset client-proximity-sensor device client

# 清除指定MAC地址的设备信息。

<Sysname> reset client-proximity-sensor device mac-address 0023-1212-2323

【相关命令】

·     display client-proximity-sensor entry

1.1.20  reset client-proximity-sensor statistics

reset client-proximity-sensor statistics命令用来清除所有探针AP上报的信息。

【命令】

reset client-proximity-sensor statistics

【视图】

用户视图

【缺省用户角色】

network-admin

【举例】

# 清除所有探针AP上报的信息。

<Sysname> reset client-proximity-sensor statistics

【相关命令】

·     display client-proximity-sensor statistics receive

不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!