10-WLAN Advanced Features Command Reference

HomeSupportResource CenterH3C Access Points Cloud Mode Command References(E2442 R2442)-6W10010-WLAN Advanced Features Command Reference
02-WLAN probe commands
Title Size Download
02-WLAN probe commands 109.52 KB

WLAN probe commands

client-proximity-sensor

Use client-proximity-sensor enable to enable WLAN probe.

Use undo client-proximity-sensor to restore the default.

Syntax

client-proximity-sensor enable

undo client-proximity-sensor

Default

WLAN probe is disabled.

Views

Radio interface view

Predefined user roles

network-admin

Examples

# Enable WLAN probe.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/1

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

client-proximity-sensor ap-timer

Use client-proximity-sensor ap-timer to set the AP entry timers.

Use undo client-proximity-sensor ap-timer to restore the default.

Syntax

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

undo client-proximity-sensor ap-timer

Default

The inactivity timer and aging timer for AP entries are 300 seconds and 600 seconds, respectively.

Views

System view

Predefined user roles

network-admin

Parameters

inactive inactive-value: Specifies the inactivity timer for AP entries, in the range of 60 to 1200 seconds.

aging aging-value: Specifies the aging timer for AP entries, in the range of 120 to 86400 seconds.

Usage guidelines

The aging time must be at least twice the inactive time. As a best practice, use the default inactive time and aging time.

Errors might exist in the time changes of AP entries, and the error value depends on the interval at which sensors report information about detected devices.

Examples

# Set the inactivity timer and aging timer for AP entries to 120 seconds and 360 seconds, respectively.

<Sysname> system-view

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

Related commands

client-proximity-sensor report-ac-interval

client-proximity-sensor audit-mac-address

Use client-proximity-sensor audit-mac-address to configure a sensor to report the MAC address of the auditing device.

Use undo client-proximity-sensor audit-mac-address to restore the default.

Syntax

client-proximity-sensor audit-mac-address mac-address

undo client-proximity-sensor audit-mac-address

Default

A sensor does not report the MAC address of the auditing device to a server.

Views

AP view

Predefined user roles

network-admin

Parameters

mac-address: Specifies an auditing device by its MAC address in H-H-H format.

Usage guidelines

After you specify an auditing device for a sensor, the sensor will report the collected wireless device information and the MAC address of the auditing device to a server.

If a server requires the MAC addresses of auditing devices, you must specify an auditing device for each sensor. Then, the server can distinguish the received wireless device information by auditing device.

Examples

# Configure AP ap1 to report MAC address 001b-2233-5d2b of the auditing device to a server.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA6320

[Sysname-wlan-ap-ap1] client-proximity-sensor audit-mac-address 001b-2233-5d2b

client-proximity-sensor client-timer

Use client-proximity-sensor client-timer to set the client entry timers.

Use undo client-proximity-sensor client-timer to restore the default.

Syntax

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

undo client-proximity-sensor client-timer

Default

The inactivity timer and aging timer for client entries are 300 seconds and 600 seconds, respectively.

Views

System view

Predefined user roles

network-admin

Parameters

inactive inactive-value: Specifies the inactivity timer for client entries, in the range of 60 to 1200 seconds.

aging aging-value: Specifies the aging timer for client entries, in the range of 120 to 86400 seconds.

Usage guidelines

The aging time must be at least twice the inactive time. As a best practice, use the default inactive time and aging time.

Errors might exist in the time changes of client entries, and the error value depends on the interval at which sensors report information about detected devices.

Examples

# Set the inactivity timer and aging timer for client entries to 120 seconds and 360 seconds, respectively.

<Sysname> system-view

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

Related commands

client-proximity-sensor report-ac-interval

client-proximity-sensor filter-list

Use client-proximity-sensor filter-list to configure the MAC address filtering list. The AC does not report information about devices with MAC addresses in the list.

Use undo client-proximity-sensor filter-list to remove the configuration.

Syntax

client-proximity-sensor filter-list list

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

Default

No MAC address filtering list is configured.

Views

System view

Predefined user roles

network-admin

Parameters

list: Specifies a MAC address or a class of MAC addresses in H-H-H format. For example, if you specify 0400-0000-0000, you specify MAC addresses whose third bit in the first byte is 1.

all: Specifies all MAC addresses.

Examples

# Add MAC addresses whose third bit in the first byte is 1 to the MAC address filtering list.

<Sysname> system-view

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

