02-WLAN Configuration Guides

HomeSupportConfigure & DeployConfiguration GuidesH3C Unified Wired and Wireless Access Controller User Manual (R5417P03)-6W10302-WLAN Configuration Guides
15-Wireless location configuration
Title Size Download
15-Wireless location configuration 132.93 KB

Configuring wireless location

About wireless location

Wireless location tracks 802.11 devices for medical monitoring, asset management, and logistics management.

Wireless location system

As shown in Figure 1, a wireless location system contains 802.11 devices, information receivers(802.11 APs), and a location server. 802.11 devices include Tags (small wireless devices that can only send 802.11 packets periodically) and MUs (all 802.11 devices except Tags).

Figure 1 Wireless location system

 

Wireless location mechanism

Wireless location operates as follows:

1.        The 802.11 devicesends a wireless packet.

2.        Upon receiving the wireless packet, the APs encapsulate the collected location information (including RSSI and timestamp) in location packets, and then send the packets to the location server.

3.        The location server calculates the location of the 802.11 or BLE device.

A location server needs location information from a minimum of three APs to locate an 802.11 or BLE device.

Wireless location methods

RF fingerprinting sets up a fingerprint database by collecting signal strength and location of clients. To locate a client, an AP encapsulates the location information of the client into a location packet and sends the packet to the location server. The location server uses a location algorithm to match the signal strength of the client against information in the database to locate the client.

RF fingerprinting is used to locate MUs and Tags.

Restrictions and guidelines: Wireless location configuration

You can configure APs by using the following methods:

·          Configure APs one by one in AP view.

·          Assign APs to an AP group and configure the AP group in AP group view.

·          Configure all APs in global configuration view.

For an AP, the settings made in these views for the same parameter take effect in descending order of AP view, AP group view, and global configuration view.

Wireless location tasks at a glance

To configure RF fingerprinting, perform the following tasks:

1.        Enabling RF fingerprinting

2.        Enabling radio-based location

3.        Specifying an IPv4 address and a port number for the location server

4.        Specifying a port to listen for messages from the location server

5.        Specifying a multicast MAC address for Tags

6.        Specifying the type of devices to locate

7.        (Optional.) Configuring raw frame reporting

8.        (Optional.) Configuring MU information reporting

9.        (Optional.) Specifying the location packet format

10.     (Optional.) Specifying the report mode for location packets

11.     (Optional.) Configuring wireless location common parameters

¡  Configuring packet dilution

¡  Enabling ignoring beacon frames

¡  Enabling ignoring AP frames

¡  Configuring RSSI-based packet filtering

¡  Configuring client packet rate limiting

¡  Configuring location packet rate limiting

¡  Configuring wireless location keepalive

Configuring RF fingerprinting

Enabling RF fingerprinting

Restrictions and guidelines

For an AP to send location packets to the location server, you must enable both RF fingerprinting and radio-based location.

Procedure

1.        Enter system view.

system-view

2.        Enter AP view, AP group view, or global configuration view.

¡  Enter AP view.

wlan ap ap-name

¡  Enter AP group view.

wlan ap-group group-name

¡  Enter global configuration view.

wlan global-configuration

3.        Enable RF fingerprinting.

rfid-tracking fingerprint enable

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, RF fingerprinting is disabled.

Enabling radio-based location

Restrictions and guidelines

For an AP to send location packets to the location server, you must enable both RF fingerprinting and radio-based location.

Procedure

1.        Enter system view.

system-view

2.        Enter AP view or an AP group's AP model view.

¡  Enter AP view.

wlan ap ap-name

¡  Execute the following commands in sequence to enter an AP group's AP model view:

wlan ap-group group-name

ap-model ap-model

3.        Enter radio view.

radio radio-id

4.        Enable radio-based location.

rfid-tracking radio enable

By default:

¡  In radio view, an AP uses the configuration in an AP group's radio view.

¡  In an AP group's radio view, radio-based location is disabled.

Specifying an IPv4 address and a port number for the location server

About specifying an IPv4 address and port number for the location server

This feature enables APs to send location packets to the specified IPv4 address and port number for communicating with the location server.

Procedure

1.        Enter system view.

system-view

2.        Enter AP view, AP group view, or global configuration view.

¡  Enter AP view.

wlan ap ap-name

¡  Enter AP group view.

wlan ap-group group-name

¡  Enter global configuration view.

wlan global-configuration

3.        Specify an IPv4 address and a port number for the location server.

