Updating an Existing AR Sandbox

Home Forums AR Sandbox Forum Updating an Existing AR Sandbox

This topic contains 5 replies, has 4 voices, and was last updated by  Oliver Kreylos 9 months ago.

Viewing 6 posts - 1 through 6 (of 6 total)
  • Author
    Posts
  • #101507

    Oliver Kreylos
    Moderator

    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.

    #101569

    INTPTT
    Participant

    Thanks Oliver! Jensen (on the forum here) performed our update today. Appears to be working great! Also able to map the pause topo better than the script we had previously. Now to find the best way to script the GUI changes for the water flow/viscosity… need to change it with the different shaders for the full effect! (I’d love to pause the flow when changing to ice or make the snow fall off instead of flow, for example.)

    Appreciate all the work you continue to do with this forum and the software. I can say for certain you’ve made hundreds of kids super happy up in this neck of the woods, and every adult pretty much says some form of “Oh that’s really cool!”

    You should setup a donation box of some kind (PayPal or whatever.) Never know…

    #102429

    ndscs.lscet
    Participant

    Is this the same process for upgrading to 2.2? I followed the instructions and when I run 2.2 there is no elevation colors and the water simulation doesn’t work, any ideas?

    #102485

    Oliver Kreylos
    Moderator

    Add -uhm (“use height map”) to the command line to enable color mapping. This should also enable rain, but if it doesn’t, explicitly specify a rain elevation range via -rer , for example, -rer 20 100.

    #102712

    techsupport
    Participant

    hi Oliver, how can I update from SARndbox-2.2 to 2.3, can you please describe the procedure? is it this one?

    $ cd ~/src
    $ wget -O – http://idav.ucdavis.edu/~okreylos/ResDev/SARndbox/SARndbox-2.3.tar.gz | tar xfz –
    $ cd SARndbox-2.3
    $ time make -j8
    Finally, copy over your old configuration:

    $ cp ~/src/SARndbox-<previous version>/etc/SARndbox-2.2/* etc/SARndbox-2.3
    $ cp ~/src/SARndbox-<previous version>/share/SARndbox-2.2/* share/SARndbox-2.3

    #102721

    Oliver Kreylos
    Moderator

    Basically, yes. All your configuration stuff is in …/etc/SARndbox-<version>, so you only have to copy over the share directory if you put custom shaders in there, such as lava shaders. But if you did that, you need to copy the entire share hierarchy, not just the share/SARndbox-<previous version> directory itself:
    cp -R ~/src/SARndbox-<previous version>/share/SARndbox-<previous version> share/

Viewing 6 posts - 1 through 6 (of 6 total)

You must be logged in to reply to this topic.

Comments are closed.