OpenSimulator · EN

INI files and SQL connections

Detailed OpenSimulator 0.9.3.1 explanations based on INI templates and source code.

Your deployment may organize schemas and files differently. Always inspect actual loaded settings. Never edit SQL data directly without a backup.

Which process reads which INI?

ROBUST commonly uses Robust.ini or Robust.HG.ini. Each simulator reads OpenSim.ini and its included GridCommon.ini or StandaloneCommon.ini. Editing a ROBUST INI does not automatically change simulator settings.

DatabaseService, StorageProvider, ConnectionString

[DatabaseService] selects a storage provider and connection string. Data Source names the MySQL server; Database names the SQL schema. One server can host several independent schemas. Some modules may override the default connection.

EstateConnectionString

GridCommon.ini.example provides EstateConnectionString for a separate estate schema. Another option uses [EstateDataStore] EstateDataRemoteConnector with [EstateService] EstateServerURI and an explicitly enabled EstateDataRobustConnector on ROBUST.

SQLite and includes

Templates include SQLite and MySQL examples. Watch commented lines, active includes and module overrides: effective loaded configuration determines data locations.

Editing precautions

Changing Database does not migrate data. Empty targets may be initialized with new tables, making records appear lost. Back up schemas and INI files before changes; never publish real SQL passwords.

Teaching examples from separate files. Verify includes and driver options before adapting.

; Robust.HG.ini du service central
[DatabaseService]
StorageProvider = "OpenSim.Data.MySQL.dll"
ConnectionString = "Data Source=localhost;Database=central_services;User ID=grid_user;Password=EXEMPLE;"

; GridCommon.ini d'un simulateur (autre fichier)
[DatabaseService]
StorageProvider = "OpenSim.Data.MySQL.dll"
ConnectionString = "Data Source=localhost;Database=region_data;User ID=region_user;Password=EXEMPLE;"
; EstateConnectionString = "Data Source=localhost;Database=estate_data;User ID=estate_user;Password=EXEMPLE;"

Other guides in this section

OpenSimulator 0.9.3.1 source files