Configuring Wi-Fi Terminal Location

Pre-configuration Tasks

Before configuring Wi-Fi terminal location, perform the tasks listed in the following table.

**Table 1** Pre-configuration tasks
Task		Description
Create an AP group		Each AP will be added and can be added to only one AP group. An AP group is typically used to provide the same configurations for multiple APs. By default, the system has an AP group default. To create an AP group, execute this task. For details, see Creating an AP Group.
Configure an AP to go online	Configure a DHCP server	To go online normally, APs and STAs must obtain IP addresses. You can configure an AC as a DHCP server or use an independent DHCP server to allocate IP addresses to APs and STAs. For details, see Configuring a DHCP Server.
	Configure network interconnections	To enable APs and STAs to obtain IP addresses, APs to discover the AC and go online on the AC, and STAs to access the network, configure interconnections between network devices. For details, see Configuring Network Interconnections.
	Configure country codes	Correct country code configuration ensures that radio attributes of APs comply with laws and regulations of countries and regions to which the APs are delivered. For details, see Configuring Country Codes.
	Configure a source interface or source address	Before an AP establishes a CAPWAP tunnel with an AC, a source interface or source address must be specified for the AC. For details, see Configuring a Source Interface.
	Add APs	You can add APs in any of the following modes: Importing APs offline. Configuring AC to automatically discover an AP. Manually confirming APs added to the list of unauthorized APs. Adding an AP offline is recommended when the MAC address or SN of the AP is already learned. For details, see Adding APs.

Procedure

Run system-view
The system view is displayed.
Run wlan
The WLAN view is displayed.
Set the working mode for radios in an AP group or for a specified radio.
You can set the radio working mode in the AP radio view or AP group radio view. The configuration in the AP group radio view takes effect on all AP radios in an AP group and that in the AP radio view takes effect only on a specified AP radio. The configuration in the AP radio view has a higher priority than that in the AP group radio view.
- Set the working mode for all radios in an AP group.
  1. Run the ap-group name group-name command to enter the AP group view.
  2. Run the radio radio-id command to enter the radio view.
  3. Run the work-mode { normal | monitor [ [ proxy-scan ] dual-band-scan enable ] } command to set the working mode for radios in an AP group.
    
    By default, radios in an AP group work in normal mode.
  4. Run the quit command to return to the AP group view.
- Set the working mode for a specified AP radio.
  1. Run the ap-id ap-id, ap-mac ap-mac, or ap-name ap-name command to enter the AP view.
  2. Run the radio radio-id command to enter the radio view.
  3. Run the work-mode { normal | monitor [ [ proxy-scan ] dual-band-scan enable ] } command to set the working mode for a specified AP radio.
    
    By default, an AP radio works in normal mode.
  4. Run the quit command to return to the AP view.
An AP can work in two modes:
- normal: indicates the normal mode.
  If air scan functions (such as WIDS, spectrum analysis, and terminal location) are disabled on a radio, the radio is used to transmit common WLAN services.
  If air scan functions (such as WIDS, spectrum analysis, and terminal location) are enabled on a radio, the radio transmits common WLAN services and also provides the monitoring function. A transient increase in the WLAN service latency may occur, which does not affect network access. However, if any latency-sensitive service (such as videoconferencing) is running, it is recommended that a separate radio be used for air scan.
- monitor: indicates the monitor mode.
  In this mode, the radio can only transmit WLAN services scanned by the air interface but cannot transmit common WLAN services.
  
  In monitor mode, some APs support the following functions:
  dual-band-scan: indicates inter-band scanning. In this mode, the radio can perform scanning at both the 2.4 GHz and 5 GHz bands.
  proxy-scan: indicates proxy scanning. In this mode, the radio is dedicated to all air interface scanning functions on behalf of service radios, ensuring that services on the service radios are not affected.
Run quit
Return to the WLAN view.
Run air-scan-profile name profile-name
An air scan profile is created and the air scan profile view is displayed.

By default, the system provides the air scan profile default.
Run the undo scan-disable command to enable the air scan function.
By default, the air scan function is enabled.
Run scan-channel-set { country-channel | dca-channel | work-channel }
An air scan channel set is configured.

By default, an air scan channel set contains all channels supported by the country code of an AP.
(Optional) Run scan-period scan-time
The period during which the AP scans channels is configured.

The default period during which an AP scans channels is 60 ms.

The channel scan period applies to radio calibration, smart roaming, WLAN location, and WIDS functions.

A shorter channel scan period means fewer location packets that the device can obtain, which affects the location accuracy. A longer channel scan period has a much larger impact on services.
(Optional) Run scan-interval scan-time
The interval at which the AP scans channels is configured.

By default, the air scan interval is 10000 ms.

