ModRex

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(New page: ==About== RealXtend have had it's own OpenSimulator fork running for a long time, but that's all changing now(thanks to the devs). Anyway, it's really in alpha-state atm, so don't expect a...)
 
(expended tutorial)
Line 1: Line 1:
−
==About==
+
==Overview==
−
RealXtend have had it's own OpenSimulator fork running for a long time, but that's all changing now(thanks to the devs). Anyway, it's really in alpha-state atm, so don't expect anything to run yet. This tutorial is just a description how it 'might' work, considering the fact I don't have it running myself yet ;)
+
ModRex is a joint effort - in the form of a module - to make OpenSim aware of RealXtend specific functionality. It will allow us to use the best of both worlds. RealXtend with features like meshes, uv-mapping, particle-scripts, python-scripting, bots, and OpenSim-trunk with up-to-date codebase, and features like region webloading, mysql, hypergrid and webmaps.
  
−
==ModularRex==
+
''This is still pre-alpha code, so some features may not work.''
−
If you're on windows, download the module from the forge, and compile using visual studio. For linux, check out the tracker item containing a prebuild.xml . With the prebuild file, you can make a nant build file using something like:
+
 
 +
==Procedure==
 +
===Windows===
 +
If you're on windows, download the module from the forge, and compile using visual studio.  
 +
 
 +
===Linux===
 +
At the moment branch 0.2 is used, but normally check out trunk. I use this directory structure for RealXtend now:
 +
mkdir /opt/opensim opt/opensim/simulator /opt/opensim/authentication /opt/opensim/avatarstorage /opt/opensim/builds
 +
* Check out and compile OpenSim:
 +
svn co http://opensimulator.org/svn/opensim/trunk /opt/opensim/builds/7xxx
 +
runprebuild.sh
 +
nant
 +
* Make a directory 'modrex' in your checked out OpenSim dir, and from there check out modrex(or check out a branch, if current)
 +
svn checkout http://forge.opensimulator.org/svn/modrex/trunk .
 +
* Prepare the code for nant(There should be a prebuild.xml file):
 
  mono ../../bin/Prebuild.exe /target nant
 
  mono ../../bin/Prebuild.exe /target nant
 
  nant
 
  nant
−
''Make sure you have a directory structure like: /myopensimdir/modrex/ModularRex, where myopensimdir contains a bin directory''
+
* Copy bin/Debug/ModularRex.dll to /opt/opensim/simulator
 +
* Download and build the authentication service
 +
svn co https://realxtendserver.svn.sourceforge.net/svnroot/realxtendserver/authentication/tags/0.4 /opt/opensim/authentication
 +
bin/Prebuild.exe /target nant
 +
nant
 +
* Create a mysql database for authentication(authentication?) and start the service with mono
 +
* Setup authentication
 +
MySql_SqlHandler.dll (or SQLite_SqlHandler.dll. MySql_SqlHandler.dll gives not implemented messages but seems to work ok)
 +
<enter>(AuthenticationEngine=AuthenticationEngine.dll)
 +
<enter>(logging enabled=False)
 +
<enter>(def. region x 1000)
 +
<enter>(def. region y 1000)
 +
<enter>(avatarstorageurl 172.16.1.65:10000)
 +
<enter>(default gridurl 172.16.1.65:9000)
 +
<enter>(default dns)
 +
<enter>(dbserver 127.0.0.1)
 +
<enter>(dbname authentication)
 +
<enter>(dbuser root)
 +
*******(dbpw for root)
 +
172.16.1.65 (httpsettings LAN-IP)
 +
''The authentication daemon should run by now''
  
−
From here, you have to launch the authentication service and the avatarstorage service. Now run OpenSim.exe and watch the module get loaded. From here...I dont have a clue :-)
+
* Download and build the avatarstorage service
 +
svn co https://realxtendserver.svn.sourceforge.net/svnroot/realxtendserver/avatarstorage/tags/0.4 /opt/opensim/avatarstorage
 +
bin/Prebuild.exe /target nant
 +
nant
 +
* Create a database for avatarstorage(avatarstorage?) and start the service with mono
 +
* Setup avatarstorage
 +
MySql_SqlHandler.dll
 +
<enter>(AuthenticationEngine.dll)
 +
<enter>(Inventory True)
 +
<enter>(PersonalInventoryService.dll)
 +
PersonalInventory.SQLITE.dll
 +
<enter>(logging_enabled False)
 +
<enter>(dbserver 127.0.0.1)
 +
avatarstorage (dbname)
 +
<enter>(dbuser root)
 +
********(dbpw root)
 +
172.16.1.65 (httpsettings LAN-IP)
 +
<enter>(http port 10000)
 +
<enter>(ssl False)
 +
''The avatarstorage daemon should run by now''
 +
