Updating Your Grid

From Open Metaverse Wiki

Opensimulator: Grid Owners: Updating Your Grid

Updating to a New Version of Opensim

The developers are always fixing bugs and adding features, and you might want to update to it. This can be done by using 'git pull' to update your copy of the sources. If git finds no updates, you don't have to proceed with the building and installing.

   cd ~/Source/OpenSim-Sasquatch/
   git pull
   dotnet clean
   dotnet build --configuration Release

Update and Restart all the Regions

Then go update the bin directories in all regions. Usually you can update the regions one at a time without needing to update Robust to match. Changing one or two regions gives you an opportunity to test the new version before you run it everywhere. Here's how to update one region:

   cd ~/Grid/Regions/Welcome
   mv bin oldbin
   cp -r ~/Source/OpenSim-Sasquatch/build/Release bin
   cp oldbin/OpenSim.ini bin
   cd bin
   screen -r Welcome
   shutdown
   mono OpenSim.exe
   ^A^D

I always move the bin folder out of the way but keep it around in case I need to switch back.

Then I bring in a copy of the new bin folder from the recently built version.

Because all my OpenSim.ini files are identical I can copy any of them, or the one in the oldbin folder. All the region specific parameters are up one level in the file system, all the grid specific settings are up 3 levels of the file system.

Finally I re-attach to the screen currently running the region, shut that instance down and start up the new version.

Update and Restart Robust

Actually, you probably want to update Robust before you update all the regions. But is is possible to do this last, and to do it on a live system as long as you restart Robust quickly when nobody is looking. I would not do this on a very busy system, do it in the middle of the night when few avatars are visiting.

   cd ~Grid/Robust
   mv bin oldbin
   cp -r ~/Source/OpenSim-Sasquatch/build/Release bin
   cp oldbin/Robust.ini bin
   cd bin
   screen -r Robust
   shutdown
   mono Robust.exe
   ^A^D

Next: Managing an OpenSim Grid on the Bare Metal