Our step-by-step guide to configure the access point(s) to forward data for processing by Pareto Anywhere.
Learn how we at reelyActive configure the APs for open source telemetry and more
Tutorials to consider instead
One or more Aruba Instant APs running AOS 8.8 or higher.
Early adopters of AOS 10 can install the AOS8 app from the IoT Connector App Store to continue to enjoy the functionality presented in this tutorial.
AOS 10 will be fully supported in future—this is a temporary workaround.
Connect and log in to the access point over a local network.
Ensure that the access point is powered and connected to the local network from which it will be configured.
Consult the Aruba documentation specific to your AP model, if required.
From a computer on the local network, browse to the access point via its IP address (ex: http://192.168.0.1).
Log in with the username admin and the corresponding password, then proceed to the next step.
Create and enable a Telemetry Websocket to forward data to Pareto Anywhere.
Aruba Instant version 8.8 or greater is required. First upgrade the AP firmware if/as required.
From the admin page:
Consult the Aruba documentation for the latest Aruba IoT Websocket Interface guide, if required.
Complete the new transport stream popup as follows:
Parameter | Value | Notes |
---|---|---|
Name | reelyActive | User-defined |
State | Enabled | |
Server type | Telemetry Websocket | |
Server URL | ws://x.x.x.x/aruba | Substitute x.x.x.x for Pareto Anywhere server IP address* |
Device classes | All | Optionally filter by class |
Reporting interval | 900 seconds | Reduce to 5 seconds or less for occupancy analytics |
BLE data forwarding | Enabled | Forwards payload/sensor data |
Per-frame filtering | Disabled | |
RSSI reporting format | Last | Best option for real-time location |
Environment type | Office | Influences RSSI-based distance estimation in device filters |
Proxy | — | Complete if required |
Authentication | Use token | Required |
Access token | token | Ignored by Pareto Anywhere |
Device filters | 5 seconds (Reporting activity) |
Pareto Anywhere discards stale data |
*A Pareto Anywhere instance running on port 3001 of 192.168.0.123 would require ws://192.168.0.123:3001/aruba
The given transport stream parameters are intended to facilitate initial integration on a trusted local network.
The use of wss:// rather than ws:// is strongly recommended for production deployments and for data forwarding to remote instances, which in turn requires advanced configuration of Pareto Anywhere.
Contact us about our Beyond Integration plan for assistance.
Click OK to complete the configuration.
Create and enable the Bluetooth Low Energy radio profile on the AP.
From the admin page:
Consult the Aruba documentation for the latest IoT – Basic Setup Guide, if required.
Complete the new radio profile popup as follows:
Parameter | Value | Notes |
---|---|---|
Name | reelyActive | User-defined |
State | Enabled | |
Radio | Internal | |
Radio mode | BLE | |
BLE operational mode | Both | Beaconing = discoverability, Scanning = discovery |
Console | Off | |
Tx Power | 0 dBm |
Click OK to complete the configuration.
Click the Save button at the bottom right of the window to complete and enable the configuration.
Observing data in Pareto Anywhere requires no additional action if an instance based on the pareto-anywhere package is running, or, for quick-and-dirty validation, run barnowl-aruba as described below.
If a Pareto Anywhere installation based on the pareto-anywhere package is already present and running on the target computer on the host network, the data forwarded by the AP should be available in both the web apps and APIs.
To quickly validate that data is correctly received on the target computer on the host network, it is possible to run barnowl-aruba standalone to initiate a WebSocket server on port 3001 using the /aruba route as follows:
git clone https://github.com/reelyactive/barnowl-aruba.git npm install npm start
If the access point is correctly configured, and at least one compatible Bluetooth Low Energy device is advertising in range, raddec data should appear in the console.
Our cheatsheet details the raddec and dynamb JSON output from the Pareto Anywhere open source middleware.
Tutorial prepared with ♥ by jeffyactive.
You can reelyActive's open source efforts directly by contributing code & docs, collectively by sharing across your network, and commercially through our packages.Continue exploring our open architecture and all its applications.