Setting Up Mega-Regions

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(Fixed Mega-Region example)
(Revised to 07x formats)
Line 69: Line 69:
 
<br>
 
<br>
  
== Steps ==
+
== Steps ==
  
 
<br>'''Step 1:'''&nbsp;&nbsp;  
 
<br>'''Step 1:'''&nbsp;&nbsp;  
Line 82: Line 82:
 
<blockquote>'''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;</blockquote><blockquote>OARS&nbsp;- [[OpenSim Archives]]&nbsp;</blockquote><blockquote>
 
<blockquote>'''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;</blockquote><blockquote>OARS&nbsp;- [[OpenSim Archives]]&nbsp;</blockquote><blockquote>
 
#'''Make a backup of your database!'''&nbsp;  
 
#'''Make a backup of your database!'''&nbsp;  
#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;'''  
+
#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.oar&nbsp;'''  
 
#Set "CombineContiguousRegions=true", in OpenSim.ini.  
 
#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'''  
 
#'''Verify your bin\regions\RegionConfig.ini '''is configured according to the specification for MegaRegion as shown in '''Step 2'''  
Line 108: Line 108:
 
AllowAlternatePorts = False
 
AllowAlternatePorts = False
 
ExternalHostName = YourIP_DNSname
 
ExternalHostName = YourIP_DNSname
;
 
MasterAvatarUUID = 00000000-0000-0000-0000-000000000000
 
MasterAvatar =
 
MasterAvatar =
 
;MasterAvatarSandboxPassword =
 
 
;
 
;
 
;NonphysicalPrimMax = 0
 
;NonphysicalPrimMax = 0
Line 125: Line 120:
 
Location = 5000,5001
 
Location = 5000,5001
 
InternalAddress = 0.0.0.0
 
InternalAddress = 0.0.0.0
InternalPort = 9900
+
InternalPort = 9002
 
AllowAlternatePorts = False
 
AllowAlternatePorts = False
 
ExternalHostName = YourIP_DNSname
 
ExternalHostName = YourIP_DNSname
 
;
 
;
MasterAvatarUUID = 00000000-0000-0000-0000-000000000000
 
MasterAvatar =
 
MasterAvatar =
 
;MasterAvatarSandboxPassword =
 
;
 
 
;NonphysicalPrimMax = 0
 
;NonphysicalPrimMax = 0
 
;PhysicalPrimMax = 0
 
;PhysicalPrimMax = 0
Line 148: Line 138:
 
AllowAlternatePorts = False
 
AllowAlternatePorts = False
 
ExternalHostName = YourIP_DNSname
 
ExternalHostName = YourIP_DNSname
;
 
MasterAvatarUUID = 00000000-0000-0000-0000-000000000000
 
MasterAvatar =
 
MasterAvatar =
 
;MasterAvatarSandboxPassword =
 
 
;  
 
;  
 
;NonphysicalPrimMax = 0
 
;NonphysicalPrimMax = 0
Line 162: Line 147:
 
;
 
;
 
;************************************************
 
;************************************************
;
 
 
[RegionName_S]
 
[RegionName_S]
 
RegionUUID = 00000000-0000-0000-0000-000000000000
 
RegionUUID = 00000000-0000-0000-0000-000000000000
Line 170: Line 154:
 
AllowAlternatePorts = False
 
AllowAlternatePorts = False
 
ExternalHostName = YourIP_DNSname
 
ExternalHostName = YourIP_DNSname
;
 
MasterAvatarUUID = 00000000-0000-0000-0000-000000000000
 
MasterAvatar =
 
MasterAvatar =
 
;MasterAvatarSandboxPassword =
 
 
;  
 
;  
 
;NonphysicalPrimMax = 0
 
;NonphysicalPrimMax = 0
Line 191: Line 170:
 
AllowAlternatePorts = False
 
AllowAlternatePorts = False
 
ExternalHostName = YourIP_DNSname
 
ExternalHostName = YourIP_DNSname
;
 
MasterAvatarUUID = 00000000-0000-0000-0000-000000000000
 
MasterAvatar =
 
MasterAvatar =
 
;MasterAvatarSandboxPassword =
 
 
;  
 
;  
 
;NonphysicalPrimMax = 0
 
;NonphysicalPrimMax = 0
Line 211: Line 185:
 
AllowAlternatePorts = False
 
AllowAlternatePorts = False
 
ExternalHostName = YourIP_DNSname
 
