Connectors - Revision history

Ssm2017: added quicklinks

2013-01-14T07:26:37Z

added quicklinks

Justincc: /* References */

2012-04-26T15:26:41Z

‎References

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

2012-03-04T06:18:04Z

Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

MakoBot: Robot: Cosmetic changes

2012-03-04T02:53:48Z

Robot: Cosmetic changes

Justincc: Improve readability of table by breaking out locations of the various components

2011-07-18T22:44:42Z

Improve readability of table by breaking out locations of the various components

Justincc at 00:07, 5 July 2011

2011-07-05T00:07:36Z

Justincc: /* Overview */

2011-07-04T18:19:31Z

‎Overview

Justincc: /* Configuration */

2011-07-04T18:19:03Z

‎Configuration

Justincc: /* Configuration */

2011-07-04T18:18:32Z

‎Configuration

Justincc: /* Example */

2011-07-04T18:06:08Z

‎Example

← Older revision		Revision as of 07:26, 14 January 2013
Line 1:		Line 1:
		+	{{Quicklinks}}
		+	<br />
	==Overview==		==Overview==

← Older revision		Revision as of 15:26, 26 April 2012
Line 78:		Line 78:

	For some more extensive but somewhat outdated documentation on services and connectors, please see [[OpenSim Services and Service Connectors]]		For some more extensive but somewhat outdated documentation on services and connectors, please see [[OpenSim Services and Service Connectors]]
		+
		+	See [[Services]] for a summary of services.

@@ Line 6: / Line 6: @@
 !Component!!Location!!Description
 |-
-| The simulator code itself || OpenSim core or a module || This initially references the service to get or set data.
+| The simulator code itself || OpenSimulator core or a module || This initially references the service to get or set data.
 |-
 | The simulator service connector || OpenSim/Region/CoreModules/ServiceConnectorsOut (for outbound connections) and ServiceConnectorsIn (for inbound connections) || These connectors come in two flavours, local and remote.  The local connectors connect directly to the service and are used when caller and service are in the same process (as in the standalone configuration).  The remote connectors use the service connectors in OpenSim/Services/Connectors to make a call over the network to some remote process.
@@ Line 33: / Line 33: @@
 == Configuration ==
-Connectors are configured in OpenSim configuration files. For standalone, the configuration is in bin/config-include/Standalone.ini. Standalone users never need to change this file. For grid users, the configuration is in bin/config-include/Grid.ini and GridCommon.ini. In the grid case, GridCommon.ini (after copying from GridCommon.ini.example) is where the user specifies the URLs for each grid service.
+Connectors are configured in OpenSimulator configuration files. For standalone, the configuration is in bin/config-include/Standalone.ini. Standalone users never need to change this file. For grid users, the configuration is in bin/config-include/Grid.ini and GridCommon.ini. In the grid case, GridCommon.ini (after copying from GridCommon.ini.example) is where the user specifies the URLs for each grid service.
 === Standalone ===
@@ Line 52: / Line 52: @@
      LocalServiceModule = "OpenSim.Services.AssetService.dll:AssetService"
-This is where we tell OpenSim which DLL to load for the in-process asset service.
+This is where we tell OpenSimulator which DLL to load for the in-process asset service.
 === Grid ===

@@ Line 1: / Line 1: @@
 ==Overview==
-There are up to 5 components involved in connecting simulator code to a grid service.  These are
+There are up to 5 components involved in connecting simulator code to a grid service. These are
 {| border="1"
@@ Line 17: / Line 17: @@
 |}
-==Example==
+== Example ==
-Let's take a look at the asset service.  The asset service connector is available as the Scene.AssetService property in the Scene object (direct references aren't always available - sometimes the connector has to be requested via the Scene.RequestModuleInterface<Interface>() mechanism).
+Let's take a look at the asset service. The asset service connector is available as the Scene.AssetService property in the Scene object (direct references aren't always available - sometimes the connector has to be requested via the Scene.RequestModuleInterface<Interface>() mechanism).
 A caller executes the method Scene.AssetService.Get() to retrieve an asset synchronously.