client-proximity-sensor random-mac-report enable

Use client-proximity-sensor random-mac-report enable to enable reporting of information about Apple terminals that use a random MAC address.

Use undo client-proximity-sensor random-mac-report enable to disable reporting of information about Apple terminals that use a random MAC address

Syntax

client-proximity-sensor random-mac-report enable

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

Default

Information about Apple terminals that use a random MAC address is not reported.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Apple terminals send probe requests by using a random MAC address whose second bit in the first byte is 1 and cause sensors to detect non-existent wireless devices. Enable or disable this command as appropriate.

Examples

# Enable reporting of information about Apple terminals that use a random MAC address.

<Sysname> system-view

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

client-proximity-sensor report-ap enable

Use client-proximity-sensor report-ap enable to enable reporting of AP information to the UDP server.

Use undo client-proximity-sensor report-ap enable to disable reporting of AP information to the UDP server.

Syntax

client-proximity-sensor report-ap enable

undo client-proximity-sensor report-ap enable

Default

AP information is not reported to the UDP server.

Views

System view

Predefined user roles

network-admin

Examples

# Enable reporting of AP information to the UDP server.

<Sysname> system-view

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

client-proximity-sensor report-oasis cache

Use client-proximity-sensor report-oasis cache enable to enable the device to cache client information upon disconnection from the cloud server.

Use undo client-proximity-sensor report-oasis cache enable to disable the device from caching client information upon disconnection from the cloud server.

Syntax

client-proximity-sensor report-oasis cache enable

undo client-proximity-sensor report-oasis cache enable

Default

The device does not cache client information upon disconnection from the cloud server.

Views

System view

Predefined user roles

network-admin

Usage guidelines

After you configure this command, the device caches client information received from sensors when the connection between the device and the cloud server goes down. After the device reconnects to the cloud server, the device sends the cached information to the cloud server.

Examples

# Enable the device to cache client information upon disconnection from the cloud server.

<Sysname> system-view

[Sysname] client-proximity-sensor report-oasis cache enable

client-proximity-sensor report-oasis client

Use client-proximity-sensor report-oasis client to set the report interval and the number of client entries that the AC sends to the cloud server in each report.

Use undo client-proximity-sensor report-oasis to restore the default.

Syntax

client-proximity-sensor report-oasis client interval interval number number

undo client-proximity-sensor report-oasis client

Default

The AC reports 10 client entries to the cloud server every 1000 milliseconds.

Views

System view

Predefined user roles

network-admin

Parameters

interval interval: Specifies the interval at which the AC reports client information to the cloud server, in the range of 100 to 60000 milliseconds.

number number: Specifies the number of client entries that the AC sends to the cloud server in each report, in the range of 1 to 100.

Examples

# Configure the AC to report 50 client entries to the cloud server every 500 milliseconds.

<Sysname> system-view

[Sysname] client-proximity-sensor report-oasis client interval 500 number 50

client-proximity-sensor report-oasis disable

Use client-proximity-sensor report-oasis disable to disable the AC from reporting wireless device information to the cloud server.

Use undo client-proximity-sensor report-oasis disable to restore the default.

Syntax

client-proximity-sensor report-oasis disable

undo client-proximity-sensor report-oasis disable

Default

The AC reports wireless device information to the cloud server.

Views

System view

Predefined user roles

network-admin

Examples

# Disable the AC from reporting wireless device information to the cloud server.

<Sysname> system-view

[Sysname] client-proximity-sensor report-oasis disable

client-proximity-sensor report-oasis rssi-change-threshold

Use client-proximity-sensor report-oasis rssi-change-threshold to set the RSSI difference threshold for reporting client information to the cloud server.

Use undo client-proximity-sensor report-oasis rssi-change-threshold to restore the default.

Syntax

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

undo client-proximity-sensor report-oasis rssi-change-threshold

Default

The RSSI difference threshold is 50.

Views

System view

Predefined user roles

network-admin

Parameters

rssi-change-threshold threshold-value: Specifies the RSSI difference threshold for reporting client information to the cloud server, in the range of 1 to 100.

Usage guidelines

The AC does not report the client information received from a sensor to the cloud server when the following conditions are met:

·     The client has already been detected before.

·     The RSSI difference of the client between the most recent two reports does not reach the specified threshold.

Examples

# Set the RSSI difference threshold to 50 for reporting client information to the cloud server.

<Sysname> system-view

