Transfered from OSG Upgrading Info release @ Migration Time & updated to current paths etc.

Upgrade procedure for upgrading your simulators to OpenSimulator v0.7 on OSgrid

Step 1: Backups

It is vital that you do complete database backups before beginning the upgrade procedure, OSgrid will not be held responsible if you decide to skip this step and things go wrong. For SqlLite users you just need to make a copy of your OpenSim.db file in /bin folder. Just copy and paste this file to a safe location before beginning upgrade process.
For MySql users you should be performing a SQL dump of your database, see this site for some basic SQL dump commands:

http://www.patrickpatoray.com/index.php?Page=30

mysqldump example from command line :

mysqldump -u username -p --databases DB_NAME > /PATH/TO/DUMPFILE.SQL


Step 2: Downloading and Extracting

This step is exactly the same as you have done in the past, with the exception of the location of where you are downloading from
http://download.osgrid.org/?dir=&sort_b ... ort_as=asc for Most Recent OSG BINARY ZIP (works on Windows, Linux & Mac)

OR:
If downloading from the OpenSimulator GIT repo, just note that if you are downloading from GIT or using the source zips provided at http://download.osgrid.org/ and compiling yourself you will have to download some extra files that you did not previously have to download in v0.6.x of OpenSimulator.

Once you have downloaded unzip the release as you have done in the past up to this point the upgrade procedure is the same as in the past.

! NOTE !
DO NOT put the new OpenSim Software OVER (on top of) your existing BIN Directory.
Rename your 069 Bin to bin_old and place the new Binary in BIN.
NEVER EVER Install OpenSim on top of an existing installations.

Step 3: Additional Downloads for self compile (Skip this step if your using the OSgrid Binary Release)

For those of you who are compiling OpenSimulator yourself there are some additional files you need to add to your /bin folder you can download below:

1. osprofile module to enable user profiles (required) @ http://download.osgrid.org/OpenSimProfile.Modules.dll

2. ossearch module to enable grid searches (required) @ http://download.osgrid.org/OpenSimSearch.Modules.dll

3. Startup Commands to precache region data (optional) @ http://download.osgrid.org/startup_commands.txt

Place all of these files into your OpenSim /bin directory where OpenSim.exe resides.


Step 4: INI Upgrades

Upgrading your .ini files, be sure to check the new OpenSim.ini example: @ http://download.osgrid.org/OpenSim.ini.txt) and GridCommon.ini (example: HTTP://download.osgrid.org/GridCommon.ini.txt)

You will need to transpose some of the data from your old .ini files such as your http_listener_port = ports & custom Settings.
Database connections are setup now in bin\config-include\GridCommon.ini SqLite & MySql. (SqLite is Default)
MySql Connection Strings:
07x) ConnectionString = "Data Source=localhost;Database=opensim;User ID=opensim;Password=***;"
069) storage_connection_string = "Data Source=localhost;Database=opensim;User ID=opensim;Password=***;"
Do not try to use your old .ini files for the upgrade procedure, They are not the same in 0.7.x as they were in 0.6.9


Step 5: Running OpenSim

After everything above is done, you are going to run OpenSim for the 1st time ie:

x86 Windows (32 bit): OpenSim.exe
x64 Windows (64 bit): OpenSim.32BitLaunch.exe
x86/64 Linux : mono OpenSim.exe
OSX : mono OpenSim.exe

You will see the Migration on database running, be sure to pay attention to your console during this phase, if you see any errors please be sure to record them so you can report the issue or use it to compare to the trouble shooting section below for possible solutions.
If you see the migration complete without error and your sim gets to [Startup Complete] then It will ask you to enter the Following Information:

Do you wish to join an existing estate? [no]: Press Enter
Estate name to join [None]: ENTER your EstateName *NB
Estate owner first name [Test]: ENTER your Avatars FirstName
Estate owner last name [User]: ENTER your Avatars LastName

*NB Use no Special Characters
This will have to be repeated for every region in the Region.ini. (Tedious, Yes, but you have to do it)Once completed it should not ask you again.

Congratulations you are now done the 0.7 upgrade procedure, you can log into your sim or proceed onto your next simulator upgrade if your running multiple simulators, just rinse and
repeat until your done .

If you did experience any errors see Step 6 for troubleshooting procedures.

Step 6: Troubleshooting.

Problem A : MySql has timed out during migration
Solution A: This means you have ignored Step 3 subsection 4. Please restore your backup and start over following the directions this time.

Problem B : MySql Migration errored about Lightshare Tables and spewed errors.
Solution B: If this happens you will need to download (http://download.osgrid.org/regionwindlight.sql) and run this table upgrade sql yourself ie :

MySql -u username -p DB_NAME < /PATH/TO/regionwindlight.sql

Problem C: I get a masses of "Caught exception processing byte arrays in SculptMap()" errors on console
Solution C: When you are sure the sim has loaded restart your sim you may need to close the console or end task on the process, this problem
should only happen on the initial startup, then never again, or if you are using phpMyAdmin you can also import this sql file to the proper database that way as well.

Problem D: My simulator crashes on 1st start with following error :
[MODULES]: Could not load types for [OpenSim.Data.Tests, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null].
Solution D: Get the Latest OSG Binary Package from the Links Above in Step-2

If you get stuck on any of these solutions or steps above please join us on our IRC channel #osgrid at irc.freenode.net for more help @ http://www.osgrid.org/index.php/freenode

Good Luck everyone!

Hi,

We have been trying for quite some time to upgrade, however we get stuck in this phase. It does not accept our owner name. Please help.

I upgraded using the instructions above and I want to turn off avatar account authentication on my standalone Ubuntu 10.10 server running MySQL. I do not see where I can do this in any of the INI files. Any suggestions?

Thanks in advance,

Robert

Robert,
I am told that this option is no longer available, but I have found what seems to be where it appears,
have a look in config-include>Standalone.ini (not to be confused with StandaloneCommon.ini)
this file is not meant to be changed but the authentication dll seems to be enabled here,

there is 3 places it appears here [Modules], [AuthenticationService], and [UserAccountService]
I have tried various combinations here but it doesnt seem to work for me,

If you get it working somehow please post your findings somewhere in this forum, maybe not here because this isnt exactly the right place for this discussion, I suggest you start a new topic under technical Support or OpenSim Software.
Regards
Cam