Quuppa Data Aggregator User Manual

This guide describes how to install and configure the Quuppa Data Aggregator (QDA) software. It is expected that you are already familiar with the Quuppa Site Planner (QSP) tool and the Quuppa Positioning Engine (QPE). If not, before continuing, please refer first to the Quuppa Development Quick Start Guide on how to use QSP and to the Quuppa Controller Installation Guide on how to install and configure QPE.

The QDA is a Java web application that collects and aggregates data from multiple QPEs, and exposes aggregated data through the Aggregator API. This is needed when a project is too large to be run by a single QPE server. The main benefit of running QDA is that it allows the selection of the best position candidate when multiple QPEs "see" the same tag. This can happen, for instance, when one QPE is handling indoors and another QPE is handling outdoors, and a tag happens to be at the doorway. In this case QDA decides the best position estimate and also sends the selection information back to all QPEs, so that only one QPE outputs the location data and only one QPE can command the tag at a time. The QDA also provides a single API to receive the positioning data.

The diagram below is of the basic system components and a simple network architecture. It is recommended to have only one QDA but the number of QPEs is not limited. Each QPE instance and associated Locators run within their assigned Locator network. IP addresses and subnet ranges can be freely configured by the network administrator, below addresses are only provided as examples. From each QPE, data is sent to QDA which then aggregates the data and exposes it through QDA API. All communication between QPEs and the QDA is based on standard TCP/IP. QPEs also connect to the Quuppa Customer Portal (QCP) for license/subscription validation for which purpose Internet connection is needed. The QDA does not require connection to QCP. Furthermore, the QDA does not require a license, it is enough that the QPEs are running a valid license/subscription.

The QDA can be run on multiple operating systems and web server software. Our preferred operating system and web server software are Ubuntu and Tomcat, respectively, as we are using these ourselves and can support them. For the best system performance, we recommend to have all QPEs and QDA on separate servers. QDA features are only available with QSP and QPE version 5.3 or later. It is recommended to use the same software version of QSP, QPE and QDA.