[Sysname] client-proximity-sensor report-oasis rssi-change-threshold 50

client-proximity-sensor rssi-change-threshold

Use client-proximity-sensor rssi-change-threshold to set the RSSI difference threshold for wireless device detection.

Use undo client-proximity-sensor rssi-change-threshold to restore the default.

Syntax

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

undo client-proximity-sensor rssi-change-threshold

Default

The RSSI difference threshold for wireless device detection is 50.

Views

System view

Predefined user roles

network-admin

Parameters

threshold-value: Specifies the RSSI difference threshold for wireless device detection, in the range of 1 to 100.

Usage guidelines

A sensor does not update the information about a wireless device when the following conditions are met:

·     The wireless device has been detected before.

·     The RSSI difference of the wireless device between the most recent two detections does not reach the specified threshold.

Examples

# Set the RSSI difference threshold for wireless device detection to 50.

<Sysname> system-view

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

client-proximity-sensor rssi-threshold

Use client-proximity-sensor rssi-threshold to set the RSSI threshold for clients or APs.

Use undo client-proximity-sensor rssi-threshold to restore the default.

Syntax

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

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

Default

The RSSI thresholds for clients and APs are not set.

Views

System view

Predefined user roles

network-admin

Parameters

ap ap-rssi-value: Specifies the RSSI threshold for APs, in the range of 1 to 100.

client client-rssi-value: Specifies the RSSI threshold for clients, in the range of 1 to 100.

Usage guidelines

Sensors do not ignore any wireless devices by default. After you configure this command, sensors will ignore wireless devices with an RSSI lower than the specified RSSI threshold.

Examples

# Configure sensors to ignore APs with an RSSI lower than 30.

<Sysname> system-view

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

client-proximity-sensor rt-report enable

Use client-proximity-sensor rt-report enable to enable real-time reporting of wireless device information to the UDP server.

Use undo client-proximity-sensor rt-report enable to disable real-time reporting of wireless device information to the UDP server.

Syntax

client-proximity-sensor rt-report enable

undo client-proximity-sensor rt-report enable

Default

Information about wireless devices is reported to the UDP server at the specified interval.

Views

System view

Predefined user roles

network-admin

Examples

# Enable real-time reporting of wireless device information to the UDP server.

<Sysname> system-view

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

client-proximity-sensor server

Use client-proximity-sensor server to specify an HTTPS server to receive wireless device information.

Use undo client-proximity-sensor server to restore the default.

Syntax

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

undo client-proximity-sensor server

Default

No HTTPS server is specified.

Views

System view

Predefined user roles

network-admin

Parameters

string: Specifies an HTTPS server by its address, a case-sensitive string of 8 to 127 characters. The address must start with https://.

window-time window-time-value: Specifies the window time in the range of 10 to 60 seconds. The default window time is 30 seconds.

partner partner-value: Specifies the partner flag value. The default partner flag value is 11.

Examples

# Specify the HTTPS server with address https://10.152.3.209/xxx/yy to receive wireless device information.

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

client-proximity-sensor udp-server

Use client-proximity-sensor udp-server to specify a UDP server to receive wireless device information.

Use undo client-proximity-sensor udp-server to restore the default.

Syntax

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

undo client-proximity-sensor udp-server

Default

No UDP server is specified.

Views

System view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the IPv4 address of the UDP server.

port port-number: Specifies the port number of the UDP server, in the range of 1 to 65534.

interval interval: Specifies the interval at which the AC sends information about the same device to the UDP server, in the range of 1 to 600 seconds. The default interval is 30 seconds.

preshared-key: Specifies a preshared key.

cipher: Specifies a key in encrypted form.

simple: Specifies a key in plaintext form.

key-string: Specifies the key. Its plaintext form is a case-sensitive string of 8 to 63 characters. Its encrypted form is a case-sensitive string of 41 to 117 characters.

Examples

# Specify the UDP server with IP address 10.152.3.209 and port number 443 to receive wireless device information.

<Sysname> system-view

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

display client-proximity-sensor device

Use display client-proximity-sensor device to display information about wireless devices detected by sensors.

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

ap: Displays information about detected APs.

client: Displays information about detected clients.

mac-address mac-address: Displays information about the wireless device with the specified MAC address. The mac-address argument is in H-H-H format.

verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information.

Examples

# Display brief information about wireless devices detected by sensors.

<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

Table 1 Command output

Field

Description

MAC address

