Configure Beacon Management and Asset Tracking for AOS 6.5.x (Controller)
Information Needed for Meridian Editor Aruba Network Configuration
Use this guide to configure Aruba controllers with AOS 6.5.2.x/6.5.3.x or 6.5.4.x for use with Meridian Beacon Management and Asset Tracking.
- Configure Clock/NTP services
- Configure preferred DNS to reach *.meridianapps.com
Complete These Steps
Complete these steps to enable the Meridian Asset Tracking solution.
- Turn on the embedded Bluetooth in your APs and configure your infrastructure for Beacons Management.
- Install the DigiCert root certificate on all local controllers.
- Configure the Web Secure Socket between your controller and the Meridian back-end servers.
- Deploy your Aruba Access Points using the Beacons app.
- Configure your Aruba Asset Tags using the Tags app.
Notes on Web Secure Socket for Asset Tracking
Before you begin, you'll need to gather or set the following information in order to properly configure your controller for asset tracking.
|Controller or IAP||Value|
|Beacons Management URL||https://edit.meridianapps.com/api/beacons/manage|
|Access Token||Access Token (available in Meridian Editor)|
|BLE Operation Mode||Beaconing|
|Global Tag Ingestion URLs ---|
|BLE Asset Tag Ingestion Endpoint URL for **6.5.2.x/6.5.3.x**||wss://tags.meridianapps.com/streams/v1beta1/ingestion/tags/websocket|
|BLE Asset Tag Ingestion Endpoint URL for **6.5.4.x+**|| https://tags.meridianapps.com/api/v1beta1/streams/ingestion.start
|EU Tag Ingestion URLs ---|
|EU BLE Asset Tag Ingestion Endpoint URL for **6.5.2.x/6.5.3.x**||wss://tags-eu.meridianapps.com/streams/v1beta1/ingestion/tags/websocket|
|EU BLE Asset Tag Ingestion Endpoint URL for **6.5.4.x+**|| https://tags-eu.meridianapps.com/api/v1beta1/streams/ingestion.start
When an Aruba Tag is heard by an access point, the AP sends the RSSI value it's heard to the Meridian Editor using these configuration values. The Editor uses the highest weighted average RSSI value of the Aruba Tag heard by three of APs to track it on the map. This is a continual process for all Aruba Tags being tracked for a location.
Find Your Location ID
If you need to find your Meridian Editor location ID, the following image shows where to find that.
Aruba Controller-based WLAN Configuration
The Aruba Wi-Fi network infrastructure is configured using an Aruba controller and APs. Configure a controller with Meridian configuration values and it will propagate that configuration to all connected APs.
The controller should have DNS configured and able to reach
Aruba Controller Configuration
Generate an Access Token for Communicating to the Meridian Server.
To get started, create your access token in the Meridian Editor.
- In the sidebar menu click Beacons, then select, "Beacons Management" from the top navigation menu, and then click Generate a New Access Token to get started.
- You'll need to copy your Access token and use in a later step to configure your infrastructure.
Configuring Beacons Management
- In the controller web UI, go to the Configuration tab.
- In the sidebar navigation menu, click AP Configuration.
- Expand the AP settings, and then click AP system. This opens the AP system profile pane.
In the AP system profile pane, click the Advanced tab to input the BLE configuration information you got from the Meridian Editor.
Set BLE Operational Mode to Beaconing.
Configuring for Asset Tracking
Adding DigiCert Root Certificate to the Aruba Controller
The websocket endpoint uses wss protocol (secure websockets) and the server certificate is validated by the websocket library. When using a Meridian endpoint (with the *.meridianapps.com domain), the server is signed by a DigiCert root certificate, that requires the user to add the root CA certificate to the controller.
Uploading the certificate to the controller can be done under the Configuration > Management > Certificates menu.
Select DER as the certificate format and Trusted CA as the certificate type.
The root CA certificate for Meridian is available at:
Configure an AP System-Profile Using the Aruba Controller CLI
#configure terminal (config) #ap system-profile <profile-name> (AP system profile "System-Profile-Name") #ble-url <ble-url> (AP system profile "System-Profile-Name") #ble-token <ble-token> (AP system profile "System-Profile-Name") #ble-op-mode Beaconing (AP system profile "System-Profile-Name") #end #write memory
Configure the Web-Secure Socket (WSS) in the Aruba Controller CLI
for AOS 6.5.2.x and 6.5.3.x
#configure terminal (config) #ble_relay mgmt-server type ws wss://tags.meridianapps.com/streams/v1beta1/ingestion/tags/websocket or for EU-hosted instances (config) #ble_relay mgmt-server type ws wss://tags-eu.meridianapps.com/streams/v1beta1/ingestion/tags/websocket <br>
for AOS 6.5.4.x
#configure terminal (config) #ble_relay mgmt-server type https <ingestion URL> token <token ID> id <location ID>
Where: Ingestion URL = Global or EU Tag Ingestion Endpoint URL (shown above)
Token ID = The Meridian Editor Beacons Management token.
Location ID = Found in the Meridian Editor URL string or under the “Locations” tab in the Meridian Editor. At this time, Configuration of WSS is not available through the Aruba Controller Web-UI.
In order for the WSS to open, as shown in the Validate your BLE Infrastructure section below, you must successfully deploy an Aruba AP and configure an Asset Tag using the Tags app.
At least one deployed Asset Tag will need to be in range of a configured observer in order for the Asset Tag signal to trigger the establishment of a WebSocket connection.