Setting Up Mega-Regions

Revision as of 10:20, 27 November 2009

This article or section needs more examples
While the information on this page may be good, it is complex information that needs examples to make it user friendly. Please consider writing some examples of usage for this page.

This article or section contains incomplete information.
Please help us by completing the content on this page.

There are still some outstanding issues being addressed by the Dev team. If you wish to incvorporate your eisting regions into a MegaRegion, make OARS and do Full Backups of everything on the current regions. Restoring OAR will deposit the restored region on the most South West Corner ONLY. This is being worked out at the time of this writting. (more information needs to be put in this area...)

Here is a Diagram of Possible Configurations. This is not all inclusive but is a good example of layout for the regions.

Step 1:

FRESH Installation:

This assumes you have a NEW OpenSim installation with a Clean (empty) Database.
Modify the OpenSim.ini and change CombineContiguousRegions=false to CombineContiguousRegions=true. This is located at the top of the OpenSim.ini under the ## REGIONS Section.
Proceed to Step 2 and make sure that your bin\regions\RegionConfig.ini is configured according to the specification for MegaRegion
Start your OpenSim Instance & there you have it.

EXISTING Regions Being Converted:

Warning! If your regions have existing content, joining them may be dangerous -- you risk losing content.
Please follow the following steps if your regions have content:
Make a backup of your database!
Make an OAR for EACH REGION which you intend integrate into a Mega-Region. In Console Type the following commands (Highlighted in BOLD): change region RegionName next save oar RegionName.tar.gz NB: save oar can be pathed to another directory such as save oar c:\mybackups\RegionName.tar.gz
Set "CombineContiguousRegions=true", in OpenSim.ini.
Verify your bin\regions\RegionConfig.ini is configured according to the specification for MegaRegion as shown in Step 2
start Opensim. You'll see a lot of error messages -- ignore them.
Wait till Console Activity Stops, then in Console Type: fix-phantoms
Wait till this process completes, it can take several minutes for the backup thread to store everything
When the Console Activity Stops, then in Console Type: backup (This will persist the data into the Database again as a precaution)
Restart Opensim, and check that all the objects are in their right places.
This has worked for me (Zonja) - your mileage may vary.
Please refer to this post from Diva for more information

Step 2: bin\regions\RegionConfig.ini

The Example Provided here is for a 3x3, 9 Simulator Mega-Region. Ensure that you fill in the Correct Information in all the required fields. Order your regions from South-West to North-East in your bin\regions\RegionsConfig.ini