MAC address of the wireless device.

Type

Wireless device type:

·     AP.

·     Client.

Duration

Time elapsed since the wireless device entered the current status.

Sensors

Number of sensors that detected the wireless device.

Channel

Channel on which the wireless device was most recently detected.

Status

Wireless device status:

·     Active.

·     Inactive.

 

# Display detailed information about wireless devices detected by sensors.

<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 detected time: 2016-04-03/09:05:51

       Last detected 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

  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 detected time: 2016-04-03/14:52:56

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

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

Table 2 Command output

Field

Description

Total number detected devices

Number of detected wireless devices.

AP

MAC address of the detected AP.

Client

MAC address of the detected client.

Last detected associated AP

MAC address of the AP with which the client most recently associated. The MAC address is the BSSID of the AP.

Status

Wireless device status:

·     Active.

·     Inactive.

Status duration

Time elapsed since the wireless device entered the current status.

Vendor

OUI of the wireless device. This field displays Not found if no OUIs are imported or the OUI of the device does not match any of the imported OUIs.

Security

Security method:

·     WEP.

·     WPA.

·     WPA2.

·     None.

Encryption method

Encryption method:

·     TKIP.

·     CCMP.

·     WEP.

·     None.

Authentication method

Authentication method:

·     PSK.

·     802.1X.

·     Others—Authentication methods except for PSK authentication and 802.1X authentication.

·     None.

Broadcast SSID

Whether the AP broadcasts SSIDs. If the AP does not broadcast SSIDs, the SSID field in the output is null.

Beacon interval

Beacon interval in TU. One TU is equal to 1024 microseconds.

Up duration

Time elapsed since the AP started.

Total number of reported APs

Number of sensors that detected the client.

AP n

Sensor that detected the wireless device. n represents the number of the sensor and is automatically assigned by the system.

AP ID

AP ID of the sensor.

AP name

Name of the sensor that detected the wireless device.

Radio ID

ID of the radio that detected the wireless device.

RSSI

RSSI of the sensor.

Channel

Channel on which the sensor most recently detected the wireless device.

First detected time

Time when the sensor detected the wireless device for the first time.

Last detected time

Time when the sensor most recently detected the wireless device.

Total number of associated clients

Number of clients that are associated with the AP.

n:H-H-H

MAC address of the wireless client associated with the AP. n is the number of the wireless client and is automatically assigned by the system.

Detected associated AP

AP with which the wireless client is associated.

 

display client-proximity-sensor sensor

Use display client-proximity-sensor sensor to display information about sensors.

Syntax

display client-proximity-sensor sensor

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display information about sensors.

<Sysname> display client-proximity-sensor sensor

Total number of sensors: 1

Sensor ID    Sensor name                Radio ID   Status

3            ap1                        1          Active

Table 3 Command output

Field

Description

Status

Sensor status:

·     Active.

·     Inactive

display client-proximity-sensor statistics receive

Use display client-proximity-sensor statistics receive to display statistics received from sensors.

Syntax

display client-proximity-sensor statistics receive

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display statistics received from sensors

<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

Table 4 Command output

Field

Description

Information from sensor n

Information collected from sensor n, where n represents the ID of the sensor.

Detected AP updated messages

Number of AP update messages.

Detected client updated messages

Number of client update messages.

Detected AP deleted messages

Number of AP delete messages.

Detected client deleted messages

Number of client delete messages.

Detected all device deleted messages

Number of device delete messages

 

Related commands

reset client-proximity-sensor statistics receive

reset client-proximity-sensor device

Use reset client-proximity-sensor device to clear wireless device information.

Syntax

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

Views

User view

Predefined user roles

network-admin

Parameters

ap: Specifies detected APs.

client: Specifies detected clients.

mac-address mac-address: Specifies a wireless device by its MAC address, in H-H-H format.

all: Specifies all detected devices.

Examples

# Clear information about detected clients.

<Sysname> reset client-proximity-sensor device client

# Clear information about the wireless device with MAC address 0023-1212-2323.

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

Related commands

display client-proximity-sensor device

reset client-proximity-sensor statistics receive

Use reset client-proximity-sensor statistics receive to clear statistics received from sensors.

Syntax

reset client-proximity-sensor statistics receive

Views

User view

Predefined user roles

network-admin

Examples

# Clear statistics received from sensors.

<Sysname> reset client-proximity-sensor statistics receive

Related commands

display client-proximity-sensor statistics receive