OpenSimulator Internals/Code Map/ROBUST - Revision history

Jwbshaw: updates

2026-07-07T13:57:14Z

updates

← Older revision		Revision as of 13:57, 7 July 2026
Line 167:		Line 167:

	* [[OpenSimulator Internals/Code Map]]		* [[OpenSimulator Internals/Code Map]]
			* [[OpenSimulator Internals/Code Map/Scene]]
			* [[OpenSimulator Internals/Code Map/ScenePresence]]
			* [[OpenSimulator Internals/Code Map/AvatarFactoryModule]]
			* [[OpenSimulator Internals/Code Map/AttachmentsModule]]
			* [[OpenSimulator Internals/Code Map/EntityTransferModule]]
			* [[OpenSimulator Internals/Code Map/HGEntityTransferModule]]
			* [[OpenSimulator Internals/Code Map/InventoryAccessModule]]
	* [[OpenSimulator Internals/Reading the Code]]		* [[OpenSimulator Internals/Reading the Code]]
	* [[OpenSimulator Internals/ROBUST Services]]		* [[OpenSimulator Internals/ROBUST Services]]
	* [[OpenSimulator Internals/Connector Architecture]]		* [[OpenSimulator Internals/Connector Architecture]]

Jwbshaw: update with new

2026-07-07T12:11:49Z

update with new

@@ Line 1: / Line 1: @@
 = OpenSimulator Internals/Code Map/ROBUST =
@@ Line 110: / Line 108: @@
 === Service Implementations ===
-Each service connector loaded from [ServiceList] handles one service domain. See [[OpenSimulator Internals/ROBUST Services]] for the full list.
+Each service connector loaded from [ServiceList] handles one service domain.
 {| class="wikitable"
@@ Line 126: / Line 124: @@
 |-
 | AuthenticationService || OpenSim/Services/AuthenticationService/PasswordAuthenticationService.cs || OpenSim/Server/Handlers/Authentication/
 |-
 | LoginService || OpenSim/Services/LLLoginService/LLLoginService.cs || OpenSim/Server/Handlers/Login/
@@ Line 133: / Line 137: @@
 | UserAgentService || OpenSim/Services/HypergridService/UserAgentService.cs || OpenSim/Server/Handlers/Hypergrid/
 |}
 See [[OpenSimulator Internals/Code Map/ROBUST/GridService RegisterRegion]] for a detailed trace of GridService.RegisterRegion() and DeregisterRegion().
 ----

Jwbshaw: add

2026-07-07T11:53:10Z

add

← Older revision		Revision as of 11:53, 7 July 2026
Line 1:		Line 1:


	= OpenSimulator Internals/Code Map/ROBUST =		= OpenSimulator Internals/Code Map/ROBUST =

Jwbshaw: Added

2026-07-07T11:46:28Z

Added

← Older revision		Revision as of 11:46, 7 July 2026
Line 1:		Line 1:

	= OpenSimulator Internals/Code Map/ROBUST =		= OpenSimulator Internals/Code Map/ROBUST =

Line 131:		Line 132:
	\| UserAgentService \|\| OpenSim/Services/HypergridService/UserAgentService.cs \|\| OpenSim/Server/Handlers/Hypergrid/		\| UserAgentService \|\| OpenSim/Services/HypergridService/UserAgentService.cs \|\| OpenSim/Server/Handlers/Hypergrid/
	\|}		\|}

			See [[OpenSimulator Internals/Code Map/ROBUST/GridService RegisterRegion]] for a detailed trace of GridService.RegisterRegion() and DeregisterRegion().

	----		----

Jwbshaw: fixed main calling code

2026-06-29T20:43:21Z

fixed main calling code

