OpenSimulator - User contributions [en]

Download

2009-05-18T05:35:27Z

HomerHorwitz: Updated link/version number

{{Template:Quicklinks}}
=Source code=
Here are the current released versions of OpenSim.

Please see [[Branches]] for more information on the repository branches and what they are for.

'''Please note:''' As OpenSim is still at an alpha code maturity stage, there is absolutely no guarantee that functionality works or is stable, even in the numbered releases. Certain features may not work either because the code is in rapid evolution, or because functionality expected by the Linden Labs Second Life viewer has simply not been implemented yet. However, constructive feedback is still welcomed.

Also, please be aware that OpenSim requires that you have a fair amount of technical knowledge in order to set it up.

The lastest source releases are always hosted at http://dist.opensimulator.org, the current latest releases is '''0.6.4.1''' and provided as:
* http://dist.opensimulator.org/opensim-0.6.4.1-release.tar.gz - best for Linux systems
* http://dist.opensimulator.org/opensim-0.6.4.1-release.zip - best for Windows systems

The only difference between the 2 is the archive format, the source is exactly the same.

== Release Code via Subversion ==

Instead of using a source archive release, you can pull specific releases from our subversion. For Windows you can install just [http://subversion.tigris.org/servlets/NewsItemView?newsItemID=1941 Subversion] or the often preferred [http://tortoisesvn.tigris.org Tortoise Subversion extension]. Mac OS X 10.5 and above have Subversion built but OS. X 10.4.x can still [http://homepage.mac.com/martinott/Subversion-1.4.4.pkg.zip download Subversion]. All Linux systems should have subversion installed, or available from their package repositories.

* '''0.6.4 Alpha with post-release fixes''' (preferred)
svn co http://opensimulator.org/svn/opensim/branches/0.6.4-post-fixes opensim

* '''0.6.4 Alpha release tag'''
svn co http://opensimulator.org/svn/opensim/tags/0.6.4-release opensim

== Release notes ==

These are extracted from the subversion history log and correlated with the tagged releases. It should provide some idea of the changes between each tagged version.
* [[Recent]] (since last tagged version)
* [[0.6.4.1-release]] (SVN version 9009)
* [[0.6.4-release]] (SVN version 8960)
* [[0.6.3-release]] (SVN version 8506)
* [[0.6.2-release]] (SVN version 8068)
* [[0.6.1-release]] (SVN version 7880)
* [[0.6.0-release]] (SVN version 7176)
* [[0.5.11-release]] (SVN version 6676)
* [[0.5.10-release]] (SVN version 6422)
* [[0.5.9-release]] (SVN version 5970)
* [[0.5.8-release]] (SVN version 5111)
* [[0.5.7-release]] (SVN version 4818)
* [[0.5.6-release]] (SVN version 4488)
* [[0.5.5-release]] (SVN version 4239)
* [[0.5.4-release]] (SVN version 3879) (Not sure what happened to 0.5.3 & 0.5.2)
* [[0.5.1-release]] (SVN version 3724)
* [[0.5.0-release]] (SVN version 3184)
* [[0.4.5.3-stable]] (SVN version 2844)
* [[0.4.5.2-stable]] (SVN version 2772)
* [[0.4.5.1-stable]] (SVN version 2610)
* [[0.4.5-release]] (SVN version 2293)
* [[0.4.0-rc]] (SVN version 1953)
* [[0.3.2-release]] (SVN version 1385)
* [[0.3.1-devel]] (SVN version 1226) (Around here things start to get a bit confusing)
* [[0.2.1-release]] (SVN version 1224)
* [[0.3.0-devel]] (SVN version 1126)
* [[0.0.0-release]] (SVN version 1022)
* [[0.1.0-release]] (SVN version 1021)
* [[0.2.0-release]] (SVN version 1020)

=Binaries=
The OpenSim project only does source based releases, which you must [[Build_Instructions|compile]] yourself. Many members of our community provide binary installers that you can used based on those source releases. Links below are provided for convenience.

==Installers==

* '''0.6.3 Windows Installer (Postfix Edition r8730)'''
http://forge.opensimulator.org/gf/download/frsrelease/175/441/OpenSim0.6.3Setup.exe

* '''0.6.2 Windows Installer'''
http://forge.opensimulator.org/gf/download/frsrelease/157/359/OpenSimSetup0.6.2.exe

* '''[[UnofficialDebPackages|Unofficial .deb packages]]

= Older Versions Archive =

All older versions of OpenSim are available from the svn repo. Please be aware that even if there is zero official support for the latest version, there's even less support for older ones. They are kept here for historical and technological reference only.

The 'official' release tags are kept here:
http://opensimulator.org/svn/opensim/tags/

The post-fixes, as well as some experimental offshoots are kept here:
http://opensimulator.org/svn/opensim/branches/

= Experimental Upstream Code =
'''There Be Dragons Beyond This Point'''

If you are truly feeling dangerous, adventurous, or want to help us test the next version of OpenSim you are welcome to grab the latest unstable code out of our subversion trunk. Any warnings previous expressed about the alpha nature of the code go double or triple if you are running directly off of trunk. '''Never, ever, ever, never''' run this in production environments, it is not suitable for that unless you are very familiar with the source code, and can hot fix any piece of it (that probably means you are an OpenSim core member). Feedback and testing on the unstable tree is appreciated, as that helps us make the next release better. If this scares you from using trunk, that was intended.

If it breaks, you get to keep both pieces.

* '''Latest Subversion revision version (bleeding edge)'''
svn co http://opensimulator.org/svn/opensim/trunk opensim

* '''To checkout a specific revision'''
svn co -r #### http://opensimulator.org/svn/opensim/trunk opensim
where #### is the number of the desired revision.

Another option for obtaining the code is via [http://git-scm.com/ git] from the [http://opensimulator.org/viewgit OpenSim Git Mirror]. The git mirror only contains trunk code (no branches or tags) and may be up to 1 hour behind the svn trunk.

* '''Latest git revision version (bleeding edge)'''
git clone http://opensimulator.org/git/opensim

=Related Software=
[[Related_Software|Related Software Section - CLICK HERE]] 

''Pages by Category:''[[:Category:Users| User-pages]],[[:Category:Development| Developer-pages]],[[:Category:Scripts| Scripts]] 

[[Category:Users]]
[[Category:Developers]]
<cleanpage title=hide cats=hide />

New Region Modules

2009-05-13T17:37:42Z

HomerHorwitz: Minor edits, adding note about Close/RemoveRegion

(This is a first draft-version and can change at any time until complete
implementation. Feel free to comment, either on the Discussion page or on the
opensim-dev mailing list)

= Why =

The current RegionModule system's API is in part inconsistent and doesn't
really support region-restarts and adding/removing regions on the fly during
a region-server run.
E.g., the API says ''Initialise'' is called for every region (in every
region-module), after that, ''PostInitialise'' is called for every region-module.
When a new region is added, what should happen?
* Don't call ''Initialise'': Then the region-module isn't initialised for that region, which leads to missing functionality.
* Call ''Initialise'': Then ''PostInitialise'' was called too early. Actually, ''PostInitialise'' can not be called at all, because you can add a region after that anytime.

What should happen if a region is restarted? What should happen if a region
is removed?

= What =

The new region-module system is based on three interfaces: ''ISharedRegionModule'',
''INonSharedRegionModule'' and ''IRegionModuleBase'', which is the base interface for
the other two.

public interface IRegionModuleBase
{
string Name { get; }
void Initialise(IConfigSource source);
void Close();
void AddRegion(Scene scene);
void RegionLoaded(Scene scene);
void RemoveRegion(Scene scene);
}

public interface ISharedRegionModule : IRegionModuleBase
{
void PostInitialise();
}

public interface INonSharedRegionModule : IRegionModuleBase
{
}

* Loading the region-modules' classes happens via ''Mono.Addins'' on server-start.
* Instantiating the region-modules happens...
** for ''ISharedRegionModule''s once after loading (on server start)
** for ''INonSharedRegionModule''s after creation of the ''Scene'' object.
* You can cleanup when a region is removed.
* You can cleanup before the server shuts down.

;Note:
:A ''PostInitialise'' for a ''INonSharedRegionModule'' doesn't make a lot of sense, as we don't have a certain point from which on we won't call ''Initialise'' on a ''INonSharedRegionModule'' again. Every time a new region is added (on restart, too), a new instance is created and ''Initialise'' is called on that instance, so the intended semantics of ''PostInitialise'' will never apply.

= Details =

== Start of region-server ==

* Region-server starts, the classes of all region-modules are loaded in no particular order
** For every ''ISharedRegionModule'', one instance is created and ''Initialise'' is called.
** For every ''ISharedRegionModule'' instance, ''PostInitialise'' is called.
* The ''Scene''s are instantiated, one by one:
** For every ''Scene''
*** for every ''INonSharedRegionModule'', a new instance is created and ''Initialise'' called.
*** for every ''INonSharedRegionModule'' and ''ISharedRegionModule'', ''AddRegion(scene)'' is called. The modules are associated to the ''Scene'' (for deletion on remove)
*** for every ''INonSharedRegionModule'' and ''ISharedRegionModule'', ''RegionLoaded(scene)'' is called (you can access the methods in other modules of that scene via ''scene.RequestModuleInterface<ModuleInterfaceType>()'' here).

== Adding a region ==
* for every ''INonSharedRegionModule'', a new instance is created and ''Initialise'' called.
* for every ''INonSharedRegionModule'' and ''ISharedRegionModule'', ''AddRegion(scene)'' is called. The modules are associated to the ''Scene'' (for deletion on remove)
* for every ''INonSharedRegionModule'' and ''ISharedRegionModule'', ''RegionLoaded(scene)'' is called.

== Removing a region ==

* For every ''INonSharedRegionModule'' of the scene and every ''ISharedRegionModule'', ''RemoveRegion(scene)'' is called
** For the ''INonSharedRegionModule''s, ''Close'' is called
* Every module reference of the scene is removed from the scene. No references should be left after that; the ''INonSharedRegionModule''s could be garbage collected now.

== Restarting a region ==

Restarting happens as a sequence of [[#Removing_a_region|"Removing a region"]], followed by a
[[#Adding_a_region|"Adding a region"]]. As usual, avatars that are in that region when it restarts are kicked.

== Shutdown of the region-server ==

* For every scene, perform the [[#Removing_a_region|"Removing a region"]] step:
** ''RemoveRegion'' is called for all scenes and modules, ''Close'' is called for all the ''INonSharedRegionModule''s
* ''Close'' is called for all the ''ISharedRegionModule''. The ''ISharedRegionModule'' could now be garbage-collected.

= Notes =

* ''RemoveRegion''/''Close'' is for cleaning up. Things you added in ''Initialise''/''AddRegion'' should be removed in ''Close''/''RemoveRegion'' again, respectively.
* The modules are loaded via ''Mono.Addins''. This means, you can build your own assemblies with region modules, and by putting them into the ''<opensim>/bin'' folder, they will be loaded automatically. For this to work, you need to add a ''<something>.addin.xml'' file within your assembly-resources and provide a (or several) ''/OpenSim/RegionModule'' extensions in it. For examples, have a look at ''<opensim>/OpenSim/Region/CoreModules/Resources/CoreModulePlugin.addin.xml'' (and ''<opensim>/bin/OpenSim.addin.xml'' as the provider of the extension-point).

: clear enough? Or should we add a spelled out example? [[User:HomerHorwitz|HomerHorwitz]] 18:21, 12 May 2009 (UTC)

= TODOs =
* Configuration about which modules should be loaded.
: we already have the <tt>enabled = true/false</tt> OpenSim.ini config option for most region modules --- [[User:DrScofield|DrScofield]] 09:53, 26 January 2009 (UTC)
: which is a horribly ad hoc solution - we really do need a better way of controlling this imho --- [[User:Justincc|Justincc]] 20:26, 28 January 2009 (UTC)
: agree with Justin. A module shouldn't be responsible for turning itself off, it should never get loaded in the first place --[[User:SeanDague|SeanDague]] 21:51, 28 January 2009 (UTC)

New Region Modules

2009-05-12T18:21:16Z

HomerHorwitz: Fix things, complete docs. This should represent the reality at the time of writing.

(This is a first draft-version and can change at any time until complete
implementation. Feel free to comment, either on the Discussion page or on the
opensim-dev mailing list)

= Why =

The current RegionModule system's API is in part inconsistent and doesn't
really support region-restarts and adding/removing regions on the fly during
a region-server run.
E.g., the API says ''Initialise'' is called for every region (in every
region-module), after that, ''PostInitialise'' is called for every region-module.
When a new region is added, what should happen?
* Don't call ''Initialise'': Then the region-module isn't initialised for that region, which leads to missing functionality.
* Call ''Initialise'': Then ''PostInitialise'' was called too early. Actually, ''PostInitialise'' can not be called at all, because you can add a region after that anytime.

What should happen if a region is restarted? What should happen if a region
is removed?

= What =

The new region-module system is based on three interfaces: ''ISharedRegionModule'',
''INonSharedRegionModule'' and ''IRegionModuleBase'', which is the base interface for
the other two.

public interface IRegionModuleBase
{
string Name { get; }
void Initialise(IConfigSource source);
void Close();
void AddRegion(Scene scene);
void RegionLoaded(Scene scene);
void RemoveRegion(Scene scene);
}

public interface ISharedRegionModule : IRegionModuleBase
{
void PostInitialise();
}

public interface INonSharedRegionModule : IRegionModuleBase
{
}

* Loading the region-modules' classes happens via ''Mono.Addins'' on server-start.
* Instantiating the region-modules happens...
** for ''ISharedRegionModule''s once after loading (on server start)
** for ''INonSharedRegionModule''s after creation of the ''Scene'' object.
* You can cleanup when a region is removed.
* You can cleanup before the server shuts down.

;Note:
:A ''PostInitialise'' for a ''INonSharedRegionModule'' doesn't make a lot of sense, as we don't have a certain point from which on we won't call ''Initialise'' on a ''INonSharedRegionModule'' again. Every time a new region is added (on restart, too), a new instance is created and ''Initialise'' is called on that instance, so the intended semantics of ''PostInitialise'' will never apply.

= Details =

== Start of region-server ==

* Region-server starts, the classes of all region-modules are loaded in no particular order
** For every ''ISharedRegionModule'', one instance is created and ''Initialise'' is called.
** For every ''ISharedRegionModule'' instance, ''PostInitialise'' is called.
* The ''Scene''s are instantiated, one by one:
** For every ''Scene''
*** for every ''INonSharedRegionModule'', a new instance is created and ''Initialise'' called.
*** for every ''INonSharedRegionModule'' and ''ISharedRegionModule'', ''AddRegion(scene)'' is called. The modules are associated to the ''Scene'' (for deletion on remove)
*** for every ''INonSharedRegionModule'' and ''ISharedRegionModule'', ''RegionLoaded(scene)'' is called (you can access the methods in other modules of that scene via ''scene.RequestModuleInterface<ModuleInterfaceType>()'' here).

== Adding a region ==
* for every ''INonSharedRegionModule'', a new instance is created and ''Initialise'' called.
* for every ''INonSharedRegionModule'' and ''ISharedRegionModule'', ''AddRegion(scene)'' is called. The modules are associated to the ''Scene'' (for deletion on remove)
* for every ''INonSharedRegionModule'' and ''ISharedRegionModule'', ''RegionLoaded(scene)'' is called.

== Removing a region ==

* For every ''INonSharedRegionModule'' of the scene and every ''ISharedRegionModule'', ''RemoveRegion(scene)'' is called
** For the ''INonSharedRegionModule''s, ''Close'' is called
* Every module reference of the scene is removed from the scene. No references should be left after that; the ''INonSharedRegionModule''s could be garbage collected now.

== Restarting a region ==

Restarting happens as a sequence of [[#Removing_a_region|"Removing a region"]], followed by a
[[#Adding_a_region|"Adding a region"]]. As usual, avatars that are in that region when it restarts are kicked.

== Shutdown of the region-server ==

* For every scene, perform the [[#Removing_a_region|"Removing a region"]] step:
** ''RemoveRegion'' is called for all scenes and modules, ''Close'' is called for all the ''INonSharedRegionModule''s
* ''Close'' is called for all the ''ISharedRegionModule''. The ''ISharedRegionModule'' could now be garbage-collected.

= Notes =

The modules are loaded via ''Mono.Addins''. This means, you can build your own assemblies with region modules, and by putting
it into the ''<opensim>/bin'' folder, they will be loaded automatically. For this to work, you need to add a ''<something>.addin.xml'' file within your assembly-resources and provide a (or several) ''/OpenSim/RegionModule'' extensions in it. For examples, have a look at ''<opensim>/OpenSim/Region/CoreModules/Resources/CoreModulePlugin.addin.xml'' (and ''<opensim>/bin/OpenSim.addin.xml'' as the provider of the extension-point).
: clear enough? Or should we add a spelled out example? [[User:HomerHorwitz|HomerHorwitz]] 18:21, 12 May 2009 (UTC)

= TODOs =
* Configuration about which modules should be loaded?
: we already have the <tt>enabled = true/false</tt> OpenSim.ini config option for most region modules --- [[User:DrScofield|DrScofield]] 09:53, 26 January 2009 (UTC)
: which is a horribly ad hoc solution - we really do need a better way of controlling this imho --- [[User:Justincc|Justincc]] 20:26, 28 January 2009 (UTC)
: agree with Justin. A module shouldn't be responsible for turning itself off, it should never get loaded in the first place --[[User:SeanDague|SeanDague]] 21:51, 28 January 2009 (UTC)

Development Team

2009-03-05T18:51:49Z

HomerHorwitz: Corrected my IRC name

== Active OpenSim Core Developers ==
These people have commit access to our central SVN server and are [http://www.ohloh.net/projects/4753/contributors regular contributors] to the codebase.

(please add in as much info as you like for your name)

<table border="1" cellpadding="2" cellspacing="0" class="sortable">
<tr>
<th>Photo </th>
<th>IRC Nick </th>
<th>Name</th>
<th>SL Avatar</th>
<th>Other Grid</th>
<th>Time Zone (UTC)</th>
<th>Org</th>
<th>Areas of Interest</th>
</tr>

<tr>
<td />
<td>[[User:MW |MW ]]</td>
<td>Darren</td>
<td>OSG:Wright Juran TN:Darren Guard</td>
<td></td>
<td>0</td>
<td>[http://tribalmedia.se/ Tribal Media AB]</td>
<td>Everything</td>
</tr>
<tr>
<td> </td>
<td>[[User:lbsa71|lbsa71]]</td>
<td>Stefan Andersson</td>
<td>Tribal Skytower</td>
<td>OSG:Stefan Andersson TN:Stefan Andersson</td>
<td>+1</td>
<td>[http://tribalmedia.se/ Tribal Media AB]</td>
<td>Web Integration</td>
</tr>
<tr>
<tr>
<td />
<td>[[User:Adam Frisby|Adam Frisby]]</td>
<td>Adam Frisby</td>
<td>Adam Zaius</td>
<td></td>
<td>+8</td>
<td>DeepThink Pty Ltd</td>
<td>Terrain, Performance</td>
</tr>
<tr>
<td />
<td>[[User:MingChen|MingChen]]</td>
<td>Mike/Michael Ortman</td>
<td>Ming Chen</td>
<td></td>
<td>-6 (-5 in Summer)</td>
<td>DeepThink Pty Ltd</td>
<td>Estate/Parcel Support/Modules/Keeping things all neat and tidy.</td>
</tr>
<tr>
<td />
<td>[[User:SeanDague|sdague]]</td>
<td>Sean Dague</td>
<td>Neas Bade</td>
<td></td>
<td>-5</td>
<td>IBM</td>
<td>Database, Linux, Testing, Misc</td>
</tr>
<tr>
<td />
<td>[[User:Tedd|Tedd]]</td>
<td>Tedd Hansen</td>
<td>Tedd Maa</td>
<td></td>
<td>+1</td>
<td>Tedd Hansen</td>
<td>Programming/Scripting/Architecture</td>
</tr>
<tr>
<td />
<td>[[User:dalien|dalien]]</td>
<td>Dalien Talbot</td>
<td>Dalien Talbot</td>
<td></td>
<td>+1</td>
<td>Mostly TCP-based</td>
<td>Small fixes; rev.eng./prototyping; nightlies; git-keeper </td>
</tr>
<tr>
<td />
<td>ckrinke</td>
<td>Charles Krinke</td>
<td>Charlesk Bing</td>
<td></td>
<td>-8</td>
<td> </td>
<td>Reliability/Grid servers/ll-functions</td>
</tr>
<tr>
<td />
<td>[[User:chi11ken|chi11ken]]</td>
<td>Jeff Ames</td>
<td>Chillken Proto</td>
<td> </td>
<td>+9</td>
<td>[http://www.genkii.com Genkii]</td>
<td> </td>
</tr>
<tr>
<td />
<td>[[User:adjohn|adjohn]]</td>
<td>Adam Johnson</td>
<td>Zeuz Zenovka</td>
<td> </td>
<td>+9</td>
<td>[http://www.genkii.com Genkii]</td>
<td> </td>
</tr>
<tr>
<td />
<td>[[User:joha1|joha1]]</td>
<td>Johan Berntsson</td>
<td>Joppi Brandenburg</td>
<td> </td>
<td>+9</td>
<td>[http://www.3di.jp/en/ 3Di Inc, Japan] http://www.3di.jp/en/</td>
<td>Performance, packet handling/libSL</td>
</tr>
<tr>
<td />
<td>[[User:Teravus|Teravus]]</td>
<td>Teravus</td>
<td>Teravus Ousley</td>
<td></td>
<td>-5</td>
<td>W3z</td>
<td>Physics & Admin tools, A working sim.</td>
</tr>
<tr>
<td />
<td>[[User:justincc|justincc]]</td>
<td>Justin Clark-Casey</td>
<td>Lulworth Beaumont</td>
<td>Justin Clark-Casey (osgrid)</td>
<td>0</td>
<td>Black Dress Technology [http://justincc.wordpress.com justincc's OpenSim blog]</td>
<td>Grid, performance & reliability, inventory (avatar and object), assets, scenes, etc.</td>
</tr>
<tr>
<td />
<td>[[Alondria]]</td>
<td></td>
<td>Alondria LeFay</td>
<td>Alondria LeFay (OSGrid)</td>
<td>-8</td>
<td>Independent</td>
<td>Implementation of LSL functions and other scripting tidbits.</td>
</tr>
<tr>
<td />
<td>[[User:DrScofield|drscofld]]</td>
<td>Dirk Husemann</td>
<td>Dr Scofield</td>
<td></td>
<td>+1</td>
<td>IBM</td>
<td>reliability, networking protocols, voice, inventory, assets, remote control, and pretty much everything else :-)</td>
</tr>
<tr>
<td />
<td>[[User:dahlia|dahlia]]</td>
<td>T. Hoff</td>
<td>Dahlia Trimble</td>
<td></td>
<td>-8 / -7</td>
<td>independent</td>
<td>prim collision geometry, more later :)</td>
</tr>
<tr>
<td></td>
<td>[[User:Mikem|mikem]]</td>
<td>Mike</td>
<td> </td>
<td> </td>
<td>+9</td>
<td>[http://www.3di.jp/en/ 3Di Inc, Japan] http://www.3di.jp/en/</td>
<td>patches, scripting improvements, LSL compiler</td>
</tr>
<tr>
<td></td>
<td>[[User:Melanie_T|Melanie_T]]</td>
<td>Melanie</td>
<td>Melanie Milland</td>
<td> </td>
<td>0</td>
<td>Xumeo Inc.</td>
<td>Scripting, Prims/Scene, Life, The Universe, and Everything</td>
</tr>
<tr>
<td></td>
<td>[[User:HomerHorwitz|homerh]]</td>
<td>Homer Horwitz</td>
<td>Homer Horwitz</td>
<td> </td>
<td>+2</td>
<td>Independent</td>
<td>rev. engineering, "now, that's funny" problems, but still interested in all parts of it</td>
</tr>
<tr>
<td></td>
<td>[[User:Diva|Diva]]</td>
<td>Crista Lopes</td>
<td>Diva Canto</td>
<td>Crista Lopes / Diva Canto</td>
<td>-8</td>
<td>University of California, Irvine</td>
<td>Everything, except databases</td>
</tr>
<tr>
<td />
<td>[[User:nlin|nlin]]</td>
<td>N Lin</td>
<td>Standard Drucker</td>
<td> </td>
<td>+9</td>
<td>[http://www.3di.jp/en/ 3Di Inc, Japan] http://www.3di.jp/en/</td>
<td>Physics, scripting, more to come</td>
</tr>
</table>

== Retired OpenSim core developers ==

These people are core developers who have transcended our mortal plane (i.e. they are no longer active).

<table border="1" cellpadding="2" cellspacing="0" class="sortable">
<tr>
<th>Photo </th>
<th>IRC Nick </th>
<th>Name</th>
<th>SL Avatar</th>
<th>Other Grid</th>
<th>Time Zone (UTC)</th>
<th>Org</th>
<th>Areas of Interest</th>
</tr>
<tr>
<td />
<td>[[User:babblefrog|babblefrog]]</td>
<td>Brian McBee</td>
<td>Dogen Coldstream</td>
<td>Babblefrog Ballistic (osgrid)</td>
<td>-8</td>
<td>Disorganized</td>
<td> </td>
</tr>
<tr>
<td />
<td>[[User:danx0r|danx0r]]</td>
<td>Dan Miller</td>
<td>Albert Pascal</td>
<td></td>
<td>-8</td>
<td>squiggle.com</td>
<td>PHEEZIKS; everything</td>
</tr>
<tr>
<td />
<td>Tleiades</td>
<td> </td>
<td>Tleiades Hax</td>
<td></td>
<td>+1</td>
<td> </td>
<td>Grid servers/Database</td>
</tr>
<tr>
<td />
<td>[[User:Darok|Darok]]</td>
<td> </td>
<td>Darok Kaminski</td>
<td></td>
<td>+1</td>
<td> </td>
<td>Physics engines (especially BulletX)</td>
</tr>
<tr>
<td />
<td>Gareth / Gwen</td>
<td>Gareth Nelson</td>
<td>Gareth Ellison</td>
<td>Gareth Nelson (on everywhere but SL)</td>
<td>BST (UTC+1)</td>
<td>Litesim Ltd</td>
<td>Grid servers, sim border crossing, avatar animations</td>
</tr>
</table>

== Additional Developers/Testers/Contributors ==
These people have contributed bug reports, patches or other contributions to OpenSim.

<table border="1" cellpadding="2" cellspacing="0" class="wikitable sortable">
<tr>
<th>IRC Nick </th>
<th>Name</th>
<th>SL Avatar</th>
<th>Other Grid</th>
<th>Time Zone (UTC)</th>
<th>Org</th>
<th>Areas of Interest</th>
</tr>

<tr>
<td>[[User:Nebadon|Nebadon]]</td>
<td>Michael Cerquoni</td>
<td>Nebadon Izumi</td>
<td>Nebadon Izumi</td>
<td>-7 Arizona</td>
<td>Oni Kenkon Creations</td>
<td>Building, Scripting, Testing</td>
</tr>

<tr>
<td>[[User:jtclark48|jclark4]]</td>
<td>Jay Clark</td>
<td>Jay Clarke</td>
<td></td>
<td>-5</td>
<td>IBM</td>
<td>Physics, Grid Host, AI, Scripting, Testing</td>
</tr>

<tr>
<td>[[User:AdamStevenson|BigFootAg]]</td>
<td>Adam Stevenson</td>
<td>Adamus Petrov</td>
<td></td>
<td>-6</td>
<td>Texas A&M University</td>
<td>AI, Skynet, Evolving Systems, Biology</td>
</tr>

<tr>
<td>[[User:jeff1564|Jeff1564]]</td>
<td>Jeff</td>
<td>Potter Taurog</td>
<td></td>
<td>-8</td>
<td></td>
<td>Building, Scripting, Testing</td>
</tr>

<tr>
<td>Rock_Vacirca</td>
<td>Colin Withers</td>
<td>Rock Vacirca</td>
<td> </td>
<td>+1</td>
<td>http://rock-vacirca.blogspot.com</td>
<td>Testing, building, scripting, maintaining an opensim blog.</td>
</tr>

<tr>
<td>simsim</td>
<td>caocao</td>
<td> </td>
<td> </td>
<td>+9</td>
<td> </td>
<td>Testing whole functions of OpenSim system,working with OpenSim-Engine,reporting on OpenSim</td>
</tr>

<tr>
<td>[[User:Vicero Lambert|Vicero Lambert]]</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </td>
</tr>

<tr>
<td>Ldvoipeng</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </td>
</tr>

<tr>
<td>idoru</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </td>
</tr>

<tr>
<td>[[User:Magi|Magi]]</td>
<td>Andy Agnew</td>
<td>Magi Merlin</td>
<td></td>
<td>+10</td>
<td>Spun Pty Ltd</td>
<td>3D Web Integration, Database stuff and playing with the odds and ends box.</td>
</tr>

<tr>
<td>john_</td>
<td>John Moyer</td>
<td>VAJohn GeekSquad or Matthew Kendal</td>
<td></td>
<td>-5</td>
<td>Best Buy/Geek Squad</td>
<td>Tester</td>
</tr>

<tr>
<td>[[User:ClarkZone|ClarkZone]]</td>
<td>Troy Admin(@ClarkZone)</td>
<td>Troy Childs</td>
<td>Troy Admin (ClarkZone)</td>
<td>-5</td>
<td>Http://clarkzone.dyndns.org</td>
<td>Tester and Grid Host</td>
</tr>

<tr>
<td>[[User:aiaustin|aiaustin]]</td>
<td>Ai Austin</td>
<td>Ai Austin</td>
<td>Ai AIAI (AIAI Grid)</td>
<td>+0</td>
<td>AIAI, University of Edinburgh http://www.aiai.ed.ac.uk/~ai/ http://vue.ed.ac.uk/openvue/</td>
<td>Windows Vista tests Content testing Use of multiple VWs</td>
</tr>

<tr>
<td>Marc Manders</td>
<td>Marc Manders</td>
<td> </td>
<td> </td>
<td>+6</td>
<td>marcmanders@gmail.com</td>
<td>creative features</td>
</tr>

<tr>
<td>[[User:balthazar|balthazar]]</td>
<td>Trevor Brooks</td>
<td>Balthazar Sin</td>
<td></td>
<td>-5</td>
<td>None</td>
<td>Terrains, testing and some small coding tasks</td>
</tr>

<tr>
<td>[[User:jimbo2120|jimbo2120]]</td>
<td>Michael Osias</td>
<td>Illuminous Beltran</td>
<td></td>
<td>-5</td>
<td>IBM</td>
<td>Grid, AI, Skynet, coding and testing</td>
</tr>

<tr>
<td>[[User:Sakai|Sakai]]</td>
<td>Steve S</td>
<td></td>
<td>Sakai Openlife (OpenlifeGrid)</td>
<td>+10</td>
<td>http://www.openlifegrid.com</td>
<td>Grid, Hardware, Testing, Contribution</td>
</tr>

<tr>
<td>ZeroPoint</td>
<td> </td>
<td>Guilderoy Dench</td>
<td></td>
<td>-5</td>
<td> </td>
<td>Programming/Database</td>
</tr>

<tr>
<td>MaltosSosa</td>
<td>Maltos Sosa</td>
<td>Maltos Sosa </td>
<td>Maltos Sosa (Central Grid)</td>
<td> </td>
<td>Central Grid</td>
<td>Grid Operator, Central Grid Project Manager. Anything we can offer, just ask.</td>
</tr>

<tr>
<td>[[User:DerekTang|DerekTang]]</td>
<td>Derek Tang</td>
<td>Derek Timeless</td>
<td>Derek Tang (ChineseGrid)</td>
<td>+8</td>
<td>http://ChineseGrid.net</td>
<td>Running a public WINDOWS sim for testing, Docs, Helping Chinese users to enjoy OpenSim; building Chinese OpenSim communities. In construction...</td>
</tr>

<tr>
<td>[[User:TayB|TayB]]</td>
<td>Earl B</td>
<td>Taylor Boyau</td>
<td></td>
<td>-10</td>
<td>ViziGrid</td>
<td>Grid Host,Networking,Contributions & Testing.</td>
</tr>

<tr>
<td>[[User:JamieDav|JamieDav]]</td>
<td>Jamie David</td>
<td>Jamie David</td>
<td></td>
<td>+7</td>
<td>Forum</td>
<td>Grid, Sim, Avitar, Functionality</td>
</tr>

<tr>
<td>[[User:Krtaylor|Krtaylor]]</td>
<td>Kurt Taylor</td>
<td>Kurt Stringer </td>
<td></td>
<td>-6</td>
<td>IBM</td>
<td>Grid, Networking, Monitoring, Scripting, Inventory, Testing</td>
</tr>

<tr>
<td>[[User:Nink|Nink]]</td>
<td>Peter Finn</td>
<td>Nink Noonan</td>
<td></td>
<td>-5</td>
<td>IBM</td>
<td>Disruptive Influence.</td>
</tr>

<tr>
<td>[[User:Bruce|Bruce]]</td>
<td>Bruce Meerson</td>
<td>Bruce Meerson</td>
<td></td>
<td>+8</td>
<td>HiPiHi</td>
<td>Watching.</td>
</tr>

<tr>
<td>[[User:Darb|DarbD]]</td>
<td>Brian B. Quinn</td>
<td>Darb Dabney</td>
<td>regions near Marin</td>
<td>PST/SLT (-7 or -8)</td>
<td>County of Marin, California http://blog.simgis.com</td>
<td>LiDAR-based sculpties, real-world terrain, pursuit of civic paraverses </td>
</tr>

<tr>
<td>[[CharlieO]]</td>
<td>Dan</td>
<td>Charlie Omega</td>
<td></td>
<td> </td>
<td> </td>
<td>Mild coding/tweaking/simple feature adds, Stress testing/break stuff, Testing limits of existing code. Making sure [[LSL Status]] is up to date</td>
</tr>

<tr>
<td>oobscure</td>
<td> </td>
<td>Opensource Obscure</td>
<td></td>
<td>+1</td>
<td>http://www.opensim.it</td>
<td>Running a public Linux sim for testing, Docs, Helping italian users, Building opensim communities, Watching</td>
</tr>

<tr>
<td>pitman</td>
<td>Mike Pitman</td>
<td>Rez Tone</td>
<td></td>
<td> </td>
<td>IBM</td>
<td>Scientific visualization schemes, virt world product design, persistant workspaces, virt world based big biz</td>
</tr>

<tr>
<td>cmu</td>
<td>Christopher Mumme</td>
<td>Snook Destiny</td>
<td></td>
<td>+1</td>
<td>http://www.cmu-develop.de/ and research group "Collaboration Systems and CSCW" at Clausthal University of Technology</td>
<td>Testing OpenSim, working with OpenSim-Engine, reporting on OpenSim</td>
</tr>

<tr>
<td>[[Silpol]]</td>
<td>Andriy Tymchenko</td>
<td>Andy Tir</td>
<td></td>
<td>EET (+2/3)</td>
<td> http://silpol.blogspot.com/ (also visible at Nokia)</td>
<td>highly uncoordinated mess with elements of palace games, under-table diplomacy, rebellion, coup d'état and mutiny. optionally pirate</td>
</tr>

<tr>
<td>[[User:Grumly|Grumly]]</td>
<td></td>
<td>Forest Klaar</td>
<td>Grumly TheBear</td>
<td>GMT+1</td>
<td>.NET MCAD Dev/Arch/Trainer http://www.devoteam.com</td>
<td>Trying to get into OpenSim code for now. Particularly interrested in data persistence. blog (Hello, Avatar!): http://lslblog.free.fr</td>
</tr>

<tr>
<td>[[daTwitch]]</td>
<td>James G. Stallings II</td>
<td> Lazarus Longstaff</td>
<td>Hiro Protagonist (OSGrid)</td>
<td>-5</td>
<td>House Husband</td>
<td>OSGrid Region owner, OSGrid Operator, Forum Admin, sometime wiki editor</td>
</tr>

<tr>
<td>gryc</td>
<td>Gryc Ueusp</td>
<td>Gryc Uriza</td>
<td>Gryc Uriza(OSGrid)</td>
<td>-6</td>
<td></td>
<td>PHP scripting, web interfaces, interconnectivity, cross-platformedness</td>
</tr>

<tr>
<td>[[User:Phrearch|Phrearch]]</td>
<td>Jeroen van Veen</td>
<td>Phrearch Miles</td>
<td>Phrearch Miles(OSGrid)</td>
<td>Amsterdam/Paris</td>
<td></td>
<td>WiXTD, Wikidoc and Moo</td>
</tr>

<tr>
<td>[[User:Burnman|Burnman]]</td>
<td>Allen Wilkins</td>
<td>Burnman Bedlam</td>
<td>Sid Green (United Grid)</td>
<td>Boston, USA</td>
<td>United Grid</td>
<td>Testing, testing, and more testing! Getting familiar with the source, interested in all aspects of the project.</td>
</tr>

<tr>
<td>[[User:krisbfunk|krisbfunk]]</td>
<td>Kris Bulman</td>
<td>krisbfunk Vought</td>
<td>Krisbfunk Nocturnal(OSGrid)</td>
<td>PE, Canada (-4)</td>
<td>Edactive Technologies NocturnalEye Productions UPEI</td>
<td>Currently: Testing, bug reports, wiki updating, building on OSGrid</td>
</tr>

<tr>
<td>[[User:HashBox|HashBox]]</td>
<td> </td>
<td>Sibariel Darkstone</td>
<td>Sibariel Darkstone (OSGrid)</td>
<td>New Zealand (+12)</td>
<td></td>
<td>Testing, bug reports, and updating the wiki.</td>
</tr>

<tr>
<td>[[User:Kinoc|Kinoc]]</td>
<td>Kino Coursey</td>
<td>Daxxon Jaxxon</td>
<td>Daxxon Kinoc (OSgrid)</td>
<td>-6</td>
<td>Daxtron Laboratories http://www.daxtron.com University of North Texas</td>
<td>AI, Semantic web, Ontologies, Natural Laanguage Processing, Cyc, Bots, NPC </td>
</tr>

<tr>
<td>[[User:trapuh|trapuh]]</td>
<td>Pedro Ribeiro</td>
<td>Vaiten Forder</td>
<td></td>
<td>GMT</td>
<td>University Student, Escola Superior de Educação de Viseu, Portugal </td>
<td>Testing, eventual bug reports and wiki. Music, web/digital arts and php+sql.</td>
</tr>

<tr>
<td>[[User:SonicViz|SonicViz]]</td>
<td>Paul Cohen</td>
<td>Komuso Tokugawa</td>
<td></td>
<td>+9</td>
<td>Http://sonicviz.com</td>
<td>Audio/Music, Interactive Music, Control Protocols, Interfaces, VisualFX, Procedural animation/Generative systems + testing and general dev</td>
</tr>

<tr>
<td>[[User:Mokele|mokele]]</td>
<td>Scott Norman</td>
<td>Mokelembembe Mokeev</td>
<td></td>
<td>-8 (Southern California)</td>
<td>Web Developer (PHP and MySQL)</td>
<td>Interested in seeing running on PowerPC Macs which it is. So, when I can, I'll compile and test on PowerPC Mac (PowerBook G4) and submit reports and then update the wiki if need on installing on Mac. Also have a Ubuntu 7.10 server that I can do testing on too.</td>
</tr>

<tr>
<td>[[User:devalnor|devalnor]]</td>
<td>Devalnor</td>
<td>M. Watkin</td>
<td></td>
<td>+1 (Belgium)</td>
<td></td>
<td>Small Patch code, bug reports, and updating the wiki.</td>
</tr>

<tr>
<td>[[User:Ezekiel|Ezekiel]]</td>
<td>Ezekiel</td>
<td>Ezekiel Zabelin</td>
<td></td>
<td>+1 </td>
<td>http://www.yosims.com </td>
<td>Concepts, business aspects of virtual worlds - web developer (PHP, MySQL, Javascript, LSL) </td>
</tr>

<tr>
<td>[[User:Buggmaster|Buggmaster]]</td>
<td>Mike D</td>
<td>Bug Master</td>
<td>None</td>
<td>-8 </td>
<td>http://www.adultmetaverse.com</td>
<td>Grid, Data/Web PHP/PERL/MySQL</td>
</tr>

<tr>
<td>[[User:Nixnerd|nixnerd]]</td>
<td></td>
<td>Dangerously Moody</td>
<td>None</td>
<td>GMT </td>
<td>http://www.integratedtechnologies.eu</td>
<td>Cross Platform Testing, Feedback, Bug Reporting</td>
</tr>

<tr>
<td>[[User:MoHax|mohax]]</td>
<td>Mo Hax</td>
<td>Mo Hax</td>
<td></td>
<td>-5 Eastern</td>
<td>IBM</td>
<td>Testing, Feedback, Content Contributions, Bug Reporting, Documenting, Development</td>
</tr>

<tr>
<td>[[User:Webmage|webmage]]</td>
<td>webmage</td>
<td>Leyla Masala</td>
<td>Web Mage</td>
<td>+1</td>
<td>IBM</td>
<td>Testing, terrain</td>
</tr>

<tr>
<td>[[User:NLStitch|NLStitch]]</td>
<td>Marijn Oosterveld</td>
<td>Stitch Seale</td>
<td>NYA</td>
<td>GMT +1 Amsterdam</td>
<td>Twingate Systems (http://www.twingate.nl) HanzeHogeschool Groningen, Netherlands
</td>
<td>Programming, Photography, AI</td>
</tr>

<tr>
<td>[[User:Ideia Boa|Ideia Boa]]</td>
<td>Joao Lopes</td>
<td>Ideia Boa</td>
<td>Ideia Boa or Boa Ideia in some grids</td>
<td>GTM+1 Stockholm/Sweden</td>
<td>WorldSimTERRA - Virtual World that speaks Portuguese too http://www.worldsimterra.com</td>
<td>Testing and more testing! Updating the original wiki and translating the OpenSim Wiki into Portuguese and reporting on OpenSim</td>
</tr>

<tr>
<td>[[User:Lulurun|lulurun]]</td>
<td>liu</td>
<td> </td>
<td> </td>
<td>+9</td>
<td>3Di Inc, Japan http://www.3di.jp</td>
<td>patches, openid, server performance, UGAI</td>
</tr>

<tr>
<td>[[User:Carlosroundel|Carlosrounde]]</td>
<td>Carlosroundel</td>
<td>Carlos Roundel</td>
<td> </td>
<td>+1</td>
<td>Cyberlandia Italy http://www.cyberlandia.net</td>
<td>grid, programmer, database, tester</td>
</tr>

<tr>
<td>[[User:Mikebert|Mikebert]]</td>
<td>Michael Strunck</td>
<td>Mikebert Miles</td>
<td>Mikebert M34</td>
<td>+1</td>
<td>OpenSIM Wiki, Germany http://www.opensim.de</td>
<td>German Wiki, Translater, Server Performance (Linux/Windows), Tester, Feedback, Bug Reporting, Server-Hosting</td>
</tr>

<tr>
<td>[[User:Fly-man-|Fly-Man-]]</td>
<td>Laurence</td>
<td></td>
<td>Fly Man</td>
<td>+1</td>
<td></td>
<td>Testing, OpenSimSearch, OpenSimProfile, OpenWiredux</td>
</tr>

<tr>
<td>Taoki</td>
<td>Mircea Kitsune / Taoki Vixen</td>
<td>Mircea Kitsune (OSGrid) / Mircea Lobo (LL grid)</td>
<td> </td>
<td>GMT +2</td>
<td> </td>
<td>Usually testing and bug reporting but I also make smaller patches where I know what to do.</td>
</tr>

<tr>
<td>[[User:Patnad|Patnad]]</td>
<td>Patrick</td>
<td>Patnad Babii</td>
<td>Patnad Babii (OSGrid)</td>
<td>GMT -5</td>
<td> </td>
<td>Bug testing and reporting, I code C# but haven't touched OpenSim Project.. Yet!</td>
</tr>

<tr>
<td>[[User:Hallow Palmer|Hallow Palmer]]</td>
<td>Markus</td>
<td>Hallow Palmer</td>
<td> </td>
<td>+1</td>
<td>Grid4Us http://www.grid4us.net</td>
<td>Server Performance (Windows), Tester, Feedback, Business concepts,Bug Reporting, Server-Hosting</td>
</tr>

<tr>
<td>[[User:^DarkMan|^DarkMan]]</td>
<td>Brian Adair</td>
<td>Patrick Ouachita</td>
<td>Brian Adair | Patrick Meta</td>
<td>-6 CST</td>
<td>RealMetaLife | B&H Networking</td>
<td>Building, Scripting, Testing, etc.</td>
</tr>

<tr>
<td>[[User:tlaukkan|Tommi Laukkanen]]</td>
<td>Tommi Laukkanen</td>
<td> </td>
<td>Tommi Laukkanen</td>
<td>+2 GMT</td>
<td>http://www.bubblecloud.org</td>
<td>Protocols ([http://www.bubblecloud.org MXP]), NHibernate, Scrip API, Map Generation, Bug Fixes, Grid Hosting</td>
</tr>

<tr>
<td>[[User:bikcmp|bikcmp]]</td>
<td>Jason</td>
<td>NONE</td>
<td>NONE</td>
<td>EST</td>
<td>Blue Software</td>
<td>God power, reporting and fixing bugs, and overall performance.</td>
</tr>

<tr>
<td>[[User:arthursv|arthursv]]</td>
<td>Arthur Valadares</td>
<td>Arthur Valadares</td>
<td>NONE</td>
<td>-3</td>
<td>IBM</td>
<td>Unit testing, database plugins, bug fixes, general </td>
</tr>

<tr>
<td>[[User:Mystical|Mystical]]</td>
<td>Kevin Tweedy</td>
<td>Mystical Demina</td>
<td>Mystical Demina</td>
<td>-5</td>
<td>Extreme Reality Grid http://www.XRGrid.com</td>
<td>Windows Communication Framework, Workflow Foundation,Entity Framework Hosting,Enhancements,Content,Services,Security</td>
</tr>

</table>
[[Category:Main]]
[[Category:Development]]

New Region Modules

2009-01-24T19:58:31Z

HomerHorwitz: Initial version

(This is a first draft-version and can change at any time until complete
implementation. Feel free to comment, either on the Discussion page or on the
opensim-dev mailing list)

= Why =

The current RegionModule system's API is in part inconsistent and doesn't
really support region-restarts and adding/removing regions on the fly during
a region-server run.
E.g., the API says ''Initialise'' is called for every region (in every
region-module), after that, ''PostInitialise'' is called for every region-module.
When a new region is added, what should happen?
* Don't call ''Initialise'': Then the region-module isn't initialised for that region, which leads to missing functionality.
* Call ''Initialise'': Then ''PostInitialise'' was called too early. Actually, ''PostInitialise'' can not be called at all, because you can add a region after that anytime.

What should happen if a region is restarted? What should happen if a region
is removed?

= What =

The new region-module system is based on three interfaces: ''ISharedRegionModule'',
''INonSharedRegionModule'' and ''IRegionModuleBase'', which is the base interface for
the other two.

public interface IRegionModuleBase
{
string Name { get; }
void Initialise(IConfigSource source);
void Close();
void AddRegion(Scene scene);
void RemoveRegion(Scene scene);
}

public interface ISharedRegionModule : IRegionModuleBase
{
void PostInitialise();
}

public interface INonSharedRegionModule : IRegionModuleBase
{
}

* Loading the region-modules' classes happens via ''Mono.Addins'' on server-start.
* Instantiating the region-modules happens...
** for ''ISharedRegionModule''s once after loading (on server start)
** for ''INonSharedRegionModule''s after creation of the ''Scene'' object.
* You can cleanup when a region is removed.
* You can cleanup before the server shuts down.

;Note:
:A ''PostInitialise'' for a ''INonSharedRegionModule'' doesn't make a lot of sense, as we don't have a certain point from which on we won't call ''Initialise'' on a ''INonSharedRegionModule'' again. Every time a new region is added (on restart, too), a new instance is created and ''Initialise'' is called on that instance, so the intended semantics of ''PostInitialise'' will never apply.

= Details =

== Start of region-server ==

* Region-server starts, the classes of all region-modules are loaded in no particular order
* The ''Scene''s are instantiated.
** For every ''ISharedRegionModule'', one instance is created and ''Initialise'' is called.
** For every ''ISharedRegionModule'' instance, ''PostInitialise'' is called.
** For every ''Scene'', for every ''INonSharedRegionModule'', a new instance is created and ''Initialise'' called.
** For every ''Scene'', for every ''INonSharedRegionModule'' and ''ISharedRegionModule'', ''AddRegion(scene)'' is called. The modules are associated to the ''Scene'' (for deletion on remove)

== Adding a region ==

* A new ''INonSharedRegionModule'' instance is created and ''Initialise'' is called
* The new ''Scene'' object is created.
* For every ''INonSharedRegionModule'' and ''ISharedRegionModule'', ''AddRegion(scene)'' is called. The modules are associated to the ''Scene'' (for deletion on remove)

== Removing a region ==

* For every ''INonSharedRegionModule'' of the scene and every ''ISharedRegionModule'', ''RemoveRegion(scene)'' is called
* For every ''INonSharedRegionModule'' of the scene, ''Close'' is called
* Every module reference of the scene is removed from the scene. No references should be left after that; the ''INonSharedRegionModule''s could be garbage collected now.

== Restarting a region ==

For simplicity, I'd like to do this as a [[#Removing_a_region|"Removing a region"]], followed by a
[[#Adding_a_region|"Adding a region"]]. Is there a functional reason for not doing that?

== Shutdown of the region-server ==

* For every scene, perform the [[#Removing_a_region|"Removing a region"]] step:
** ''RemoveRegion'' is called for all scenes and modules
** ''Close'' is called for all the ''INonSharedRegionModule''s
* ''Close'' is called for all the ''ISharedRegionModule''. Possible book-keeping references are removed; the ''ISharedRegionModule'' could now be garbage-collected.

= Questions =
* Loading via Mono.Addins? Via ExtensionLoader? Via our own loader (like the current one)?
* Configuration about which modules should be loaded?

Logging

2008-12-19T18:26:25Z

HomerHorwitz: Added another example

== Changing logging levels before startup ==

OpenSim uses the [http://logging.apache.org/log4net/ log4net] package for logging. This means that every executable you run for OpenSim has an accompanying .config file which contains the logging configuration

For instance, the OpenSim.exe.config file looks like this.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net" />
</configSections>
<appSettings>
</appSettings>
<log4net>
<appender name="Console" type="OpenSim.Framework.Console.OpenSimAppender, OpenSim.Framework.Console">
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date{HH:mm:ss} - %message%newline" />
</layout>
</appender>

<appender name="LogFileAppender" type="log4net.Appender.FileAppender">
<file value="OpenSim.log" />
<appendToFile value="true" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date %-5level - %logger %message%newline" />
</layout>
</appender>


<logger name="NHibernate" additivity="false">
<level value="INFO"/>
<appender-ref ref="NHibernateFileLog"/>
</logger>

<root>
<level value="DEBUG" />
<appender-ref ref="Console" />
<appender-ref ref="LogFileAppender" />
</root>
</log4net>
</configuration>

This looks rather complicated, but if you want to change the level of messages logged, then you could change the value in the <root> section (right at the end) which is

<level value="DEBUG" />

in the example above to something different, e.g.

<level value="WARN" />

which will only display warning and error level log messages. Permissible values are ALL, DEBUG, INFO, WARN, ERROR, FATAL, OFF

You can also see from the OpenSim.exe.config file that log files are written to OpenSim.log (as well as the console).

=== Rolling file appender and maximum log-file size ===

Log4net provides several log-file appenders. One of them is the ''RollingFileAppender'', which limits log-file size and rotates log-files automatically. To use this appender, add the following section to the log4net-configuration:

<appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender">
<file value="OpenSim.log" />
<appendToFile value="true" />
<maximumFileSize value="1000KB" />
<maxSizeRollBackups value="2" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date %-5level - %logger %message%newline" />
</layout>
</appender>

The maximum size can be set in the ''maximumFileSize'' element, the ''maxSizeRollBackups'' element determines the maximum number of rolling log-files. So, the setting above will create a log-file named ''OpenSim.log'' with a maximum size of 1000KB. When the limit is reached, ''OpenSim.log'' will be renamed to ''OpenSim.log.1'', and a fresh ''OpenSim.log'' is started (possibly after renaming ''OpenSim.log.1'' to ''OpenSim.log.2'', should that file exist already).

To use the appender defined above, replace the line
<appender-ref ref="LogFileAppender" />
by
<appender-ref ref="RollingFileAppender" />

Further information about configuration of log4net can be found on the [http://logging.apache.org/log4net/release/manual/configuration.html Log4Net configuration page].

=== More specialized requirements ===
As an example, similar to [http://opensimulator.org/mantis/view.php?id=2603 Mantis#2603], if you want logging the XEngine's DEBUG output into a separate file ''xengine.log'', and let only the message with level INFO and higher appear on the console, you can do that by adding the following lines to your ''OpenSim.exe.config'':

<appender name="XengineLogFileAppender" type="log4net.Appender.FileAppender">
<file value="xengine.log" />
<appendToFile value="true" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date %-5level - %logger %message%newline" />
</layout>
</appender>

<appender name="XengineConsole" type="OpenSim.Framework.Console.OpenSimAppender, OpenSim.Framework.Console">
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date{HH:mm:ss} - %message%newline" />
</layout>
<filter type="log4net.Filter.LevelRangeFilter">
<levelMin value="INFO" />
<levelMax value="FATAL" />
</filter>
</appender>

<logger name="OpenSim.Region.ScriptEngine.XEngine.XEngine" additivity="false">
<appender-ref ref="XengineLogFileAppender" />
<appender-ref ref="XengineConsole" />
</logger>

(if there is a shorter way to do it, please replace those lines above) ;-)

Or, as an easier example, if you want to have the normal logging, except for the HttpServers which you want only INFO messages for, you can add the following lines after the ''</root>''-tag:

<logger name="OpenSim.Framework.Servers.HttpServerLogWriter">
<level value="INFO" />
</logger>

== Setting log levels during runtime ==

It isn't currently possible to change the level of logging to the log file during runtime. However, it is possible to change the level sent to the console. You can do this by executing the

set log level [<level>]

command. For example

set log level error

will mean only errors are sent to the console. The log still receives messages that meet the level set in the OpenSim.exe.config file at startup.

Not specifying any level will tell you what the current console logging level is.

Changes to the log level sent to the console will not persist over restarts. If you want the change to be permanent, you can set a threshold value in the ConsoleAppender in a config file such as OpenSim.exe.config as described above.

Logging

2008-11-11T21:45:44Z

HomerHorwitz: Added an example for #2603

== Changing logging levels before startup ==

OpenSim uses the [http://logging.apache.org/log4net/ log4net] package for logging. This means that every executable you run for OpenSim has an accompanying .config file which contains the logging configuration

For instance, the OpenSim.exe.config file looks like this.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net" />
</configSections>
<appSettings>
</appSettings>
<log4net>
<appender name="Console" type="OpenSim.Framework.Console.OpenSimAppender, OpenSim.Framework.Console">
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date{HH:mm:ss} - %message%newline" />
</layout>
</appender>

<appender name="LogFileAppender" type="log4net.Appender.FileAppender">
<file value="OpenSim.log" />
<appendToFile value="true" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date %-5level - %logger %message%newline" />
</layout>
</appender>


<logger name="NHibernate" additivity="false">
<level value="INFO"/>
<appender-ref ref="NHibernateFileLog"/>
</logger>

<root>
<level value="DEBUG" />
<appender-ref ref="Console" />
<appender-ref ref="LogFileAppender" />
</root>
</log4net>
</configuration>

This looks rather complicated, but if you want to change the level of messages logged, then you could change the value in the <root> section (right at the end) which is

<level value="DEBUG" />

in the example above to something different, e.g.

<level value="WARN" />

which will only display warning and error level log messages. Permissible values are ALL, DEBUG, INFO, WARN, ERROR, FATAL, OFF

You can also see from the OpenSim.exe.config file that log files are written to OpenSim.log (as well as the console).

=== Rolling file appender and maximum log-file size ===

Log4net provides several log-file appenders. One of them is the ''RollingFileAppender'', which limits log-file size and rotates log-files automatically. To use this appender, add the following section to the log4net-configuration:

<appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender">
<file value="OpenSim.log" />
<appendToFile value="true" />
<maximumFileSize value="1000KB" />
<maxSizeRollBackups value="2" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date %-5level - %logger %message%newline" />
</layout>
</appender>

The maximum size can be set in the ''maximumFileSize'' element, the ''maxSizeRollBackups'' element determines the maximum number of rolling log-files. So, the setting above will create a log-file named ''OpenSim.log'' with a maximum size of 1000KB. When the limit is reached, ''OpenSim.log'' will be renamed to ''OpenSim.log.1'', and a fresh ''OpenSim.log'' is started (possibly after renaming ''OpenSim.log.1'' to ''OpenSim.log.2'', should that file exist already).

To use the appender defined above, replace the line
<appender-ref ref="LogFileAppender" />
by
<appender-ref ref="RollingFileAppender" />

Further information about configuration of log4net can be found on the [http://logging.apache.org/log4net/release/manual/configuration.html Log4Net configuration page].

=== More specialized requirements ===
As an example, similar to [http://opensimulator.org/mantis/view.php?id=2603 Mantis#2603], if you want logging the XEngine's DEBUG output into a separate file ''xengine.log'', and let only the message with level INFO and higher appear on the console, you can do that by adding the following lines to your ''OpenSim.exe.config'':

<appender name="XengineLogFileAppender" type="log4net.Appender.FileAppender">
<file value="xengine.log" />
<appendToFile value="true" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date %-5level - %logger %message%newline" />
</layout>
</appender>

<appender name="XengineConsole" type="OpenSim.Framework.Console.OpenSimAppender, OpenSim.Framework.Console">
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date{HH:mm:ss} - %message%newline" />
</layout>
<filter type="log4net.Filter.LevelRangeFilter">
<levelMin value="INFO" />
<levelMax value="FATAL" />
</filter>
</appender>

<logger name="OpenSim.Region.ScriptEngine.XEngine.XEngine" additivity="false">
<appender-ref ref="XengineLogFileAppender" />
<appender-ref ref="XengineConsole" />
</logger>

(if there is a shorter way to do it, please replace those lines above) ;-)

== Setting log levels during runtime ==

It isn't currently possible to change the level of logging to the log file during runtime. However, it is possible to change the level sent to the console. You can do this by executing the

set log level [<level>]

command. For example

set log level error

will mean only errors are sent to the console. The log still receives messages that meet the level set in the OpenSim.exe.config file at startup.

Not specifying any level will tell you what the current console logging level is.

Changes to the log level sent to the console will not persist over restarts. If you want the change to be permanent, you can set a threshold value in the ConsoleAppender in a config file such as OpenSim.exe.config as described above.

OSSL Implemented

2008-11-08T16:41:59Z

HomerHorwitz: Added osTeleportAgent

{| border=1 style="border-collapse:collapse;th background-color:#666;width:100%;text-align:center;"
! style="background-color:#D2ECD2;" | Function
! style="background-color:#D2ECD2;" | Explanation
! style="background-color:#D2ECD2;" | Examples
|-
| string osSetDynamicTextureURL(string dynamicID, string contentType, string url, string extraParams,int timer);
| Loads a webtexture on a prim
| [[osSetDynamicTextureURL_example1|example 1]]
|-
|-
| double osTerrainGetHeight(int x, int y);
| Gets height of terrain
|
|-
|-
| int osTerrainSetHeight(int x, int y);
| Sets height of terrain
|
|-
|-
| int osRegionRestart(double seconds);
| Restarts the region
|
|-
|-
| void osRegionNotice(string msg);
| Sends a notice to the region
|-
|-
| System.Collections.Hashtable osParseJSON(string JSON);
| returns a hashtable containing the structured JSON contents (c# only)
| [[osParseJSON_example1|example 1]]
|-
|-
| osMessageObject(key objectId, string message);
| sends a string to the object identified by objectId, the receiving object requires to implement the method dataserver( key queryid, string data ) in a contained script(s). The queryid passed will be the id of the calling object.
|
|-
|-
| osTeleportAgent(key agentId, string regionName, vector position, vector lookAt);
| Teleports agent ''agentId'' to region ''regionName'', region-local position ''position'', with looking direction ''lookAt'' without asking the user first (in contrast to ''llMapDestination'')
|-
|-
| osTeleportAgent(key agentId, vector position, vector lookAt);
| Teleports agent ''agentId'' to position ''position'' in the same region, with looking direction ''lookAt'' without asking the user first (in contrast to ''llMapDestination'')
|-
|-
[[Category:Users]]
[[Category:Development]]

Development Team

2008-09-11T20:01:19Z

HomerHorwitz: /* Active OpenSim Core Developers */

== Active OpenSim Core Developers ==
These people have commit access to our central SVN server and are [http://www.ohloh.net/projects/4753/contributors regular contributors] to the codebase.

(please add in as much info as you like for your name)

<table border="1" cellpadding="2" cellspacing="0" class="sortable">
<tr>
<th>Photo </th>
<th>IRC Nick </th>
<th>Name</th>
<th>SL Avatar</th>
<th>Other Grid</th>
<th>Time Zone (UTC)</th>
<th>Org</th>
<th>Areas of Interest</th>
</tr>
<tr>
<td />
<td>[[User:MW |MW ]]</td>
<td>Darren</td>
<td>Wright Juran</td>
<td></td>
<td>0</td>
<td>Tribal Media AB</td>
<td>everything</td>
</tr>
<tr>
<td />
<td>[[User:Adam Frisby|Adam Frisby]]</td>
<td>Adam Frisby</td>
<td>Adam Zaius</td>
<td></td>
<td>+8</td>
<td>DeepThink Pty Ltd</td>
<td>Terrain, Performance</td>
</tr>
<tr>
<td />
<td>[[User:MingChen|MingChen]]</td>
<td>Mike/Michael Ortman</td>
<td>Ming Chen</td>
<td></td>
<td>-6 (-5 in Summer)</td>
<td>DeepThink Pty Ltd</td>
<td>Estate/Parcel Support/Modules/Keeping things all neat and tidy.</td>
</tr>
<tr>
<td> </td>
<td>[[User:lbsa71|lbsa71]]</td>
<td>Stefan Andersson</td>
<td>PierreJoseph Proudhon</td>
<td>OSG:Stefan Andersson OLG:Stefan Andersson</td>
<td>+1</td>
<td>Tribal Media AB</td>
<td> 3D and Web Integration</td>
</tr>
<tr>
<td />
<td>[[User:SeanDague|sdague]]</td>
<td>Sean Dague</td>
<td>Neas Bade</td>
<td></td>
<td>-5</td>
<td>IBM</td>
<td>Database, Linux, Testing, Misc</td>
</tr>
<tr>
<td />
<td>[[User:Tedd|Tedd]]</td>
<td>Tedd Hansen</td>
<td>Tedd Maa</td>
<td></td>
<td>+1</td>
<td>Tedd Hansen</td>
<td>Programming/Scripting/Architecture</td>
</tr>
<tr>
<td />
<td>[[User:dalien|dalien]]</td>
<td>Dalien Talbot</td>
<td>Dalien Talbot</td>
<td></td>
<td>+1</td>
<td>Mostly TCP-based</td>
<td>Small fixes; rev.eng./prototyping; nightlies; git-keeper </td>
</tr>
<tr>
<td />
<td>ckrinke</td>
<td>Charles Krinke</td>
<td>Charlesk Bing</td>
<td></td>
<td>-8</td>
<td> </td>
<td>Reliability/Grid servers/ll-functions</td>
</tr>
<tr>
<td />
<td>[[User:chi11ken|chi11ken]]</td>
<td>Jeff Ames</td>
<td>Chillken Proto</td>
<td> </td>
<td>+9</td>
<td>[http://www.3di.jp/en/ 3Di Inc, Japan] / Genkii</td>
<td> </td>
</tr>
<tr>
<td />
<td>[[User:adjohn|adjohn]]</td>
<td>Adam Johnson</td>
<td>Zeuz Zenovka</td>
<td> </td>
<td>+9</td>
<td>[http://www.3di.jp/en/ 3Di Inc, Japan] / Genkii</td>
<td> </td>
</tr>
<tr>
<td />
<td>[[User:joha1|joha1]]</td>
<td>Johan Berntsson</td>
<td>Joppi Brandenburg</td>
<td> </td>
<td>+9</td>
<td>[http://www.3di.jp/en/ 3Di Inc, Japan] http://www.3di.jp/en/</td>
<td>Performance, packet handling/libSL</td>
</tr>
<tr>
<td />
<td>[[User:Teravus|Teravus]]</td>
<td>Teravus</td>
<td>Teravus Ousley</td>
<td></td>
<td>-5</td>
<td>W3z</td>
<td>Physics & Admin tools, A working sim.</td>
</tr>
<tr>
<td />
<td>[[User:justincc|justincc]]</td>
<td>Justin Clark-Casey</td>
<td>Lulworth Beaumont</td>
<td>Justin Clark-Casey (osgrid)</td>
<td>0</td>
<td>None (for a week) [http://justincc.wordpress.com justincc's OpenSim blog]</td>
<td>Grid, performance & reliability, inventory (avatar and object), assets, scenes, etc.</td>
</tr>
<tr>
<td />
<td>[[Alondria]]</td>
<td></td>
<td>Alondria LeFay</td>
<td>Alondria LeFay (OSGrid)</td>
<td>-8</td>
<td>Independent</td>
<td>Implementation of LSL functions and other scripting tidbits.</td>
</tr>
<tr>
<td />
<td>[[User:DrScofield|drscofld]]</td>
<td>Dirk Husemann</td>
<td>Dr Scofield</td>
<td></td>
<td>+1</td>
<td>IBM</td>
<td>reliability, networking protocols, voice, inventory, assets, remote control, and pretty much everything else :-)</td>
</tr>
<tr>
<td />
<td>[[User:dahlia|dahlia]]</td>
<td>T. Hoff</td>
<td>Dahlia Trimble</td>
<td></td>
<td>-8 / -7</td>
<td>independent</td>
<td>prim collision geometry, more later :)</td>
</tr>
<tr>
<td></td>
<td>[[User:Mikem|mikem]]</td>
<td>Mike</td>
<td> </td>
<td> </td>
<td>+9</td>
<td>[http://www.3di.jp/en/ 3Di Inc, Japan] http://www.3di.jp/en/</td>
<td>patches, scripting improvements, LSL compiler</td>
</tr>
<tr>
<td></td>
<td>[[User:Homer Horwitz|Homer_Horwitz]]</td>
<td>Homer Horwitz</td>
<td>Homer Horwitz</td>
<td> </td>
<td>+2</td>
<td>Independent</td>
<td>map/TP, rev. engineering, "now, that's funny" problems, but still interested in all parts of it</td>
</tr>

</table>

== Retired OpenSim core developers ==

These people are core developers who have transcended our mortal plane (i.e. they are no longer active).

<table border="1" cellpadding="2" cellspacing="0" class="sortable">
<tr>
<th>Photo </th>
<th>IRC Nick </th>
<th>Name</th>
<th>SL Avatar</th>
<th>Other Grid</th>
<th>Time Zone (UTC)</th>
<th>Org</th>
<th>Areas of Interest</th>
</tr>
<tr>
<td />
<td>[[User:babblefrog|babblefrog]]</td>
<td>Brian McBee</td>
<td>Dogen Coldstream</td>
<td>Babblefrog Ballistic (osgrid)</td>
<td>-8</td>
<td>Disorganized</td>
<td> </td>
</tr>
<tr>
<td />
<td>[[User:danx0r|danx0r]]</td>
<td>Dan Miller</td>
<td>Albert Pascal</td>
<td></td>
<td>-8</td>
<td>squiggle.com</td>
<td>PHEEZIKS; everything</td>
</tr>
<tr>
<td />
<td>Tleiades</td>
<td> </td>
<td>Tleiades Hax</td>
<td></td>
<td>+1</td>
<td> </td>
<td>Grid servers/Database</td>
</tr>
<tr>
<td />
<td>[[User:Darok|Darok]]</td>
<td> </td>
<td>Darok Kaminski</td>
<td></td>
<td>+1</td>
<td> </td>
<td>Physics engines (especially BulletX)</td>
</tr>
<tr>
<td />
<td>Gareth / Gwen</td>
<td>Gareth Nelson</td>
<td>Gareth Ellison</td>
<td>Gareth Nelson (on everywhere but SL)</td>
<td>BST (UTC+1)</td>
<td>Litesim Ltd</td>
<td>Grid servers, sim border crossing, avatar animations</td>
</tr>
</table>

== Additional Developers/Testers/Contributors ==
These people have contributed bug reports, patches or other contributions to OpenSim.

<table border="1" cellpadding="2" cellspacing="0" class="wikitable sortable">
<tr>
<th>IRC Nick </th>
<th>Name</th>
<th>SL Avatar</th>
<th>Other Grid</th>
<th>Time Zone (UTC)</th>
<th>Org</th>
<th>Areas of Interest</th>
</tr>
<tr>
<td>[[User:Nebadon|Nebadon]]</td>
<td>Michael Cerquoni</td>
<td>Nebadon Izumi</td>
<td>Nebadon Izumi</td>
<td>-7 Arizona</td>
<td>Oni Kenkon Creations</td>
<td>Building, Scripting, Testing</td>
</tr>
<tr>
<td>[[User:jtclark48|jclark4]]</td>
<td>Jay Clark</td>
<td>Jay Clarke</td>
<td></td>
<td>-5</td>
<td>IBM</td>
<td>Physics, Grid Host, AI, Scripting, Testing</td>
</tr>
<tr>
<td>[[User:AdamStevenson|BigFootAg]]</td>
<td>Adam Stevenson</td>
<td>Adamus Petrov</td>
<td></td>
<td>-6</td>
<td>Texas A&M University</td>
<td>AI, Skynet, Evolving Systems, Biology</td>
</tr>
<tr>
<td>simsim</td>
<td>caocao</td>
<td> </td>
<td> </td>
<td>+9</td>
<td> </td>
<td>Testing whole functions of OpenSim system,working with OpenSim-Engine,reporting on OpenSim</td>
</tr>
<tr>
<td>[[User:Vicero Lambert|Vicero Lambert]]</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>Ldvoipeng</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>idoru</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </td>
</tr>
<tr>
<td>[[User:Magi|Magi]]</td>
<td>Andy Agnew</td>
<td>Magi Merlin</td>
<td></td>
<td>+10</td>
<td>Spun Pty Ltd</td>
<td>3D Web Integration, Database stuff and playing with the odds and ends box.</td>
</tr>
<tr>
<td>john_</td>
<td>John Moyer</td>
<td>VAJohn GeekSquad or Matthew Kendal</td>
<td></td>
<td>-5</td>
<td>Best Buy/Geek Squad</td>
<td>Tester</td>
</tr>
<tr>
<td>[[User:ClarkZone|ClarkZone]]</td>
<td>Troy Admin(@ClarkZone)</td>
<td>Troy Childs</td>
<td>Troy Admin (ClarkZone)</td>
<td>-5</td>
<td>Http://clarkzone.dyndns.org</td>
<td>Tester and Grid Host</td>
</tr>
<tr>
<td>[[User:aiaustin|aiaustin]]</td>
<td>Ai Austin</td>
<td>Ai Austin</td>
<td>Ai AIAI (AIAI Grid)</td>
<td>+0</td>
<td>AIAI, University of Edinburgh http://www.aiai.ed.ac.uk/~ai/ http://vue.ed.ac.uk/openvue/</td>
<td>Windows Vista tests Content testing Use of multiple VWs</td>
</tr>
<tr>
<td>[[User:balthazar|balthazar]]</td>
<td>Trevor Brooks</td>
<td>Balthazar Sin</td>
<td></td>
<td>-5</td>
<td>None</td>
<td>Terrains, testing and some small coding tasks</td>
</tr>
<tr>
<td>[[User:jimbo2120|jimbo2120]]</td>
<td>Michael Osias</td>
<td>Illuminous Beltran</td>
<td></td>
<td>-5</td>
<td>IBM</td>
<td>Grid, AI, Skynet, coding and testing</td>
</tr>
<tr>
<td>[[User:Sakai|Sakai]]</td>
<td>Steve S</td>
<td></td>
<td>Sakai Openlife (OpenlifeGrid)</td>
<td>+10</td>
<td>http://www.openlifegrid.com</td>
<td>Grid, Hardware, Testing, Contribution</td>
</tr>
<tr>
<td>ZeroPoint</td>
<td> </td>
<td>Guilderoy Dench</td>
<td></td>
<td>-5</td>
<td> </td>
<td>Programming/Database</td>
</tr>
<tr>
<td>MaltosSosa</td>
<td>Maltos Sosa</td>
<td>Maltos Sosa </td>
<td>Maltos Sosa (Central Grid)</td>
<td> </td>
<td>Central Grid</td>
<td>Grid Operator, Central Grid Project Manager. Anything we can offer, just ask.</td>
</tr>

<tr>
<td>[[User:DerekTang|DerekTang]]</td>
<td>Derek Tang</td>
<td>Derek Timeless</td>
<td>Derek Tang (ChineseGrid)</td>
<td>+8</td>
<td>http://ChineseGrid.net</td>
<td>Running a public WINDOWS sim for testing, Docs, Helping Chinese users to enjoy OpenSim; building Chinese OpenSim communities. In construction...</td>
</tr>

<tr>
<td>[[User:TayB|TayB]]</td>
<td>Earl B</td>
<td>Taylor Boyau</td>
<td></td>
<td>-10</td>
<td>ViziGrid</td>
<td>Grid Host,Networking,Contributions & Testing.</td>
</tr>
<tr>
<td>[[User:JamieDav|JamieDav]]</td>
<td>Jamie David</td>
<td>Jamie David</td>
<td></td>
<td>+7</td>
<td>Forum</td>
<td>Grid, Sim, Avitar, Functionality</td>
</tr>
<tr>
<td>[[User:Krtaylor|Krtaylor]]</td>
<td>Kurt Taylor</td>
<td>Kurt Stringer </td>
<td></td>
<td>-6</td>
<td>IBM</td>
<td>Grid, Networking, Monitoring, Scripting, Inventory, Testing</td>
</tr>
<tr>
<td>[[User:Nink|Nink]]</td>
<td>Peter Finn</td>
<td>Nink Noonan</td>
<td></td>
<td>-5</td>
<td>IBM</td>
<td>Disruptive Influence.</td>
</tr>
<tr>
<td>[[User:Bruce|Bruce]]</td>
<td>Bruce Meerson</td>
<td>Bruce Meerson</td>
<td></td>
<td>+8</td>
<td>HiPiHi</td>
<td>Watching.</td>
</tr>
<tr>
<tr>
<td>[[User:Darb|DarbD]]</td>
<td>Brian B. Quinn</td>
<td>Darb Dabney</td>
<td>regions near Berkeley</td>
<td>-7</td>
<td>City of Berkeley, CA http://blog.simgis.org</td>
<td>LiDAR-based sculpties, real-world terrain, pursuit of civic paraverses </td>
</tr>
<tr>
<td>[[CharlieO]]</td>
<td>Dan</td>
<td>Charlie Omega</td>
<td></td>
<td> </td>
<td> </td>
<td>Mild coding/tweaking/simple feature adds, Stress testing/break stuff, Testing limits of existing code. Making sure [[LSL Status]] is up to date</td>
</tr>
<tr>
<td>oobscure</td>
<td> </td>
<td>Opensource Obscure</td>
<td></td>
<td>+1</td>
<td>http://www.opensim.it</td>
<td>Running a public Linux sim for testing, Docs, Helping italian users, Building opensim communities, Watching</td>
</tr>
<tr>
<td>pitman</td>
<td>Mike Pitman</td>
<td>Rez Tone</td>
<td></td>
<td> </td>
<td>IBM</td>
<td>Scientific visualization schemes, virt world product design, persistant workspaces, virt world based big biz</td>
</tr>
<tr>
<td>cmu</td>
<td>Christopher Mumme</td>
<td>Snook Destiny</td>
<td></td>
<td>+1</td>
<td>http://www.cmu-develop.de/ and research group "Collaboration Systems and CSCW" at Clausthal University of Technology</td>
<td>Testing OpenSim, working with OpenSim-Engine, reporting on OpenSim</td>
</tr>

<tr>
<td>[[Silpol]]</td>
<td>Andriy Tymchenko</td>
<td>Andy Tir</td>
<td></td>
<td>EET (+2/3)</td>
<td> http://silpol.blogspot.com/ (also visible at Nokia)</td>
<td>highly uncoordinated mess with elements of palace games, under-table diplomacy, rebellion, coup d'état and mutiny. optionally pirate</td>
</tr>
<tr>
<td>[[User:Grumly|Grumly]]</td>
<td></td>
<td>Forest Klaar</td>
<td>Grumly TheBear</td>
<td>GMT+1</td>
<td>.NET MCAD Dev/Arch/Trainer http://www.devoteam.com</td>
<td>Trying to get into OpenSim code for now. Particularly interrested in data persistence. blog (Hello, Avatar!): http://lslblog.free.fr</td>
</tr>
<tr>
<td>[[daTwitch]]</td>
<td>James G. Stallings II</td>
<td> Lazarus Longstaff</td>
<td>Hiro Protagonist (OSGrid)</td>
<td>-5</td>
<td>House Husband</td>
<td>OSGrid Region owner, OSGrid Operator, Forum Admin, sometime wiki editor</td>
</tr>

<tr>
<td>gryc</td>
<td>Gryc Ueusp</td>
<td>Gryc Uriza</td>
<td>Gryc Uriza(OSGrid)</td>
<td>-6</td>
<td></td>
<td>PHP scripting, web interfaces, interconnectivity, cross-platformedness</td>
</tr>

<tr>
<td>[[User:Phrearch|Phrearch]]</td>
<td>Jeroen van Veen</td>
<td>Phrearch Miles</td>
<td>Phrearch Miles(OSGrid)</td>
<td>Amsterdam/Paris</td>
<td></td>
<td>Wiki documentation/skinning/plugin, patches, testing with Linux, redux development, opensim admin tool(bash), implementing LSL-functions</td>
</tr>

<tr>
<td>[[User:Burnman|Burnman]]</td>
<td>Allen Wilkins</td>
<td>Burnman Bedlam</td>
<td>Sid Green (United Grid)</td>
<td>Boston, USA</td>
<td>United Grid</td>
<td>Testing, testing, and more testing! Getting familiar with the source, interested in all aspects of the project.</td>
</tr>

<tr>
<td>[[User:krisbfunk|krisbfunk]]</td>
<td>Kris Bulman</td>
<td>krisbfunk Vought</td>
<td>Krisbfunk Nocturnal(OSGrid)</td>
<td>PE, Canada (-4)</td>
<td>Edactive Technologies NocturnalEye Productions UPEI</td>
<td>Currently: Testing, bug reports, wiki updating, building on OSGrid</td>
</tr>

<tr>
<td>[[User:HashBox|HashBox]]</td>
<td> </td>
<td>Sibariel Darkstone</td>
<td>Sibariel Darkstone (OSGrid)</td>
<td>New Zealand (+12)</td>
<td></td>
<td>Testing, bug reports, and updating the wiki.</td>
</tr>

<tr>
<td>[[User:Kinoc|Kinoc]]</td>
<td>Kino Coursey</td>
<td>Daxxon Jaxxon</td>
<td>Daxxon Kinoc (OSgrid)</td>
<td>-6</td>
<td>Daxtron Laboratories http://www.daxtron.com University of North Texas</td>
<td>AI, Semantic web, Ontologies, Natural Laanguage Processing, Cyc, Bots, NPC </td>
</tr>
<tr>
<td>[[User:trapuh|trapuh]]</td>
<td>Pedro Ribeiro</td>
<td>Vaiten Forder</td>
<td></td>
<td>GMT</td>
<td>University Student, Escola Superior de Educação de Viseu, Portugal </td>
<td>Testing, eventual bug reports and wiki. Music, web/digital arts and php+sql.</td>
</tr>
<tr>
<td>[[User:SonicViz|SonicViz]]</td>
<td>Paul Cohen</td>
<td>Komuso Tokugawa</td>
<td></td>
<td>+9</td>
<td>Http://sonicviz.com</td>
<td>Audio/Music, Interactive Music, Control Protocols, Interfaces, VisualFX, Procedural animation/Generative systems + testing and general dev</td>
</tr>
<tr>
<td>[[User:Mokele|mokele]]</td>
<td>Scott Norman</td>
<td>Mokelembembe Mokeev</td>
<td></td>
<td>-8 (Southern California)</td>
<td>Web Developer (PHP and MySQL)</td>
<td>Interested in seeing running on PowerPC Macs which it is. So, when I can, I'll compile and test on PowerPC Mac (PowerBook G4) and submit reports and then update the wiki if need on installing on Mac. Also have a Ubuntu 7.10 server that I can do testing on too.</td>
</tr>

<tr>
<td>[[User:devalnor|devalnor]]</td>
<td>Devalnor</td>
<td>M. Watkin</td>
<td></td>
<td>+1 (Belgium)</td>
<td></td>
<td>Small Patch code, bug reports, and updating the wiki.</td>
</tr>

<tr>
<td>[[User:Ezekiel|Ezekiel]]</td>
<td>Ezekiel</td>
<td>Ezekiel Zabelin</td>
<td></td>
<td>+1 </td>
<td>http://www.yosims.com </td>
<td>Concepts, business aspects of virtual worlds - web developer (PHP, MySQL, Javascript, LSL) </td>
</tr>

<tr>
<td>[[User:Diva|diva]]</td>
<td>Crista Lopes</td>
<td>Diva Canto</td>
<td>Diva Canto or Crista Lopes in as many grids as possible</td>
<td>-8 </td>
<td>UC Irvine and http://metaverseink.com </td>
<td>Search, general architecture, real-world modeling</td>
</tr>

<tr>
<td>[[User:Buggmaster|Buggmaster]]</td>
<td>Mike D</td>
<td>Bug Master</td>
<td>None</td>
<td>-8 </td>
<td>http://www.adultmetaverse.com</td>
<td>Grid, Data/Web PHP/PERL/MySQL</td>
</tr>

<tr>
<td>[[User:Nixnerd|nixnerd]]</td>
<td>Richmund</td>
<td>Dangerously Moody</td>
<td>None</td>
<td>GMT </td>
<td>http://www.integratedtechnologies.eu</td>
<td>Cross Platform Testing, Feedback, Bug Reporting</td>
</tr>

<tr>
<td>[[User:MoHax|mohax]]</td>
<td>Mo Hax</td>
<td>Mo Hax</td>
<td></td>
<td>-5 Eastern</td>
<td>IBM</td>
<td>Testing, Feedback, Content Contributions, Bug Reporting, Documenting, Development</td>
</tr>

<tr>
<td>[[User:Webmage|webmage]]</td>
<td>webmage</td>
<td>Leyla Masala</td>
<td>Web Mage</td>
<td>+1</td>
<td>IBM</td>
<td>Testing, terrain</td>
</tr>

<tr>
<td>[[User:NLStitch|NLStitch]]</td>
<td>Marijn Oosterveld</td>
<td>Stitch Seale</td>
<td>NYA</td>
<td>GMT +1 Amsterdam</td>
<td>
Twingate Systems (http://www.twingate.nl) 
HanzeHogeschool Groningen, Netherlands
</td>
<td>Programming, Photography, AI</td>
</tr>

<tr>
<td>[[User:Ideia Boa|Ideia Boa]]</td>
<td>Joao Lopes</td>
<td>Ideia Boa</td>
<td>Ideia Boa or Boa Ideia in as many grids as possible</td>
<td>+1</td>
<td>Cub SL Portugues - Portugueses Virtual World Site http://www.clubslportugues.com OpenSimPT the Grid for Portuguese language too http://www.opensimpt.com</td>
<td>Testing, testing, and more testing! Trying to get into OpenSim code for now. Updating the original wiki and translating the OpenSim Wiki into Portugueses and reporting on OpenSim</td>
</tr>

<tr>
<td>[[User:Lulurun|lulurun]]</td>
<td>liu</td>
<td> </td>
<td> </td>
<td>+9</td>
<td>3Di Inc, Japan http://www.3di.jp</td>
<td>patches, openid, server performance, UGAI</td>
</tr>

<tr>
<td>[[User:Carlosroundel|Carlosrounde]]</td>
<td>Carlosroundel</td>
<td>Carlos Roundel</td>
<td> </td>
<td>+1</td>
<td>Cyberlandia Italy http://www.cyberlandia.net</td>
<td>grid, programmer, database, tester</td>
</tr>

<tr>
<td>[[User:Mikebert|Mikebert]]</td>
<td>Michael Strunck</td>
<td>Mikebert Miles</td>
<td> </td>
<td>+1</td>
<td>OpenSIM Wiki, Germany http://www.opensim.de</td>
<td>German Wiki, Translater, Server Performance (Linux/Windows), Tester, Feedback, Bug Reporting, Server-Hosting</td>
</tr>

</table>
[[Category:Main]]
[[Category:Development]]

Database:Users

2008-08-31T18:33:59Z

HomerHorwitz: Initial version

'''users''' ''Stores users profile data''      (back to [[Database Documentation]])

The current structure of the users table is as follows:
{| cellpadding="5" cellspacing="0" border="1"
!align="left"| Field
!align="left"| Type
!align="left"| Null
!align="left"| Key
!align="left"| Default
!align="left"| Extra
|-
| UUID || varchar(36) || NO || PRI || '' ||
|-
| username || varchar(32) || NO || UNI || ||
|-
| lastname || varchar(32) || NO || UNI || ||
|-
| passwordHash || varchar(32) || NO || || ||
|-
| passwordSalt || varchar(32) || NO || || ||
|-
| homeRegion || bigint(20) unsigned || YES || || NULL ||
|-
| homeLocationX || float || YES || || NULL ||
|-
| homeLocationY || float || YES || || NULL ||
|-
| homeLocationZ || float || YES || || NULL ||
|-
| homeLookAtX || float || YES || || NULL ||
|-
| homeLookAtY || float || YES || || NULL ||
|-
| homeLookAtZ || float || YES || || NULL ||
|-
| created || int(11) || NO || || ||
|-
| lastLogin || int(11) || NO || || ||
|-
| userInventoryURI || varchar(255) || YES || || NULL ||
|-
| userAssetURI || varchar(255) || YES || || NULL ||
|-
| profileCanDoMask || int(10) unsigned || YES || || NULL ||
|-
| profileWantDoMask || int(10) unsigned || YES || || NULL ||
|-
| profileAboutText || text || YES || || NULL ||
|-
| profileFirstText || text || YES || || NULL ||
|-
| profileImage || varchar(36) || YES || || NULL ||
|-
| profileFirstImage || varchar(36) || YES || || NULL ||
|-
| webLoginKey || varchar(36) || YES || || NULL ||
|-
| homeRegionID || char(36) || NO || || '00000000-0000-0000-0000-000000000000' ||
|-
| userFlags || int(11) || NO || || '0' ||
|-
| godLevel || int(11) || NO || || '0' ||
|-
| customType || varchar(32) || NO || || '' ||
|-
| partner || char(36) || NO || || '00000000-0000-0000-0000-000000000000' ||
|}

;UUID
:The unique id of the user

;username
:The first name of the user

;lastname
:The last name of the user

;passwordHash
:The MD5-hash from password and salt
;passwordSalt
:The password salt

;homeRegion
:The region-handle of the home-region

;homeLocationX, homeLocationY, homeLocationZ
:The home-location within the home-region

;homeLookAtX, homeLookAtY, homeLookAtZ
:The direction the avatar looks after TP to the home-location

;created
:Creation timestamp of the profile (in seconds since UNIX-epoch (Jan 1st, 1971))

;lastLogin
:Time of last login (in seconds since UNIX-epoch)

;userInventoryURI
:needs to be documented

;userAssetURI
:needs to be documented

;profileCanDoMask
:needs to be documented

;profileWantDoMask
:needs to be documented

;profileAboutText
:The text in the about field of the profile dialog

;profileFirstText
:The text in the first-life field of the profile dialog

;profileImage
:The UUID of the profile image

;profileFirstImage
:The UUID of the first-life image

;webLoginKey
:needs to be documented

;homeRegionID
:The region UUID of the home-region

;userFlags
:needs to be documented

;godLevel
:needs to be documented

;customType
:needs to be documented

;partner
:The UUID of an user that will appear in the partner field of the profile dialog

Database:Documentation

2008-08-31T17:31:58Z

HomerHorwitz: added reference to 'users' table

This is a running start at documenting the tables in the MySQL instances used on both grid and regions, and describing how they relate to each other in the context of an OpenSim grid.

SQLite is generally not considered apropriate for this use case and will not be covered here; however the table structures are very similar and most of what is here will be useful in that context as well.

Note that some of these tables may be relics, some may be planned for future use, and some may see heavy use but have columns which are relics, not yet properly updated or not yet used at all. Alpha code FTW!! :D

The instances:
<table>
<tr>
<td align=left>Grid:</td>
<tr>
<td> </td>
</tr>
<tr>
<td>[[agents]] </td><td>Records agent (Avatar/User) login details</td>
<tr>
<td>[[assets]] </td><td>Comprehensive grid assets including textures and avatar inventories</td>
</tr><tr>
<td>[[avatarappearance]] </td><td>Persistence of the visual appearance of avatars between logins</td>
</tr>
<tr>
<td>[[inventoryfolders]] </td><td>Inventory folder-related details *excepting contents*</td>
</tr>
<tr>
<td> </td><td>Contents are in the [[inventoryitems]] table and point back to [[inventoryfolders]]</td>
</tr>
<tr>
<td>[[inventoryitems]] </td><td>All inventory item details (including folder associations) except contents - contents are referenced</td>
</tr>
<tr>
<td> </td><td>in the [[assets]] table </td>
</tr>
<tr>
<td>[[logs]] </td><td>Stores a record of logged events</td>
</tr>
<tr>
<td>[[logs_preTimestamp]] </td><td>Old format [[logs]] table? **RELIC - no longer present in dist DB</td>
</tr>
<tr>
<td> </td><td>*** it would appear neither of these log tables is currently used *** </td>
</tr>
<tr>
<td>[[migrations]]</td><td>Supports 'automagic' migration to new database formats</td>
</tr>
<tr>
<td>[[regions]]</td><td>Regions known to the grid</td>
</tr>
<tr>
<td>[[reservations]]</td><td>Region registration table. This table has no rows on OSGrid and is likely in place for future functionality **RELIC - no longer present in dist DB</td>
</tr>
<tr>
<td>[[userfriends]]</td><td>Friends list registration</td>
</tr>
<tr>
<td>[[users]]</td><td>Stored user profile</td>
</tr>
</table>
 
<table>
<tr>
<td align=left>Region:</td>
<tr>
<td> </td>
</tr>
<tr>
<td>[[estate_groups]] </td><td>Narrowly purposed at present. Appears to associate UUIDs under an Estate ID</td>
</tr>
<tr>
<td>[[estate_managers]] </td><td>Assoicates UUIDs with Estate ID</td>
</tr>
<tr>
<td>[[estate_map]] </td><td>Associates Regions with Estates By Estate ID</td>
</tr>
<tr>
<td>[[estate_settings]] </td><td>Settings for Estates</td>
</tr>
<tr>
<td>[[estate_users]] </td><td>Users allowed on the Estate</td>
</tr>
<tr>
<td>[[estateban]] </td><td>Users banned from the Estate</td>
</tr>
<tr>
<td>[[land]] </td><td>Parcel Properties</td>
</tr>
<tr>
<td>[[landaccesslist]] </td><td>Parcel Access List</td>
</tr>
<tr>
<td>[[migrations]] </td><td>Supports 'automagic' upgrade to new database formats</td>
</tr>
<tr>
<td>[[primitems]] </td><td>contains the prim's inventory, which is not at all unlike the avatars' inventory with the exception of folders</td>
</tr>
<tr>
<td>[[prims]] </td><td>All rezzed prim details *excepting shape and contents*</td>
</tr>
<tr>
<td>[[primshapes]] </td><td>Properties of all rezzed prims</td>
</tr>
<tr>
<td>[[regionban]] </td><td>Per-Region ban list</td>
</tr>
<tr>
<td>[[regionsettings]] </td><td>Per-Region settings</td>
</tr>
<tr>
<td>[[terrain]] </td><td>Terrain mesh revision history</td>
</tr>
</table>

Full details of back-store instantiation as performed by the OpenSim software can be found here: 
http://opensimulator.org/svn/opensim/trunk/OpenSim/Data/MySQL/Resources/
 
Here is a note concerning the [[initial creation of the MySQL tables]] 
Questions about this documentation can be directed to daTwitch on #opensim-dev or #osgrid FreeNode IRC or Hiro Protagonist on OSGrid. 
For further clarification of the content ask on #opensim-dev look for sdague, JustinCC or DrSco

Logging

2008-08-21T05:56:17Z

HomerHorwitz: Adding information about rolling log-files

== Changing logging levels before startup ==

OpenSim uses the [http://logging.apache.org/log4net/ log4net] package for logging. This means that every executable you run for OpenSim has an accompanying .config file which contains the logging configuration

For instance, the OpenSim.exe.config file looks like this.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net" />
</configSections>
<appSettings>
</appSettings>
<log4net>
<appender name="Console" type="OpenSim.Framework.Console.OpenSimAppender, OpenSim.Framework.Console">
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date{HH:mm:ss} - %message%newline" />
</layout>
</appender>

<appender name="LogFileAppender" type="log4net.Appender.FileAppender">
<file value="OpenSim.log" />
<appendToFile value="true" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date %-5level - %logger %message%newline" />
</layout>
</appender>


<logger name="NHibernate" additivity="false">
<level value="INFO"/>
<appender-ref ref="NHibernateFileLog"/>
</logger>

<root>
<level value="DEBUG" />
<appender-ref ref="Console" />
<appender-ref ref="LogFileAppender" />
</root>
</log4net>
</configuration>

This looks rather complicated, but if you want to change the level of messages logged, then you could change the value in the <root> section (right at the end) which is

<level value="DEBUG" />

in the example above to something different, e.g.

<level value="WARN" />

which will only display warning and error level log messages. Permissible values are ALL, DEBUG, INFO, WARN, ERROR, FATAL, OFF

You can also see from the OpenSim.exe.config file that log files are written to OpenSim.log (as well as the console).

=== Rolling file appender and maximum log-file size ===

Log4net provides several log-file appenders. One of them is the ''RollingFileAppender'', which limits log-file size and rotates log-files automatically. To use this appender, add the following section to the log4net-configuration:

<appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender">
<file value="OpenSim.log" />
<appendToFile value="true" />
<maximumFileSize value="1000KB" />
<maxSizeRollBackups value="2" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date %-5level - %logger %message%newline" />
</layout>
</appender>

The maximum size can be set in the ''maximumFileSize'' element, the ''maxSizeRollBackups'' element determines the maximum number of rolling log-files. So, the setting above will create a log-file named ''OpenSim.log'' with a maximum size of 1000KB. When the limit is reached, ''OpenSim.log'' will be renamed to ''OpenSim.log.1'', and a fresh ''OpenSim.log'' is started (possibly after renaming ''OpenSim.log.1'' to ''OpenSim.log.2'', should that file exist already).

To use the appender defined above, replace the line
<appender-ref ref="LogFileAppender" />
by
<appender-ref ref="RollingFileAppender" />

Further information about configuration of log4net can be found on the [http://logging.apache.org/log4net/release/manual/configuration.html Log4Net configuration page].

== Setting log levels during runtime ==

It isn't currently possible to change the level of logging to the log file during runtime. However, it is possible to change the level sent to the console. You can do this by executing the

set log level [<level>]

command. For example

set log level error

will mean only errors are sent to the console. The log still receives messages that meet the level set in the OpenSim.exe.config file at startup.

Not specifying any level will tell you what the current console logging level is.

Changes to the log level sent to the console will not persist over restarts. If you want the change to be permanent, you can set a threshold value in the ConsoleAppender in a config file such as OpenSim.exe.config (see the log4net docs for more details).