Configure Beacon Management and Asset Tracking for AOS 8.3.x (Controller)

Use this guide to configure Aruba controllers with AOS 8.3.x for use with Meridian Beacon Management and Asset Tracking.

Prerequisites

  1. Configure Clock/NTP services
  2. Configure preferred DNS to reach *.meridianapps.com

Complete These Steps

Complete these steps to enable the Meridian Asset Tracking solution.

  1. Turn on the embedded Bluetooth in your APs and configure your infrastructure for Beacons Management.
  2. Install the DigiCert root certificate on your Managed Devices (MDs) also known as your local controller(s)
  3. Configure the Web Secure Socket between your controller and the Meridian back-end servers. This should be done on your MDs/local controllers.
  4. Deploy your Aruba Access Points using the Beacons app.
  5. Configure your Aruba Asset Tags using the Tags app.

Notes on Web Secure Socket for Asset Tracking

In order for the Web Secure Socket to open between the Aruba Infrastructure and the Meridian Cloud, you must successfully deploy an Aruba AP using the Beacons app and configure an Asset Tag using the Aruba Tags app.

Information Needed for Meridian Editor Aruba Network Configuration

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

Location ID

https://edit.meridianapps.com/apps/{Location ID}

Beacons Management endpointURL 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 endpointURL 
https://tags.meridianapps.com/api/v1beta1/streams/ingestion.start
EU Tag Ingestion URLs ---
EU BLE Asset Tag Ingestion endpointURL 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.

Required for AOS 8.3.x

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  *.meridianapps.com.

Generate an Access Token for Communicating to the Meridian Server.

To get started, create your access token in the Meridian Editor.

  1. 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.
  2. You'll need to copy your Access token and use in a later step to configure your infrastructure.

Configuring Beacons Management

This can be done via CLI as well, which if preferred, is referenced below.

  1. In the Controller's web UI, go to the Configuration tab.
  2. In the sidebar navigation menu, click System.
  3. In the top navigation menu, select Profiles.
  4. Under All Profiles, select AP.
  5. In the AP System pane, indicate the system profile used by your APs.
  6. Open the Advanced setting pane.
  7. In the BLE operation mode field, enter beaconing.
  8. Configure IoT Transport Profile (Config below)

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:   

https://dl.cacerts.digicert.com/DigiCertGlobalRootCA.crt	

Configure an AP System-Profile to Enable Access Point Beacons Using the Aruba Controller CLI

#configure terminal     
(config) #ap system-profile <profile-name>         
(AP system profile "System-Profile-Name") #ble-op-mode Beaconing     
(AP system profile "System-Profile-Name") #end     
#write memory
		

Configure Beacons Management and Asset Tracking IoT Transport Profiles in the Aruba Controller CLI

ArubaOS 8.3.x uses the ioT transportProfile methodology for configuration. Use the following commands;

Configuring Beacons Management

#configure terminal

(config) #iot transportProfile <beacons management profile-name>
(ioT Data Profile "profile-name) #endpointType Meridian-Beacon-Management
(ioT Data Profile "profile-name) #endpointURL https://edit.meridianapps.com/api/beacons/manage
(ioT Data Profile "profile-name) #endpointToken <meridian-token>
(ioT Data Profile "profile-name) #payloadContent managed-beacons
(ioT Data Profile "profile-name) #transportInterval 600
!
(config) #iot useTransportProfile <beacons-management-profile-name>

Configuring Connection to Asset Tags Back-end Server

#configure terminal

(config) #iot transportProfile <asset-tracking-profile-name>
(ioT Data Profile "profile-name) #endpointType Meridian-Asset-Tracking
(ioT Data Profile "profile-name) #endpointURL <Select Global or EU endpointURL from above inventory>
(ioT Data Profile "profile-name) #endpointToken <meridian-token>
(ioT Data Profile "profile-name) #endpointID <locationID>
(ioT Data Profile "profile-name) #payloadContent managed-tags
(ioT Data Profile "profile-name) #transportInterval 5
!
(config) #iot useTransportProfile <asset-tracking-profile-name>
		

locationID = Found in the Meridian Editor URL string or under the “Locations” tab in the Meridian Editor. 

endpointToken = Found in the Meridian Editor Beacons Management Page

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.