Groups

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(XmlRpcGroups module: updated the opensim.ini [groups] section)
Line 10: Line 10:
 
To enable basic groups functionality on rev 9215 or later, the <tt>Groups</tt> section of your <tt>OpenSim.ini</tt> should look something like:
 
To enable basic groups functionality on rev 9215 or later, the <tt>Groups</tt> section of your <tt>OpenSim.ini</tt> should look something like:
  
[Groups]
+
  [Groups]
    Enabled = true
+
    Enabled = true
 
+
    ; This is the current groups stub in Region.CoreModules.Avatar.Groups
    ; This is the current groups stub in Region.CoreModules.Avatar.Groups
+
    ;Module  = Default
    ;Module  = Default
+
    ; The PHP code for the server is available from the Flotsam project for you to deploy
+
    ; to your own server.  The Flotsam project is located at http://code.google.com/p/flotsam/
    ; 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
+
    Module  = GroupsModule
    ; or available if you use this service, but it's available now and seems to work. 
+
    ; Enable Group Notices
    ; The PHP code for the service is available for you to deploy to your own server.
+
    NoticesEnabled   = true
    ;
+
    ; This makes the Groups modules very chatty on the console.
    Module = XmlRpcGroups
+
    DebugEnabled    = true
+
    ; Specify which messaging module to use for groups messaging and if it's enabled
    XmlRpcServiceURL      = http://osflotsam.org/xmlrpc.php
+
     MessagingModule = GroupsMessagingModule
    ;XmlRpcServiceReadKey = 1234
+
    MessagingEnabled = true
    ;XmlRpcServiceWriteKey = 1234
+
    ; Service connector to Groups Service [Select One]
    XmlRpcMessagingEnabled = true
+
    ; XmlRpc Service Connector to the Flotsam XmlRpc Groups Service Implementation
    XmlRpcNoticesEnabled   = true
+
    ServicesConnectorModule = XmlRpcGroupsServicesConnector
+
    XmlRpcServiceURL        = http://yourxmlrpcserver.com/xmlrpc.php
    ; This makes the XmlRpcGroups modules very chatty on the console.
+
    ;XmlRpcServiceReadKey    = 1234
    ;XmlRpcDebugEnabled     = true
+
    ;XmlRpcServiceWriteKey  = 1234
+
    ; Disables HTTP Keep-Alive for XmlRpcGroupsServicesConnector HTTP Requests,
    ; Disables HTTP Keep-Alive for Groups Module HTTP Requests, work around for
+
    ; this is a work around fora problem discovered on some Windows based region servers.
    ; a problem discovered on some Windows based region servers. Only disable
+
    ; Only disable keep alive if you see a large number (dozens) of the following Exceptions:
    ; if you see a large number (dozens) of the following Exceptions:
+
    ; System.Net.WebException: The request was aborted: The request was canceled.
    ; System.Net.WebException: The request was aborted: The request was canceled.
+
    ;
    ;
+
    ; XmlRpcDisableKeepAlive = false
    ; XmlRpcDisableKeepAlive = false
+
  
  

Revision as of 17:57, 31 January 2010


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 PHP code for the server is available from the Flotsam project for you to deploy
   ; to your own server.  The Flotsam project is located at http://code.google.com/p/flotsam/
   ;
   Module  = GroupsModule
   ; Enable Group Notices
   NoticesEnabled   = true
   ; This makes the Groups modules very chatty on the console.
   DebugEnabled     = true
   ; Specify which messaging module to use for groups messaging and if it's enabled
   MessagingModule = GroupsMessagingModule
   MessagingEnabled = true
   ; Service connector to Groups Service [Select One]
   ; XmlRpc Service Connector to the Flotsam XmlRpc Groups Service Implementation
   ServicesConnectorModule = XmlRpcGroupsServicesConnector
   XmlRpcServiceURL        = http://yourxmlrpcserver.com/xmlrpc.php
   ;XmlRpcServiceReadKey    = 1234
   ;XmlRpcServiceWriteKey   = 1234
   ; Disables HTTP Keep-Alive for XmlRpcGroupsServicesConnector HTTP Requests,
   ; this is a work around fora problem discovered on some Windows based region servers.
   ; Only disable keep alive 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.

Personal tools
General
About This Wiki