Update the QPE Software

Always updating your system to run the latest Quuppa software release ensures that you get the best system performance and access to the newest features and bug fixes. This instruction will walk you through updating the Quuppa Positioning Engine (QPE) software.

Note: The Quuppa software products are tested and verified on Ubuntu and Quuppa recommends the use of Ubuntu whenever possible.
  1. Log in to the Quuppa Customer Portal and navigate to the Downloads section.
  2. Download the QuuppaReleasePackage-xxx-ServerAndApps.zip package.
    Note: To ensure that you do not miss any updates, we recommend that you enable email notifications for the latest release package in the Quuppa Customer Portal. This can be done by clicking the Disabled, click to enable link in the Email notifications column.
  3. Extract the package into a folder on your computer (for example the Downloads folder).
  4. Open terminal window using the shortcut ctrl + alt + t.
  5. Stop Tomcat by issuing following command in the terminal window: 
    sudo service tomcat9 stop
    Note: If you are using Tomcat 8, make sure to edit the command for the right Tomcat version.
  6. Delete the old qpe.war and qpe folder: 
    sudo rm -rf /var/lib/tomcat9/webapps/qpe*
  7. Copy the file qpe-web-[xxx].war from the folder where you extracted the QuuppaReleasePackage-xxx-ServerAndApps.zip package to the directory /var/lib/tomcat9/webapps/ and rename to qpe.war.

    For example, if you have saved the zip file in your Downloads folder and extracted there into the QuuppaServerAndApps folder, you can apply command:

    sudo cp /home/<your_user_name>/Downloads/QuuppaServerAndApps/<qpe-web-[xxx].war> /var/lib/tomcat9/webapps/qpe.war
  8. Start Tomcat: 
    sudo service tomcat9 start
  9. Open your browser, point it to http://localhost:8080/qpe and check that the QPE version has been updated.
  10. Refresh your browser's cache when viewing the tag tables or 2D/3D maps by pressing ctrl + F5.
    Tip: All output from Tomcat goes to /var/log/tomcat9/catalina.out (in addition to /var/lib/tomcat9/logs/catalina.out). If you are experiencing issues running the QPE, Quuppa Support may ask you to provide these files for remote troubleshooting (you may need to 'sudo' to access the folder). The command tail -f -n100 /var/log/tomcat9/catalina.out is useful for viewing log files as they update.
    Important: After updating your QPE to the latest version, please also update to the latest versions of the QSP and QDP software (available in the same QuuppaReleasePackage-xxx-ServerAndApps.zip package as the QPE software). For instructions on how to do this, please see the QSP User Manual. Once all three pieces of software have been updated, save the project with the new QSP version and then submit it to the Quuppa portal server. This ensures consistency between the project version, QSP and QPE.