Say you already have an AR Sandbox that’s humming along like a well-tuned Swiss watch, but you want to update to new software versions to get the yummy new features. How do you do that without having to start over from scratch?
In the worst case (as in when moving from SARndbox-1.5-001 to SARndbox-1.6), you have to update three software packages: Vrui, Kinect, and SARndbox itself.
Of those three, Vrui and Kinect can be updated in-place without any data loss, and SARndbox will install into a new directory, and you can copy over your settings. Still, start by backing up everything, just in case:
$ cd ~
$ tar cfz Vrui-3.1-old.tar.gz Vrui-3.1/
$ cd src
$ tar cfz SARndbox-old.tar.gz SARndbox-<current version number>/
(I’m assuming default installation locations throughout.)
This creates two tarballs (Vrui-3.1-old.tar.gz and SARndbox-old.tar.gz), which you keep in a safe place.
To update Vrui from any 3.1 version to 3.1-004:
$ cd ~/src
$ wget -O - http://idav.ucdavis.edu/~okreylos/ResDev/Vrui/Vrui-3.1-004.tar.gz | tar xfz -
This downloads and unpacks Vrui-3.1-004, into a new directory ~/src/Vrui-3.1-004.
$ cd ~/src/Vrui-3.1-004
$ time make -j8
$ make install
This installs the new Vrui over the previous 3.1 installation in ~/Vrui-3.1, but retaining all custom configuration files.
Then download, unpack, make, and install Kinect-2.8-002, if you don’t already have it:
$ cd ~/src
$ wget -O - http://idav.ucdavis.edu/~okreylos/ResDev/Kinect/Kinect-2.8-002.tar.gz | tar xfz -
$ cd Kinect-2.8-002
$ time make -j8
$ make install
If you do already have Kinect-2.8-002, clean it out and re-make instead of downloading again:
$ cd ~/src/Kinect-2.8-002
$ make squeakyclean
$ time make -j8
$ make install
Then download, unpack, and make SARndbox-1.6:
$ cd ~/src
$ wget -O - http://idav.ucdavis.edu/~okreylos/ResDev/SARndbox/SARndbox-1.6.tar.gz | tar xfz -
$ cd SARndbox-1.6
$ time make -j8
Finally, copy over your old configuration:
$ cp ~/src/SARndbox-<previous version>/etc/SARndbox-<previous version>/* etc/SARndbox-1.6
$ cp ~/src/SARndbox-<previous version>/share/SARndbox-<previous version>/* share/SARndbox-1.6
Then you run SARndbox as before, and everything should look exactly as before. If not, time to unpack those backups.
noopara.
