Groups

Revision as of 21:26, 30 April 2009

XmlRpcGroups module

As of rev 9215 in the OpenSim SVN repo, there is now an experimental groups module, XmlRpcGroups, which interacts with a remote XMLRPC service to provide basic groups functionality.

To enable basic groups functionality on rev 9215 or later, the Groups section of your OpenSim.ini should look something like:

[Groups]
    Enabled = true
 
    ; This is the current groups stub in Region.CoreModules.Avatar.Groups
    ;Module  = Default

    ; The XmlRpcGroups implementation can be used against the publically available service
    ; that I have made available for testing.  Your group data is not guarenteed safe
    ; or available if you use this service, but it's available now and seems to work.  
    ; The PHP code for the service is available for you to deploy to your own server.
    ;
    Module  = XmlRpcGroups

    XmlRpcServiceURL       = http://osflotsam.org/xmlrpc.php
    ;XmlRpcServiceReadKey = 1234
    ;XmlRpcServiceWriteKey = 1234
    XmlRpcMessagingEnabled = true
    XmlRpcNoticesEnabled   = true

    ; This makes the XmlRpcGroups modules very chatty on the console.
    ;XmlRpcDebugEnabled     = true

    ; Disables HTTP Keep-Alive for Groups Module HTTP Requests, work around for
    ; a problem discovered on some Windows based region servers.  Only disable
    ; if you see a large number (dozens) of the following Exceptions:
    ; System.Net.WebException: The request was aborted: The request was canceled.
    ;
    ; XmlRpcDisableKeepAlive = false

The XmlRpcServiceReadKey and XmlRpcServiceWriteKey options were implemented in OpenSim SVN rev 9354, and can allow a groups service operator to require a region to provide a read and/or write key in order to access that particular group service.

The XMLRPC service for groups at osflotsam.org is a public test service. If you'd instead like to run your own on your own web server, you can download the code for it from http://code.google.com/p/flotsam/ , specifically what's in trunk/Groups/php , and adjust it and your OpenSim.ini accordingly. More info here and here.