The channel scan interval applies to radio calibration, smart roaming, WLAN location, and WIDS functions.
- If the customer has high requirements on real-time data analysis, configure a small air scan interval using the scan-interval command to improve the scan frequency; however, higher scan frequency indicates much larger impact on the services.
- If the customer has high requirements on real-time locating services, deploy the APs on the same channel to scan channels.
Run quit
Return to the WLAN view.
Run radio-2g-profile name profile-name or radio-5g-profile name profile-name
The radio profile view of the specified AP is displayed.
- By default, the system provides the 2G radio profile default.
- By default, the system provides the 5G radio profile default.
Run air-scan-profile profile-name
The air scan profile is bound to the radio profile.

By default, the air scan profile default is bound to a radio profile.
Run quit
Return to the WLAN view.
(Optional) Configure the WIDS function according to Configuring Device Detection and Containment and Configuring Attack Detection and a Dynamic Blacklist.
To use the Wi-Fi terminal location function to locate unauthorized STAs, rogue APs and bridges, and ad-hoc devices, you need to enable WIDS. To use the Wi-Fi terminal location function to locate authorized STAs, you do not need to enable WIDS.
Run vap-profile name profile-name
A VAP profile is created.

By default, the system provides the VAP profile default.

When a VAP profile exists in the system, you can use the existing one or create a new one.
Run quit
Return to the WLAN view.
Bind the VAP profile to radios of an AP group or a specific AP as required to make the radios properly work. For details, see Binding VAP Profiles.
Run quit
Return to the WLAN view.
Run location-profile name profile-name
A location profile is created and the location profile view is displayed.

By default, no location profile is created.
Run private mu-enable
Wi-Fi terminal location is enabled on the AP.

Locating a STA requires at least three APs to scan signals on the WLAN.

By default, Wi-Fi terminal location is disabled on an AP.
(Optional) Run private report-frequency time
The interval at which the AP reports channel scan information is configured.

By default, an AP reports channel scan information every 20s (20000 ms).
(Optional) Run private report-protocol { udp | http }
The protocol type used by APs to report information is configured.

By default, an AP uses UDP to reports information.
(Optional) Run private mu protocol-version { v3 | v5 }
The STA location protocol version is configured.

The default terminal location protocol version is v3.
Run private server { ip-address ip-address | domain domain } port port-num [ via-ac ac-port ac-port-num ]
The destination IP address and port number are configured for the AP to report STA location data.

By default, no destination IP address or port number is configured for the AP to report STA location data.
(Optional) Run source ip-address ip-address
The source IP address from which the AC sends packets to the Location Server is configured.

By default, the source IP address from which the AC sends packets to the Location Server is not configured.
- You need to run this command only when location information is forwarded to the location server via an AC.
- To configure the AC as the destination to which the AP reports location information:
  - You must configure the number of the port through which the AC communicates with the location server.
  - Ensure that the port number configured on the location server is the same as the number of the port through which the AC communicates with the location server.
- To configure the location server as the destination to which the AP reports location information, ensure that the port number configured on the location server is the same as the number of the port through which the AP reports location information.
- The port number through which the AP reports location information cannot be the same as the number of the port through which the AC communicates with the location server.
- If the location server uses the Linux system and has URPF enabled, the source IP address that the AC uses to send packets to the location server must be pinged by the server.
Run quit
Return to the WLAN view.
Enter the AP group view or AP view.
- Run the ap-group name group-name command to enter the AP group view.
- Run the ap-id ap-id, ap-mac ap-mac, or ap-name ap-name command to enter the AP view.
Run radio-2g-profile profile-name { radio { radio-id | all } } or radio-5g-profile profile-name { radio { radio-id | all } }
The radio profile is bound to the AP group or AP.
- By default, the 2G radio profile default is bound to an AP group, but no 2G radio profile is bound to an AP.
- By default, the 5G radio profile default is bound to an AP group, but no 5G radio profile is bound to an AP.
Run location-profile profile-name radio { radio-id | all }
The location profile is bound to the specified radio on the AP.

By default, no location profile is bound to a radio.
Run quit
Return to the WLAN view.
(Optional) Run location source ip-address ip-address
The source IP address in packets sent by an AC to a location server is configured.

By default, the source IP address is not configured in packets sent by an AC to a location server.

In scenarios where the active and standby ACs are deployed, configure the source IP address on the standby AC using the location source command cannot be synchronized to the standby AC. When source IP addresses are configured on an AC using the location source and source commands at the same time, the source IP address configured using the source command takes effect.

Verifying the Configuration

Run the display location-profile name profile-name command to check Wi-Fi terminal location configurations.
Run the display references location-profile name profile-name command to check reference information about a location profile.

Follow-up Procedure

After Wi-Fi terminal location is configured on the AC, configure required WLAN location parameters on the location server so that you can check Wi-Fi terminal location results on the location server.