HOW TO ADD A NEW REGION TO THE AVACON GRID

1. Place the new regions where they will be located on the AvaCon Grid Region Map

2. Edit each region square on the map to the correct Region Name, Center, UDP Port (increment up from last port used, goes in regions.ini), TCP port (increment up from last port used, goes in opensim.ini), Estate name, and ID (all lower case, use a – for spaces).

3. Go to the MySQL screen to create a new database for the new region

at the mysql console type “create database <name>;”

4. On the AvGrid server, create a copy of an existing region folder from /home/avgrid/grid_01/configs

5. Rename the folder to the region-ID (all lower case, use a – for spaces) to match the region name.

6. Edit /home/avgrid/grid_01/configs/[region-ID]/Regions/regions.ini

– Name the region as it will appear on the Grid map
– Grab a new random UUID from http://www.famkruithof.net/uuid/uuidgen and paste into RegionUUID =
– Enter the grid Location coordinates from the AvaCon Grid Region Map
– Enter the UDP port from the AvaCon Grid Region Map in Internal Port =

 

7. Edit /home/avgrid/grid_01/configs/[region-ID]/opensim.ini

– Search for “http_listener_port =” and change the port # to the TCP port listed in AvaCon Grid Region Map

– Search for “Include-Architecture =” edit string replace copied region name with new [region-ID]

– Search for “PIDFile =” edit string replace copied region name with new [region-ID]

– Search for “regionload_regionsdir=” edit string replace copied region name with new [region-ID]

 

8. Edit /home/avgrid/grid_01/configs/[region-ID]/config-include/FlotsamCache.ini

– Change CacheDirectory = /home/avgrid/grid_01/region_cache/[region-ID]

 

9. Edit /home/avgrid/grid_01/configs/[region-ID]/config-include/GridCommon.ini

– change Connection String > enter new database name [region-ID]

– change Include-FlotsamCache = edit string replace copied region name with new [region-ID]

 

10. Edit /home/avgrid/grid_01/configs/[region-ID]/config-include/GridHypergrid.ini

– Change Include-Common = edit string replace copied region name with new [region-ID]

 

11. Go to /home/avgrid/grid_01/bin

– make a copy of an existing [region].sh file

– rename to [region-id].sh

– In while string, replace old region name with [region-ID] in both places

– Make sure owner can Read Write Execute on the .sh file

12. To make new screen tabs

ctrl+a c
to name the tab
its ctrl+a shift+a
you should see the focus go to the name you can just backspace and type in whatever and hit enter

13. To launch region

go to /home/avgrid/grid_01/bin
type ./[region-ID].sh

14. Add to backup schema

in /home/avgrid/grid_01/00-Backups
there are two shell scripts
daily-backups.sh
and robust-backup.sh
you want daily-backups.sh
its pretty self explanatory once you see it
basically just copy and paste a line and edit it for new db’s