ExternalHostName = YourIP_DNSname
;
 
MasterAvatarUUID = 00000000-0000-0000-0000-000000000000
 
MasterAvatar =
 
MasterAvatar =
 
;MasterAvatarSandboxPassword =
 
 
;  
 
;  
 
;NonphysicalPrimMax = 0
 
;NonphysicalPrimMax = 0
Line 232: Line 201:
 
AllowAlternatePorts = False
 
AllowAlternatePorts = False
 
ExternalHostName = YourIP_DNSname
 
ExternalHostName = YourIP_DNSname
;
 
MasterAvatarUUID = 00000000-0000-0000-0000-000000000000
 
MasterAvatar =
 
MasterAvatar =
 
;MasterAvatarSandboxPassword =
 
 
;  
 
;  
 
;NonphysicalPrimMax = 0
 
;NonphysicalPrimMax = 0
Line 253: Line 217:
 
AllowAlternatePorts = False
 
AllowAlternatePorts = False
 
ExternalHostName = YourIP_DNSname
 
ExternalHostName = YourIP_DNSname
MasterAvatarUUID = 00000000-0000-0000-0000-000000000000
+
;
MasterAvatar =
+
MasterAvatar =
+
;MasterAvatarSandboxPassword =
+
 
;NonphysicalPrimMax = 0
 
;NonphysicalPrimMax = 0
 
;PhysicalPrimMax = 0
 
;PhysicalPrimMax = 0
Line 272: Line 233:
 
AllowAlternatePorts = False
 
AllowAlternatePorts = False
 
ExternalHostName = YourIP_DNSname
 
ExternalHostName = YourIP_DNSname
;
 
MasterAvatarUUID = 00000000-0000-0000-0000-000000000000
 
MasterAvatar =
 
MasterAvatar =
 
;MasterAvatarSandboxPassword =
 
 
;  
 
;  
 
;NonphysicalPrimMax = 0
 
;NonphysicalPrimMax = 0
Line 285: Line 241:
 
;ScopeID = 00000000-0000-0000-0000-000000000000
 
;ScopeID = 00000000-0000-0000-0000-000000000000
 
;
 
;
;************************************************
+
;************************************************</source>
 
+
 
+
 
+
== Additional References ==
+

Revision as of 19:18, 26 October 2010



There are still some outstanding issues being addressed by the Dev team.  If you wish to incorporate your existing 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...)


Layout Diagram

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

SPECIAL NOTE: Most Viewers still suffer the 4096 Teleport Bug where people cannot teleport more than 4K regions away.  OSGrid is centered @ 10000 10000.  Some Viewers, such as MeerKat & Imprudence have addressed this recently, others will likely follow suit.  This bug applies to HyperGrided regions as well as Non-Hypergrid regions.

Mega region Layout Example




























Steps


Step 1:  

FRESH Installation:

This assumes you have a NEW OpenSim installation with a Clean (empty) Database.
  1. 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.
  2. Proceed to Step 2 and make sure that your bin\regions\RegionConfig.ini is configured according to the specification for MegaRegion
  3. 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: 
OARS - OpenSim Archives 
  1. Make a backup of your database! 
  2. 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.oar 
  3. Set "CombineContiguousRegions=true", in OpenSim.ini.
  4. Verify your bin\regions\RegionConfig.ini is configured according to the specification for MegaRegion as shown in Step 2
  5. start Opensim. You'll see a lot of error messages -- ignore them.
  6. Wait till Console Activity Stops, then in Console Type:  fix-phantoms
  7. Wait till this process completes, it can take several minutes for the backup thread to store everything
  8. When the Console Activity Stops, then in Console Type:  backup   (This will persist the data into the Database again as a precaution)
  9. 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
;
;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
;
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
; 
;ScopeID = 00000000-0000-0000-0000-000000000000
;************************************************
[RegionName_NW]
RegionUUID = 84b41485-6884-412d-b4a2-2f6941559924
Location = 5000,5002
InternalAddress = 0.0.0.0
InternalPort = 9003
AllowAlternatePorts = False
ExternalHostName = YourIP_DNSname
; 
;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
; 
;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
; 
;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
; 
;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
; 
;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
;
;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
; 
;NonphysicalPrimMax = 0
;PhysicalPrimMax = 0
ClampPrimSize = False
;MaxPrims = 15000
; 
;ScopeID = 00000000-0000-0000-0000-000000000000
;
;************************************************
Personal tools
General
About This Wiki