Revision as of 17:35, 27 November 2013

Introduction

OpenSimulator 0.7.6 and onwards ship with built-in user profiles support. This will support the dialog-based user profiles seen in Singularity and similar third-party viewers, but not the purely web-based profiles seen in other viewers

At this time, there are issues with using this in a standalone system.

Before OpenSimulator 0.7.6, user profiles was supported using an externally added module. See Profile for more information.

Enabling

Enabling the built-in user profiles support requires

1. Configuration in Robust.ini or Robust.HG.ini as appropriate.
2. Configuration in OpenSim.ini

Configuration in Robust.ini or Robust.HG.ini

The user profiles service needs to be enabled and the connector set up so that the appropriate JSON RPC methods are available to simulators.

Enable service

This requires a UserProfilesService section. You should be able to use the one from Robust.ini.example (or Robust.HG.ini.example) with Enabled = true. For instance

[UserProfilesService]
    LocalServiceModule = "OpenSim.Services.UserProfilesService.dll:UserProfilesService"
    Enabled = false
    ;; Configure this for separate profiles database
    ;; ConnectionString = "Data Source=localhost;Database=opensim;User ID=opensim;Password=*****;Old Guids=true;"
    ;; Realm = UserProfiles
    UserAccountService = OpenSim.Services.UserAccountService.dll:UserAccountService
    AuthenticationServiceModule = "OpenSim.Services.AuthenticationService.dll:PasswordAuthenticationService"

Enable connector

In the [ServiceList] section of Robust.ini or Robust.HG.ini, this requires the connector to be set up on a port that is available to the simulators (and only the simulators). Usually, this would be the same private port on which other grid-only services are exposed. For instance

[ServiceList]
UserProfilesServiceConnector = "8002/OpenSim.Server.Handlers.dll:UserProfilesConnector"

Configuration in OpenSim.ini

Here, there needs to be a [UserProfiles] section with a ProfileServiceURL set that the simulator can reach (not the viewer). For instance, if your ROBUST services and simulator are on the same LAN and your ROBUST services are running on a machine with IP address 192.168.1.3, then this setting would be

[UserProfiles]
  ProfileServiceURL = http://192.168.1.3:8002

See OpenSim.ini.example for more details.