Difference between revisions of "Architecture/Robust"

From LookingGlass

Jump to: navigation, search
(half formatted)
(intro section. more formatting)
Line 1: Line 1:
===Robust Architecture===
+
==Robust Architecture==
"Robust" is two things:  
+
This is a walk through of the Robust system in OpenSimulator as of September 12, 2010.
 +
The goal is to explain the component and grid service system by digging down in some
 +
example services.
 +
 
 +
The term "Robust" is used for two things:  
 
* a modular system of connectors enabling flexible configurations of grid services; and  
 
* a modular system of connectors enabling flexible configurations of grid services; and  
 
* a container for running back-end grid services
 
* a container for running back-end grid services
Line 18: Line 22:
 
<tt>LocalAssetServicesConnector</tt>'s code is in  
 
<tt>LocalAssetServicesConnector</tt>'s code is in  
 
<tt>OpenSim.Region.CoreModules.ServiceConnectorsOut.Asset</tt>. This module
 
<tt>OpenSim.Region.CoreModules.ServiceConnectorsOut.Asset</tt>. This module
presents an <tt>IAssetService</tt> interface and provides that functionality
+
is a shared region module that registers itself with the region to
by looking up a local service module in <tt>Standalone.ini</tt>
+
present an <tt>IAssetService</tt> interface.
 
+
It provides that functionality
<tt>LocalAssetServicesConnector</tt> finds in <tt>Standalone.ini</tt>:
+
by looking up a local service module in <tt>Standalone.ini</tt>. <tt>LocalAssetServicesConnector</tt> finds in <tt>Standalone.ini</tt>:
  
 
     [AssetService]
 
     [AssetService]
Line 29: Line 33:
 
which implements local database access for assets.
 
which implements local database access for assets.
  
Now let's look at Grid mode. The entry in "Grid.ini" is
+
Now let's look at Grid mode. The entry in <tt>Grid.ini</tt> is
 
     [Modules]
 
     [Modules]
 
         AssetService = "RemoteAssetServicesConnector"
 
         AssetService = "RemoteAssetServicesConnector"
Line 35: Line 39:
 
<tt>RemoteAssetServicesConnector</tt>'s code is in
 
<tt>RemoteAssetServicesConnector</tt>'s code is in
 
<tt>OpenSim.Region.CoreModules.ServiceConnectorOut.Asset</tt> and
 
<tt>OpenSim.Region.CoreModules.ServiceConnectorOut.Asset</tt> and
presents an <tt>IAssetService</tt> interface as well as inheriting the
+
is also a region module that registers its
 +
<tt>IAssetService</tt> with the region. This module also inherits the
 
<tt>AssetServicesConnector</tt> class. This module uses the URI
 
<tt>AssetServicesConnector</tt> class. This module uses the URI
specifed in the <tt>[AssetService]</tt> section to connect
+
specified in the <tt>[AssetService]</tt> section to connect
 
to the remote grid service.
 
to the remote grid service.
  
Line 73: Line 78:
 
by the standalone configuration. So, what one ends up with is a
 
by the standalone configuration. So, what one ends up with is a
 
network connector in the region which can talk to a network connection
 
network connector in the region which can talk to a network connection
receiver in Robust.exe which is running the exact same code as
+
receiver in <tt>Robust.exe</tt> which is running the exact same code as
 
the standalone asset service.
 
the standalone asset service.
  

Revision as of 18:09, 12 September 2010

Home < Architecture < Robust

Robust Architecture

This is a walk through of the Robust system in OpenSimulator as of September 12, 2010. The goal is to explain the component and grid service system by digging down in some example services.

The term "Robust" is used for two things:

  • a modular system of connectors enabling flexible configurations of grid services; and
  • a container for running back-end grid services

We'll start with the first and work up to the second.

The Robust connector architecture links together request APIs to service providers with a set of modules that are loaded and configured at simulator start up time.

Let's work through an example for a standalone grid.

In Standalone.ini, there is

   [Modules]
       AssetServices = "LocalAssetServicesConnector"

LocalAssetServicesConnector's code is in OpenSim.Region.CoreModules.ServiceConnectorsOut.Asset. This module is a shared region module that registers itself with the region to present an IAssetService interface. It provides that functionality by looking up a local service module in Standalone.ini. LocalAssetServicesConnector finds in Standalone.ini:

   [AssetService]
       LocalServiceModule = "OpenSim.Services.AssetService.dll:AssetService"

LocalAssetServicesConnector loads the asset service (see note below) which implements local database access for assets.

Now let's look at Grid mode. The entry in Grid.ini is

   [Modules]
       AssetService = "RemoteAssetServicesConnector"

RemoteAssetServicesConnector's code is in OpenSim.Region.CoreModules.ServiceConnectorOut.Asset and is also a region module that registers its IAssetService with the region. This module also inherits the AssetServicesConnector class. This module uses the URI specified in the [AssetService] section to connect to the remote grid service.

As a side note, the connectors specified in the [Modules] section are loaded via OpenSim.ApplicationPlugins.RegionModulesController.RegionModulesControllerPlugin which loads all the modules with the extension "/OpenSim/RegionModules". This extension is specified either in the source of the module or in one of the XML resource files (like "CoreModulePlugin.addin.xml"). Later connectors are usually loaded by the Robust plugin loader (OpenSim.Server.Base.ServerUtils.LoadPlugin). This latter loader takes the parameter "DLLName:PackageID" which is what you will find elsewhere in the configuration files.

For the grid configuration, each region in the simulator is connected to a RemoteAssetServicesConnector which implements the IAssetService interface by making network requests.

This is where the Robust grid service container comes in.

To implement the receiver of the asset requests and access the database a container is needed which reads configuration and assembles all the connectors. The application Robust.exe reads Robust.ini and starts up all the services specified in ServiceConnectors.

Continuing with the asset service example, the parameter is "8003/OpenSim.Server.Handlers.dll:AssetServiceConnector. This connector looks up the asset service in Robust.ini:

   [AssetService]
       LocalServiceModule = "OpenSim.Services.AssetService.dll:AssetService"

Well look at that! This is exactly the same asset service code loaded by the standalone configuration. So, what one ends up with is a network connector in the region which can talk to a network connection receiver in Robust.exe which is running the exact same code as the standalone asset service.

<<picture of networked asset service>>

This connector architecture is used for all the services and each region service can be individually configured for remote or local connections and code can be shared between the standalone setup and the grid services setup.

Since everything is parameterized, there is no reason that there be only one grid service -- there can be many Robust.exe's each configured to run some of the grid services. Similarly, some services could be local while others remote. Why you'd do that I don't know, but it's possible.

<<picture of multiple grid service servers>>

HYPERGRID

OTHER NOTES

There has been some confusion about the different available grid backends (Robust and Simian).

The Robust backend uses C# code to implement the grid service (asset, inventory, ...) and the code is modularized in such a way that the same code can be used for standalone and grid simulator configurations. The Simian backend, on the other hand, is an implementation of the grid services using REST/PHP/etc. So, Robust and Simian both use the Robust connector architecture but use different protocols and data storage systems on the backend.

Personal tools