Jwbshaw: first

2026-06-30T09:07:31Z

first

New page

= OpenSimulator Internals/Walkthroughs/Bring Up Grid =

== Overview ==

Traces what happens from running the ROBUST executable to the grid being ready to accept simulator registrations and logins.

See [[OpenSimulator Internals/Code Map/ROBUST]] for the component reference this walkthrough is built from.

----

== Steps ==

=== 1. Process starts ===

OpenSim/Server/ServerMain.cs -- OpenSimServer.Main()

Culture set, .NET HTTP client defaults configured (connection limit 64, Nagle off, certificate validation callback installed).

=== 2. Config loaded ===

OpenSim/Server/Base/HttpServerBase.cs (constructor)

Robust.ini loaded, Include-* files merged, environment variables merged, command line args applied last. Variable substitution expands ${Section|Key} references. [Network] section read for port and SSL settings -- port is mandatory, startup throws if missing.

No database activity yet.

=== 3. HTTP server starts ===

Main HTTP server bound to the port from [Network] (8002 on osimdev). Optional SSL listener if configured. Server is running but has no handlers registered yet.

=== 4. Connector list assembled ===

[Startup].ServiceConnectors and all keys in [ServiceList] are merged into one list.

=== 5. Connectors loaded one at a time ===

For each entry (format configName@port/dll:class):

# Port parsed -- if specified, MainServer.GetHttpServer(port) creates or retrieves a server on that port. T1's GatekeeperServiceInConnector, LLLoginServiceInConnector, GridInfoServerInConnector etc. run on the public port (8002). GridServiceConnector, AssetServiceConnector etc. run on the private port (8003).
# ServerUtils.LoadPlugin<IServiceConnector>() instantiates the class via reflection
# Each connector's constructor:
#* Reads its own config section (e.g. [GridService], [AssetService])
#* Loads its LocalServiceModule -- the actual service implementation (e.g. GridService.cs)
#* The service implementation's constructor opens a MySQL connection and runs schema migrations (MIGRATIONS log lines -- "GridStore data tables already up to date at revision 10" etc.)
#* Registers its HTTP handlers on the server for that port

This is the step where the database tables are created or verified for every service: regions, UserAccounts, Avatars, GridUser, auth, tokens, inventoryfolders, inventoryitems, assets, Friends, AgentPrefs, Presence, hg_traveling_data.

Special case: LLLoginServiceInConnector gets an IndexPHPHandler added to its server before its own handlers are registered.

=== 6. GridService specifically ===

See [[OpenSimulator Internals/Code Map/ROBUST]] service table and [[OpenSimulator Internals/GridService]] for full detail.

GridService constructor:
# Reads DeleteOnUnregister, AllowDuplicateNames, AllowHypergridMapSearch from [GridService]
# Loads AuthenticationService if configured
# Registers console commands (show regions, set region flags, etc.) -- only the first instance does this
# Calls SetExtraServiceURLs() -- populates m_ExtraFeatures from [LoginService] and Hypergrid config (search URL, map tile URL, grid name, grid nick, gatekeeper URI)
# Creates HypergridLinker if HypergridLinker = true -- throws if HyperGrid config section missing

No regions are registered in the database yet at this point -- the regions table is empty (or holds stale entries from a previous run that have not yet timed out).

=== 7. Platform DLL fixup ===

System.Drawing.Common.dll is copied for the current OS (Windows vs Linux) before the rest of startup completes.

=== 8. Startup logo, plugin loader ===

robuststartuplogo.txt printed if present. PluginLoader created for registry-based plugins (not used in a typical setup).

=== 9. Main loop ===

m_Server.Run() enters the console prompt loop. ROBUST is now up and listening on both ports, with every service's database schema verified, but no simulator has registered yet.

----

== Database State After This Walkthrough ==

{| class="wikitable"
! Table !! State
|-
| regions || Empty (fresh grid) or stale entries from previous run
|-
| UserAccounts || GRID SERVICES system account only (UserLevel 240)
|-
| auth || Empty
|-
| assets || ~2600 library assets loaded by AssetService on its own startup path
|-
| All other tables || Empty
|}

----

== What Happens Next ==

A simulator process starting up and calling RegisterRegion() is the next walkthrough -- see [[OpenSimulator Internals/Walkthroughs/Bring Up Region]].

----

== See Also ==

* [[OpenSimulator Internals/Code Map/ROBUST]]
* [[OpenSimulator Internals/GridService]]
* [[OpenSimulator Internals/Databases]]
* [[OpenSimulator Internals/Walkthroughs/Bring Up Region]]

OpenSimulator Internals/Walkthroughs/Bring Up Grid - Revision history

Jwbshaw: first