rfid-tracking fingerprint engine-address engine-address engine-port engine-port

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, no IPv4 address and port number are specified for the location server.

Specifying a port to listen for messages from the location server

About specifying the port to listen

Perform this task to specify a port for an AP to listen for messages from the location server.

Procedure

1.        Enter system view.

system-view

2.        Enter AP view, AP group view, or global configuration view.

¡  Enter AP view.

wlan ap ap-name

¡  Enter AP group view.

wlan ap-group group-name

¡  Enter global configuration view.

wlan global-configuration

3.        Specify a port to listen for messages from the location server.

rfid-tracking fingerprint vendor-port vendor-port-number

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, the port to listen is port 1144.

Specifying a multicast MAC address for Tags

About the multicast MAC address for Tags

The destination MAC address of packets sent by Tags is the multicast MAC address defined by the manufacturer. Perform this task to specify the multicast MAC address for an AP to identify Tags.

If you do not specify a multicast MAC address for Tags, an AP determines that all received 802.11 packets are from MUs.

Procedure

1.        Enter system view.

system-view

2.        Enter AP view, AP group view, or global configuration view.

¡  Enter AP view.

wlan ap ap-name

¡  Enter AP group view.

wlan ap-group group-name

¡  Enter global configuration view.

wlan global-configuration

3.        Specify a multicast MAC address for Tags.

rfid-tracking fingerprint tag-multicast-address mac-address

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, no multicast MAC address is specified for Tags.

Specifying the type of devices to locate

About specifying the type of devices to locate

This feature enables an AP to send location information about only the specified type of devices to the location server.

Procedure

1.        Enter system view.

system-view

2.        Enter AP view or an AP group's AP model view.

¡  Enter AP view.

wlan ap ap-name

¡  Execute the following commands in sequence to enter an AP group's AP model view:

wlan ap-group group-name

ap-model ap-model

3.        Enter radio view.

radio radio-id

4.        Specify the type of devices to locate.

rfid-tracking mode { mu | tag } *

By default:

¡  In radio view, an AP uses the configuration in an AP group's radio view.

¡  In an AP group's radio view, the type of devices to locate is not specified.

Configuring raw frame reporting

About raw frame reporting

This feature enables an AP to encapsulate both the raw frames and the location information obtained from the frames in location packets.

Procedure

1.        Enter system view.

system-view

2.        Enter AP view, AP group view, or global configuration view.

¡  Enter AP view.

wlan ap ap-name

¡  Enter AP group view.

wlan ap-group group-name

¡  Enter global configuration view.

wlan global-configuration

3.        Configure raw frame reporting.

rfid-tracking fingerprint raw-frame-report { disable | enable }

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, raw frame reporting is disabled.

Configuring MU information reporting

About MU information reporting

This feature enables an AP to encapsulate MU information, including the IP address and the transmit rate of an MU in location packets.

Procedure

1.        Enter system view.

system-view

2.        Enter AP view, AP group view, or global configuration view.

¡  Enter AP view.

wlan ap ap-name

¡  Enter AP group view.

wlan ap-group group-name

¡  Enter global configuration view.

wlan global-configuration

3.        Configure MU information reporting.

rfid-tracking fingerprint mu-report { disable | enable }

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, MU information reporting is disabled.

Specifying the location packet format

About location packet formats

RF fingerprinting supports the following location packet formats:

·          CUPID-hybrid—An AP encapsulates only clients' MAC addresses and RSSIs in location packets.

·          General—This format is applicable to most scenarios. Most third-party location servers support only the general format.

·          Lightweight—An AP encapsulates location information for several clients in one lightweight location packet to save bandwidth. This format is applicable to traffic-sensitive scenarios.

Procedure

1.        Enter system view.

system-view

2.        Enter AP view, AP group view, or global configuration view.

¡  Enter AP view.

wlan ap ap-name

¡  Enter AP group view.

wlan ap-group group-name

¡  Enter global configuration view.

wlan global-configuration

3.        Specify the location packet format.

rfid-tracking fingerprint report-format { cupid-hybrid | general | light-weight }

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, an AP sends location packets in general format.

Specifying the report mode for location packets

About location packet report modes

Both the AC (centralized report) and APs (local report) can report location packets to the location server. In centralized report mode, APs need to send location packets to the AC first.

Procedure

1.        Enter system view.

system-view

2.        Enter AP view, AP group view, or global configuration view.

¡  Enter AP view.

wlan ap ap-name

¡  Enter AP group view.

wlan ap-group group-name

