Use the Offline Module for Generation Q Locators

The Offline Module is an optional module for Generation Q Locator subscriptions, which allows the Quuppa Positioning Engine (QPE) to run a project completely offline. The feature has been developed for situations where the Quuppa system cannot be connected to a network (e.g. for security reasons or in cases where the internet connection on site is unstable). To use the Offline Module for Generation Q Locators, you will need to have Generation Q Locators (i.e. Q17 or Q35) as well as the QPE release v7.0 or later.

Note: The Offline Module needs to be purchased separately and paid in advance. If the module has not been enabled in advance, the QPE will stop running after 48 hours offline without a connection to the Quuppa Customer Portal as it is unable to verify license details or perform a file sync. Without the Offline module enabled, the QPE will check for updates every hour.

When the Offline Module is enabled, the QPE will continue to run even if the Quuppa Customer Portal (QCP) has not established a connection with the QPE to perform a file sync for over 48 hours. The module also makes it possible to store the project file locally without submitting it to the QCP. However, please note that this will limit Quuppa’s ability to help you troubleshoot the project in the future.

Start implementing your offline project by following the steps below:

  1. Create a project in the Quuppa Site Planner (QSP) using only Generation Q Locators with subscriptions that have a valid Offline Module and save the project file in the QPE’s project folder (defined in the QPE configuration as -Dproject.folder) With the Offline Module, you can choose whether or not to also save the project file in the QCP.
    Note: You can check the QPE’s project folder from the Working Directory row in the QPE Web Console. Please note that only one .quuppaproject file can be stored in this folder at a time.
    Warning: Please remember that you are responsible for backing up the project files and ensuring that you are always using the latest version of the file.
  2. Physically install and deploy the system. For more information about deploying your Quuppa system, please see our Quuppa Development Kit Quick Start Guide.
  3. Log in to the QCP.
  4. Open the Subscriptions list from the main Dashboard.
  5. Select the relevant subscription by clicking on the subscription ID. This will open the Subscription Details page.
  6. Check that the Offline Module has been enabled.

    Note: Locators under different subscriptions can be used together in the same offline project as long as all of the subscriptions have the Offline Module enabled. Please check the Subscription details page for each subscription that you want to use in this project. However, it is important to remember that if the subscription types differ, the QPE will run according to the lowest subscription type included in the project.
  7. Check that the subscription has been activated. If not, activate it by clicking the Activate Subscription button.

  8. Generate a project key by clicking the Create Project Key associated to this Subscription button.

    The Project Key details page will open.

  9. Click the Associate Locators for offline use button to add Locators.

  10. Add all of the Generation Q Locators that will be used in the project to the project key manually by entering their ID numbers into the provided field. You can get the list of Locators from the Locator table in the QSP.

    Warning: All of the Locators must be Generation Q Locators with subscriptions that have valid Offline Modules. Do not add any other Locators (e.g. LD Generation Locators) to the project file in the QSP or to the project key in the QCP as they will not work in the offline project.

    Also, remember to add all of the Locators to the project key field every time you add new Locators to the project as inserting new data into this field will overwrite previously saved data.

    Note: If the Locators have not previously been associated with a subscription in the QCP, adding them to the project key will automatically associate them to the subscription linked to this project key.
  11. Once the Locators are added to the project key and the subscription is activated, you can download the license file, license signature and the sync file from QCP by clicking the Download files button on the Project Key Details page. The button will only be available if the subscription has been activated, return to step 4 if it's not available. If you have submitted the latest project file to the QCP, the downloaded files will also include the project file and the project signature.
    Note: Make sure that you have deployed all of the Locators successfully before downloading this file.
  12. Unzip the downloaded files and transfer them to the offline QPE's project folder (defined in the QPE configuration as -Dproject.folder) e.g. using a memory stick. Please also make sure that the latest version of the project file is in the same folder.
  13. In the QPE Web Console, click the Start in tracking mode button to start running the project offline.