← Older revision		Revision as of 20:43, 29 June 2026
Line 9:		Line 9:
	=== Entry Point ===		=== Entry Point ===

	OpenSim/Server/~~Base/OpenSimServer~~.cs -- Main()		OpenSim/Server/ServerMain.cs -- class OpenSimServer, Main()

	Sequence:		Sequence:

	# ~~Instantiates~~ HttpServerBase ("R.O.B.U.S.T.", args)		# Sets culture and .NET HTTP client defaults:
	~~# Config~~ loaded ~~in layers~~ (see below)		#* ServicePointManager.DefaultConnectionLimit = 64
	# ~~HTTP server~~(s) ~~started~~		#* ServicePointManager.MaxServicePointIdleTime = 30000
	# ~~Service~~ connector ~~plugins loaded~~ from [ServiceList] ~~in Robust~~.~~ini~~		#* Expect100Continue = false
	# ~~Main loop~~ -- console ~~prompt~~, ~~watchdog~~, ~~waits for shutdown~~		#* UseNagleAlgorithm = false
			#* ServerCertificateValidationCallback = ValidateServerCertificate
			# Creates HttpServerBase("R.O.B.U.S.T.", args) -- config is loaded here (see Config Loading below)
			# Reads [Startup] section -- throws if missing
			# Reads DnsTimeout (default 30000ms), NoVerifyCertChain, NoVerifyCertHostname from [Startup]
			# Calls WebUtil.SetupHTTPClients() with cert settings and max 32 connections
			# Reads connector list -- merges ServiceConnectors from [Startup] with all keys from [ServiceList]
			# Copies System.Drawing.Common.dll for current platform (Windows vs Linux)
			# Loops through connectors -- parses configName@port/dll:class format, loads each (see Service Connector Loading below)
			# Special case: LLLoginServiceInConnector gets an IndexPHPHandler added to its HTTP server before loading
			# Prints robuststartuplogo.txt to console if present
			# Creates PluginLoader
			# Calls m_Server.Run() -- enters main loop
			# On exit: m_Server.Shutdown(), Util.StopThreadPool(), Environment.Exit()

	----		----
Line 23:		Line 36:
	=== Config Loading ===		=== Config Loading ===

	OpenSim/~~Framework~~/~~Servers~~/~~HttpServer/BaseHttpServer~~.cs		OpenSim/Server/Base/HttpServerBase.cs
	OpenSim/Server/Base/ServicesServerBase.cs		OpenSim/Server/Base/ServicesServerBase.cs

	~~Config is loaded~~ in ~~layers~~, each overriding the previous:		HttpServerBase constructor handles config loading. Layers are applied in order, each overriding the previous:

	# Command line args parsed (-i ini file, -c console, -l logfile, -p prompt, -g logconfig)		# Command line args parsed (-i ini file, -c console, -l logfile, -p prompt, -g logconfig)
Line 46:		Line 59:
	=== HTTP Servers ===		=== HTTP Servers ===

	OpenSim/~~Framework~~/~~Servers~~/~~HttpServer/BaseHttpServer~~.cs		OpenSim/Server/Base/HttpServerBase.cs

	* Main HTTP server created on port from [Network]		* Main HTTP server created on port from [Network]
	* Optional second SSL listener if https_listener = true		* Optional second SSL listener if https_listener = true
	* All servers started before connectors are loaded ~~-- handlers~~ register into a running server		* All servers started before connectors are loaded
			* Additional ports are created on demand via MainServer.GetHttpServer(port) during connector loading
			* Handlers register into a running server during connector construction

	----		----
Line 56:		Line 71:
	=== Service Connector Loading ===		=== Service Connector Loading ===

	~~OpenSim/Server/Base/ServicesServerBase.cs -- LoadPlugins()~~
	OpenSim/Server/Base/ServerUtils.cs -- LoadPlugin()		OpenSim/Server/Base/ServerUtils.cs -- LoadPlugin()

	~~Each entry in [ServiceList] in Robust.ini is loaded as a plugin~~:		Connector string format:

	~~AssetServiceConnector = "${Const\|PrivatePort}~~/OpenSim.Server.Handlers.dll:~~AssetServiceConnector"~~		configName@port/OpenSim.Server.Handlers.dll:ClassName

	~~Format~~: ~~Port~~/~~DllName~~:~~ClassName~~		Parsing:
			* Split on / -- left side is optional configName@port, right side is dll:class
			* Split left side on @ -- if two parts, first is configName, second is port
			* If port specified: get or create HTTP server for that port via MainServer.GetHttpServer()
			* If no port: use MainServer.Instance (main port)

	LoadPlugin() ~~uses .NET reflection~~ to ~~instantiate each connector class~~, ~~passing IConfigSource and~~ IHttpServer~~. Each connector registers its HTTP handlers on the running server during construction.~~		Loading:
			* LoadPlugin() tries constructor with (IConfigSource, IHttpServer, configName) first
			* Falls back to (IConfigSource, IHttpServer) if that fails
			* Loaded connectors added to m_ServiceConnectors list
			* Failed loads logged as errors but do not stop startup

	See [[OpenSimulator Internals/Connector Architecture]] for the full connector pattern.		See [[OpenSimulator Internals/Connector Architecture]] for the full connector pattern.
Line 78:		Line 100:
	* Sits in a console prompt loop		* Sits in a console prompt loop
	* Shutdown signal (quit/shutdown command or SIGTERM) triggers:		* Shutdown signal (quit/shutdown command or SIGTERM) triggers:
	** ~~HTTP server shutdown~~		** m_Server.Shutdown()
	** ~~Watchdog disposal~~		** Util.StopThreadPool()
	** ~~Thread pool shutdown~~		** Environment.Exit()
	** PID file removal

	----		----

