Configuration of the file “GridCommon.ini”

The file “Gridcommon.ini” in the subdirectory “config-include” contains many important settings. Here the database for your own regions is selected, also various URLs (web addresses) are set for the grid of your choice your server will be connected to. Starting point for this tutorial is the “GridCommon.ini.example” as included in the Arriba Download.

Section DatabaseService

Here the database is selected, either SQLite or MySQL. The respective other choice must be commented out with semicolons (;)!

SQLite is included in OpenSim and does not need to be previously installed or configured. Please do not get confused by the word “Standalone” in the file name, you can still connect your regions to a grid. Select the following settings to use SQLite:

Type = "SQLite"

For MySQL a database server and a database has to be set up in advance, as described for example in this tutorial. MySQL is more powerful than SQLite, namely one of the fastest free of use database programs. For MySQL, choose the following settings:

Type = "MySQL"
ConnectionString = "Data Source=localhost;Database=opensim;User ID=opensim;Password=TopSecret;Old Guids=true;"

In this example, the database is called “opensim”, the user is also called “opensim” and the password is “TopSecret”. Pay attention to capitalization! The database is located on the same machine (localhost).

Other sections

The following modules define different connections to the grid you want to connect to. The following values must be adopted exactly as specified by the grid admins!

The following examples take the values from constants that would have to be set in the OpenSim.ini file. This is a convenient method especially for smaller grids (with only one computer for the grid services). Alternatively, the individual URLs are entered here in plain text, meaning “http://……”.

Important! Note that Arriba often requires a final slash (/) at the end of the URL.

[Hypergrid]
  HomeURI = "${Const|BaseURL}:${Const|PublicPort}/"
  GatekeeperURI = "${Const|BaseURL}:${Const|PublicPort}/"
[Modules]
  AssetCaching = "FlotsamAssetCache"
  Include-FlotsamCache = "config-include/FlotsamCache.ini"
  ;; Select the appropriate module only in grids
  ;; that offer a search, see also in [Search]. 
  ; SearchModule = "OpenSimSearch"
[AssetService]
  AssetServerURI = "${Const|PrivateBaseURL}:${Const|PrivatePort}"
[InventoryService]
  InventoryServerURI = "${Const|PrivateBaseURL}:${Const|PrivatePort}"
[GridInfo]
  GridInfoURI = "${Const|BaseURL}:${Const|PublicPort}/"
[GridService]
  GridServerURI = "${Const|PrivateBaseURL}:${Const|PrivatePort}"
  Gatekeeper = "${Const|BaseURL}:${Const|PublicPort}/"
[Messaging]
  Gatekeeper = "${Const|BaseURL}:${Const|PublicPort}/"
[AvatarService]
  AvatarServerURI = "${Const|PrivateBaseURL}:${Const|PrivatePort}"
[PresenceService]
  PresenceServerURI = "${Const|PrivateBaseURL}:${Const|PrivatePort}"
[UserAccountService]
  UserAccountServerURI = "${Const|PrivateBaseURL}:${Const|PrivatePort}"
[GridUserService]
  GridUserServerURI = "${Const|PrivateBaseURL}:${Const|PrivatePort}"
[AuthenticationService]
  AuthenticationServerURI = "${Const|PrivateBaseURL}:${Const|PrivatePort}"
[FriendsService]
  FriendsServerURI = "${Const|PrivateBaseURL}:${Const|PrivatePort}"
[HGInventoryAccessModule]
  HomeURI = "${Const|BaseURL}:${Const|PublicPort}/"
  Gatekeeper = "${Const|BaseURL}:${Const|PublicPort}/"
[HGAssetService]
  HomeURI = "${Const|BaseURL}:${Const|PublicPort}/"
[UserAgentService]
  UserAgentServerURI = "${Const|BaseURL}:${Const|PublicPort}/"
[MapImageService]
  MapImageServerURI = "${Const|PrivateBaseURL}:${Const|PrivatePort}"
[Search]
  ;; Only in grids that offer a search, possibly in [Modules]
  ;; an additional entry for the module used is necessary.
  ; SearchURL = "${Const|BaseURL}:${Const|PublicPort}/"
[XBakes]
  ;; Only in grids which use the "Baked Texture ROBUST Service" 
  ;; add here the following line:
  ; URL = "${Const|PrivateBaseURL}:${Const|PrivatePort}"

Interesting optional entries

If you jump into a grid via HG teleport, where HG 2.0 (with the Suitcase) is active, then a “not available” is added to the directory name of your own inventory (except Suitcase) in the viewer. This should remind you that in the foreign grid you can only access the Suitcase. But if your own grid has HG 1.0, this is a hoax: your own inventory can be reached from any other grid.
If “RestrictInventoryAccessAbroad = false” is set here, then this message is suppressed. (Default is true.)

[HGInventoryAccessModule]
  ; RestrictInventoryAccessAbroad = true

“OutboundPermission = false” prohibits Hypergrid visitors from copying objects. This setting can be useful if there are no vendors on the regions or other objects that are to be passed on. (Default is “true”.) However, this does not protect against copies using specially modified OpenSim viewers!

[HGInventoryAccessModule]
  ; OutboundPermission = true

Continued: Configuration of the file “OpenSim.ini”

Scroll to Top