OGP patches with Agent Domain/Service

The referenced patches enable a simple agent domain, consistent with the OGP Agent Domain hosted by Linden Lab(TM) on their VAAK test grid. This agent domain requires an OGP compliant client. Currently, the Snowglobe client works.

What is included

An Agent Domain/Service, permitting OGP style Login and Teleport between regions

Inventory reflection permitting a single inventory to be maintained and accessed across OGP teleports

a "scattered asset service" which lets you fetch assets from remote regions.

What is not included:

IMs and Group notifcations or related services

Security

Presence across grid

Any Agent Service / Agent Service messaging

This is a PRELIMINARY, NON PRODUCTION patch for tester and the curious.

It does not provide security

It is undergoing testing

Do not run this code in productoin environments. Assume this code will change over
time, both to fix bugs, and to track changes in the proposed specification.

Accessing the source code

The tree itself is hosted on github where you can download the latest version. you can either download via the download button or you can clone the git repository:

WARNING: DO not check out into an existing OpenSim? Install 

WARNING: Not for production use -- Use at your own risk

% git clone git://github.com/zekizeki/agentservice.git

after the initial check out you will see 
"warning: remote HEAD refers to nonexistent ref, unable to checkout."
ignore the above warning and do the next 2 steps

% cd agentservice
% git checkout -b august27merge origin/august27merge

Running the code:

You should be familiar with running a normal gridded or stand along OpenSim? environment, post the August 2009 .ini and configuration changes.

This note will not help you setup mysql, sqllite, or related components. It assumes you know how to build, install and manage a basic opensim install.
 

You can build and configure this copy of OpenSim? normally.

You need to enable the OGP code in your regions:

OGP is enabled in the main portion of the region ini file.

in OpenSim?.ini  modify the "openGridProtocol" stanza::
OpenGridProtocol?

;These are the settings for the Open Grid Protocol.. the Agent Domain, Region Domain, you know..

;On/true or Off/false

ogp_enabled=true;
Name Prefix/suffix when using OGP
ogp_firstname_prefix=""
ogp_lastname_suffix="_EXTERNAL"
 
 

You need to start the openSim.Grid.AgentDomain?.exe executable, using either mono or native
support, depending on your environment.

The AgentDomain? code will act as a trivial login service. You can add users via the AgentDomain? console, as if it were a standard OpenSim? user service.

Configuring to use the scattered asset service:

./config-include$ more Standalone.ini
;;
;; Please don't change this file.
;; All optional settings are in StandaloneCommon?.ini.example,
;; which you can copy and change.
;;

Includes?
    Include-Common = "config-include/StandaloneCommon?.ini"

Modules?
    AssetServices?     = "LocalLocalAssetServicesConnector?Connector"
    InventoryServices? = "LocalLocalInventoryServicesConnector?Connector"
    NeighbourServices? = "LocalLocalNeighbourServicesConnector?Connector"

AssetService?
    LocalServiceModule? = "OpenSim?.Services.ScatteredAssetService?.dll:ScatteredAs?
setService"

InventoryService?
    LocalServiceModule? = "OpenSim?.Services.InventoryService?.dll:InventoryService?

 Configuring the scattered asset service:

You need to tell the scatered asset service where to look for assets:

In the bin directory you will find "interop.txt"

ciogrid@ame314:/opt/opensim/agentservice/bin$ more interop.txt
#
# Local port is the port that this
# asset server will listen on.
#
localport = 9999
#
# These are examples of other known asset servers.
# Provided your machine is an SMP, you can use
# these to test things out by way of circular
# failures. Specifying a prefix (path) is only
# necessary if this is a heterogeneous asset
# server such as cable beach.
#
# server   = 127.0.0.1:9999
server = ame313.watson.ibm.com:9999
#server = ame314.watson.ibm.com
# server   = plato 

 Feedback:

Please feel free to send feedback to:

David Levine dwl@us.ibm.com

Alan Webb alan_webb@us.ibm.com

Rob Smart smartrob@uk.ibm.com