In OpenSim.ini you need to pay attention to following ini items:

[Startup]

• gridmode = true
• clientstack_plugin="ModularRex.dll"

clientstack_plugin must be set to ModularRex so that when client logs in sim creates NaaliClientView that deals with realxtend features: for example broadcasts avatar addresses to other clients in sim so avatar appearances show up correctly.

• storage_plugin = "OpenSim.Data.SQLite.dll"
• storage_connection_string="URI=file:OpenSim.db,version=3";

For database connections you need to choose one of available database providers. sqlite or mysql are recommended. storage_plugin deals with regions database connections.

• physics = basicphysics

physics parameter defines physics engine to be used and basicphysics is one that is known to work without exeptions at the time of writing. Be sure that this is only declared once, when included modrex.ini declares this for the second time exeptions may occur.

[Network]

• http_listener_port = 9000
• default_location_x = 1000
• default_location_y = 1000

These specify port where client connects to and default location for client (The user server sends these to Naali, after it asks them from robust server)

• grid_server_url = "http://127.0.0.1:8003"
• grid_send_key = "null"
• grid_recv_key = "null"
• user_server_url = "http://127.0.0.1:8002"
• user_send_key = "null"
• user_recv_key = "null"
• asset_server_url = "http://127.0.0.1:8003"
• inventory_server_url = "http://127.0.0.1:8003"
• messaging_server_url = "http://127.0.0.1:8006/"

These urls are the corresponding grid, user, asset, inventory and messaging server addresses. In our configuration grid, asset and inventory services are located at robust server and therefore they have the same ip.

[AssetService]

• AssetServerURI = "http://127.0.0.1:8003"
• DefaultAssetLoader = "OpenSim.Framework.AssetLoader.Filesystem.dll"
• AssetLoaderArgs = "assets/AssetSets.xml"
• AssetLoaderEnabled = true

Defines asset loader for opensim and again uri pointing to robust server

[InventoryService]

• InventoryServerURI = "http://127.0.0.1:8003"

Again setting the inventory service to point to robust service

[GridService]

• LocalServiceModule = "OpenSim.Services.GridService.dll:GridService"
• GridServerURI = "http://127.0.0.1:8003"
• StorageProvider = "OpenSim.Data.Null.dll:NullRegionData"

Setting the grid service to point robust server

[AuthorizationService]

• AuthorizationServerURI = "http://127.0.0.1:8002"

Setting the authorization service to point to user server

[Modules]

• NeighbourServices = "RemoteNeighbourServicesConnector"
• NeighbourServiceInConnector = true
• LandServiceInConnector = true

• AssetServices = "ModCableBeach.dll:AssetServiceConnector"
• InventoryServices = "ModCableBeach.dll:InventoryServiceConnector"
• GridServices = "RemoteGridServicesConnector"

• LLProxyLoginModule = true
• Include-modules = "addon-modules/*/config/*.ini"

These connectors connect the opensim to robust server services, the first part before the colon (:) gives the dll name and the latter part the connector name in the dll. Asset, inventory and grid service connectors for connecting to robust service all reside inside ModCableBeach.dll. Include-modules must point to plase where modrex.ini is located.

See our OpenSim.ini example

Regions.ini has simple syntax, you just give your region name in square brackets and give region values like normal ini file values like:

[My Sim name]
RegionUUID = b25f33f2-7d10-4c18-bd2f-130ad19440d7
Location = 1000,1000
InternalAddress = 0.0.0.0
InternalPort = 9001
AllowAlternatePorts = False
ExternalHostName = SYSTEMIP
MasterAvatarFirstName = Test
MasterAvatarLastName = User
MasterAvatarSandboxPassword = test

You can have more than one region defined in the same file, RegionUUID, sim name, location and port must be unique to each region. Usually these are asked in the region startup and sim creates this file for you.

[Startup]

• EventQueue = false

This must be disabled, so when enabling rex event queue could be enabled

[realXtend]

• enabled = true

Enabling realXtend UDP ports and realXtend avatars

• rex_python = true
• RexEventQueue = true

Enabling python and rex event queue

• FirstPort = 7000

This does probably have not effect since clientstack_plugin is set to ModularRex and port 9000 used for Naali connections, but to be on the safe side is set here

• db_connectionstring = "MySQLDialect;MySqlDataDriver;Data Source=localhost;Database=os_modrex;User ID=root;Password=root"

This is connection string for modrex, depending on your choise of database set your database driver, database user name and password here.

• ClientView = naali

ClientView should be set to naali for the realXtend Naali viewer.

See our modrex.ini example and more information about configuring ModreX

For robust server you only need to configure OpenSim.Server.ini

[Startup]