-Suppose first of all that we're running a standalone configuration where both simulator and service are in the same process.  In this case, the simulator's call goes to the LocalAssetServiceConnector.Get().  This first checks the cache, and if the asset isn't found there, then calls AssetService.Get().  The AssetService retrieves the asset from persistent storage and passes it back to the simulator code.
+Suppose first of all that we're running a standalone configuration where both simulator and service are in the same process. In this case, the simulator's call goes to the LocalAssetServiceConnector.Get(). This first checks the cache, and if the asset isn't found there, then calls AssetService.Get(). The AssetService retrieves the asset from persistent storage and passes it back to the simulator code.
-Now let's suppose that we're running in a grid configuration, where the asset service is operating on some other machine.  As before, the simulator code calls Scene.AssetService.Get().  This time, the call is routed to RemoteAssetServiceConnector.Get(), which in this case inherits from OpenSim/Services/Connectors/AssetServiceConnector.
+Now let's suppose that we're running in a grid configuration, where the asset service is operating on some other machine. As before, the simulator code calls Scene.AssetService.Get(). This time, the call is routed to RemoteAssetServiceConnector.Get(), which in this case inherits from OpenSim/Services/Connectors/AssetServiceConnector.
 AssetServiceConnector.Get() generates an HTTP call to http://yourassetserver/assets/assetId, where assetId is the id of the asset requested.
-This hops over the network and is handled by OpenSim/Server/Handlers/Asset/AssetServerConnector.  It uses its own AssetServerGetHandler to unpack the HTTP request and call the AssetService to retrieve the data.  If the asset is found, then it returns the asset as XML ready for the receiving AssetServiceConnector to unpack.  If the asset is missing then it returns a 404 HTTP status code.
+This hops over the network and is handled by OpenSim/Server/Handlers/Asset/AssetServerConnector. It uses its own AssetServerGetHandler to unpack the HTTP request and call the AssetService to retrieve the data. If the asset is found, then it returns the asset as XML ready for the receiving AssetServiceConnector to unpack. If the asset is missing then it returns a 404 HTTP status code.
-==Configuration==
+== Configuration ==
-Connectors are configured in OpenSim configuration files.  For standalone, the configuration is in bin/config-include/Standalone.ini.  Standalone users never need to change this file.  For grid users, the configuration is in bin/config-include/Grid.ini and GridCommon.ini.  In the grid case, GridCommon.ini (after copying from GridCommon.ini.example) is where the user specifies the URLs for each grid service.
+Connectors are configured in OpenSim configuration files. For standalone, the configuration is in bin/config-include/Standalone.ini. Standalone users never need to change this file. For grid users, the configuration is in bin/config-include/Grid.ini and GridCommon.ini. In the grid case, GridCommon.ini (after copying from GridCommon.ini.example) is where the user specifies the URLs for each grid service.
-===Standalone===
+=== Standalone ===
-Let's look at Standalone.ini.  You'll see that there is a Modules section with the lines
+Let's look at Standalone.ini. You'll see that there is a Modules section with the lines
   [Modules]
@@ Line 45: / Line 45: @@
      ...
-This is where the connectors are specified for each service.  As you can see, the asset service here is specified to use the LocalAssetServicesConnector.
+This is where the connectors are specified for each service. As you can see, the asset service here is specified to use the LocalAssetServicesConnector.
 Further down, you can see the section
@@ Line 54: / Line 54: @@
 This is where we tell OpenSim which DLL to load for the in-process asset service.
-===Grid===
+=== Grid ===
 Compare this with Grid.ini.
@@ Line 64: / Line 64: @@
      ...
 In this case, the asset service connector is specified as the RemoteAssetServicesConnector class.
-The [AssetService] section isn't in this file because we don't load a service class directly (seeing as the service is hosted remotely).  Rather, we need to specify the URL where the asset service is found.  Since this will be different for various grid installations, it's in the user configurable GridCommon.ini file instead.
+The [AssetService] section isn't in this file because we don't load a service class directly (seeing as the service is hosted remotely). Rather, we need to specify the URL where the asset service is found. Since this will be different for various grid installations, it's in the user configurable GridCommon.ini file instead.
   [AssetService]
@@ Line 75: / Line 75: @@
      AssetServerURI = "http://myassetserver.com:8003"
-==References==
+== References ==
 For some more extensive but somewhat outdated documentation on services and connectors, please see [[OpenSim Services and Service Connectors]]