* Setup OpenSim in standalone mode(Grid is not working yet); add these lines to OpenSim.ini:
 +
<source lang="bash">
 +
[realXtend]
 +
enabled=true
 +
</source>
 +
* You can use this [[mooxtd little script]] to manage and start the services(uses screen)
 +
* Create a user in the authentication console
 +
create user
 +
the 'Account' part is the first part in your rex-username(account@myauthenticationdaemonuri)
 +
Once the three services are running, an initial user was made, fire up the realXtend client with wine and login.
  
−
Don't know how to login with the realxtend client from here. Anyone?
+
==Known Quirks==
 +
* Shift-copy a mesh leaves a prim behind
 +
* Meshes are persistant only after a clean shutdown
 +
* Mesh collision doesn't work yet

Revision as of 00:39, 7 January 2009

Contents

Overview

ModRex is a joint effort - in the form of a module - to make OpenSim aware of RealXtend specific functionality. It will allow us to use the best of both worlds. RealXtend with features like meshes, uv-mapping, particle-scripts, python-scripting, bots, and OpenSim-trunk with up-to-date codebase, and features like region webloading, mysql, hypergrid and webmaps.

This is still pre-alpha code, so some features may not work.

Procedure

Windows

If you're on windows, download the module from the forge, and compile using visual studio.

Linux

At the moment branch 0.2 is used, but normally check out trunk. I use this directory structure for RealXtend now: 

mkdir /opt/opensim opt/opensim/simulator /opt/opensim/authentication /opt/opensim/avatarstorage /opt/opensim/builds
  • Check out and compile OpenSim: 
svn co http://opensimulator.org/svn/opensim/trunk /opt/opensim/builds/7xxx
runprebuild.sh
nant
  • Make a directory 'modrex' in your checked out OpenSim dir, and from there check out modrex(or check out a branch, if current) 
svn checkout http://forge.opensimulator.org/svn/modrex/trunk .
  • Prepare the code for nant(There should be a prebuild.xml file): 
mono ../../bin/Prebuild.exe /target nant
nant
  • Copy bin/Debug/ModularRex.dll to /opt/opensim/simulator
  • Download and build the authentication service 
svn co https://realxtendserver.svn.sourceforge.net/svnroot/realxtendserver/authentication/tags/0.4 /opt/opensim/authentication
bin/Prebuild.exe /target nant
nant
  • Create a mysql database for authentication(authentication?) and start the service with mono
  • Setup authentication 
MySql_SqlHandler.dll (or SQLite_SqlHandler.dll. MySql_SqlHandler.dll gives not implemented messages but seems to work ok)
<enter>(AuthenticationEngine=AuthenticationEngine.dll)
<enter>(logging enabled=False)
<enter>(def. region x 1000)
<enter>(def. region y 1000)
<enter>(avatarstorageurl 172.16.1.65:10000)
<enter>(default gridurl 172.16.1.65:9000)
<enter>(default dns)
<enter>(dbserver 127.0.0.1)
<enter>(dbname authentication)
<enter>(dbuser root)
*******(dbpw for root)
172.16.1.65 (httpsettings LAN-IP)

The authentication daemon should run by now

  • Download and build the avatarstorage service 
svn co https://realxtendserver.svn.sourceforge.net/svnroot/realxtendserver/avatarstorage/tags/0.4 /opt/opensim/avatarstorage
bin/Prebuild.exe /target nant
nant
  • Create a database for avatarstorage(avatarstorage?) and start the service with mono
  • Setup avatarstorage 
MySql_SqlHandler.dll
<enter>(AuthenticationEngine.dll)
<enter>(Inventory True)
<enter>(PersonalInventoryService.dll)
PersonalInventory.SQLITE.dll
<enter>(logging_enabled False)
<enter>(dbserver 127.0.0.1)
avatarstorage (dbname)
<enter>(dbuser root)
********(dbpw root)
172.16.1.65 (httpsettings LAN-IP)
<enter>(http port 10000)
<enter>(ssl False)

The avatarstorage daemon should run by now

  • Setup OpenSim in standalone mode(Grid is not working yet); add these lines to OpenSim.ini: 
[realXtend]
 enabled=true
  • You can use this mooxtd little script to manage and start the services(uses screen)
  • Create a user in the authentication console 
create user

the 'Account' part is the first part in your rex-username(account@myauthenticationdaemonuri) Once the three services are running, an initial user was made, fire up the realXtend client with wine and login.

Known Quirks

  • Shift-copy a mesh leaves a prim behind
  • Meshes are persistant only after a clean shutdown
  • Mesh collision doesn't work yet
Retrieved from "http://opensimulator.org/index.php?title=ModRex&oldid=9802"
Personal tools
General
About This Wiki