Setting up and starting your second region

From Open Metaverse Wiki
Revision as of 22:57, 27 September 2023 by Tess (talk | contribs) (Adding backlink to the Grid owners index page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Opensimulator: Grid Owners: Setting up and starting your second region

Once you have one region working, setting up the second one or the nth one is a breeze! Just copy the home region folder into a new one, edit just two files and change just a few lines in each. Here are the steps that I do:

   cd ~/Grid/Regions
   cp -r Welcome Na-vi-Tree-of-Life
   cd Na-vi-tree-of-Life
   edit Locals.ini
       change RegionDir to "Na-vi-Tree-of-Life"
       change http_listener_port to 8021
   edit Regions/Regions.ini
       change the first line to [Na'vi Tree of Life]
       change the RegionUUID to an unique UUID
       change the InternalPort to 8021
       change the location, size and other parameters for this region
   cd bin
   screen -r Na-vi-Tree-of-Life
   mono OpenSim.exe
   ^A^D

There are a few lines in the new region folder that you probably should delete after copying, the 'pid' file and the log file.

As mentioned before, the new UUID must be unique which can be done by using https://www.uuidgenerator.net/ or by doing some change to old ones using some unique process, for example like embedding the unique port number in the UUID.

The port numbers must be unique on the system. I kept a spreadsheet of used ports for a long time before I wrote tools to manage them for me. From the Grid folder, this command will find all the port numbers currently in use:

   grep -r InternalPort *

If you use a location that causes the region to overlap another region, you will get reasonable error messages telling you that.

Next: Updating Your Grid when a New Version of OpenSim comes out