Installing Updates
The following page details the steps to update the OutdoorNav software that is already installed on your platform.
Please ensure that you have received an email advising you that an update is available since only those who receive the update emails will be have access to the update files.
Download
-
Click the link that was sent to you in the update email. You will be sent to a cloud storage drive with the following file structure (/Documents/General/Releases/...)
-
Navigate to the version folder you wish to update to and download the following files:
-
cpr-onav-ui.tar
-
cpr-onav-base.tar
-
cpr-onav-autonomy.tar
-
cpr-onav-app.zip
-
-
Connect to the robot
Option 1: via ethernet (port located inside of the rear charge port door)
Option 2: via wifi (Husky SSID: cpr_a300_amp_xxx)
-
Transfer all files to the robots /opt/onav/ folder
Linux:
scp cpr-onav-app.zip cpr-onav-ui.tar cpr-onav-base.tar cpr-onav-autonomy.tar robot@192.168.131.1:/opt/onav/Windows: Use FileZilla Client to transfer all files to the robot.
SFTP Connection:
-
Host: sftp://192.168.131.1
-
Username: robot
-
Password: clearpath
-
Update
-
Run the below command to update the version of OutdoorNav, where <latest_version> is the folder of the last version of OutdoorNav that has been installed on the robot and <new_version> is the version you want to update to.
python3 /opt/onav/<latest_version>/app/update/update.py -v <new_version>Eg. To update from version 2.1.0 to version 2.2.0 run the following
python3 /opt/onav/2.1.0/app/update/update.py -v 2.2.0-
this will create a new version folder in /opt/onav/
-
copy all persistent data from the last version
-
installs the app folder
-
stops the currently running version of OutdoorNav
-
starts the new version of OutdoorNav
-
Cleanup
-
Remove all extraneous files
rm /opt/onav/cpr-onav-ui.tar /opt/onav/cpr-onav-base.tar /opt/onav/cpr-onav-autonomy.tar /opt/onav/cpr-onav-app.zip
If you have made any customization changes to the app/ directory of your previous version, you will need to make these same modifications manually yourself to the new versions app/ directory files.