Jwbshaw: first

2026-06-28T10:08:29Z

first

New page

= OpenSimulator Internals/Code Map/ROBUST =

== Overview ==

ROBUST is the grid services process. It reads configuration, starts HTTP listeners, loads service connector plugins, then sits waiting for incoming HTTP requests from simulators.

----

=== Entry Point ===

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

Sequence:

# Instantiates HttpServerBase ("R.O.B.U.S.T.", args)
# Config loaded in layers (see below)
# HTTP server(s) started
# Service connector plugins loaded from [ServiceList] in Robust.ini
# Main loop -- console prompt, watchdog, waits for shutdown

----

=== Config Loading ===

OpenSim/Framework/Servers/HttpServer/BaseHttpServer.cs
OpenSim/Server/Base/ServicesServerBase.cs

Config is loaded in layers, each overriding the previous:

# Command line args parsed (-i ini file, -c console, -l logfile, -p prompt, -g logconfig)
# Ini file loaded -- defaults to Robust.ini, derived from executable name. Can be a local file or remote HTTP/HTTPS URL.
# Include-* keys scanned -- additional ini files merged in. Supports wildcards and URLs. Loop repeats until no new includes found.
# Environment variables merged in
# Command line args merged on top -- command line always wins
# Variable substitution run (ReplaceKeyValues) -- expands ${Section|Key} references
# ReadConfig() called -- reads [Network] section for port and SSL settings

[Network] minimum requirements:
* port -- required, no default, ROBUST will not start without it
* https_main, https_listener, https_external -- optional SSL flags
* cert_path, cert_pass -- required if SSL enabled
* ConsolePort -- optional remote console port

----

=== HTTP Servers ===

OpenSim/Framework/Servers/HttpServer/BaseHttpServer.cs

* Main HTTP server created on port from [Network]
* Optional second SSL listener if https_listener = true
* All servers started before connectors are loaded -- handlers register into a running server

----

=== Service Connector Loading ===

OpenSim/Server/Base/ServicesServerBase.cs -- LoadPlugins()
OpenSim/Server/Base/ServerUtils.cs -- LoadPlugin()

Each entry in [ServiceList] in Robust.ini is loaded as a plugin:

AssetServiceConnector = "${Const|PrivatePort}/OpenSim.Server.Handlers.dll:AssetServiceConnector"

Format: Port/DllName:ClassName

LoadPlugin() uses .NET reflection to instantiate each connector class, passing IConfigSource and IHttpServer. Each connector registers its HTTP handlers on the running server during construction.

See [[OpenSimulator Internals/Connector Architecture]] for the full connector pattern.

----

=== Main Loop ===

OpenSim/Server/Base/ServicesServerBase.cs -- Run()

* Watchdog and MemoryWatchdog threads enabled
* Sits in a console prompt loop
* Shutdown signal (quit/shutdown command or SIGTERM) triggers:
** HTTP server shutdown
** Watchdog disposal
** Thread pool shutdown
** PID file removal

----

=== Service Implementations ===

Each service connector loaded from [ServiceList] handles one service domain. See [[OpenSimulator Internals/ROBUST Services]] for the full list.

{| class="wikitable"
! Service !! Implementation !! Handler
|-
| AssetService || OpenSim/Services/AssetService/AssetService.cs || OpenSim/Server/Handlers/Asset/
|-
| GridService || OpenSim/Services/GridService/GridService.cs || OpenSim/Server/Handlers/Grid/
|-
| UserAccountService || OpenSim/Services/UserAccountService/UserAccountService.cs || OpenSim/Server/Handlers/UserAccounts/
|-
| PresenceService || OpenSim/Services/PresenceService/PresenceService.cs || OpenSim/Server/Handlers/Presence/
|-
| InventoryService || OpenSim/Services/InventoryService/XInventoryService.cs || OpenSim/Server/Handlers/Inventory/
|-
| AuthenticationService || OpenSim/Services/AuthenticationService/PasswordAuthenticationService.cs || OpenSim/Server/Handlers/Authentication/
|-
| LoginService || OpenSim/Services/LLLoginService/LLLoginService.cs || OpenSim/Server/Handlers/Login/
|-
| GatekeeperService || OpenSim/Services/HypergridService/GatekeeperService.cs || OpenSim/Server/Handlers/Hypergrid/
|-
| UserAgentService || OpenSim/Services/HypergridService/UserAgentService.cs || OpenSim/Server/Handlers/Hypergrid/
|}

----

== See Also ==

* [[OpenSimulator Internals/Code Map]]
* [[OpenSimulator Internals/Reading the Code]]
* [[OpenSimulator Internals/ROBUST Services]]
* [[OpenSimulator Internals/Connector Architecture]]