UserProfiles

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(Configure Standalone Service)
m (restructure section levels a bit to improve readability - I hope)
Line 9: Line 9:
 
Enabling the built-in user profiles support requires  
 
Enabling the built-in user profiles support requires  
  
# Configuration in Robust.ini or Robust.HG.ini as appropriate.
+
# Configuration the Service in Robust.ini, Robust.HG.ini or StandaloneCommon.ini as appropriate.
 
# Configuration in OpenSim.ini
 
# Configuration in OpenSim.ini
  
==Configuration in Robust.ini or Robust.HG.ini==
+
=Configuration for a Grid Service 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.
 
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 ===
+
== 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
 
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
  
Line 31: Line 31:
 
If it is desired to provide a separate database for the user profile data, then remove the leading ';' from ConnectionString and Realm, providing the needed values to connect the service to your data source. The data source must be created and configured for access before use.
 
If it is desired to provide a separate database for the user profile data, then remove the leading ';' from ConnectionString and Realm, providing the needed values to connect the service to your data source. The data source must be created and configured for access before use.
  
=== Enable connector ===
+
== 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
 
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
  
Line 39: Line 39:
 
</pre>
 
</pre>
  
=== Publish Profile Server URI for HyperGrid ===
+
== Publish Profile Server URI for HyperGrid ==
 
The [LoginService] section of the Robust.HG.ini file needs the connection details for the Profile Service so that foreign users will be able to view the profile of your users when they travel to other grids via HyperGrid. Set the value of SRV_ProfileServerURI to the URI your Profile Service is configured to use. See the following for example.
 
The [LoginService] section of the Robust.HG.ini file needs the connection details for the Profile Service so that foreign users will be able to view the profile of your users when they travel to other grids via HyperGrid. Set the value of SRV_ProfileServerURI to the URI your Profile Service is configured to use. See the following for example.
  
Line 47: Line 47:
 
</pre>
 
</pre>
  
== Configure Standalone Service ==
+
= Configure for a Standalone Service =
 
Configuring the Standalone simulator to make the built-in Profile Service available is accomplished by editing the StandaloneCommon.ini file in the bin/config-include directory.
 
Configuring the Standalone simulator to make the built-in Profile Service available is accomplished by editing the StandaloneCommon.ini file in the bin/config-include directory.
  
=== Enable service ===
+
== Enable service ==
 
Find the [UserProfileService] section in your StandaloneCommon.ini and make the necessary changes for your site
 
Find the [UserProfileService] section in your StandaloneCommon.ini and make the necessary changes for your site
  
Line 68: Line 68:
 
The preceding example will enable the UserProfiles service using the main database for the profile tables. If a separate database is desired for the profiles data, remove the leading ';' from the ConnectionString and Realm entries. Provide the correct values to the ConnectionString for your profiles database.. The data source must be created and configured for access before use.
 
The preceding example will enable the UserProfiles service using the main database for the profile tables. If a separate database is desired for the profiles data, remove the leading ';' from the ConnectionString and Realm entries. Provide the correct values to the ConnectionString for your profiles database.. The data source must be created and configured for access before use.
  
=== Publish Profile Server URI for HyperGrid ===
+
== Publish Profile Server URI for HyperGrid ==
 
If the Standalone is configured for HyperGrid operation, then the profile service URL will need to be published to allow foreign users to view your user's profiles when they travel to other grids. This is accomplished by setting the value of the SRV_ProfileServerURI which is found under the [LoginService] section in the StandaloneCommon.ini. For example
 
If the Standalone is configured for HyperGrid operation, then the profile service URL will need to be published to allow foreign users to view your user's profiles when they travel to other grids. This is accomplished by setting the value of the SRV_ProfileServerURI which is found under the [LoginService] section in the StandaloneCommon.ini. For example
  
Line 76: Line 76:
 
</pre>
 
</pre>
  
==Configuration in OpenSim.ini==
+
=Configuration for Region Servers 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
 
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
  

Revision as of 07:19, 28 November 2013

Contents

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 the Service in Robust.ini, Robust.HG.ini or StandaloneCommon.ini as appropriate.
  2. Configuration in OpenSim.ini

Configuration for a Grid Service 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 = true
    ;; 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"

If it is desired to provide a separate database for the user profile data, then remove the leading ';' from ConnectionString and Realm, providing the needed values to connect the service to your data source. The data source must be created and configured for access before use.

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"

Publish Profile Server URI for HyperGrid

The [LoginService] section of the Robust.HG.ini file needs the connection details for the Profile Service so that foreign users will be able to view the profile of your users when they travel to other grids via HyperGrid. Set the value of SRV_ProfileServerURI to the URI your Profile Service is configured to use. See the following for example.

[LoginService]
SRV_ProfileServerURI = http://example.com:8002

Configure for a Standalone Service

Configuring the Standalone simulator to make the built-in Profile Service available is accomplished by editing the StandaloneCommon.ini file in the bin/config-include directory.

Enable service

Find the [UserProfileService] section in your StandaloneCommon.ini and make the necessary changes for your site

[UserProfilesService]
    LocalServiceModule = "OpenSim.Services.UserProfilesService.dll:UserProfilesService"
    Enabled = true

    ;; Configure this for separate databse
    ; 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"

The preceding example will enable the UserProfiles service using the main database for the profile tables. If a separate database is desired for the profiles data, remove the leading ';' from the ConnectionString and Realm entries. Provide the correct values to the ConnectionString for your profiles database.. The data source must be created and configured for access before use.

Publish Profile Server URI for HyperGrid

If the Standalone is configured for HyperGrid operation, then the profile service URL will need to be published to allow foreign users to view your user's profiles when they travel to other grids. This is accomplished by setting the value of the SRV_ProfileServerURI which is found under the [LoginService] section in the StandaloneCommon.ini. For example

[LoginService]
SRV_ProfileServerURI = http://example.com:8002

Configuration for Region Servers 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.

Personal tools
General
About This Wiki