¡  Enter global configuration view.

wlan global-configuration

3.        Specify the report mode for location packets.

rfid-tracking fingerprint report-mode { central | local }

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, the local report mode is used.

Configuring wireless location common parameters

Configuring packet dilution

About packet dilution

This feature enables an AP to send a location packet upon receiving the specific number of wireless packets or at the specified interval. This reduces the workloads of the location server and the AP.

For example, the dilution factor is 10 and the timeout timer is 5 seconds. If RF fingerprinting is enabled, the AP sends a location packet every time it receives 10 wireless packets from an MU client (excluding management and broadcast packets). If the AP fails to receive 10 packets from an MU client before the timeout timer expires, it sends the most recent wireless packet to the location server.

Restrictions and guidelines

This feature takes effect only on MU clients for RF fingerprinting.

Procedure

1.        Enter system view.

system-view

2.        Enter AP view, AP group view, or global configuration view.

¡  Enter AP view.

wlan ap ap-name

¡  Enter AP group view.

wlan ap-group group-name

¡  Enter global configuration view.

wlan global-configuration

3.        Enable packet dilution.

rfid-tracking dilution enable

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, packet dilution is disabled.

4.        Set the dilution factor and dilution timeout timer.

rfid-tracking dilution factor factor timeout timeout

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, the dilution factor and dilution timeout timer are not configured.

Enabling ignoring beacon frames

About ignoring beacon frames

Ignoring beacon frames prevents traffic flood.

Restrictions and guidelines

This feature takes effect only when RF fingerprinting is configured.

Procedure

1.        Enter system view.

system-view

2.        Enter AP view, AP group view, or global configuration view.

¡  Enter AP view.

wlan ap ap-name

¡  Enter AP group view.

wlan ap-group group-name

¡  Enter global configuration view.

wlan global-configuration

3.        Enable the AP to ignore beacon frames.

rfid-tracking ignore beacon enable

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, beacon frames are not ignored.

Enabling ignoring AP frames

About ignoring AP frames

AP frames are frames that an AP received from other APs. Configure this feature if you do not need to locate or monitor APs.

Restrictions and guidelines

This feature takes effect only when RF fingerprinting is configured.

Procedure

1.        Enter system view.

system-view

2.        Enter AP view, AP group view, or global configuration view.

¡  Enter AP view.

wlan ap ap-name

¡  Enter AP group view.

wlan ap-group group-name

¡  Enter global configuration view.

wlan global-configuration

3.        Enable the AP to ignore AP frames.

rfid-tracking ignore ap-frame enable

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, AP frames are not ignored.

Configuring RSSI-based packet filtering

About RSSI-based packet filtering

When RSSI-based packet filtering is enabled, an AP does not report location information in packets with an RSSI lower than the RSSI threshold. This feature enables an AP to not locate clients far away from the AP.

Restrictions and guidelines

This feature takes effect only when RF fingerprinting is configured.

Procedure

1.        Enter system view.

system-view

2.        Enter AP view, AP group view, or global configuration view.

¡  Enter AP view.

wlan ap ap-name

¡  Enter AP group view.

wlan ap-group group-name

¡  Enter global configuration view.

wlan global-configuration

3.        Enable RSSI-based packet filtering.

rfid-tracking rssi enable

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, RSSI-based packet filtering is disabled.

4.        Set the RSSI threshold.

rfid-tracking rssi threshold rssi-threshold

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, the RSSI threshold is 5 (–123 dBm).

Configuring client packet rate limiting

About client packet rate limiting

This feature enables an AP to not report location information from excessive client packets when both the CIR and CBS are exceeded. This practice ensures that the location information for each client can be sent to the location server and prevents client packets from flooding the AP.

Restrictions and guidelines

This feature takes effect only when RF fingerprinting is configured.

If packet dilution is enabled, this feature limits the rate for diluted packets.

Procedure

1.        Enter system view.

system-view

2.        Enter AP view, AP group view, or global configuration view.

¡  Enter AP view.

wlan ap ap-name

¡  Enter AP group view.

wlan ap-group group-name

¡  Enter global configuration view.

wlan global-configuration

3.        Enable client packet rate limiting.

rfid-tracking client rate-limit enable

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, client packet rate limiting is disabled.

4.        Set the CIR and CBS for client packets.

rfid-tracking client rate-limit cir cir [ cbs cbs ]

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, the CIR and CBS for client packets are not set.

Configuring location packet rate limiting

About location packet rate limiting

