Upgrading

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(Migrating databases)
(Updating your version of OpenSimulator)
(22 intermediate revisions by 10 users not shown)
Line 1: Line 1:
== Migrating between versions of OpenSim without changing database backends ==
+
{{Quicklinks}}
 +
<br />
  
Upgrading OpenSim so that your data stays intact is not too difficult. If you’re using MySQL or MSSQL as a backend database with standalone OpenSim then all you should have to do is copy over your bin/Regions xml files (and maybe your OpenSim.ini if you don’t want to re-enter your settings manually) to the new OpenSim version and start it.
+
= Updating your version of OpenSimulator =
  
If you're using grid mode then you will also need to copy the 5 xml files in the bin directory that govern the configuration of the UGAIM servers.
+
Upgrading your version of OpenSimulator involves 2 major steps
  
Note that estate_settings.xml if present is used for default values for estates, but the saved settting themselves are in the data base "estate_settings" tables (since r5525).
+
1. Updating your existing data for the new version of OpenSimulator.
  
OpenSim contains code to automatically migrate all your data to conform to the newest formats. However, we would always suggest backing up your database beforehand in case something goes wrong during the conversion (e.g. you have a power cut).
+
2. Updating the config files for the new [[0.9.0.0_Release#Pivot_Release:_0.8.2.1]]version of OpenSimulator.
  
Using sqlite (the default on disk database) is just a little more complicated. As well as copying bin/Regions and possibly OpenSim.ini, you also need to copy all the db files (AssetStorage.db, inventorystore.db, OpenSim.db and userprofile.db) to your new installation.
+
NOTE: If you are upgrading from a version of OpenSimulator prior to 0.8.2.1, then you MUST first upgrade to *0.8.2.1* and then proceed to upgrade to 0.9.0.0. Full details can be found in the wiki page found at:<br /> http://opensimulator.org/wiki/0.9.0.0_Release#Pivot_Release:_0.8.2.1
  
This process should always work between the last numbered versions (e.g. going from 0.5.9 to 0.6.0).  It may also work for older versions (e.g. 0.5.8 to 0.6.0) though this is not guaranteed.
+
== Updating your existing data ==
  
 +
The first step is very easy.  OpenSimulator has a data migration system which will automatically update your old database schema and data for use with the new version of OpenSimulator.  This will be valid for many past versions of OpenSimulator (currently all the way back to OpenSimulator 0.6.9 and quite possibly before).
 +
 +
Naturally, we very strongly recommend that you make a backup of your old database first, but the upgrade process almost always occurs without a hitch.  However, one could always suffer a power cut or other major computer failure during the ugprade.
 +
 +
[edit]
 +
If you're using SQLite, then you will also need to copy over the database files since these are in the OpenSimulator bin directory.  These will be all the files ending with .db (e.g. Asset.db, inventory.db).
 +
 +
Performing this upgrade means configuring your new OpenSimulator version to access your existing database.  This brings us onto the next step.
 +
 +
== Updating your config files ==
 +
 +
This step is a little more involved.  We don't recommend that you simply copy over your existing config files to the new OpenSimulator installation.  Although this will often work, sometimes it's quite possible to miss new configuration settings which end up causing subtle and unexplained problems.
 +
 +
Instead, we strongly recommend that you look through the new config files and copy over the settings that apply to both the new and old config.
 +
 +
This applies to both the main configuration files (e.g. OpenSim.ini and config-include/*.ini) and any region configuration files.
 +
 +
SEE Discussion at [[Talk:Upgrading]] for examples of How-To Back Up & Restore your system PRIOR to ANY Migration or Upgrade!
 +
 +
== Examples ==
  
 
  '''METHOD 1: If Using SQLite in StandAlone Mode'''
 
  '''METHOD 1: If Using SQLite in StandAlone Mode'''
Line 23: Line 44:
 
     - All *.db files
 
     - All *.db files
 
     - The opensim.ini file
 
     - The opensim.ini file
     - The \bin\regions XML files
+
 
     - estate_settings.xml (if it has been amended)
+
4. Look through the following configuration files and copy over your changed settings.
 +
    - The opensim.ini file
 +
     - The bin/config-include INI files
 +
    - The bin/Regions XML files
 +
     - The bin/estate_settings.xml (if it has been amended)
 
   
 
   
  4. Launch the new opensim.exe
+
  5. Launch the new opensim.exe
  
 
  '''METHOD 2: If Using MySQL in StandAlone Mode'''
 
  '''METHOD 2: If Using MySQL in StandAlone Mode'''
Line 33: Line 58:
 
   
 
   
 
  2. Put this new installation in a new folder
 
  2. Put this new installation in a new folder
+
 
  3. Copy the following files from the old \bin to the new \bin
+
  3. Look through the following configuration files and copy over your changed settings.
 
     - The opensim.ini file
 
     - The opensim.ini file
     - The \bin\regions XML files
+
     - The bin/Regions XML files
     - estate_settings.xml (if it has been amended)
+
     - The bin/config-include INI files
 +
    - The bin/estate_settings.xml (if it has been amended)
 
   
 
   
 
  4. Launch the new opensim.exe
 
  4. Launch the new opensim.exe
  
'''METHOD 3: If Using MySQL in Grid Mode'''
+
TODO: Need to write example/instructions for migrating ROBUSTThis is actually a lot simpler - one just needs to copy over settings in Robust.ini as appropriate.
+
1. Build the latest version from source (or download the binaries)
+
   
+
2. Put this new installation in a new folder
+
+
3. Copy the following files from the old \bin to the new \bin
+
    - The opensim.ini file
+
    - The \bin\regions XML files
+
    - The 5 XML config files
+
    - estate_settings.xml (if it has been amended)
+
+
4. Launch services in the following order: UGAIM + R where "R" designates the region server (Opensim)
+
  
== Migrating databases ==
+
= Changing the database used by OpenSimulator =
  
Since SQLite is our default database, there often comes a time when people outgrow it and want to move on to another database backend (usually MySQL). There is a script on the forge at [http://forge.opensimulator.org/gf/project/sqlite2mysql/] which should be able to do the conversion.  If it's out of date then just give the author/s a nudge (or patch it!)
+
Since SQLite is our default database, there often comes a time when people outgrow it and want to move on to another database backend (usually MySQL).
  
An alternative method is to change to each region (change-region)before backing up to a separate filesave out OpenSim region archives (OARs) for each of your regions, change the database backend and then reload them. The disadvantage of this is that it's a little laborious if you have many regions, and your inventory will not be migrated (you would need to rez everything out to the region, convert, and then derez them again to your inventory).
+
An alternative method is to change to each region (change-region) before backing up their contents to a separate OpenSimulator Region Archive (OAR) for each region. Then change the database backend and then reload the OARs in each region separately. The disadvantage of this is that it's a little laborious if you have many regions.
  
You can use the "command-script" feature of OpenSim.exe to semi-automate this. For example:
+
You can use the "command-script" feature of OpenSim.exe to semi-automate this. E.g., create a file in your "bin" directory, called something like "dobackup", which contains the necessary commands, for example:
 
+
Create a file in your "bin" directory, called something like "dobackup", which contains the necessary commands, for example:
+
  
 
  change-region My Island 1
 
  change-region My Island 1
Line 73: Line 85:
 
  change-region root
 
  change-region root
  
This can be run from OpenSim.exe by typing "command-script" followed by the name you gave the script (eg "dobackup"). Note that this will overwrite the previous backup of the same name.
+
This can be run from OpenSim.exe by typing "command-script" followed by the name you gave the script (eg "dobackup"). Note that this will overwrite the previous backup of the same name.
 +
 
 +
Note that using a save and reload via the OAR mechanism would not normally migrate your avatar inventories (you would need to rez everything out to the region, convert the data base, and then derez them again to your inventory).
 +
 
 +
= Related =
 +
 
 +
[[Upgrade_Ubuntu_Standalone]] - OpenSimulator Upgrade notes for Ubuntu 8.10

Revision as of 07:58, 11 October 2021


Contents

Updating your version of OpenSimulator

Upgrading your version of OpenSimulator involves 2 major steps

1. Updating your existing data for the new version of OpenSimulator.

2. Updating the config files for the new 0.9.0.0_Release#Pivot_Release:_0.8.2.1version of OpenSimulator.

NOTE: If you are upgrading from a version of OpenSimulator prior to 0.8.2.1, then you MUST first upgrade to *0.8.2.1* and then proceed to upgrade to 0.9.0.0. Full details can be found in the wiki page found at:
http://opensimulator.org/wiki/0.9.0.0_Release#Pivot_Release:_0.8.2.1

Updating your existing data

The first step is very easy. OpenSimulator has a data migration system which will automatically update your old database schema and data for use with the new version of OpenSimulator. This will be valid for many past versions of OpenSimulator (currently all the way back to OpenSimulator 0.6.9 and quite possibly before).

Naturally, we very strongly recommend that you make a backup of your old database first, but the upgrade process almost always occurs without a hitch. However, one could always suffer a power cut or other major computer failure during the ugprade.

[edit] If you're using SQLite, then you will also need to copy over the database files since these are in the OpenSimulator bin directory. These will be all the files ending with .db (e.g. Asset.db, inventory.db).

Performing this upgrade means configuring your new OpenSimulator version to access your existing database. This brings us onto the next step.

Updating your config files

This step is a little more involved. We don't recommend that you simply copy over your existing config files to the new OpenSimulator installation. Although this will often work, sometimes it's quite possible to miss new configuration settings which end up causing subtle and unexplained problems.

Instead, we strongly recommend that you look through the new config files and copy over the settings that apply to both the new and old config.

This applies to both the main configuration files (e.g. OpenSim.ini and config-include/*.ini) and any region configuration files.

SEE Discussion at Talk:Upgrading for examples of How-To Back Up & Restore your system PRIOR to ANY Migration or Upgrade!

Examples

METHOD 1: If Using SQLite in StandAlone Mode

1. Build the latest version from source (or download the binaries)

2. Put this new installation in a new folder

3. Copy the following files from the old \bin to the new \bin
   - All *.db files
   - The opensim.ini file
4. Look through the following configuration files and copy over your changed settings.
   - The opensim.ini file
   - The bin/config-include INI files
   - The bin/Regions XML files
   - The bin/estate_settings.xml (if it has been amended)

5. Launch the new opensim.exe
METHOD 2: If Using MySQL in StandAlone Mode

1. Build the latest version from source (or download the binaries)

2. Put this new installation in a new folder
3. Look through the following configuration files and copy over your changed settings.
   - The opensim.ini file
   - The bin/Regions XML files
   - The bin/config-include INI files
   - The bin/estate_settings.xml (if it has been amended)

4. Launch the new opensim.exe

TODO: Need to write example/instructions for migrating ROBUST. This is actually a lot simpler - one just needs to copy over settings in Robust.ini as appropriate.

Changing the database used by OpenSimulator

Since SQLite is our default database, there often comes a time when people outgrow it and want to move on to another database backend (usually MySQL).

An alternative method is to change to each region (change-region) before backing up their contents to a separate OpenSimulator Region Archive (OAR) for each region. Then change the database backend and then reload the OARs in each region separately. The disadvantage of this is that it's a little laborious if you have many regions.

You can use the "command-script" feature of OpenSim.exe to semi-automate this. E.g., create a file in your "bin" directory, called something like "dobackup", which contains the necessary commands, for example:

change-region My Island 1
save-oar MI1
change-region My Island 2
save-oar MI2
change-region Another Region
save-oar AR
change-region root

This can be run from OpenSim.exe by typing "command-script" followed by the name you gave the script (eg "dobackup"). Note that this will overwrite the previous backup of the same name.

Note that using a save and reload via the OAR mechanism would not normally migrate your avatar inventories (you would need to rez everything out to the region, convert the data base, and then derez them again to your inventory).

Related

Upgrade_Ubuntu_Standalone - OpenSimulator Upgrade notes for Ubuntu 8.10

Personal tools
General
About This Wiki