• ServiceConnectors = "ModCableBeach.dll:CableBeachServerConnector,ModCableBeach.dll:AssetServerConnector,
  ModCableBeach.dll:InventoryServerConnector,OpenSim.Server.Handlers.dll:FreeswitchServerConnector,
  OpenSim.Server.Handlers.dll:GridServiceConnector,ModCableBeach.dll:WebDAVServerConnector"

Startup section and ServiceConnectors parameter tells what dlls Robust server loads at startup as comma (,) separated list of dll and service to load value pairs, like ModCableBeach.dll:CableBeachServerConnector, where ModCableBeach.dll is dll name and CableBeachServerConnector is the service loaded from dll. In the above example all connector services that Naali needs are listed.

[Network]

• port = 8003

Port of the Robust server.

[CableBeachService]

• ServiceUrl = "http://127.0.0.1:8003/"

Our robust service url and port

• OpenIDProvider = "http://127.0.0.1:8002/"

This is set to point to UserServer

• UserService = "http://127.0.0.1:8002"

UserService is also located at UserServer

• PropertyProvider = "NHibernatePropertyStorage"
• ConnectionString = "MySQLDialect;MySqlDataDriver;Data Source=localhost;Database=TaigaWebdav;User ID=root;Password=root"

These values need to be specified WebDAV property provider, you need to set up your database access, with correct user id and password, or use DummyPropertyProvider. DummyPropertyProvider wont store WebDAV properties, so when using DummyPropertyProvider inventory properties will be lost on server startup.

[AssetService]

• LocalServiceModule = "OpenSim.Services.AssetService.dll:AssetService"
• DefaultAssetLoader = "OpenSim.Framework.AssetLoader.Filesystem.dll"
• AssetLoaderArgs = "assets/AssetSets.xml"
• StorageProvider = "OpenSim.Data.MySQL.dll"
• ConnectionString = "Data Source=localhost;Database=grid;User ID=root;Password=root;"

As an example, the above configuration precisely mimicks the legacy asset server. It is read by the asset IN connector (defined above) and it then loads the OUT connector (a local database module). That, in turn, reads the asset loader and database connection information. Above values are tested with Naali, you need to set your corresponding database access connectionstrings with correct user id and password, you probably can also use other storage providers.

[InventoryService]

• LocalServiceModule = "OpenSim.Services.InventoryService.dll:InventoryService"
• UserServerURI = "http://127.0.0.1:8002"
• SessionAuthentication = "false"
• StorageProvider = "OpenSim.Data.MySQL.dll"
• ConnectionString = "Data Source=localhost;Database=grid;User ID=root;Password=root;"

Same values as for asset service, in addition inventory service also needs UserServerURI for authenticating inventory requests.

[GridService]

• LocalServiceModule = "OpenSim.Services.GridService.dll:GridService"
• StorageProvider = "OpenSim.Data.MySQL.dll:MySqlRegionData"
• ConnectionString = "Data Source=localhost;Database=opensim;User ID=root;Password=root;"
• Realm = "regions"

This section specifies Robust services grid database connection, again you need to specify here your database connection string. Above example sets up mysql storage provider for grid regions.

See our OpenSim.Server.ini example

For messaging server you only need to configure MessagingServer_Config.xml The xml file has Config element that has these attributes:

• default_user_server="http://127.0.0.1:8002/"
• user_send_key="null"
• user_recv_key="null"
• default_grid_server="http://127.0.0.1:8003/"
• grid_send_key="null"
• grid_recv_key="null"
• database_connect="Data Source=localhost;Database=grid;User ID=root;Password=root;"
• database_provider="OpenSim.Data.MySQL.dll"
• region_comms_provider="OpenSim.Region.Communications.OGS1.dll"
• http_port="8006"
• http_ssl="False"
• published_ip="127.0.0.1"
• console_user=""
• console_pass=""

Here we setup user server and grid server (robust server address) for messaging server and setup database connection credentials and set database table name (grid), set database provider dll and dll for region comms provider, below is link for example file:

See our MessagingServer_Config.xml example

For user server you only need to configure UserServer_Config.xml These attributes are set in the Config xml element:

• Config default_startup_message="Welcome to OGS"
• default_grid_server="http://127.0.0.1:8003/"
• grid_send_key="null"
• grid_recv_key="null"
• default_inventory_server="http://127.0.0.1:8003/"
• default_authentication_server="http://localhost:8002/"
• library_location=".\inventory\Libraries.xml"
• database_provider="OpenSim.Data.MySQL.dll"
• database_connect="Data Source=localhost;Database=grid;User ID=root;Password=root;"
• http_port="8002"
• enable_llsd_login="True"
• enable_hg_login="True"
• default_loginLevel="0"

Obviously we set here startup message and grid + inventory servers to point to robust server and also authentication server to point to user server. The default word is used on those parameters because with openId inventory and authentication services can be somewhere else. Again we set database connection string and provider. Example file describes the xml file in more detail:

See our UserServer_Config.xml example