@@ Line 4: / Line 4: @@
 {| border="1"
-!Component!!Description
+!Component!!Location!!Description
 |-
-| The simulator code itself || This references the data service.  This can be in OpenSim core or in a module.
+| The simulator code itself || OpenSim core or a module || This initially references the service to get or set data.
 |-
-| The simulator service connector || These are found in OpenSim/Region/CoreModules/ServiceConnectorsOut/ (for outbound connections) and ServiceConnectorsIn/ (for inbound connections).  These connectors come in two flavours, local and remote.  The local connectors connect directly to the service and are used when caller and service are in the same process (as in the standalone configuration).  The remote connectors use the service connectors in OpenSim/Services/Connectors to make a call over the network to some remote process.
+| The simulator service connector || OpenSim/Region/CoreModules/ServiceConnectorsOut (for outbound connections) and ServiceConnectorsIn (for inbound connections) || These connectors come in two flavours, local and remote.  The local connectors connect directly to the service and are used when caller and service are in the same process (as in the standalone configuration).  The remote connectors use the service connectors in OpenSim/Services/Connectors to make a call over the network to some remote process.
 |-
-| The remote service connector || These are found in OpenSim/Services/Connectors, as stated above.  They actually marshal the data and make the appropriate call to a remote data service.  These are not used for in-process connections.
+| The remote service connector || OpenSim/Services/Connectors || These do the work of actually marshalling the data and make the appropriate call to a remote data service.  These are not used for in-process connections.
 |-
-| The remote service handler || These are found in OpenSim/Server/Handlers/  These are not used for in-process connections.  These unpack the call received from a simulator connector and pass it on to the service itself.
+| The remote service handler || OpenSim/Server/Handlers || These are not used for in-process connections.  These unpack the call received from a simulator connector and pass it on to the service itself.
 |-
-| The service || Each major service has its own package (e.g. OpenSim/Services/AssetService).  The service actually services the call and returns data to the caller, if applicable.
+| The service || Each major service has its own package (e.g. OpenSim/Services/AssetService).|| The service actually services the call and returns data to the caller, if applicable.
 |}

← Older revision		Revision as of 00:07, 5 July 2011
Line 74:		Line 74:
	;		;
	AssetServerURI = "http://myassetserver.com:8003"		AssetServerURI = "http://myassetserver.com:8003"
		+
		+	==References==
		+
		+	For some more extensive but somewhat outdated documentation on services and connectors, please see [[OpenSim Services and Service Connectors]]

← Older revision		Revision as of 18:18, 4 July 2011
Line 32:		Line 32:

	==Configuration==		==Configuration==
		+
		+	Connectors are configured in OpenSim configuration files. For standalone, the configuration is in bin/config-include/Standalone.ini. Standalone users never need to change this file. For grid users, the configuration is in bin/config-include/Grid.ini and GridCommon.ini. In the grid case, GridCommon.ini (after copying from GridCommon.ini.example) is where the user specifies the URLs for each grid service.
		+
		+	Let's look at Standalone.ini. You'll see that there is a Modules section with the lines
		+
		+	[Modules]
		+	AssetServices = "LocalAssetServicesConnector"
		+	InventoryServices = "LocalInventoryServicesConnector"
		+	NeighbourServices = "LocalNeighbourServicesConnector"
		+	...
		+
		+	This is where the connectors are specified for each service. As you can see, the asset service here is specified to use the LocalAssetServicesConnector.
		+
		+	Further down, you can see the section
		+
		+	[AssetService]
		+	LocalServiceModule = "OpenSim.Services.AssetService.dll:AssetService"
		+
		+	This is where we tell OpenSim which DLL to load for the in-process asset service.
		+
		+	Compare this with Grid.ini.
		+
		+	[Modules]
		+	AssetServices = "RemoteAssetServicesConnector"
		+	InventoryServices = "RemoteXInventoryServicesConnector"
		+	GridServices = "RemoteGridServicesConnector"
		+	...
		+
		+	In this case, the asset service connector is specified as the RemoteAssetServicesConnector class.
		+
		+	The [AssetService] section isn't in this file because we don't load a service class directly (seeing as the service is hosted remotely). Rather, we need to specify the URL where the asset service is found. Since this will be different for various grid installations, it's in the user configurable GridCommon.ini file instead.
		+
		+	[AssetService]
		+	...
		+	;
		+	; change this to your grid-wide asset server
		+	;
		+	AssetServerURI = "http://myassetserver.com:8003"