Talk:Upgrading

ALWAYS Backup your system before Upgrading or Changing systems

Instructions for Backing up your data

backup = persists data on region to the database.

export save-all = exports everything for the regions into the bin\exports folder structure.

You will a structure as shown here bin\exports\12f345f0-1b23-12de-1a23-1234567c8a90 This is the UUID for the region and contains; heightmap.r32, objects.xml, objects.xml.gzs, README.TXT, region.manifest

Why so many forms ? The Simple Answer, is that it is more efficient & prudent to have all possible forms of backup available should you require them. It's like have a spare tire in your car, you may never need it but you just might and if you do, you'll be 100km from civilisation, not next to a service centre.

Single Region / Simulator

On your OpenSim Server Console, run the following commands;

backup export save-all terrain save RegionName.r32 save xml2 RegionName.xml save oar RegionName.tar.gz

Where RegionName = your descriptive name for your region. These commands can include a path as well, but the path MUST exist;

.NET Example (Windows) terrain save c:\Backup\TERRAINS\RegionName.r32 save xml2 c:\Backup\XML2\RegionName.xml save oar c:\Backup\OAR\RegionName.tar.gz

Linux Example terrain save /opt/Backups/TERRAINS/RegionName.r32 save xml2 /opt/Backups/XML2/RegionName.xml save oar /opt/Backups/OARS/RegionName.tar.gz

Multi-Region / Simulators

(examples are pathed to folders)

.NET Example (Windows) change region root backup export save-all change region Region1 terrain save c:\Backup\Backup\TERRAINS\Region1.r32 save xml2 c:\Backup\XML2\Region1.xml save oar c:\Backup\OAR\Region1.tar.gz change region Region2 terrain save c:\Backup\TERRAINS\Region2.r32 save xml2 c:\Backup\XML2\Region2.xml save oar c:\Backup\OAR\Region2.tar.gz

Linux Example change region root backup export save-all change region Region1 terrain save /opt/Backups/TERRAINS/Region1.r32 save xml2 /opt/Backups/XML2/Region1.xml save oar /opt/Backups/OARS/Region1.tar.gz change region Region2 terrain save /opt/Backups/TERRAINS/Region1.r32 save xml2 /opt/Backups/XML2/Region1.xml save oar /opt/Backups/OARS/Region1.tar.gz

RESTORING The Data if Needed

NOTE: the xml2 is commented out as the terrain & oar file will restore all data and terrain. should the oar file have an error, the XML2 can be used to restore the regions contents

.NET Example (Windows) change region Region1 terrain load c:\Backup\TERRAINS\Region1.r32 load oar c:\Backup\OAR\Region1.tar.gz ; load xml2 c:\Backup\XML2\Region1.xml ; change region Region2 terrain load c:\OSGrid\Backup\TERRAINS\Region2.r32 load oar c:\OSGrid\Backup\OAR\Region2.tar.gz ; load xml2  c:\OSGrid\Backup\XML2\Region2.xml

Linux Example change region Region1 terrain load /opt/Backups/Region1.r32 load oar /opt/Backups/OAR\Region1.tar.gz ; load xml2 /opt/Backups/XML2\Region1.xml ; change region Region2 terrain load /opt/Backups/TERRAINS\Region2.r32 load oar /opt/Backups/OAR\Region2.tar.gz ; load xml2  /opt/Backups/XML2\Region2.xml

Extended Discussion and more examples and working automated backup / restore system posted on the Forum at OSGrid: "HOW-TO: Backup & Restore OpenSim Server"