; 9 Simulator 3x3 Mega-Region Example
; Supply a unique UUID for each region
; Unique InternalPort for Each Region
; Ensure you put your MasterAvatar UUID 
; 
;************************************************
[RegionName_SW]
RegionUUID = "00000000-0000-0000-0000-000000000000"
Location = "5000,5000"
InternalAddress = "0.0.0.0"
InternalPort = 9001
AllowAlternatePorts = False
ExternalHostName = "YourIP_DNSname"
;
MasterAvatarUUID = "00000000-0000-0000-0000-000000000000"
MasterAvatarFirstName = "FirstName"
MasterAvatarLastName = "LastName"
;MasterAvatarSandboxPassword = ""
;
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
;
;ScopeID = "00000000-0000-0000-0000-000000000000"
;************************************************
[RegionName_W]
RegionUUID = "00000000-0000-0000-0000-000000000000"
Location = "5000,5001"
InternalAddress = "0.0.0.0"
InternalPort = 9002
AllowAlternatePorts = False
ExternalHostName = "YourIP_DNSname"
;
MasterAvatarUUID = "00000000-0000-0000-0000-000000000000"
MasterAvatarFirstName = "FirstName"
MasterAvatarLastName = "LastName"
;MasterAvatarSandboxPassword = ""
; 
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
; 
;ScopeID = "00000000-0000-0000-0000-000000000000"
;************************************************
[RegionName_NW]
RegionUUID = "00000000-0000-0000-0000-000000000000"
Location = "5000,5002"
InternalAddress = "0.0.0.0"
InternalPort = 9003
AllowAlternatePorts = False
ExternalHostName = "YourIP_DNSname"
; 
MasterAvatarUUID = "00000000-0000-0000-0000-000000000000"
MasterAvatarFirstName = "FirstName"
MasterAvatarLastName = "LastName"
;MasterAvatarSandboxPassword = ""
; 
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
; 
;ScopeID = "00000000-0000-0000-0000-000000000000"
;
;************************************************
;
[RegionName_S]
RegionUUID = "00000000-0000-0000-0000-000000000000"
Location = "5001,5000"
InternalAddress = "0.0.0.0"
InternalPort = 9004
AllowAlternatePorts = False
ExternalHostName = "YourIP_DNSname"
; 
MasterAvatarUUID = "00000000-0000-0000-0000-000000000000"
MasterAvatarFirstName = "FirstName"
MasterAvatarLastName = "LastName"
;MasterAvatarSandboxPassword = ""
; 
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
; 
;ScopeID = "00000000-0000-0000-0000-000000000000"
;
;************************************************
[RegionName_Centre]
RegionUUID = "00000000-0000-0000-0000-000000000000"
Location = "5001,5001"
InternalAddress = "0.0.0.0"
InternalPort = 9005
AllowAlternatePorts = False
ExternalHostName = "YourIP_DNSname"
; 
MasterAvatarUUID = "00000000-0000-0000-0000-000000000000"
MasterAvatarFirstName = "FirstName"
MasterAvatarLastName = "LastName"
;MasterAvatarSandboxPassword = ""
; 
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
; 
;ScopeID = "00000000-0000-0000-0000-000000000000"
;************************************************
[RegionName_N]
RegionUUID = "00000000-0000-0000-0000-000000000000"
Location = "5001,5002"
InternalAddress = "0.0.0.0"
InternalPort = 9006
AllowAlternatePorts = False
ExternalHostName = "YourIP_DNSname"
; 
MasterAvatarUUID = "00000000-0000-0000-0000-000000000000"
MasterAvatarFirstName = "FirstName"
MasterAvatarLastName = "LastName"
;MasterAvatarSandboxPassword = ""
; 
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
;ScopeID = "00000000-0000-0000-0000-000000000000"
;
;************************************************
;
[RegionName_SE]
RegionUUID = "00000000-0000-0000-0000-000000000000"
Location = "5002,5000"
InternalAddress = "0.0.0.0"
InternalPort = 9007
AllowAlternatePorts = False
ExternalHostName = "YourIP_DNSname"
; 
MasterAvatarUUID = "00000000-0000-0000-0000-000000000000"
MasterAvatarFirstName = "FirstName"
MasterAvatarLastName = "LastName"
;MasterAvatarSandboxPassword = ""
; 
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
; 
;ScopeID = "00000000-0000-0000-0000-000000000000"
;
;************************************************
[RegionName_E]
RegionUUID = "00000000-0000-0000-0000-000000000000"
Location = "5002,5001"
InternalAddress = "0.0.0.0"
InternalPort = 9008
AllowAlternatePorts = False
ExternalHostName = "YourIP_DNSname"
MasterAvatarUUID = "00000000-0000-0000-0000-000000000000"
MasterAvatarFirstName = "FirstName"
MasterAvatarLastName = "LastName"
;MasterAvatarSandboxPassword = ""
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
; 
;ScopeID = "00000000-0000-0000-0000-000000000000"
;
;************************************************
[RegionName_NE]
RegionUUID = "00000000-0000-0000-0000-000000000000"
Location = "5002,5002"
InternalAddress = "0.0.0.0"
InternalPort = 9009
AllowAlternatePorts = False
ExternalHostName = "YourIP_DNSname"
; 
MasterAvatarUUID = "00000000-0000-0000-0000-000000000000"
MasterAvatarFirstName = "FirstName"
MasterAvatarLastName = "LastName"
;MasterAvatarSandboxPassword = ""
; 
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
; 
;ScopeID = "00000000-0000-0000-0000-000000000000"
;
;************************************************

@@ Line 1: / Line 1: @@
-= Setting up Mega-Regions  =
 {{needsexample}} {{content}}
@@ Line 67: / Line 65: @@
 <br>
-<br>'''Step 1:'''&nbsp;&nbsp; OpenSim.ini
+<br>'''Step 1:'''&nbsp;&nbsp;
-At the top, there is a section like shown here.&nbsp; Change the setting to true, default is false
+'''FRESH Installation:'''
 <blockquote>
