Talk:Upgrading

Latest revision as of 10:53, 15 February 2022

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