Setting Up Mega-Regions
From OpenSimulator
(Difference between revisions)
m (deleted teasing blanks) |
(refactoring & updating based on version 0.7.x) |
||
| Line 1: | Line 1: | ||
{{Template:Quicklinks}} | {{Template:Quicklinks}} | ||
| + | {{needsexample}} | ||
| + | {{ambox | ||
| + | | type = content | ||
| + | | text = 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...) Updated October 26, 2010}} | ||
| − | + | = 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 4096 regions away. OSGrid is centered @ 10000 10000. Some Viewers, such as MeerKat or Imprudence, have addressed this recently, others will likely follow suit. This bug applies to HyperGrided regions as well as Non-Hypergrid regions. | |
| − | + | [[Image:MegaReg Layout.png|center|512x512px|Mega region Layout Example]] | |
| + | = Steps = | ||
| + | === Step 0: Back Up Regions === | ||
| − | + | If your OpenSim instance doesn't have currently any contents, then proceed to [[#Step 1: Edit the File "OpenSim.ini"]]. | |
| − | + | 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. See [[Backups]] for instructions. | |
| + | # Make an OAR for EACH REGION which you intend integrate into a Mega-Region. See [[OpenSim_Archives]] for instructions. | ||
| − | [ | + | === Step 1: Edit the File "OpenSim.ini" === |
| + | |||
| + | Modify your OpenSim.ini. In <nowiki>[Startup]</nowiki> section, change | ||
| + | <source lang="ini"> | ||
| + | ; CombineContiguousRegions = false | ||
| + | </source> | ||
| + | to | ||
| + | <source lang="ini"> | ||
| + | ; CombineContiguousRegions = true | ||
| + | </source> | ||
| + | |||
| + | === Step 2: Edit the File "Regions.ini" === | ||
| + | |||
| + | Edit the file Region.ini which is located in "bin\Regions". | ||
| + | |||
| + | The example provided in [[#Example of Regions.ini File]] below is for a Mega-Region consists of 3x3, 9 simulator. Fill in the correct information in all the required fields. Remember to order your regions from '''South-West to North-East '''in your Regions.ini. | ||
| + | |||
| + | === Step 3 : Start OpenSim Instance === | ||
| − | + | Start Opensim. If your regions have no contents, then you already have it! If not, | |
| − | + | # You'll see a lot of error messages -- ignore them. | |
| + | #Wait for a while before console activity stopping, then type: '''fix-phantoms''' | ||
| + | #Wait before process completing. It can take several minutes for the backup thread to store everything. | ||
| + | #When the console activity stops, 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. | ||
| − | + | See Also: [http://www.metaverseink.com/blog/?p=28 Importing OARs into megaregions (Diva's blog post)] | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | = Example of Regions.ini File = | |
<source lang="ini">; 9 Simulator 3x3 Mega-Region Example | <source lang="ini">; 9 Simulator 3x3 Mega-Region Example | ||
Revision as of 00:22, 26 February 2011
 |
Languages: |
|
|
|
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. |
|
|
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...) Updated October 26, 2010 |
Contents |
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 4096 regions away. OSGrid is centered @ 10000 10000. Some Viewers, such as MeerKat or Imprudence, have addressed this recently, others will likely follow suit. This bug applies to HyperGrided regions as well as Non-Hypergrid regions.
Steps
Step 0: Back Up Regions
If your OpenSim instance doesn't have currently any contents, then proceed to #Step 1: Edit the File "OpenSim.ini".
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. See Backups for instructions.
- Make an OAR for EACH REGION which you intend integrate into a Mega-Region. See OpenSim_Archives for instructions.
Step 1: Edit the File "OpenSim.ini"
Modify your OpenSim.ini. In [Startup] section, change
; CombineContiguousRegions = falseto
; CombineContiguousRegions = trueStep 2: Edit the File "Regions.ini"
Edit the file Region.ini which is located in "bin\Regions".
The example provided in #Example of Regions.ini File below is for a Mega-Region consists of 3x3, 9 simulator. Fill in the correct information in all the required fields. Remember to order your regions from South-West to North-East in your Regions.ini.
Step 3 : Start OpenSim Instance
Start Opensim. If your regions have no contents, then you already have it! If not,
- You'll see a lot of error messages -- ignore them.
- Wait for a while before console activity stopping, then type: fix-phantoms
- Wait before process completing. It can take several minutes for the backup thread to store everything.
- When the console activity stops, 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.
See Also: Importing OARs into megaregions (Diva's blog post)
Example of Regions.ini File
; 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 ; ;************************************************