-;;Combine all contiguous regions into one large region
+This assumes you have a NEW OpenSim installation with a Clean (empty)&nbsp;Database.
-<br>; Order your regions from South to North, West to East in your regions.ini and then set this to true
-<br>; '''Warning'''! If your regions have existing content, joining them may be dangerous -- you risk losing content.
+#Modify the OpenSim.ini&nbsp; and change '''CombineContiguousRegions=false '''to '''CombineContiguousRegions=true'''.&nbsp; This is located at the top of the OpenSim.ini under the ## REGIONS&nbsp; Section.
-<br>; Please follow the following steps if your regions have content:
+#Proceed to '''Step 2''' and make sure that your '''bin\regions\RegionConfig.ini '''is configured according to the specification for MegaRegion
-<br>; 1) '''Make a backup of your database!'''
+#Start your OpenSim Instance &amp;&nbsp;there you have it.
-<br>; 2) Set "CombineContiguousRegions=true", start Opensim. You'll see a lot of error messages -- ignore them.
+</blockquote>
-<br>; 3) Go to the Opensim console, and type "fix-phantoms"
+'''EXISTING&nbsp;Regions Being Converted:'''
-<br>; 4) Wait some minutes for the backup thread to store everything
+<blockquote>
-<br>; 5) Restart Opensim, and check that all the objects are in their right places.
+'''Warning'''! If your regions have existing content, joining them may be dangerous -- you risk losing content.&nbsp;<br>Please follow the following steps if your regions have content:&nbsp;
-<br>; This has worked for me ([[User:Zonja|Zonja]]) - your mileage may vary.
-<br>; Please refer to [http://www.metaverseink.com/blog/?p=28 this post from Diva] for more information
+#'''Make a backup of your database!'''&nbsp;
-<br>;
+#Make an OAR&nbsp;for EACH&nbsp;REGION which you intend integrate into a Mega-Region.&nbsp; In Console Type the following commands (Highlighted in '''BOLD'''):&nbsp; '''change region RegionName&nbsp; '''''next''&nbsp; '''save oar RegionName.tar.gz'''&nbsp; ''NB: save oar can be pathed to another directory such as''&nbsp; '''save oar c:\mybackups\RegionName.tar.gz&nbsp;'''
-<br>CombineContiguousRegions=true
+#Set "CombineContiguousRegions=true", in OpenSim.ini.
+#'''Verify your bin\regions\RegionConfig.ini '''is configured according to the specification for MegaRegion as shown in '''Step 2'''
+#start Opensim. You'll see a lot of error messages -- ignore them.
+#Wait till Console Activity Stops,&nbsp;then in Console Type:&nbsp; '''fix-phantoms'''
+#Wait till this process completes, it can take several&nbsp;minutes for the backup thread to store everything
+#When the Console Activity Stops, then in Console Type:&nbsp; '''backup&nbsp;&nbsp; ('''''<b>This will persist the data into the Database again as a precaution)</b>''
+#Restart Opensim, and check that all the objects are in their right places.&nbsp;
+This has worked for me ([[User:Zonja|Zonja]]) - your mileage may vary.&nbsp;<br>Please refer to [http://www.metaverseink.com/blog/?p=28 this post from Diva] for more information&nbsp;<br>
 </blockquote>
 '''Step 2:'''&nbsp; bin\regions\RegionConfig.ini
-The Example Provided here is for a 3x3, 9 Simulator Mega-Region.&nbsp; Ensure that you fill in the Correct Information in all the required fields.
+The Example Provided here is for a 3x3, 9 Simulator Mega-Region.&nbsp; Ensure that you fill in the Correct Information in all the required fields.&nbsp;&nbsp;Order your regions from '''South-West to North-East '''in your bin\regions\RegionsConfig.ini&nbsp;&nbsp;
 <source lang="ini">; 9 Simulator 3x3 Mega-Region Example
@@ Line 280: / Line 288: @@
 ;
 ;************************************************</source>&nbsp;
-&nbsp;
-Good Luck<br>
-Hope it Helps. --[[User:WhiteStar|WhiteStar]] 08:34, 27 November 2009 (UTC)
 &nbsp;

Views

Setting Up Mega-Regions

From OpenSimulator

Revision as of 10:20, 27 November 2009

Personal tools

General

For Administrators

For Developers

For Creators

For Grid Users

Related Links

About This Wiki

Search

Tools