Checking for Software Update

In most cases, the Oculus Prime Server control software can be updated via the remote web browser interface. To check for updated software, go to:

MENU > server > check for software update

Click ‘OK’ to download the new package, and ‘OK’ again to restart with the new version. (The system downloads the update from xaxxon.com/oculusprime/download, and will run a script to update the ROS packages from git if required)

If this doesn’t work, the package can be manually updated via the instructions below.

Manual Update

Manually updating the software requires deleting the old package and downloading the new one. Before deleting the old package, you’ll want to backup your system configuration and calibration settings.

BACKUP EXISTING CONFIGURATION:
Connect to Oculus Prime via ssh and enter

$ cp ~/oculusPrime/conf/oculus_settings.txt ~/Desktop/

Modify the path to 'oculusPrime/’ as necessary (and target path if Desktop doesn’t suit you).

If you have navigation waypoints and routes set up, you can back those up by doing:

$ cp ~/oculusPrime/conf/waypoints.txt ~/Desktop/
$ cp ~/oculusPrime/conf/navigationroutes.xml ~/Desktop/

Save navigation log information by copying the log folder:

$ cp -r ~/oculusPrime/webapps/oculusPrime/navigationlog ~/Desktop/

If you have any framegrabs, streams, or rss entries saved, back those up as well by doing:

$ cp -r ~/oculusPrime/webapps/oculusPrime/framegrabs ~/Desktop/
$ cp -r ~/oculusPrime/webapps/oculusPrime/streams ~/Desktop/
cp ~/oculusPrime/webapps/oculusPrime/rss.xml ~/Desktop/

DELETE THE OLD PACKAGE:
Now its safe to delete the old package:

$ rm -rf ~/oculusPrime

DOWNLOAD THE NEW PACKAGE:
Download the new Oculus Prime Server package from Oculus Prime Downloads. When you unpack it, you’ll get the ‘oculusPrime’ folder.

Move the files and folders you backed up into their previous locations.

UPGRADE OS AND DEPENDENCIES:
Make sure you’ve upgraded any required libraries. Do:

$ sudo apt update && sudo apt upgrade

UPDATE ROS:
Finally, make sure you’re running the latest Oculus Prime ROS package. See upgrading instructions here

NEXT: Auto Navigation and Patrol Routes