11-WLAN Advanced Features Command Reference

HomeSupportResource CenterReference GuidesCommand ReferencesH3C FAT AP Command References(R5436)-6W10111-WLAN Advanced Features Command Reference
02-WLAN probe commands
Title Size Download
02-WLAN probe commands 105.42 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.

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

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.

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

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 Oasis platform.

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

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 Oasis platform.

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 Oasis platform goes down. After the device reconnects to the Oasis platform, the device sends the cached information to the Oasis platform.

Examples

# Enable the device to cache client information upon disconnection from the Oasis platform.

<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 Oasis platform 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 Oasis platform 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 Oasis platform, in the range of 100 to 60000 milliseconds.

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

Examples

# Configure the AC to report 50 client entries to the Oasis platform 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 Oasis platform.

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 Oasis platform.

Views

System view

Predefined user roles

network-admin

Examples

# Disable the AC from reporting wireless device information to the Oasis platform.

<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 Oasis platform.

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 Oasis platform, in the range of 1 to 100.

Usage guidelines

The AC does not report the client information received from a sensor to the Oasis platform 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 Oasis platform.

<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 device information 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

  • 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
新华三官网