Receive Simulator Data

The steps below will guide you through setting the Quuppa Positioning Engine (QPE) to run in simulator mode and viewing the simulator data through the QPE Web Console. For access to the latest features and bug fixes, please make sure that you have updated to the QPE to the latest available software release version.
Tip: The Simulator data is sent to port 22107, which needs to be open for the Simulator to work.
  1. Set the QPE to run in the simulation mode by adding the Java startup paramenter -DsimulatorMode.


    1. Open the terminal window.
    2. Open the file that defines the Java startup parameters by running the following:

      sudo nano /usr/share/tomcat9/bin/

      Note: This is the path for a typical Quuppa setup. If you have saved the parameters file somewhere else, open that file instead.
    3. Add the -DsimulatorMode parameter to the Java options line. E.g.:

      export JAVA_OPTS="-DsimulatorMode"

    4. Exit and save the file.
    5. Close the terminal window.


    1. Open the Configure Tomcat application.
    2. Open the Java tab.
    3. Add the -DsimulatorMode parameter to the Java Options.

    4. Click Apply and then start the Tomcat from the General tab before clicking OK.
  2. Open the QPE Web Console. If the QPE is in the simulation mode, you will see a message indicating this at the top of the Web Console.

  3. Check Platform Data Rates to confirm that the QPE is receiving positioning packets.

  4. Open the Map View from the link in the top left corner of the Positioning Engine Web Console and see your simulated tags moving.

    Tip: If you need to make edits to the project after you have started the QSS, just stop the QPE from the Web Console, make the needed adjustments in the QSP and start the QSS again.