This feature enables an AP to discard excessive location packets when both the CIR and CBS are exceeded. This practice prevents location packets from flooding the location server.

Restrictions and guidelines

This feature takes effect only when RF fingerprinting is configured.

Procedure

1.        Enter system view.

system-view

2.        Enter AP view, AP group view, or global configuration view.

¡  Enter AP view.

wlan ap ap-name

¡  Enter AP group view.

wlan ap-group group-name

¡  Enter global configuration view.

wlan global-configuration

3.        Enable location packet rate limiting.

rfid-tracking rate-limit enable

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, location packet rate limiting is disabled.

4.        Set the CIR and CBS for location packets.

rfid-tracking rate-limit cir cir [ cbs cbs ]

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, the CIR and CBS for location packets are not set.

Configuring wireless location keepalive

About wireless location keepalive

This feature enables an AP to send Hello packets to the location server at an interval of 15 seconds. If the location server does not receive any packets from an AP within 30 seconds, the location server determines that the AP is offline.

Restrictions and guidelines

This feature takes effect only when RF fingerprinting is configured.

Disable this feature to avoid bandwidth waste if the location server cannot process Hello packets.

Procedure

1.        Enter system view.

system-view

2.        Enter AP view, AP group view, or global configuration view.

¡  Enter AP view.

wlan ap ap-name

¡  Enter AP group view.

wlan ap-group group-name

¡  Enter global configuration view.

wlan global-configuration

3.        Configure wireless location keepalive.

rfid-tracking keepalive { disable | enable }

By default:

¡  In AP view, an AP uses the configuration in AP group view. If no setting is configured in AP group view, the AP uses the configuration in global configuration view.

¡  In AP group view, an AP uses the configuration in global configuration view.

¡  In global configuration view, wireless location keepalive is disabled.

Enabling SNMP notifications for wireless location

About SNMP notifications for wireless location

This feature enables the device to report critical wireless location events to an NMS. For wireless location event notifications to be sent correctly, you must also configure SNMP as described in the network management and monitoring configuration guide for the device.

Procedure

1.        Enter system view.

system-view

2.        Enable SNMP notifications for wireless location.

snmp-agent trap enable wlan location-aware

By default, SNMP notifications for wireless location are disabled.

Display and maintenance commands for wireless location

Execute display commands in any view.

 

Task

Command

Display radio information for wireless location.

display wlan rfid-tracking radio [ ap apname ]

 

Wireless location configuration examples

Example: Configuring RF fingerprinting

Network configuration

As shown in Figure 2, configure RF fingerprinting for AP 1, AP 2, and AP 3 to locate the MUs.

Figure 2 Network diagram

 

Procedure

1.        Configure AP 1:

# Create manual AP ap1, and specify the AP model and serial ID.

<AC> system-view

[AC] wlan ap ap1 model WA4320H

[AC-wlan-ap-ap1] serial-id 219801A0YG8165E00001

[AC-wlan-ap-ap1] quit

# Enable RF fingerprinting.

[AC-wlan-ap-ap1] rfid-tracking fingerprint enable

# Specify an IPv4 address and a port number for the location server.

[AC-wlan-ap-ap1] rfid-tracking fingerprint engine-address 192.168.10.10 engine-port 1145

# Specify a port to listen for messages from the location server.

[AC-wlan-ap-ap1] rfid-tracking fingerprint vendor-port 3000

# Enable radio-based location.

[AC-wlan-ap-ap1] radio 1

[AC-wlan-ap-ap1-radio-1] rfid-tracking radio enable

# Specify the type of devices to locate as MU.

[AC-wlan-ap-ap1-radio-1] rfid-tracking mode mu

# Enable radio 1 of AP 1.

[AC-wlan-ap-ap1-radio-1] radio enable

[AC-wlan-ap-ap1-radio-1] quit

[AC-wlan-ap-ap1] quit

[AC] quit

2.        Configure AP 2 and AP 3 in the same way AP 1 is configured.

Verifying the configuration

# Verify that RF fingerprinting is enabled and the type of devices to locate is MU for each AP.

<AC> display wlan rfid-tracking radio

                                 Wireless Locating

--------------------------------------------------------------------------------

 AP                                 Radio   Type                               

--------------------------------------------------------------------------------

 ap1                                1       MU                                  

 ap2                                1       MU                                  

 ap3                                1       MU                                  

--------------------------------------------------------------------------------

# Verify that you can view location information for the MUs by maps, forms, or reports provided by the graphics software. (Details not shown.)

 

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