OpenSimulator - User contributions [en]

Connecting

2008-10-16T17:53:30Z

Krisbfunk: /* Via a Web Browser */

==Compatible Viewers==
Before you can connect to OpenSim, you'll need to have downloaded one of the following clients that can connect to OpenSim.

* [http://get.secondlife.com Linden Client] (release version is the only fully supported viewer.)
* [http://opensim-viewer.sourceforge.net Hippo Viewer] - a fork of the Linden Client with OpenSim specific enhancements
* [[RealXtend]] - a fork of the Linden Client that has specialized features (is not fully supported yet.)

==Connecting with the Linden Viewer==
Every OpenSim grid or instance will specify a '''loginuri''', which is a uri of the form '''http://someserver:9000''' (standalone mode) or '''http://someserver:8002''' (grid mode). For instance, for osgrid, this is http://osgrid.org:8002. The following sections assume that you have that uri. We'll use http://osgrid.org:8002 as our example url.

A list of major public grids can be found at [[Grid_List]]. OSGrid is just one of many available.

=== Linux ===
* change directory to you viewer (SecondLife_XYZ)
* run <code>./secondlife -loginuri http://osgrid.org:8002</code>

=== Windows ===
* make a copy of the SecondLife icon on your desktop
* rename it to the grid you want to connect to
* edit the properties on the icon and set the command line to <code>...\SecondLife.exe" -loginuri http://osgrid.org:8002</code>

=== Mac ===
* Make a 'somefilename.sh' file, and put this in it:
* /Applications/Second\ Life.app/Contents/MacOS/Second\ Life -loginuri http://osgrid.org:8002/
* set it to executable
* run it

== Alternative Connection Approaches ==

=== Via Openlifegrid Grid Launcher ===
Another option is to try the 'Launcher' for Windows (.net required). http://www.openlifegrid.com/downloads/gridlauncher.zip 
To login to the Public GRID examples registration is required first see [[Grid_List]] for Public Grids.

=== Via a Web Browser ===

You can also set up a [[Browser Protocol Handler]] which will make opensim:// links in your browser do the expected thing, and launch the right OpenSim viewer.

* '''Xenki''' - Xenki is an XBAP 3D application intended to be a browser add-on for OpenSim.
** '''What is Xenki?'''
** http://www.adamfrisby.com/blog/2008/08/what-is-xenki/
** '''Sources:'''
** http://www.adamfrisby.com/blog/2008/08/xenki-010-alpha-sources-posted/

=== Via Rezme ===
TBD

== Known Issues ==
=== Linden Client ===
* The '''Latest''' version of the Linden client no longer supports the OpenSim os* lsl functions, preventing you from using OpenSim specific scripting if you use that client

Connecting

2008-10-16T17:52:49Z

Krisbfunk: /* Via a Web Browser */

Connecting

2008-10-16T17:51:40Z

Krisbfunk: /* Via a Web Browser */

==Compatible Viewers==
Before you can connect to OpenSim, you'll need to have downloaded one of the following clients that can connect to OpenSim.

* [http://get.secondlife.com Linden Client] (release version is the only fully supported viewer.)
* [http://opensim-viewer.sourceforge.net Hippo Viewer] - a fork of the Linden Client with OpenSim specific enhancements
* [[RealXtend]] - a fork of the Linden Client that has specialized features (is not fully supported yet.)

==Connecting with the Linden Viewer==
Every OpenSim grid or instance will specify a '''loginuri''', which is a uri of the form '''http://someserver:9000''' (standalone mode) or '''http://someserver:8002''' (grid mode). For instance, for osgrid, this is http://osgrid.org:8002. The following sections assume that you have that uri. We'll use http://osgrid.org:8002 as our example url.

A list of major public grids can be found at [[Grid_List]]. OSGrid is just one of many available.

=== Linux ===
* change directory to you viewer (SecondLife_XYZ)
* run <code>./secondlife -loginuri http://osgrid.org:8002</code>

=== Windows ===
* make a copy of the SecondLife icon on your desktop
* rename it to the grid you want to connect to
* edit the properties on the icon and set the command line to <code>...\SecondLife.exe" -loginuri http://osgrid.org:8002</code>

=== Mac ===
* Make a 'somefilename.sh' file, and put this in it:
* /Applications/Second\ Life.app/Contents/MacOS/Second\ Life -loginuri http://osgrid.org:8002/
* set it to executable
* run it

== Alternative Connection Approaches ==

=== Via Openlifegrid Grid Launcher ===
Another option is to try the 'Launcher' for Windows (.net required). http://www.openlifegrid.com/downloads/gridlauncher.zip 
To login to the Public GRID examples registration is required first see [[Grid_List]] for Public Grids.

=== Via a Web Browser ===

You can also set up a [[Browser Protocol Handler]] which will make opensim:// links in your browser do the expected thing, and launch the right OpenSim viewer.

Xenki - Xenki is an XBAP 3D application intended to be a browser add-on for OpenSim.

What is Xenki?
http://www.adamfrisby.com/blog/2008/08/what-is-xenki/

Sources:
http://www.adamfrisby.com/blog/2008/08/xenki-010-alpha-sources-posted/

=== Via Rezme ===
TBD

== Known Issues ==
=== Linden Client ===
* The '''Latest''' version of the Linden client no longer supports the OpenSim os* lsl functions, preventing you from using OpenSim specific scripting if you use that client

Oscms

2008-03-13T02:58:34Z

Krisbfunk: /* Administrator features */

==Description==
OSMS(name?) is a whitepaper for a Web-frontend to OpenSim.

==Proposed Technology==
* flex? (Client-frontend)
* AJAX? (Client-frontend)
** ExtJS (http://extjs.com/)
* JSON (Client-Server communication)
* PHP (ServerSide CGI)
* MySQL (Database)

==Coding features==
* Template engine (Smarty?)
* MVC-structured
* PEAR?
* Data-Objects
* Modular

==Administrator features==
* Login
* Add/Remove user
* Mass Upload Assets
** http://opensimulator.org/wiki/Inworld_Data <- starting point

==User features==
* Login
* Register
* Items
** Textures
*** Upload textures to inventory
*** Share textures
** Objects
*** Share objects (ODS - Object Distribution System)
*** Object profile

* Profile
** User info
** Groups
** My textures
** My objects
** User search

* Communication
** Chat logs
** MailInbox

[[Category:Users]]

Development Team

2008-02-25T14:49:57Z

Krisbfunk: /* Additional Developers/Testers/Contributors */

== OpenSim Core Developers ==
These people have commit access to our central SVN server and are regular contributors to the codebase.

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

<table border="1" cellpadding="2" cellspacing="0">
<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 / Michael Wright |MW / Michael Wright ]]</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> </td>
<td> </td>
<td></td>
<td>-6</td>
<td>DeepThink Pty Ltd</td>
<td> </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</td>
</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: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: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>[[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>ZeroPoint</td>
<td> </td>
<td>Guilderoy Dench</td>
<td></td>
<td>-5</td>
<td> </td>
<td>Programming/Database</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>cfk</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>3Di</td>
<td> </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>[[User:adjohn|adjohn]]</td>
<td>Adam Johnson</td>
<td>Zeuz Zenovka</td>
<td></td>
<td>+9</td>
<td>3Di</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>3Di</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>IBM</td>
<td>Grid servers & performance, inventory (avatar and object).</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>
</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>Gareth</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </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: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) Ai Ariella (Openlifegrid) Ai Beta (DeepGrid) </td>
<td>+0</td>
<td>AIAI, University of Edinburgh http://www.aiai.ed.ac.uk/~ai/</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>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>Vizi</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>[[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, translating the OpenSim Wiki into German and 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></td>
<td>GMT+1</td>
<td>.NET MCAD Dev/Arch/Trainer</td>
<td>Trying to get into OpenSim code for now. Particularly interrested in data persistence.</td>
</tr>
<tr>
<td>[[daTwitch]]</td>
<td>James G. Stallings II</td>
<td> Lazarus Longstaff</td>
<td>Hiro Protagonist (OSGrid) Takeshi Takahashi (OpenLife)</td>
<td>-5</td>
<td>House Husband</td>
<td>Testing everything to the limits I possibly can Sometime wiki editor blog at http://da5vid.wordpress.com</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>Documentation, scripts(perl/lsl), RIA(flex) mashup, testing</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>Zane Ashby</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>
<td>[[User:Mikkopa|mikkopa]]</td>
<td>Mikko Pallari</td>
<td></td>
<td></td>
<td>+2</td>
<td>realXtend</td>
<td>Scripting, communication, gaming, sounds</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>
</table>
[[Category:Main]]
[[Category:Development]]

FAQ

2008-02-18T19:57:43Z

Krisbfunk: /* How do I isolate and delete a users Trash items in a MySQL grid database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

=MySQL=
== How do I isolate and delete a users Trash items in a MySQL grid database? ==
NOTE: BACK UP YOUR DATABASE!

'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
 
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the '''folderName''' to isolate the users Trash '''folderID''' 
This query will locate the users Trash folder entry: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question: (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki>
 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

== How do I isolate and resolve duplicate inventory folder entries in a MySQL grid database? ==
NOTE: BACK UP YOUR DATABASE! 

'''1.''' It's first a good idea to search for the affected avatars UUID in the '''inventoryFolders''' table to see the duplicate entries. When you see this, you'll see the problem of duplicate entries. The key here will be to find out which is being used. 

'''2.''' Upload a file inworld and name it something unique. This will isolate the UUID of your root folder that is being used (even though there are dups only one is being used) 

'''3.''' Search the '''inventoryitems''' table for your uniquely named item and locate it's '''parentFolderID''' 
This query will isolate the '''parentFolderID''' based on your search for the unique item (replace '''unique_name''' with your unique item name)
<nowiki>SELECT `parentFolderID` FROM `inventoryitems` WHERE `inventoryName` LIKE 'unique_name' LIMIT 0 , 30;</nowiki>

'''4.''' Check the '''inventoryfolders''' table against the '''parentFolderID''' UUID obtained in the last search. That is your root folder that is being used.. you can delete all duplicate entries that do not match that parentFolderID. In the end, you should only have one of each type (Trash, etc) 
This query will return all values that are NOT the parentID obtained in the last search. (replace 00000000-0000-0000-0000-000000000000 with the parentID located in step 3)
<nowiki>SELECT * FROM `inventoryfolders` WHERE `folderID` NOT LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 30;</nowiki>

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:57:31Z

Krisbfunk: /* How do I isolate and delete a users Trash items in a MySQL grid database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

=MySQL=
== How do I isolate and delete a users Trash items in a MySQL grid database? ==
NOTE: BACK UP YOUR DATABASE!

'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
 
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the '''folderName''' to isolate the users Trash '''folderID''' 
This query will locate the users Trash folder entry: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question: (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki>
 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

== How do I isolate and resolve duplicate inventory folder entries in a MySQL grid database? ==
NOTE: BACK UP YOUR DATABASE! 

'''1.''' It's first a good idea to search for the affected avatars UUID in the '''inventoryFolders''' table to see the duplicate entries. When you see this, you'll see the problem of duplicate entries. The key here will be to find out which is being used. 

'''2.''' Upload a file inworld and name it something unique. This will isolate the UUID of your root folder that is being used (even though there are dups only one is being used) 

'''3.''' Search the '''inventoryitems''' table for your uniquely named item and locate it's '''parentFolderID''' 
This query will isolate the '''parentFolderID''' based on your search for the unique item (replace '''unique_name''' with your unique item name)
<nowiki>SELECT `parentFolderID` FROM `inventoryitems` WHERE `inventoryName` LIKE 'unique_name' LIMIT 0 , 30;</nowiki>

'''4.''' Check the '''inventoryfolders''' table against the '''parentFolderID''' UUID obtained in the last search. That is your root folder that is being used.. you can delete all duplicate entries that do not match that parentFolderID. In the end, you should only have one of each type (Trash, etc) 
This query will return all values that are NOT the parentID obtained in the last search. (replace 00000000-0000-0000-0000-000000000000 with the parentID located in step 3)
<nowiki>SELECT * FROM `inventoryfolders` WHERE `folderID` NOT LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 30;</nowiki>

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:55:52Z

Krisbfunk: /* How do I isolate and delete a users Trash items in a MySQL grid database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

=MySQL=
== How do I isolate and delete a users Trash items in a MySQL grid database? ==
NOTE: BACK UP YOUR DATABASE!

'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
 
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the '''folderName''' to isolate the users Trash '''folderID''' 
This query will locate the users Trash folder entry: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question: (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki>
 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

== How do I isolate and resolve duplicate inventory folder entries in a MySQL grid database? ==
NOTE: BACK UP YOUR DATABASE! 

'''1.''' It's first a good idea to search for the affected avatars UUID in the '''inventoryFolders''' table to see the duplicate entries. When you see this, you'll see the problem of duplicate entries. The key here will be to find out which is being used. 

'''2.''' Upload a file inworld and name it something unique. This will isolate the UUID of your root folder that is being used (even though there are dups only one is being used) 

'''3.''' Search the '''inventoryitems''' table for your uniquely named item and locate it's '''parentFolderID''' 
This query will isolate the '''parentFolderID''' based on your search for the unique item (replace '''unique_name''' with your unique item name)
<nowiki>SELECT `parentFolderID` FROM `inventoryitems` WHERE `inventoryName` LIKE 'unique_name' LIMIT 0 , 30;</nowiki>

'''4.''' Check the '''inventoryfolders''' table against the '''parentFolderID''' UUID obtained in the last search. That is your root folder that is being used.. you can delete all duplicate entries that do not match that parentFolderID. In the end, you should only have one of each type (Trash, etc) 
This query will return all values that are NOT the parentID obtained in the last search. (replace 00000000-0000-0000-0000-000000000000 with the parentID located in step 3)
<nowiki>SELECT * FROM `inventoryfolders` WHERE `folderID` NOT LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 30;</nowiki>

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:52:24Z

Krisbfunk: /* How do I isolate and resolve duplicate inventory folder entries in a MySQL grid database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

=MySQL=
== How do I isolate and delete a users Trash items in a MySQL grid database? ==
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
 
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the '''folderName''' to isolate the users Trash '''folderID''' 
This query will locate the users Trash folder entry: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question: (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki>
 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

== How do I isolate and resolve duplicate inventory folder entries in a MySQL grid database? ==
NOTE: BACK UP YOUR DATABASE! 

'''1.''' It's first a good idea to search for the affected avatars UUID in the '''inventoryFolders''' table to see the duplicate entries. When you see this, you'll see the problem of duplicate entries. The key here will be to find out which is being used. 

'''2.''' Upload a file inworld and name it something unique. This will isolate the UUID of your root folder that is being used (even though there are dups only one is being used) 

'''3.''' Search the '''inventoryitems''' table for your uniquely named item and locate it's '''parentFolderID''' 
This query will isolate the '''parentFolderID''' based on your search for the unique item (replace '''unique_name''' with your unique item name)
<nowiki>SELECT `parentFolderID` FROM `inventoryitems` WHERE `inventoryName` LIKE 'unique_name' LIMIT 0 , 30;</nowiki>

'''4.''' Check the '''inventoryfolders''' table against the '''parentFolderID''' UUID obtained in the last search. That is your root folder that is being used.. you can delete all duplicate entries that do not match that parentFolderID. In the end, you should only have one of each type (Trash, etc) 
This query will return all values that are NOT the parentID obtained in the last search. (replace 00000000-0000-0000-0000-000000000000 with the parentID located in step 3)
<nowiki>SELECT * FROM `inventoryfolders` WHERE `folderID` NOT LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 30;</nowiki>

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:51:14Z

Krisbfunk: /* How do I isolate and resolve duplicate inventory folder entries in a MySQL grid database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

=MySQL=
== How do I isolate and delete a users Trash items in a MySQL grid database? ==
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
 
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the '''folderName''' to isolate the users Trash '''folderID''' 
This query will locate the users Trash folder entry: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question: (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki>
 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

== How do I isolate and resolve duplicate inventory folder entries in a MySQL grid database? ==
NOTE: BACK UP YOUR DATABASE! 

'''1.''' It's first a good idea to search for the affected avatars UUID in the '''inventoryFolders''' table to see the duplicate entries. When you see this, you'll see the problem of duplicate entries. The key here will be to find out which is being used. 

'''2.''' Upload a file inworld and name it something unique. This will isolate the UUID of your root folder that is being used (even though there are dups only one is being used) 

'''3.''' Search the '''inventoryitems''' table for your uniquely named item and locate it's '''parentFolderID''' 
This query will isolate the '''parentFolderID''' based on your search for the unique item (replace '''unique_name''' with your unique item name)
<nowiki>SELECT `parentFolderID` FROM `inventoryitems` WHERE `inventoryName` LIKE 'unique_name' LIMIT 0 , 30;</nowiki>

'''4.''' Check the '''inventoryfolders''' table against the '''parentFolderID''' UUID obtained in the last search. That is your root folder that is being used.. you can delete all duplicate entries that do not match that parentFolderID. In the end, you should only have one of each type (Trash, etc) 
This query will return all values that are NOT the parentID obtained in the last search. (replace 00000000-0000-0000-0000-000000000000 with the parentID located in step 3)
<nowiki>SELECT * FROM `inventoryfolders` WHERE `folderID` NOT LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 30;</nowiki>

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:50:01Z

Krisbfunk: /* How do I isolate and resolve duplicate inventory folder entries in a MySQL grid database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

=MySQL=
== How do I isolate and delete a users Trash items in a MySQL grid database? ==
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
 
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the '''folderName''' to isolate the users Trash '''folderID''' 
This query will locate the users Trash folder entry: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question: (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki>
 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

== How do I isolate and resolve duplicate inventory folder entries in a MySQL grid database? ==
NOTE: BACK UP YOUR DATABASE! 

'''1.''' It's first a good idea to search for the affected avatars UUID in the '''inventoryFolders''' table to see the duplicate entries. When you see this, you'll see the problem of duplicate entries. The key here will be to find out which is being used. 

'''2.''' Upload a file inworld and name it something unique. This will isolate the UUID of your root folder that is being used (even though there are dups only one is being used) 

'''3.''' Search the '''inventoryitems''' table for your uniquely named item and locate it's '''parentFolderID''' 
This query will isolate the '''parentFolderID''' based on your search for the unique item (replace '''unique_name''' with your unique item name)
<nowiki>SELECT `parentFolderID` FROM `inventoryitems` WHERE `inventoryName` LIKE 'unique_name' LIMIT 0 , 30;</nowiki>

'''4.''' Check the '''inventoryfolders''' table against the '''parentFolderID''' UUID obtained in the last search. That is your root folder that is being used.. you can delete all duplicate entries that do not match that parentFolderID. In the end, you should only have one of each type (Trash, etc) 
This query will return all values that are NOT the parentID obtained in the last search
<nowiki>SELECT * FROM `inventoryfolders` WHERE `folderID` NOT LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 30;</nowiki>

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:49:37Z

Krisbfunk: /* How do I isolate and resolve duplicate inventory folder entries in a MySQL grid database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

=MySQL=
== How do I isolate and delete a users Trash items in a MySQL grid database? ==
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
 
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the '''folderName''' to isolate the users Trash '''folderID''' 
This query will locate the users Trash folder entry: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question: (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki>
 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

== How do I isolate and resolve duplicate inventory folder entries in a MySQL grid database? ==
NOTE: BACK UP YOUR DATABASE! 

'''1.''' It's first a good idea to search for the affected avatars UUID in the '''inventoryFolders''' table to see the duplicate entries. When you see this, you'll see the problem of duplicate entries. The key here will be to find out which is being used.
'''2.''' Upload a file inworld and name it something unique. This will isolate the UUID of your root folder that is being used (even though there are dups only one is being used) 
'''3.''' Search the '''inventoryitems''' table for your uniquely named item and locate it's '''parentFolderID''' 
This query will isolate the '''parentFolderID''' based on your search for the unique item (replace '''unique_name''' with your unique item name)
<nowiki>SELECT `parentFolderID` FROM `inventoryitems` WHERE `inventoryName` LIKE 'unique_name' LIMIT 0 , 30;</nowiki>
'''4.''' Check the '''inventoryfolders''' table against the '''parentFolderID''' UUID obtained in the last search. That is your root folder that is being used.. you can delete all duplicate entries that do not match that parentFolderID. In the end, you should only have one of each type (Trash, etc) 
This query will return all values that are NOT the parentID obtained in the last search
<nowiki>SELECT * FROM `inventoryfolders` WHERE `folderID` NOT LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 30;</nowiki>

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:44:54Z

Krisbfunk: /* MySQL */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

=MySQL=
== How do I isolate and delete a users Trash items in a MySQL grid database? ==
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
 
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the '''folderName''' to isolate the users Trash '''folderID''' 
This query will locate the users Trash folder entry: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question: (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki>
 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

== How do I isolate and resolve duplicate inventory folder entries in a MySQL grid database? ==
'''1.''' Upload a file and name it something unique. This will isolate the UUID of your root folder that is being used (even though there are dups only one is being used) 
'''2.''' Search the '''inventoryitems''' table for your uniquely named item and locate it's '''parentFolderID''' 
This query will isolate the '''parentFolderID''' based on your search for the unique item (replace '''unique_name''' with your unique item name)
<nowiki>SELECT `parentFolderID` FROM `inventoryitems` WHERE `inventoryName` LIKE 'unique_name' LIMIT 0 , 30;</nowiki>
'''3.''' Check the '''inventoryfolders''' table against your '''parentFolderID''' UUID. That is your root folder that is being used.. you can delete all duplicate entries that do not match that parentFolderID. In the end, you should only have one of each type (Trash, etc) 
This query will return all values that are NOT the parentID obtained in the last search
<nowiki>SELECT * FROM `inventoryfolders` WHERE `folderID` NOT LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 30;</nowiki>

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:18:39Z

Krisbfunk: /* MySQL */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

=MySQL=
== How do I isolate and delete a users Trash items in a MySQL grid database? ==
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
 
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the '''folderName''' to isolate the users Trash '''folderID''' 
This query will locate the users Trash folder entry: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question: (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki>
 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

== How do I isolate and resolve duplicate inventory folder entries in a MySQL grid database? ==

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:17:46Z

Krisbfunk: /* MySQL */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

=MySQL=
== How do I isolate and delete a users Trash items in a MySQL grid database? ==
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
 
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the '''folderName''' to isolate the users Trash '''folderID''' 
This query will locate the users Trash folder entry: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question: (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki>
 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ==

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:17:15Z

Krisbfunk: /* How do I isolate and delete a users Trash items in my mySQL database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in a MySQL grid database? ===
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
 
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the '''folderName''' to isolate the users Trash '''folderID''' 
This query will locate the users Trash folder entry: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question: (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki>
 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:15:56Z

Krisbfunk: /* How do I isolate and delete a users Trash items in my mySQL database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in my mySQL database? ===
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the '''folderName''' to isolate the users Trash '''folderID''' 
This query will locate the users Trash folder entry: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question: (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki> 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:15:20Z

Krisbfunk: /* How do I isolate and delete a users Trash items in my mySQL database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in my mySQL database? ===
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the '''folderName''' to isolate the users Trash '''folderID''' 
This query will locate the users Trash folder entry: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question: (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki> 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:14:57Z

Krisbfunk: /* How do I isolate and delete a users Trash items in my mySQL database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in my mySQL database? ===
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the '''folderName''' to isolate the users Trash '''folderID''' 
This query will locate the users Trash folder entry: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question. (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki> 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:14:19Z

Krisbfunk: /* How do I isolate and delete a users Trash items in my mySQL database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in my mySQL database? ===
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the '''folderName''' to isolate the users Trash '''folderID''' 
This query will locate the users Trash folder entries: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question. (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki> 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:13:12Z

Krisbfunk: /* How do I isolate and delete a users Trash items in my mySQL database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in my mySQL database? ===
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the folder name to isolate the users Trash '''folderID''' 
This query will locate the users Trash folder entries: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question. (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki> 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:12:27Z

Krisbfunk: /* How do I isolate and delete a users Trash items in my mySQL database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in my mySQL database? ===
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the folder name to isolage the users '''folderID''' 
This query will locate the users Trash folder entries: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question. (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki> 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:11:26Z

Krisbfunk: /* How do I isolate and delete a users Trash items in my mySQL database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in my mySQL database? ===
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the folder name 
This query will locate the users Trash folder entries: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question. (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID obtained in the last query)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki> 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:10:32Z

Krisbfunk: /* How do I isolate and delete a users Trash items in my mySQL database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in my mySQL database? ===
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30;</nowiki>
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the folder name 
This query will locate the users Trash folder entries: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30;</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question. (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999;</nowiki> 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:10:00Z

Krisbfunk: /* How do I isolate and delete a users Trash items in my mySQL database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in my mySQL database? ===
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30</nowiki>
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the folder name 
This query will locate the users Trash folder entries: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question. (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 9999</nowiki> 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:09:39Z

Krisbfunk: /* How do I isolate and delete a users Trash items in my mySQL database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in my mySQL database? ===
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 9999</nowiki>
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the folder name 
This query will locate the users Trash folder entries: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question. (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 30</nowiki> 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:08:46Z

Krisbfunk: /* How do I isolate and delete a users Trash items in my mySQL database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in my mySQL database? ===
'''1.''' Locate the avatars UUID you wish to find the trash items of, in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30</nowiki>
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the folder name 
This query will locate the users Trash folder entries: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question. (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 30</nowiki> 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:08:03Z

Krisbfunk: /* How do I isolate and delete a users Trash items in my mySQL database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in my mySQL database? ===
'''1.''' Locate the avatars UUID you wish to find the trash items of in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30</nowiki>
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the folder name 
This query will locate the users Trash folder entries: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30</nowiki>
 
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table, you can then delete them once you have isolated them. 
This query will locate the trash items of the avatar in question. (replace 00000000-0000-0000-0000-000000000000 with Trash folder UUID)
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 30</nowiki> 
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:02:35Z

Krisbfunk: /* How do I isolate and delete a users Trash items in my mySQL database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in my mySQL database? ===
'''1.''' Locate the avatars UUID you wish to find the trash items of in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30</nowiki>
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the folder name 
This query will locate the users Trash folder entries: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30</nowiki>
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table 
This query will locate the trash items of the avatar in question, you can then delete them once you have isolated them.
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 30</nowiki>
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T19:02:02Z

Krisbfunk: /* How do I isolate and delete a users Trash items in my mySQL database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in my mySQL database? ===
'''1.''' Locate the avatars UUID you wish to find the trash items of in the '''users''' table 
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30</nowiki>
'''2.''' Use the avatars UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the folder name 
This query will locate the users Trash folder entries: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30</nowiki>
'''3.''' Use the '''folderID''' UUID obtained in the last query to find all of the trash items in the '''inventoryitems''' table
This query will locate the trash items of the avatar in question, you can then delete them once you have isolated them.
<nowiki>SELECT * FROM `inventoryitems` WHERE `parentFolderID` LIKE '00000000-0000-0000-0000-000000000000' LIMIT 0 , 30</nowiki>
'''NOTE:''' These steps will not remove the associated assets from the assets table, just the items in the inventory '''inventoryitems''' table.

=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T18:51:12Z

Krisbfunk: /* How do I isolate and delete a users Trash items in my mySQL database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in my mySQL database? ===
* '''locate the users UUID''' you wish to find the trash items of '''in the users table'''
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30</nowiki>
* Use this UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the folder name
This query will locate the users Trash folder entries: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30</nowiki>

=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T18:50:45Z

Krisbfunk: /* How do I isolate and delete a users Trash items in my mySQL database? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in my mySQL database? ===
# '''locate the users UUID''' you wish to find the trash items of '''in the users table'''
This query will locate a specified users UUID: (replace User/Test with username/lastname)
<nowiki>SELECT `UUID` FROM `users` WHERE `username` LIKE 'User' AND `lastname` LIKE 'Test' LIMIT 0 , 30</nowiki>
# Use this UUID to search the field_name '''AgentID''' in the '''inventoryFolders''' table, using '''Trash''' as the folder name
This query will locate the users Trash folder entries: (replace 00000000-0000-0000-0000-000000000000 with UUID of user)
<nowiki>SELECT `folderID` FROM `inventoryfolders` WHERE `agentID` LIKE '00000000-0000-0000-0000-000000000000' AND `folderName` LIKE 'Trash'
LIMIT 0 , 30</nowiki>

=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

FAQ

2008-02-18T18:35:02Z

Krisbfunk: /* Terrain Tidbits */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

==MySQL==
=== How do I isolate and delete a users Trash items in my mySQL database? ===
=== How do I isolate and resolve duplicate inventory folder entries my mySQL database? ===

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

Troubleshooting

2008-02-18T18:30:55Z

Krisbfunk: /* Disappearing prims due to duplicate UID's */

[[Category:Users]]
This page gives any system-specific configuration settings that may be useful, and advice for problems that might be encountered.

== System-specific configuration ==
=== CentOS 5 ===

To install mono and nant, you can use the "Linux Installer for x86" found at http://www.mono-project.com/Downloads.

SVN can be installed by:

yum install subversion

Mono defaults to installing into <tt>/opt</tt>, so you may have to add this path to your environment variables, for example, in your <tt>~/.bashrc</tt>:

export PATH="/opt/mono-1.2.5/bin:$PATH"
export PKG_CONFIG_PATH="/opt/mono-1.2.5/lib/pkgconfig:$PKG_CONFIG_PATH"
export MANPATH="/opt/mono-1.2.5/share/man:$MANPATH"
export LD_LIBRARY_PATH="/opt/mono-1.2.5/lib:$LD_LIBRARY_PATH"

After changing <tt>LD_LIBRARY_PATH</tt>, you should update the dynamic linker cache:

ldconfig

You may still encounter the "The current runtime framework 'mono-2.0' is not correctly configured in the NAnt configuration file." error listed below. In that case, this may fix this:

yum install glib

If you are running a firewall as well (i.e., if <tt>iptables -L</tt> shows a list of ACCEPT and REJECT rules), you'll have to open the necessary ports if you want to access the sim from other machines. For standalone mode:

iptables -I RH-Firewall-1-INPUT -p tcp --dport 9000 -j ACCEPT
iptables -I RH-Firewall-1-INPUT -p udp --dport 9000 -j ACCEPT

=== Debian 4.0r0 ===

If you set your system to use unstable sources, and then install some packages listed below, everything should just work. To use unstable sources, modify your <tt>/etc/apt/sources.list</tt> file, replacing 'etch' or 'stable' with 'unstable':

deb ftp://ftp.debian.org/debian/ unstable main
deb-src ftp://ftp.debian.org/debian/ unstable main

Then update your packages to the new versions:

apt-get update
apt-get dist-upgrade

This will probably change a large number of packages, and may break things.
In my experience, however, if you do not use unstable sources then the packages are not up to date enough, and you run into version issues, which lead to two DllNotFoundException errors below appearing in the console output: gdiplus.dll and libopenjpeg-libsl-2.1.2.0.so.

Once the sources are updated, we need to install the necessary packages to be able to build OpenSim:

apt-get install subversion mono nant mono-gmcs mono-mjs libmono-microsoft8.0-cil libmono-system-runtime2.0-cil

If any of these packages are missing, you'll probably encounter one of the errors listed below. However, with these packages, OpenSim should build cleanly.

=== Gentoo ===
some Mono dependency & latest Mono itself may use "~x86" masked packages (assuming x86 is your platform, change may be made to reflect your ex:"~amd64" for 64bits). You could check for USE parameter with:

ACCEPT_KEYWORDS="~x86" emerge -vp subversion nant mono libgdiplus

Ten install with:

ACCEPT_KEYWORDS="~x86" emerge subversion nant mono libgdiplus

N.B: The ACCEPT_KEYWORDS="~x86" can be set in Gentoo /etc/make.conf file, but that turn up all the emerges in testing/unstable, using it at the begining of emerge command line use it only for current emerge process

=== Mac OS X ===
This assumes you're using the universal binary for mono from the [http://www.mono-project.com/ Mono Project] site.

After installing mono, you may need to update your <tt>pkg-config</tt> path. I set this in <tt>~/.bash_profile</tt>:
export PKG_CONFIG_PATH="/Library/Frameworks/Mono.framework/Versions/1.2.5.1/lib/pkgconfig/:${PKG_CONFIG_PATH}"

== Errors and fixes ==

=== Build workarounds due to non-functionality or bugs: ===

==== Disappearing prims due to duplicate UID's ====
Generally this problem occurs when a save-xml/load-xml file is loaded into the same sim without using the -newUID switch to generate new UUID's for the objects. This switch is documented in the [[Running#General OpenSim server commands|general server commands]] section. (<nowiki>load-xml <filename> -newUID</nowiki>). But if this does not work, the other way is to shift-copy your build and drag it up into the air.. then delete the one in the air, (which is actually the copy). This will generate new UID's on all your prims.. you can now leave that build, and load your original load-xml file in another region.

==== Linked objects not scaling/editing properly ====
From Mantis [[http://opensimulator.org/mantis/view.php?id=135 # 135]] and [[http://opensimulator.org/mantis/view.php?id=223 # 223]]: 
Linked objects: while linking/unlinking objects seems to work fine, the editing of single prims inside a linked object doesn't work correctly. You have to check the box "Edit linked parts", then you can select a single prim and edit it, but in most cases the changes in size- and/or postion-parameters are not accepted and revert immediately to the original ones. It is not completely reproducible, as it may work in some single case though. 
'''Workaround:''' unlink the whole object, make the changes, and relink the whole thing again. ''note:'' re-scaling unlinked objects in grid mode seems to work better than in standalone.

<hr>

=== Exception and loss of ode physics System.EntryPointNotFoundException: dSpaceLockQuery ===

The following is usually caused by using the wrong version of libode. First try find / -name "libode.so" to see if you have other copies of the ode physics engine. Then make sure you have the latest version of this.

[SCENE] [02-01 22:20:40] System.EntryPointNotFoundException: dSpaceLockQuery
at (wrapper managed-to-native) Ode.NET.d:SpaceLockQuery (intptr)
at OpenSim.Region.Physics.OdePlugin.OdeScene.waitForSpaceUnlock (IntPtr space) [0x00000]
at OpenSim.Region.Physics.OdePlugin.OdeCharacter.AvatarGeomAndBodyCreation (Single npositionX, Single npositionY, Single npositionZ, Single tensor) [0x00000]
at OpenSim.Region.Physics.OdePlugin.OdeCharacter..ctor (System.String avName, OpenSim.Region.Physics.OdePlugin.OdeScene parent_scene, OpenSim.Region.Physics.Manager.PhysicsVector pos) [0x00000]
at OpenSim.Region.Physics.OdePlugin.OdeScene.AddAvatar (System.String avName, OpenSim.Region.Physics.Manager.PhysicsVector position) [0x00000]
at OpenSim.Region.Environment.Scenes.ScenePresence.AddToPhysicalScene () [0x00000]
at OpenSim.Region.Environment.Scenes.ScenePresence.MakeRootAgent (LLVector3 pos, Boolean isFlying) [0x00000]
at OpenSim.Region.Environment.Scenes.Scene.AgentCrossing (UInt64 regionHandle, LLUUID agentID, LLVector3 position, Boolean isFlying) [0x00000]
=== MySQL connection errors after about 6-8 hours ===

MySQL has a timeout which drops the connection after 28,800 seconds of inactivity. So increase this to 31536000. Using set global wait_timeout=31536000; from the mysql console if you get these erros.

=== System.DllNotFoundException: gdiplus.dll ===

First, check to make sure that <tt>libgdiplus.so</tt> is known to the dynamic linker:

/sbin/ldconfig -p | grep libgdiplus

If nothing is found, make sure that the directory libgdiplus.so exists in is either in your <tt>LD_LIBRARY_PATH</tt> environment variable or listed in a *.conf file (e.g., gdiplus.conf) in /etc/ld.so.conf.d/. Then run <tt>ldconfig</tt> to update the cache. Then it should be able to find the library.

You may still have the above error, however, since libgdiplus also depends on other dynamic libraries, and if they fail to load, libgdiplus will fail. To test for this, run OpenSim with debugging information turned on:

MONO_LOG_LEVEL=debug mono OpenSim.exe

It may show errors loading other libraries, like <tt>libexif.so.9</tt>. In that case, linking to an existing version of the offending library may work:

ln -s libexif.so.12 libexif.so.9

''(Is there a cleaner solution than this?)''
''(Isn't this backwards shouldn't be 'ln -s libexif.so.9 libexif.so.12'))

=== The assembly mscorlib.dll was not found or could not be loaded ===

This indicates that you are missing one of the mscor libs that comes with nant. This is easily solved by getting NAnt, which comes with both versions 1.0 and 2.0 of the required lib.

apt-get install nant

=== External Program Failed: /usr/lib/pkgconfig/../../lib/mono/2.0/gmcs.exe ===

This is quickly fixed by retrieving mono-gmcs.

apt-get install mono-gmcs

=== The type or namespace name JScript does not exist in the namespace Microsoft ===

Note that it says Jscript over and over again. Hint perhaps?

apt-get install mono-mjs libmono-microsoft8.0-cil

On Fedora, the needed package is mono-jscript

=== The type or namespace name Tcp does not exist in the namespace System.Runtime.Remoting.Channels ===

This one is taken care of with a quick install:

apt-get install libmono-system-runtime2.0-cil

=== Missing: libopenjpeg-libsl-2.1.2.0-x86_64.so ===
You are on 64bit linux machine and my need to follow these instructions: [[Installing_and_running_on_x86-64 |Installing and running on x86-64 ]]

=== error while loading shared libraries: libgthread-2.0.so.0: cannot open shared object file ===

If you start with a base Debian system as we did at the top of the page, but instead of using the apt version of mono you use the installer from their website, then you may encounter this issue.

After getting the .bin file from http://www.mono-project.com/Downloads, and executing it as per its instructions, upon finishing, you may find that if you try to run `mono --version` you are presented with this message. This one means you need to install libglib2.0-0.

apt-get install libglib2.0-0

=== The current runtime framework 'mono-2.0' is not correctly configured in the NAnt configuration file. ===

This one seems to be fixed by retrieving the apt version of nant.

apt-get install nant

This can also be due to <tt>pkg-config</tt> not being able to locate the <tt>mono.pc</tt> file. Adding the directory containing this file to the environment variable <tt>PKG_CONFIG_PATH</tt> may solve this.

== Networking and config issues ==
[[OpenSim:Running |See Running section]]

=== You are able to log in, but not connect to a Region from a remote client ===

Look in your OpenSimulator/bin/Regions folder
1) Try 0.0.0.0 for the internal_ip_address in your region.xml(default.xml) file
(you'll have one of those files *per* region you've created)
2) external_host_name="127.0.0.1" will need to be changed to the accessable DNS name
such as "opensim.example-host.com" or "71.6.131.152" (your public accessable ip)

[[Category:Getting Started]]

FAQ

2008-02-16T18:54:07Z

Krisbfunk: /* I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment 'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

Troubleshooting

2008-02-12T13:26:36Z

Krisbfunk: /* Disappearing prims due to duplicate UID's */

[[Category:Users]]
This page gives any system-specific configuration settings that may be useful, and advice for problems that might be encountered.

== System-specific configuration ==
=== CentOS 5 ===

To install mono and nant, you can use the "Linux Installer for x86" found at http://www.mono-project.com/Downloads.

SVN can be installed by:

yum install subversion

Mono defaults to installing into <tt>/opt</tt>, so you may have to add this path to your environment variables, for example, in your <tt>~/.bashrc</tt>:

export PATH="/opt/mono-1.2.5/bin:$PATH"
export PKG_CONFIG_PATH="/opt/mono-1.2.5/lib/pkgconfig:$PKG_CONFIG_PATH"
export MANPATH="/opt/mono-1.2.5/share/man:$MANPATH"
export LD_LIBRARY_PATH="/opt/mono-1.2.5/lib:$LD_LIBRARY_PATH"

After changing <tt>LD_LIBRARY_PATH</tt>, you should update the dynamic linker cache:

ldconfig

You may still encounter the "The current runtime framework 'mono-2.0' is not correctly configured in the NAnt configuration file." error listed below. In that case, this may fix this:

yum install glib

If you are running a firewall as well (i.e., if <tt>iptables -L</tt> shows a list of ACCEPT and REJECT rules), you'll have to open the necessary ports if you want to access the sim from other machines. For standalone mode:

iptables -I RH-Firewall-1-INPUT -p tcp --dport 9000 -j ACCEPT
iptables -I RH-Firewall-1-INPUT -p udp --dport 9000 -j ACCEPT

=== Debian 4.0r0 ===

If you set your system to use unstable sources, and then install some packages listed below, everything should just work. To use unstable sources, modify your <tt>/etc/apt/sources.list</tt> file, replacing 'etch' or 'stable' with 'unstable':

deb ftp://ftp.debian.org/debian/ unstable main
deb-src ftp://ftp.debian.org/debian/ unstable main

Then update your packages to the new versions:

apt-get update
apt-get dist-upgrade

This will probably change a large number of packages, and may break things.
In my experience, however, if you do not use unstable sources then the packages are not up to date enough, and you run into version issues, which lead to two DllNotFoundException errors below appearing in the console output: gdiplus.dll and libopenjpeg-libsl-2.1.2.0.so.

Once the sources are updated, we need to install the necessary packages to be able to build OpenSim:

apt-get install subversion mono nant mono-gmcs mono-mjs libmono-microsoft8.0-cil libmono-system-runtime2.0-cil

If any of these packages are missing, you'll probably encounter one of the errors listed below. However, with these packages, OpenSim should build cleanly.

=== Gentoo ===
some Mono dependency & latest Mono itself may use "~x86" masked packages (assuming x86 is your platform, change may be made to reflect your ex:"~amd64" for 64bits). You could check for USE parameter with:

ACCEPT_KEYWORDS="~x86" emerge -vp subversion nant mono libgdiplus

Ten install with:

ACCEPT_KEYWORDS="~x86" emerge subversion nant mono libgdiplus

N.B: The ACCEPT_KEYWORDS="~x86" can be set in Gentoo /etc/make.conf file, but that turn up all the emerges in testing/unstable, using it at the begining of emerge command line use it only for current emerge process

=== Mac OS X ===
This assumes you're using the universal binary for mono from the [http://www.mono-project.com/ Mono Project] site.

After installing mono, you may need to update your <tt>pkg-config</tt> path. I set this in <tt>~/.bash_profile</tt>:
export PKG_CONFIG_PATH="/Library/Frameworks/Mono.framework/Versions/1.2.5.1/lib/pkgconfig/:${PKG_CONFIG_PATH}"

== Errors and fixes ==

=== Build workarounds due to non-functionality or bugs: ===

==== Disappearing prims due to duplicate UID's ====
Generally this problem occurs when a save-xml/load-xml file is loaded into the same sim without using the -newUID switch to generate new UUID's for the objects. This switch is documented in the [[Running#General OpenSim server commands|general server commands]] section. (<nowiki>load-xml2 <filename> -newUID</nowiki>). But if this does not work, the other way is to shift-copy your build and drag it up into the air.. then delete the one in the air, (which is actually the copy). This will generate new UID's on all your prims.. you can now leave that build, and load your original load-xml file in another region.

==== Linked objects not scaling/editing properly ====
From Mantis [[http://opensimulator.org/mantis/view.php?id=135 # 135]] and [[http://opensimulator.org/mantis/view.php?id=223 # 223]]: 
Linked objects: while linking/unlinking objects seems to work fine, the editing of single prims inside a linked object doesn't work correctly. You have to check the box "Edit linked parts", then you can select a single prim and edit it, but in most cases the changes in size- and/or postion-parameters are not accepted and revert immediately to the original ones. It is not completely reproducible, as it may work in some single case though. 
'''Workaround:''' unlink the whole object, make the changes, and relink the whole thing again. ''note:'' re-scaling unlinked objects in grid mode seems to work better than in standalone.

<hr>

=== Exception and loss of ode physics System.EntryPointNotFoundException: dSpaceLockQuery ===

The following is usually caused by using the wrong version of libode. First try find / -name "libode.so" to see if you have other copies of the ode physics engine. Then make sure you have the latest version of this.

[SCENE] [02-01 22:20:40] System.EntryPointNotFoundException: dSpaceLockQuery
at (wrapper managed-to-native) Ode.NET.d:SpaceLockQuery (intptr)
at OpenSim.Region.Physics.OdePlugin.OdeScene.waitForSpaceUnlock (IntPtr space) [0x00000]
at OpenSim.Region.Physics.OdePlugin.OdeCharacter.AvatarGeomAndBodyCreation (Single npositionX, Single npositionY, Single npositionZ, Single tensor) [0x00000]
at OpenSim.Region.Physics.OdePlugin.OdeCharacter..ctor (System.String avName, OpenSim.Region.Physics.OdePlugin.OdeScene parent_scene, OpenSim.Region.Physics.Manager.PhysicsVector pos) [0x00000]
at OpenSim.Region.Physics.OdePlugin.OdeScene.AddAvatar (System.String avName, OpenSim.Region.Physics.Manager.PhysicsVector position) [0x00000]
at OpenSim.Region.Environment.Scenes.ScenePresence.AddToPhysicalScene () [0x00000]
at OpenSim.Region.Environment.Scenes.ScenePresence.MakeRootAgent (LLVector3 pos, Boolean isFlying) [0x00000]
at OpenSim.Region.Environment.Scenes.Scene.AgentCrossing (UInt64 regionHandle, LLUUID agentID, LLVector3 position, Boolean isFlying) [0x00000]
=== MySQL connection errors after about 6-8 hours ===

MySQL has a timeout which drops the connection after 28,800 seconds of inactivity. So increase this to 31536000. Using set global wait_timeout=31536000; from the mysql console if you get these erros.

=== System.DllNotFoundException: gdiplus.dll ===

First, check to make sure that <tt>libgdiplus.so</tt> is known to the dynamic linker:

/sbin/ldconfig -p | grep libgdiplus

If nothing is found, make sure that the directory libgdiplus.so exists in is either in your <tt>LD_LIBRARY_PATH</tt> environment variable or listed in a *.conf file (e.g., gdiplus.conf) in /etc/ld.so.conf.d/. Then run <tt>ldconfig</tt> to update the cache. Then it should be able to find the library.

You may still have the above error, however, since libgdiplus also depends on other dynamic libraries, and if they fail to load, libgdiplus will fail. To test for this, run OpenSim with debugging information turned on:

MONO_LOG_LEVEL=debug mono OpenSim.exe

It may show errors loading other libraries, like <tt>libexif.so.9</tt>. In that case, linking to an existing version of the offending library may work:

ln -s libexif.so.12 libexif.so.9

''(Is there a cleaner solution than this?)''
''(Isn't this backwards shouldn't be 'ln -s libexif.so.9 libexif.so.12'))

=== The assembly mscorlib.dll was not found or could not be loaded ===

This indicates that you are missing one of the mscor libs that comes with nant. This is easily solved by getting NAnt, which comes with both versions 1.0 and 2.0 of the required lib.

apt-get install nant

=== External Program Failed: /usr/lib/pkgconfig/../../lib/mono/2.0/gmcs.exe ===

This is quickly fixed by retrieving mono-gmcs.

apt-get install mono-gmcs

=== The type or namespace name JScript does not exist in the namespace Microsoft ===

Note that it says Jscript over and over again. Hint perhaps?

apt-get install mono-mjs libmono-microsoft8.0-cil

On Fedora, the needed package is mono-jscript

=== The type or namespace name Tcp does not exist in the namespace System.Runtime.Remoting.Channels ===

This one is taken care of with a quick install:

apt-get install libmono-system-runtime2.0-cil

=== Missing: libopenjpeg-libsl-2.1.2.0-x86_64.so ===
You are on 64bit linux machine and my need to follow these instructions: [[Installing_and_running_on_x86-64 |Installing and running on x86-64 ]]

=== error while loading shared libraries: libgthread-2.0.so.0: cannot open shared object file ===

If you start with a base Debian system as we did at the top of the page, but instead of using the apt version of mono you use the installer from their website, then you may encounter this issue.

After getting the .bin file from http://www.mono-project.com/Downloads, and executing it as per its instructions, upon finishing, you may find that if you try to run `mono --version` you are presented with this message. This one means you need to install libglib2.0-0.

apt-get install libglib2.0-0

=== The current runtime framework 'mono-2.0' is not correctly configured in the NAnt configuration file. ===

This one seems to be fixed by retrieving the apt version of nant.

apt-get install nant

This can also be due to <tt>pkg-config</tt> not being able to locate the <tt>mono.pc</tt> file. Adding the directory containing this file to the environment variable <tt>PKG_CONFIG_PATH</tt> may solve this.

== Networking and config issues ==
[[OpenSim:Running |See Running section]]

=== You are able to log in, but not connect to a Region from a remote client ===

Look in your OpenSimulator/bin/Regions folder
1) Try 0.0.0.0 for the internal_ip_address in your region.xml(default.xml) file
(you'll have one of those files *per* region you've created)
2) external_host_name="127.0.0.1" will need to be changed to the accessable DNS name
such as "opensim.example-host.com" or "71.6.131.152" (your public accessable ip)

[[Category:Getting Started]]

FAQ

2008-02-12T13:23:09Z

Krisbfunk: /* Can I export all my prims, for safe keeping? */

[[Category:Users]]
A list of frequently asked questions. Please add anything you think is reasonable here.

= What is OpenSim? =

OpenSim is a platform for operating a virtual world, and supports multiple independent regions connecting to a single centralized grid. This is somewhat similar to the web, where anyone can run their own web server, tied together through the internet. It can also be used to create a private grid, analogous to a private intranet.

=== What is a region? ===

A region is what you see when you log into OpenSim. It is the physical place (well, virtually physical) where avatars move and interact. It is a square patch of land which may contain an island, mountains, a plain, buildings, etc., or just an ocean.

=== What is the grid? ===

The grid is the level that organizes the regions and their positions in the world, and handles things that need to exist across regions, such as a user's inventory. You can think of it as similar to the world map.

=== What does ... mean? ===

See [[OpenSim:TechRef]] for definitions of some terms commonly used in OpenSim.

= Building OpenSim =

=== I can't find any build files or solution files ===

* If you're on Windows, run <tt>runprebuild.bat</tt> - on Linux/Mac/FreeBSD, run <tt>runprebuild.sh</tt>

=== VS2005 won't open the .sln file ===

* Try running VS2005 C#. You are probably running VS2005 C++. This is a C# project.

= Running OpenSim =

=== Running OpenSim.exe from a Cygwin shell has access denied for some dll's ===

* Do a '<tt>cd bin</tt>' followed by '<tt>chmod a+x *</tt>' to make all dll files executable.

=== I cannot start my sim ===

* See [[OpenSim: Running]].

= Configuring OpenSim =

First, read [[OpenSim: Configuration]].

=== Where can I get a new UUID for my sim config? ===

Use '<tt>uuidgen</tt>' or generate one on the [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage].

=== Can I run multiple regions with OpenSim? ===

Yes. To do this add another xml file to <tt>bin/Regions</tt>. You need to create a new 'sim_UUID' (see above) and change the 'sim_name', 'internal_ip_port', 'sim_location_x' and 'sim_location_y' (and anything else you wish to change). The script <tt>share/regions/make.php</tt> may be useful for generating region files automatically. Once the new region files have been added to <tt>bin/Regions</tt>, restart OpenSim.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be in adjacent regions, so you will be able to run back and forth between regions.

* See [[OpenSim: Configuration]].

=== How do I enable prim storage? ===

* In the <tt>OpenSim.ini</tt> file, change the <tt>storage_plugin</tt> entry to
storage_plugin = OpenSim.DataStore.MonoSqlite.dll
or
storage_plugin = OpenSim.Framework.Data.MySQL.dll

You will also need to provide connection details in a <tt>storage_connection_string</tt> attribute - see the <tt>OpenSim.ini.example</tt> file in the bin directory of the OpenSim package for more information.

=== There are a bunch of textures in the library, but they are all 0x0? What's wrong? ===
To enable these extra textures for your use, you must delete your <tt>regionassets.yap</tt> file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS (textures, scripts, animations, etc) THAT YOU HAVE UPLOADED!

=== What databases can be used with OpenSim? ===
For running in standalone mode, OpenSim provides database plugins for both sqlite and MySQL. There is also an MSSQL plugin, though this has not been thoroughly tested. Sqlite requires no user configuration to set up while MySQL requires some minimal user configuration (see [[mysql-config]]).

Running in grid mode is usually done using the MySQL database. Sqlite and MSSQL may work but have not been thoroughly tested.

=== Can I export all my prims, for safe keeping? ===

Yes. From the console type:
save-xml [filename]

You can later load those prims with:
load-xml [filename]

This is also a good way to dump and clone prims from one OpenSim server to another.

= Something Has Gone Wrong! =

=== I get errors concerning 'owner_uuid' when starting up my grid after updating from svn beyond r3254 ===

When updating to recent revisions after r3254, we are now using the unused owner_uuid. There are some grids whose mysql tables were created during a time when this field was inadvertently removed from the .sql script that initializes the regions table. Logging in to your mysql instance and executing this SQL query to add the missing owner_uuid should solve this issue:

alter table `regions` add column `owner_uuid` varchar(36) default '00000000-0000-0000-0000-000000000000' not null, comment-'Rev.2';

The punctuation around regions and owner_uuid is "grave accent". The punctuation around the default value and the comment is the single quote. The "grave accent" is the one generally to the left of the One button, under the tilde and the single-quote, is, well, underneath the double quote. I think this matters to mysql.

=== I get a timeout during region handshake ===

* Do you have the correct IP in your Regions\* config files?
* Do you have multiple interfaces on the server running OpenSim? OpenSim will not bind outgoing UDP packets to a specific IP, its default IP to reach you will be what the Region answers UDP with. If you have configured the region for another IP you will get a timeout during connect.

=== I cannot connect to my OpenSim ===

* See [[OpenSim: Connecting]].

=== I can connect but cannot move ===

If the client connects but the avatar can only spin in place and not move, then the sim is not correctly configured. It completed the initial login function, but packets are not being exchanged between the client and the sim, probably due to a network configuration error on the sim.

* See [[OpenSim: Configuration]].

=== From time to time my Avatar seems to get stuck ===
Right now there is a bottle neck when syncing prims off to the database. This will cause small (5 - 10 second) apparent hangs of the Avatar, but it will recover fine once the data is synced. It is a known issue based on legacy architecture of some of the data storage code. We hope this will be removed soon.

=== I have problems with viewing the worldmap ===

* This may happen when running OpenSim on a Linux server, both in grid or standalone mode.
* Symptoms: when opening the worldmap window in the SL-viewer, the sims are not displayed grahically in the worldmap, the server console shows some error related to openjpeg, the current session freezes...
* Reason: your svn source trunk does not have the correct (or whatever...) <tt>libopenjpeg-libsl</tt> library.
* Other reason: the file "defaultstripe.png" does not exists in the same OpenSim folder, or is corrupted.
* Solution: get the newest code from libsecondlife (<tt>svn co svn://opensecondlife.org/libsl/trunk</tt>), '<tt>make</tt>' manually in the subdir <tt>openjpeg-libsl</tt>, and copy the resulting <tt>libopenjpeg-libsl-2.1.2.0.so</tt> into your OpenSim <tt>bin</tt> subdir, overwriting the existing one.
* Recompile & restart OpenSim.

= Exceptions on the Console =
This is a list of Exceptions that you may see on the console, what they mean, and if they are a problem.

=== System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so ===
Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]

You are on Linux, and the native lib libopenjpeg-libsl-2.1.2.0.so is not compatible with your system for one of the following reasons:
* You have an old processor (libopenjpeg has been compiled with optimizations)
* You are running in 64bit mode (none of the native libs are built for 64bit)

You can rebuild your own libopenjpeg from source, or run in a compatible environment.
You can do this by:
svn co svn://opensecondlife.org/libsl/trunk libsl
cd libsl/openjpeg-libsl/
make

then copy libopenjpeg-libsl-2.1.2.0.so into OpenSim bin-folder.

= OpenSim in the Wild =

=== Are there test servers running OpenSim I can connect to? ===

Yes. Check out http://www.deepgrid.com, http://osgrid.org

There are also often many private servers up for testing. Hang out on the IRC channel (Freenode #opensim), and troll for URI's.

=== Can I teleport from the Linden Lab Second Life grid to my Sim? ===

No, OpenSim islands cannot connect to the Linden Lab grid.

= Terrain Tidbits =
=== What programs can I use to create terrains for OpenSim? ===
If you are after simple terrain files (jpg, gif, etc), you can use Photoshop or any number of freeware programs, like [http://www.gimp.org/ Gimp]. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). [http://www.bundysoft.com/L3DT/ L3DT] and [http://www.planetside.co.uk/terragen/ Terragen] are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use [http://www.blender.org/ Blender]. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

You can use `terrain load IMG yourfile.png` to load '''greyscale''' PNG files. Remember to use something like `terrain rescale 0 25` to make it visible.

Here is some info on [[Using L3DT]] to make a terrain.

You can also use http://lab.parkstudio.ru/terra/ if you know a bit about heightmaps and how they work. Just set the custom landscape texture gradient to pure black and pure white and turn off water.

And here are some [[Free Terrains]] that you can use. Enjoy!

=== Where do I put the files for my terrains? ===
This one is actually pretty simple, but first the 'hard' answer: anywhere in the PATH will work. Lost? yeah, I was too, so... just drop the file into the <tt>bin</tt> directory (right where your <tt>OpenSim.exe</tt> file is).

=== How do I change the terrain for a group of sims? ===
First, the file must be in f32 (or f64?) format. This is easy to do with L3DT's export feature. (Use the RAW format and set the options to <tt>Y flipped = true</tt> and at the bottom, change it to read 'float' instead of 'ushort'). It also needs to be a file that will cover each sim in a 256x256 layer (so, for 2x2 regions, you need a 512x512 file).

Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:

terrain load-tile f32 <filename> <image X> <image y> <bottomleftsim X> <bottomleftsim y>

For example, I run a square of 4 sims in a 2x2 pattern. I started my sim placement at 0, 0 and ended at 1, 1. my line reads:

terrain load-tile f32 simalpha.raw 512 512 0 0

Next, before you log in, you may want to go to type in:

terrain multiply 0.4

This should scale it down from the nearly 300 meters altitude I ran into to something a little more reasonable for the minimap.

=== How do I load a terrain file on startup? ===
Edit the file <tt>startup_commands.txt</tt> in the bin directory and add the above commands "<tt>terrain load-tile ...</tt>" and "<tt>terrain multiply ...</tt>" one per line.

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|Tilde]] 10:32, 15 August 2007 (PDT)

=== How do I import into OpenSim the terrain shape of my Second Life sim? ===
First, assure you are in the right region if you have more than one, by using:

change-region <nowiki><regionname></nowiki>

Then use the command (depending on the filetype (F32 etc), RAW can also be used in place of here)

terrain load <nowiki><filetype> <filename></nowiki>

Watch [http://archimedix.wordpress.com/2007/11/26/opensim/ this video] for a step-by-step tutorial.

=== Other useless or usefull info depending on who reads it ===

* I found out that each point on the grey scale (0 to 255) equals approximately .23 to .25 meters in terrain height. - [[CharlieO]]
* Also for those who want to manually edit a png file, you need at minimum 3 different shades of grey. and one has to be drastically different than the other 2 in order to have the height show correctly. - [[CharlieO]]
example:
1) 0,0,0
2) 223, 233, 233
3) 255, 255, 255

= In World Questions =

=== Does in world scripting work yet? ===

Not fully implemented, but there is a lot of work going on here. Please see [[LSL Status]] for the latest info.

=== Why do I walk through objects? ===

Basicphysics doesn't support collisions between objects (just between you and the ground). There is active work on other physics engines for OpenSim, but these are quite experimental at this point, so not considered supported.

=== Can I customize my avatar? ===

Yes. In order to do this:
* Click the Inventory Button
* Create -> New Clothes -> Shirt, Pants, etc
* Create -> New Body Parts -> Hair, Shape, etc
* Edit those from your inventory
* Wear them

Your avatar doesn't always face a nice direction for doing this, so you'll need to use the camera operations to see your face for some of the modifications. This is a known issue, will be fixed in the future.

Also, you'll need to rewear you parts once you first join the environment. Right now default appearance is always "Ruth".

= Grid Mode =
Note: Grid Mode isn't officially supported yet. As such, you are pretty much on your own if you are trying to get OpenSim up and running in Grid Mode.

=== I start the sim and it doesn't connect to any grid ===

When OpenSim is first started, it needs configuration.

* See [[OpenSim: Configuration]].

=== I start the OpenSim.Grid.UserServer.exe and it gives an error ===

If this error is access denied for <tt>username@localhost</tt>, the mysql database is not set up.

It will print some text and wait for input - either an enter to accept a default value, or another value you can supply.

* See [[OpenSim: Configuration]].

=== I want to run my own Local Grid but one or more servers fail to start ===

* Be sure that you're able to start <tt>OpenSim.exe</tt> alone, in Standalone mode, and to be able to login.
* Start the servers in the correct UGAS order and answer the questions as recommended (see [[OpenSim: Configuration]]).
* Set all the external URI's to the correct IP: 127.0.0.1 if running on your local machine, or aaa.bbb.ccc.ddd if running on a remote server.
* Check again all the <tt>*.xml</tt> configuration files for any wrong settings or typing errors...!
* Don't forget to connect with your SL-viewer to port 8002 (Grid User-Server) instead of 9000 (Standalone OpenSim-Server).
* Delete all <tt>*.xml</tt> and <tt>*.yap</tt> files in the <tt>bin</tt> directory if you want to run a full reconfiguration again.

=== After the shiny new grid is running, what is next? ===
* Make sure one can stop/restart UGA &S (sims). Check out any ordering issues of stop/restart UGA w/o stop/restart sim(s).
* Make sure one can add/delete both a region and a user from the database.
* Make sure it runs overnight and check it each morning by logging into 1 or 2 key sims.
* '<tt>tail -f userserver.log</tt>' and watch/understand the login process.
* Make sure when you logoff your system, you can log back on and get control of the UGAS consoles.
=== I get a bunch of asset not found errors, while connected to a online grid, and my inventory doesn't seem to work right ===

*Make sure your opensim.ini has ' asset_database = "grid" ' otherwise it will not work correctly.

= How to ask for help =

=== Before asking for help... ===

* Search the wiki and web before asking for help.
* Check your configuration files for any obvious defects.
* Check that you're starting up the processes correctly.
* See [[OpenSim: Install]].
* See [[OpenSim: Configuration]].
* See [[OpenSim: Running]].
* See [[OpenSim: Connecting]].

=== Asking in IRC ===

IRC channels are <tt>#opensim</tt> and <tt>#opensim-dev</tt> on Freenode. Approach them in that order :) Please be courteous and remember that the developers and anyone else assisting you are volunteers there.

* Don't ask to ask, just ask.
* Phrase your question in the form of a question.
* Be specific.
* Explain the problem.
* Describe how to reproduce the problem.
* If you need to paste configuration files or error messages, please paste to [http://pastebin.ca/ pastebin] then send the link in the IRC channel.

=== After you get help ===

* If no-one can help you, please submit a bug.
* If someone does help you, please document the problem and fix on the wiki on this page.

[[Category:Getting Started]]

Chat log from the meeting on 2008-01-29

2008-01-30T00:05:50Z

Krisbfunk:

I caught the first 15 minutes while Nebadon caught the rest, which explains the switch in perspective :) [[User:Justincc|Justincc]] 15:13, 29 January 2008 (PST)

 [11:01] You: hello flks
 [11:01] You: folks
 [11:01] You: bbouncy bouncy
 [11:01] You: nice awning
 [11:01] Charles Krinkeb: Morning, all
 [11:02] Teravus Ousley: Good morning
 [11:02] Hiro Protagonist: Mornin' (afternoon!)
 [11:02] Kurt Stringer: Hi Neas
 [11:02] Kurt Stringer: Hello everyone
 [11:02] Hiro Protagonist: man, I havent seen crowd jumpin' like that since my last devo concert
 [11:02] Charles Krinkeb: I'm not sure Neas ha quite arriviled.
 [11:02] Nebadon Izumi: just float
 [11:02] Kurt Stringer: hehheh, Devo!!!
 [11:03] You: urrrgh
 [11:03] You: he's not all there?
 [11:03] Nebadon Izumi: if you float you wont bounce
 [11:03] You: good point
 [11:03] Charles Krinkeb: he has been standing there for 5 minuts facing the sign and I can read it in 4.99999 minutes.
 [11:03] Hiro Protagonist: I'll just stand off the prims
 [11:03] Nebadon Izumi: check out the water cooler inside
 [11:03] Nebadon Izumi: lol
 [11:04] Nebadon Izumi: water delivery is on tuesdays
 [11:04] Nebadon Izumi: lol
 [11:04] Hiro Protagonist: Heh!
 [11:04] You: so thirsty....
 [11:04] Charles Krinkeb: its great.
 [11:04] Teravus Ousley: :D
 [11:04] Hiro Protagonist: Awesome Neb :D
 [11:05] Charles Krinkeb: Do we put the trap door for the Gorean dungeon next to the water cooler and underwater?
 [11:05] Nebadon Izumi: lol
 [11:05] Teravus Ousley: that would be my recommendation
 [11:05] Nebadon Izumi: nest is a snack machine
 [11:05] Teravus Ousley: :D
 [11:05] Nebadon Izumi: mext
 [11:05] Nebadon Izumi: blah next
 [11:05] Charles Krinkeb: Maybe we script one of the bottles and teleport to the secret skybox?
 [11:05] You: I'm bouncing even though Im floating
 [11:05] Nebadon Izumi: lol
 [11:06] Hiro Protagonist: I cant seem to stop typing
 [11:06] You: I like the signs - very honest
 [11:06] Justin Clark-Casey likes that
 [11:06] Nebadon Izumi: yea i put up posts on the sides of the signs today
 [11:06] Kurt Stringer: y, Justin - me too, page up a bit and it goes away
 [11:06] Nebadon Izumi: so they arent just floating
 [11:06] Charles Krinkeb: We strive for straigh-forward and honesty on this grid.
 [11:06] Charles Krinkeb: Hype just gets us all in trouble.
 [11:07] Hiro Protagonist: This is awesome
 [11:07] You: yes
 [11:07] Teravus Ousley: no sit target yet :P
 [11:07] Nebadon Izumi: lol ter
 [11:07] Hiro Protagonist: I need to tell Babblefrog that Los Altos is also a sandbox region
 [11:07] You: heh, I'm not sure you're meant to use the chair like that Ter
 [11:07] Kurt Stringer: lol
 [11:07] Charles Krinkeb: Obviously, I have some emotional angst about what appears to be less then forthright statements from others (none in this meeting).
 [11:07] Nebadon Izumi: yea W2K8ODE is also sandbox
 [11:08] You: So, any concerns or issues people want to bring up?
 [11:09] Charles Krinkeb: I think two of the top issues are a) asset server stability and b) ode stability.
 [11:09] Nebadon Izumi: hmm i cant wear my clothes or avatar
 [11:09] Hiro Protagonist: yes, I'd have to agree
 [11:09] You: asset server stability is something I hope to make contributions towards soon
 [11:09] Hiro Protagonist: there's a lot of things I'd really like to see start working
 [11:09] Hiro Protagonist: but those two are things that are holding back several fronts
 [11:10] You: yeah, it sounds liek from what you're saying Charles, that perhaps we could be a bit smarter on the mysql front?
 [11:10] Charles Krinkeb: I think we have come a long ways on scripting. It is fun to visit the script building that Pablo is building over by the treehouse.
 [11:10] Teravus Ousley isn't sure the ODE issues are 'holding anything back'.. as it's a plugin..
 [11:10] You: in terms of the asst server
 [11:10] Teravus Ousley: could use a different plugin while waiting :D
 [11:11] You: what else is there that provides sold objects though? Just pos, right?
 [11:11] You: solid
 [11:11] Charles Krinkeb: Teravus. I would say holding back in this context is mostly trying to give our artists a productive environment so their muse can appear.
 [11:11] Charles Krinkeb: We also have BulletX, but I think it has been untested for some time.
 [11:12] Nebadon Izumi: yea bulletx crashes alot
 [11:12] Charles Krinkeb: Ahh, perfect chair. Fits like a glove.
 [11:12] Nebadon Izumi: lol
 [11:12] Charles Krinkeb: And no bouncing, either.
 [11:13] Teravus Ousley: well, I recently removed the 'x collision with x' console messages.. as darok hasn't updated Bullet in a while and they made it completely unusable
 [11:13] Nebadon Izumi: wonder why i cant wear my Avatar or Clothes
 [11:13] You: there you go, fixed that for you
 [11:13] Charles Krinkeb: Nebadon. Could it be a side effect of bring the 9000 assets from local to grid last Saturday?
 [11:13] Nebadon Izumi: no it worked yesteday
 [11:13] Kurt Stringer: re cloths: it takes a long time to rez
 [11:13] You: Yeah, I don't think that would be a factor
 [11:13] Nebadon Izumi: well its not attaching
 [11:13] Nebadon Izumi: they are not highlighting when i right click and wear
 [11:14] Charles Krinkeb: Could it have anything to do with POS vs ODE? Thats the only OpenSim.ini change since yesterday.
 [11:14] You: I want to start putting in more stats so we can have some better idea of whether it's the asset server taking a long time or something else
 [11:14] Nebadon Izumi: hmm seems unlikely
 [11:14] Nebadon Izumi: let me relog and see if that fixes the problem
 [11:15] Charles Krinkeb: As testers, I think we have to figure out how to give a higher quality of reports in Mantis to our developers.
 [11:15] You: Teravus: Is fixing up ODE a realstic near term goal?
 [11:15] Charles Krinkeb: To be fair to Teravus, I think physics in general is a long-term PITA for all concerned.
 [11:15] Teravus Ousley: well, let me put it to you this way.. I could remove the asserts and handle the errors gracefully
 [11:16] You: oh yeah, physics is HUGE

 [11:16] Justin Clark-Casey: as well as being head bending mathematics
 [11:16] You: nope
 [11:16] You: relog didnt help
 [11:16] Teravus Ousley: .. probably have that done in a few days.. however, the asserts are in there to help discover what we're doing wrong.
 [11:16] You: hey chris
 [11:16] Charles Krinkeb: And now we have differing results on differing test setups as Tervaus cannot see these errors happen on his local test setup, so it gets tougher to diagnose.
 [11:17] Teravus Ousley: So. Parhaps a library with asserts and without. Because some regions need to be up
 [11:17] Teravus Ousley: :D even if something wrong is done.
 [11:17] Justin Clark-Casey: interesting idea!
 [11:17] Mircea Kitsune: hi
 [11:17] Justin Clark-Casey: hi mircea
 [11:17] Hiro Protagonist: very good idea Ter
 [11:17] Charles Krinkeb: Teravus. That might work if it is an OpenSim.ini setting.
 [11:17] Mircea Kitsune: floating above the fllor again... brb
 [11:17] Teravus Ousley: no, it's a completely different library
 [11:17] Charles Krinkeb: Hi, Mircea, I love your lights and the awning.
 [11:17] Teravus Ousley: it'll be a 'swap out the odelib.so file
 [11:17] Mircea Kitsune: thank you :)
 [11:18] Mircea Kitsune: we seem to be floating a little above the floor. This happened to me many times
 [11:18] Charles Krinkeb: That makes it difficult for me to test as one of my goals is to stay as close to svn as possible.
 [11:18] You: yea its a side effect of POS
 [11:18] Hiro Protagonist: so not unlike when we were using the 'debug' version of ode, back before it was really useable at all?
 [11:18] Mircea Kitsune: ah yeah, it happens in POS
 [11:19] You: floating fixes all
 [11:19] You: lol
 [11:19] Charles Krinkeb: Why dont we just make POS a little better and wait for ODE to catch up. We can scare the ODE logic by having POS work better.
 [11:19] Teravus Ousley: well, as always, it's up to you sir. :D I'm just proposing ideas to make *your* life easier
 [11:19] Justin Clark-Casey: but is anybody willing to work on POS?
 [11:20] You: yea if we can tweak out POS it would actually be a better fit here on Wright Plaza than ODE
 [11:20] Hiro Protagonist: well, I'd be willing to run a 'stable' rev of ode, and switch to a 'test' version when it was time for testing
 [11:20] Charles Krinkeb: Where in the POS logic would you expect the bouncing issue to be, Teravus? Can you give us a clue with a subroutine name or possible theory?
 [11:20] Hiro Protagonist: whatever or where ever said 'stable' ode came from
 [11:21] Teravus Ousley: alas, I've only added two lines to POS
 [11:21] Teravus Ousley: .
 [11:21] Charles Krinkeb: Can you contact DanXor and see if you can get him fired up a little bit, Teravus?
 [11:22] Teravus Ousley: send it to the opensim-dev list :D
 [11:22] Chris D: I see that sationary avatars are showing continours updates (those not floating or sitting on prims). Is this a POS effect?
 [11:22] Justin Clark-Casey: +1. Perhaps you could make the appeal Charles?
 [11:22] Charles Krinkeb: ?? DanXor is our physics guy. Isnt he the one that brought you in?
 [11:22] Justin Clark-Casey: oh god, not that problem still
 [11:22] Teravus Ousley: mostly.. I note that I have a hard time replicating the bounce on my systems
 [11:22] Justin Clark-Casey: yeah, still huge agent updates
 [11:22] Teravus Ousley: so it seems to also be related to load
 [11:23] Justin Clark-Casey: Chris D: don't know for sure - I can't replicate this on my own test system
 [11:23] Justin Clark-Casey: though possibly I haven't been thorough enough - it could also be a more complicated load issu
 [11:23] You: maybe we shoud send Teravus a save-xml of wright plaza
 [11:23] Charles Krinkeb: An appeal needs to be made by someone that is bothered by the bouncing. If I make such an appeal it will not express any of your feelings.
 [11:23] Justin Clark-Casey: Charles, the bouncing doesn't bother you?
 [11:23] Teravus Ousley: well, that wouldn't explicitly help.. the situation would have to be very similar
 [11:24] Teravus Ousley: .. I'd need an exact copy of the server config (not just wright plaza.. but all of the plazas)
 [11:24] Charles Krinkeb: Teravus: You can log onto the Wright Plaza console any time you wish.
 [11:25] Teravus Ousley: I can however, replicate the '1 meter offset'
 [11:25] Charles Krinkeb: My only issue is I cannot babysit it 24/7 so it needs to be running without crashing.
 [11:25] Justin Clark-Casey: Aren't we auto restarting o ncrash?
 [11:25] Charles Krinkeb: Doesnt work.
 [11:25] Justin Clark-Casey: physics crash, at least
 [11:25] Justin Clark-Casey: was that an ode only thing?
 [11:26] Charles Krinkeb: Crash is to the bash prompt with ODE latest r3192.
 [11:26] You: lol omg
 [11:26] Justin Clark-Casey: We should really attempt restart on any crash, in my opinion
 [11:26] You: my clothes are changing
 [11:26] Justin Clark-Casey: automatically
 [11:26] You: 15 minutes later
 [11:26] Mircea Kitsune is using ODE all the time on her sim, but rarely ever had any problems with it
 [11:26] Teravus Ousley: well, the ODE asserts 'suck'
 [11:26] Teravus Ousley: in that you can't try/catch them
 [11:26] Charles Krinkeb: The little mice in the squirrel cage had to get up to speed to send the files to you, Nebadon.
 [11:26] Justin Clark-Casey: crap
 [11:27] You: lol
 [11:27] Mircea Kitsune: BulletX is good, but i have a bug with it in which when you land ona surface, you keep slowly sliding forever
 [11:27] You: My Packets are being delivered by Horseback messanger today
 [11:28] Charles Krinkeb: Can we make a little progress in chatting about assets for a while. I think we have perhaps beat the physics horse to death for one meeting.
 [11:28] Justin Clark-Casey: To come back to the ODE asserts... are they giving you useful info Teravus when they happen on other people's sytems? Would we lose much by disabling them in an alternate ODE library?
 [11:28] Justin Clark-Casey never tires of whipping horse flesh
 [11:28] Charles Krinkeb: Ok. No problem.
 [11:29] Justin Clark-Casey wonders if Teravus is lost altogether since he dropped off irc
 [11:29] Justin Clark-Casey: Charles, anything in particular you wanted to say regarding assets?
 [11:29] paulie Femto: :)
 [11:30] Hiro Protagonist: Hey Paulie :D
 [11:30] paulie Femto: Howdy. :)
 [11:30] Justin Clark-Casey realizes the sim could also lag out at any momenmnt...
 [11:30] Justin Clark-Casey: those damn agent updates
 [11:30] Justin Clark-Casey: why on earth are they happening....?
 [11:30] You: HE LIVES
 [11:30] You: i saw him typin
 [11:30] You: lol
 [11:30] Justin Clark-Casey: random twitching
 [11:30] Justin Clark-Casey: :)
 [11:30] Teravus Ousley: It's hard to say. When developing vehicles it might be useful information
 [11:30] Charles Krinkeb: The assetserver is not evil. It just needs a bit more TLC. We, as testers, should strive to get unambiguous Mantis reports for the developers to help them work through the issues.
 [11:31] Mircea Kitsune: Yes, yesterday i built here a lot. It has been dozens of times since primitive sizes, texttures, positions, and everything kept slipping back and i had to struggle to set them
 [11:31] Justin Clark-Casey: I think the problem is the testers don't see any data to work with
 [11:31] Justin Clark-Casey: there are no statistics and the exception traces are often uninformative
 [11:31] Charles Krinkeb: One data point is that we see the assetserver loosing its mysql connection a couple of times each week.
 [11:32] Justin Clark-Casey: well, we should see if we can get better at handling that
 [11:32] Mircea Kitsune: Ok. there is something else i wanted to say about. I was wondering if there is anyone still working on implementing lsl functions
 [11:32] Charles Krinkeb: Should we return a default asset when an asset cannot be found, instead of no asset?
 [11:32] Justin Clark-Casey: Mircea, I think some of the problems here are caused by the constant agent updates bug
 [11:32] You: .
 [11:32] Kurt Stringer: Mircea: yes, I am but VERY slowly at the moment
 [11:33] Justin Clark-Casey: Mircea, this is causing constant traffic between sim and client, potentially crowding out other packets
 [11:33] Justin Clark-Casey: Could do, I think that's low priority though
 [11:33] Charles Krinkeb: Yes, Mircea. About 110 or the 328 are running now. We need to gain a little more momentum on implementing LSL_BuiltIn_Commands.cs again.
 [11:33] Chris D: if we all fly just above the ground, the updates cease.
 [11:33] Justin Clark-Casey: just seeing if we can get everything a little more stable should be high pri, imho
 [11:33] Mircea Kitsune: yeah indeed, its more high-priority then scripts. i still wondered though
 [11:34] Kurt Stringer: Charles: agreed, good momentum at this point
 [11:34] You: hmm so maybe its POS related?
 [11:34] Justin Clark-Casey: maybe this updates issue is connected with pos
 [11:34] You: yea thats what i was just thinking justin
 [11:34] Justin Clark-Casey: yep :)
 [11:34] paulie Femto: gotta run but I'll read teh backlog l8r.
 [11:34] Hiro Protagonist: brb, must have fluids :)
 [11:35] Justin Clark-Casey: I'd be really interested in seeing an ODE without asserts, as long as that doesn't lose useful debug data
 [11:35] Charles Krinkeb: I can see updates on those who are standing, but not those who are floating.
 [11:35] Chris D: Currently Teravus and Paulie are showing continuous updates.
 [11:35] Mircea Kitsune: see you soon Paluie
 [11:35] paulie Femto: bye 4 now
 [11:35] Justin Clark-Casey: POS seems to have bit rotted over the last month
 [11:35] Charles Krinkeb: Bet if Teravus floats, the updates will decrease.
 [11:35] Justin Clark-Casey: bye paulie
 [11:35] Mircea Kitsune: what are asserts exactly? Sorry i dont know
 [11:35] paulie Femto: someone capture a log of this and post it for those who are missing this?
 [11:35] Justin Clark-Casey: asserts are statements in the code which check if a certain condition holds true
 [11:35] You: paulie float too
 [11:35] Hiro Protagonist: back :)
 [11:35] Charles Krinkeb: Voila, no updates for Teravus now.
 [11:36] Justin Clark-Casey: if not, they blurt out an error, or something analagous
 [11:36] Mircea Kitsune: wb. and nice, i see now
 [11:36] You: oh or just leave
 [11:36] You: lol
 [11:36] Teravus Ousley: .. parhaps POS is sending out all of the updates.
 [11:36] Charles Krinkeb: Maybe there is a clue there.
 [11:36] Justin Clark-Casey: hmmmmmmmmmmmmmmmmmmmmmmmmmm
 [11:36] Mircea Kitsune: From my experience, i would suggest using ODE on wright plaza all the time, but without enabling the physical flag
 [11:36] You: thats how it was
 [11:37] You: but it crashes once a day or so
 [11:37] Justin Clark-Casey: does anybody know for sure if they are animation updates? I heard that they were, but this might not be true or confirmed
 [11:37] Mircea Kitsune: ODE is the only one that never caused any trouble, such as floating, being thrown, misscoliding, etc
 [11:37] Mircea Kitsune: hmm.. thats weird
 [11:37] Charles Krinkeb: Mircea. The plazas crash within 16-24 hours of enabling ODE. It is important that they do not crash.
 [11:37] Mircea Kitsune: maybe there are some physical prims under the terrain or something
 [11:37] Mircea Kitsune: In that case dont, but i find that weird
 [11:37] Justin Clark-Casey: charles, how about a duct tape solution? A watchdog process that checks if the regions are running and restarts them if necessary
 [11:37] Mircea Kitsune: I wonder why
 [11:37] Justin Clark-Casey: checking every minute or so
 [11:38] Mircea Kitsune: hmm... i wonder if my sim crashes because of ODE too now...
 [11:38] Justin Clark-Casey: Charles, how do you feel about basicphysics?
 [11:38] You: personally Justin i think that should be a permanent feature of OpenSIM
 [11:38] Charles Krinkeb: I would rather we fix it right or we will be plagued with this when traffic starts increasing to other regions. I can see this becoming an issue with the IBM internal test grid.
 [11:38] You: whenever a sim is not running it should restart itself
 [11:38] You: unles a shutdown is issued
 [11:39] Mircea Kitsune: I live bulletX, but it makes me slide like an ice cube like i said
 [11:39] Justin Clark-Casey: nebadon, yeah, it depends on whether these things are detectable from within the vm. As Teravus says, they may not be throwing exceptions
 [11:39] Justin Clark-Casey: but in principle I would hope there is some way to tell
 [11:39] You: yea i found BulletX also doesnt like border crossing
 [11:39] Mircea Kitsune: yeah its possible
 [11:39] Kurt Stringer: Hi Sean
 [11:39] Neas Bade: sorry folks, I was off futzing on things
 [11:39] You: hmm maybe we can make a small app that runs along side of OpenSIM
 [11:40] You: to check if its running
 [11:40] Mircea Kitsune: its ok, wb
 [11:40] You: and if its not it relaunches it
 [11:40] Neas Bade: man, what's up with the bouncing still?
 [11:40] You: lol
 [11:40] Justin Clark-Casey: nebadon: yeah, that would be good
 [11:40] Justin Clark-Casey: neas - welcome to the last 40 minutes :)
 [11:40] Kurt Stringer: hehheh
 [11:40] Neas Bade: fortunately it looks like I've got scrollback :)
 [11:41] Neas Bade: is that why everyone is hovering?
 [11:41] Teravus Ousley: something in POS is causing tons of updates..
 [11:41] Justin Clark-Casey: heh, yep :)
 [11:41] Teravus Ousley: the updates stop when you hover
 [11:41] Justin Clark-Casey: if your feet don't touch the ground (well a bit more than that) you're okay
 [11:41] Mircea Kitsune: yeah i can sense a lot of lag and server stress here
 [11:41] Neas Bade: is there a reason we are using POS instead of ODE?
 [11:41] Teravus Ousley: .. so it'll be the collisions that are at issue
 [11:41] Charles Krinkeb: Neas. ODE crashes within 16-24 hours of enabling it.
 [11:41] Teravus Ousley: .. under high load, the collisions seem to exhibit erratic behavior in POS
 [11:42] Mircea Kitsune: What happens if we stil try BulletX on wright plaza?
 [11:42] Neas Bade: I think that sorting that out with ODE would be a better use of time than spending it on POS
 [11:42] Neas Bade: I like the posters in here
 [11:43] Justin Clark-Casey: neas, Ter suggested that perhaps we could take the asserts out of ODE for a 'stable' version, but have the assert filled version as well (as options). Any opinion?
 [11:43] Neas Bade: nice job whoever did those
 [11:43] Mircea Kitsune: yeah theyre nice
 [11:43] Neas Bade: anything that helps us debug would be great :)
 [11:43] Charles Krinkeb: Babblefrog and Nebadon.
 [11:43] Justin Clark-Casey: Teravus, I presume the assert must crash the ODE?
 [11:43] Justin Clark-Casey: well, this would lose debug information...
 [11:43] Justin Clark-Casey: removing the asserts, presumably
 [11:43] Teravus Ousley: no, the errors are 100% handle-able within the ODE library
 [11:44] Teravus Ousley: the developers of ODE are scientists and mathmeticians though
 [11:44] Teravus Ousley: .. so their idea of a simulation is absolute rigid perfection
 [11:44] Charles Krinkeb: 8 avatars, 50% CPU, 1235Mbyte VIRT
 [11:44] You: wow
 [11:44] You: thats really high
 [11:45] Teravus Ousley: .. and so they assert on every little issue instead of handling it effectively
 [11:45] You: 1235mb
 [11:45] You: thats absurdly high
 [11:45] Mircea Kitsune: wow... 50% cup for 8 avatars is enormous. If its a bug though its understandabel
 [11:45] Mircea Kitsune: *cpu *understandable
 [11:45] Justin Clark-Casey: What do you reckon - could we remove the asserts?
 [11:45] Teravus Ousley: Yes, we could. The only issue is they provide needed feedback from the library
 [11:45] Justin Clark-Casey: cpu is probably not helped by the constant agent updates, though they have dropped off some
 [11:45] Teravus Ousley: .. for solving issues
 [11:46] Teravus Ousley: .. essentially.. without them, doing something.. that is wrong, will end up in the action not being done and possibly no way to figure out it wasn't done.
 [11:46] Justin Clark-Casey: looks like we're in a hole then
 [11:46] Teravus Ousley: so, it'll have to be done carefully
 [11:47] Teravus Ousley: .. in such a way that it's possible to know that the the action wasn't done.
 [11:47] Teravus Ousley: like.. 'Invalid operation for locked space', for example
 [11:47] Charles Krinkeb: Can you wrap the assert logic in console debug messages?
 [11:47] Teravus Ousley: .. there is a locking bug somewhere in the ode library.
 [11:47] Teravus Ousley: unfortunately I have not been able to discover it
 [11:48] Neas Bade: ODE is still contained to a single thread, right?
 [11:48] Teravus Ousley: yes, but the collisions sometimes return at odd times compared to the actions
 [11:48] Neas Bade: ok
 [11:48] Teravus Ousley: .. this causes the locked space issues
 [11:48] Justin Clark-Casey: Teravus: this is all code within ODE rather than within OpenSim?
 [11:49] Teravus Ousley: the Asserts are
 [11:49] Teravus Ousley: and they're currently hard coded to basically call 'stop'
 [11:49] Justin Clark-Casey: ennggggggffff
 [11:49] Teravus Ousley: yep
 [11:49] Teravus Ousley: evil
 [11:49] Teravus Ousley: which is why a better system needs to be in place for it
 [11:50] Justin Clark-Casey: well, perhaps we shall just have to see what comes to pass in this area then
 [11:50] Charles Krinkeb: Your blue update cloud just stopped, Neas.
 [11:50] Neas Bade: yeh, because I flew up
 [11:51] Justin Clark-Casey: perhaps duct tape it with some kind of watchdog to restart the region for now
 [11:51] Charles Krinkeb: I know
 [11:51] Justin Clark-Casey: from outside the virtual machine, possibly
 [11:51] You: wtf
 [11:51] Neas Bade: my suggestion would be that if we can make a mod to ODE to get real data on crashes, which should switch WP back to it even if it means crashing
 [11:51] You: why is the water bottle moved?
 [11:52] Teravus Ousley: heh, someone moved it?
 [11:52] You: somewone moved the column i guess
 [11:52] You: ya know
 [11:52] You: we really really need to fox that
 [11:52] Charles Krinkeb: Which gets us to permissions, methinks.
 [11:52] You: fix it too
 [11:53] Justin Clark-Casey: perms?
 [11:53] You: we should not be able to move stuff by clicking on it
 [11:53] You: no if you click a prim it will slide
 [11:53] Mircea Kitsune: yes, i noticed that. it has caused a lot of trouble for me
 [11:53] You: its really bad
 [11:53] Mircea Kitsune: sometimes i think the editor is open and when i click somethingl, i deset it
 [11:53] Teravus Ousley: that's 'grab'
 [11:53] You: people dont realize and move prims out of place very easily
 [11:53] Mircea Kitsune: there should be a 0,35 second necessity to hold the click or so, before it moves
 [11:53] Charles Krinkeb: Can you lock the water bottle and the column, Nebadon?
 [11:53] You: you should only be able to grab in edit move
 [11:53] You: edit mode
 [11:53] You: no
 [11:53] Hiro Protagonist: it's really a perms thing - we shouldnt have perms to do that
 [11:54] Mircea Kitsune: i dont really want the click-drag removed, but not for it to be so fast either
 [11:54] You: click drag should only work in Edit Mode
 [11:54] You: it should not work unless your have edited the object
 [11:54] Mircea Kitsune: is it like that on the linden grid?
 [11:54] You: yes
 [11:54] Mircea Kitsune: i remember click-dragging prims on the linden grid
 [11:55] Mircea Kitsune: ah wait, only physical ones physicallt
 [11:55] Mircea Kitsune: *physivally
 [11:55] Teravus Ousley: well, Estate managers can move any prim in a region. .. and there's a lot of prim in wright plaza with no owner.. that's set to 'everyone can move'
 [11:55] You: yea physical prims yes
 [11:55] You: yea but that column isnt
 [11:55] Mircea Kitsune: ah yeah, in that case its all correct. Click-dragging normal prims should be disabled
 [11:55] Teravus Ousley: yep, that had to be an estate manager or the owner
 [11:56] You: some times i go to cam on a prim
 [11:56] You: and i move it
 [11:56] You: drives me nuts
 [11:56] You: lol
 [11:56] You: plus theres no undo
 [11:56] Mircea Kitsune: indeed, something else i have missed
 [11:56] Mircea Kitsune: undo
 [11:56] You: wouldnt be so catastrophic if there was an undo option
 [11:57] Teravus Ousley: I'm not entirely sure undo would help 'grab' options
 [11:57] Charles Krinkeb: Asset question: Is there a way to manipulate the mysql database to give an owner to prims on the plazas that do not have owners?
 [11:57] You: yea me either
 [11:57] Teravus Ousley: .. as a lot of things get done in grab operations
 [11:57] Mircea Kitsune: I also discovered a bad problem with linking/unlinking; if the parts of a linkset/prikmset you want to link/unlink are toated, when you do the link/unlink they all roate at random
 [11:57] Mircea Kitsune: *roated
 [11:58] Teravus Ousley: There's a patch that doesn't apply for that on mantis
 [11:58] You: yea i find that linksets only really work well if there are no wierd rotations
 [11:58] Teravus Ousley: .. I put it as feedback
 [11:58] Teravus Ousley: so the person who submitted it can fix it
 [11:58] Charles Krinkeb: 9 avatars, 48% CPU, 1309 MByte VIRT
 [11:59] You: hmm wonder why its consuming so much memory
 [11:59] Justin Clark-Casey thinks immortal asset cache
 [11:59] Charles Krinkeb: gamma rays
 [11:59] You: lol
 [11:59] You: must be American Made Ram
 [11:59] You: Obesity Ram
 [11:59] Mircea Kitsune: :)
 [11:59] Teravus Ousley: How many regions are running on this server, out of curiosity?
 [11:59] Charles Krinkeb: 3
 [12:00] You: or Oram for short
 [12:00] Charles Krinkeb: Wright Plaza, Lbsa Plaza and Prior Plaza.
 [12:00] Teravus Ousley: yes, seems very high
 [12:00] Charles Krinkeb: Its in a colo in San Diego with a fat pipe.
 [12:00] Justin Clark-Casey: could do approx asset cache memory usage as a stat on the region server
 [12:00] Justin Clark-Casey: see if I can prove my theory
 [12:00] Mircea Kitsune: Ah i thought you asked about how many sim the grid has. was curious about that too
 [12:01] Mircea Kitsune: think there are around 50 sims on this grid
 [12:01] Charles Krinkeb: 143
 [12:01] Mircea Kitsune: sweet
 [12:01] You: heres the speedtest results from Underverse server
 [12:01] You: http://www.speedtest.net/result/227327572.png
 [12:02] You: wish i could get this kinda speed at my house
 [12:03] You: mic check 1 2 1 2
 [12:03] You: lol
 [12:03] Hiro Protagonist: no kidding!
 [12:04] Teravus Ousley: Child agents item bugs me still -2 child agents :P
 [12:04] Hiro Protagonist: I hade to scrape my chin off the floor LoL
 [12:05] Mircea Kitsune: ok, if noone else wants to say anything, theres something i wanted to suggest
 [12:05] Justin Clark-Casey: please Mircea
 [12:06] Hiro Protagonist: time for me to fly - I'll catch y'all later
 [12:06] Chris D: Bye Hiro
 [12:06] Mircea Kitsune: Well, if many people would work on oepnsim, it would grow faster. The reason i dont is because, even after reading falf of a C# tutorial, i cant understand a thing. So, I have been thinking about something,
 [12:06] Mircea Kitsune: see you soon
 [12:06] Mircea Kitsune: Well,
 [12:06] Justin Clark-Casey: bye hiro
 [12:06] Charles Krinkeb: I need to go also.
 [12:06] Justin Clark-Casey: bye charles
 [12:06] Chris D: bye Charles
 [12:06] Teravus Ousley: take care Charles
 [12:06] Mircea Kitsune: I have been thinking if, someonce could try and make a "C# opensim tutorial", easy to understand for people who dont know the code well
 [12:07] Mircea Kitsune: later charles
 [12:07] Mircea Kitsune: It would probably be a lot, but i dont think its possible for new ones to learn it without one from those who know
 [12:07] Teravus Ousley: C# tutorials would be 900 pages and months of work to put together.
 [12:07] Justin Clark-Casey: yeah....
 [12:07] Teravus Ousley: ..
 [12:07] Justin Clark-Casey: codebase is already big (imo)
 [12:07] Justin Clark-Casey: perhaps if there was some particular area... ?
 [12:09] Kurt Stringer: there are bits and peices already , however, a refreshed architecture- level overview might help
 [12:10] Mircea Kitsune: We wouldnt need to understand absolutely everything, but at least for small modifications, i touhgh
 [12:10] Mircea Kitsune: *tought
 [12:10] Kurt Stringer: whew, I thought I was stuck in chat mode again
 [12:11] Justin Clark-Casey: the trouble is, each different small mod would require a different knowledge set
 [12:11] Mircea Kitsune: yeah
 [12:11] Chris D: Mircea, is there a particular area that you are interested in?
 [12:11] Justin Clark-Casey: perhaps if there was something in particular - I don't mind writing what little I know up if there's a specific need
 [12:12] Justin Clark-Casey: but I find it very difficult to motivate just for the general case :)
 [12:12] Teravus Ousley: yeah, IMHO, it requires an advanced understanding of programming in general.
 [12:12] Mircea Kitsune: Not exactly. I usually just try to go over the parts i notice i would like to fix or implement, but i stand no change :)
 [12:12] Teravus Ousley: .. however, not necessarily in C#
 [12:13] Justin Clark-Casey: Mircea, do you know other programming languages?
 [12:13] Mircea Kitsune: no, ive never been into that till now
 [12:14] Mircea Kitsune: i only used to do small little things in qbasic 7 years ago really
 [12:14] Chris D: It is difficult to advise the best approach as we do not know how much software exprience you have
 [12:14] Mircea Kitsune: yeah i dont have much, but i thought it could be easy to learn the small things for opensim
 [12:15] You: best be is buy some books
 [12:15] Justin Clark-Casey: mmm, I'm afraid I think it would be tough
 [12:15] You: with tutorial DVDs
 [12:15] You: then sift through the code
 [12:15] You: microsoft has a good C# reference on their MSDN website
 [12:15] Kurt Stringer: actually there are some really good tutorials
 [12:15] Kurt Stringer: yes Neb
 [12:15] Teravus Ousley: Walking the animals.. brb
 [12:16] Kurt Stringer: the VSCSEE has a good tutorial also
 [12:17] You: hah who wants to hear something funny
 [12:17] Mircea Kitsune: well, the reason why i said a opensim specific tutorial is that i seen there are many files, with parts one from another. and its hard to find where each belongs, and where to go to to work on a certain thing
 [12:17] You: you might have read it in the IRC last night
 [12:17] You: but MaltoSosa came into IRC channel last night wanted to know if Central Grid could donate to OpenSIM project
 [12:17] Justin Clark-Casey: mircea, the trouble is you would have to drill down very far to get anything more than a general idea
 [12:18] You: so i suggested to him that he package up his website and make it available to everyone
 [12:18] Justin Clark-Casey: would be a big doc, too much for one person I think
 [12:18] You: and he made up about 5 excuses why he couldnt
 [12:18] You: lol
 [12:18] Justin Clark-Casey: how about just money?
 [12:18] Justin Clark-Casey: A personal donation, perhaps? :)
 [12:18] Mircea Kitsune: yeah. I cant even read 5 pages cuz my head starts to spin >.> I guess its harder then itought. my idea falls then
 [12:18] You: Yea thats what he originally wanted to do
 [12:18] You: but we really have no structure in place for acccepting donations
 [12:19] Kurt Stringer: Mircea - without knowing namespaces, classes and instances, it would be very confusing
 [12:19] Mircea Kitsune: yeah
 [12:19] You: i just thought it was funny he made a bunch of excuses why he probably couldnt donate the website
 [12:19] You: lol
 [12:19] Kurt Stringer: once you get that part understood, it will make better sense
 [12:19] Justin Clark-Casey: yeah, sounds like a straight no would have been better :)
 [12:20] Chris D: RL calls, must go. Bye all.
 [12:20] Mircea Kitsune: later
 [12:20] Justin Clark-Casey: bye chrisd
 [12:20] You: yea mainly he reason was is because it was written in Cold Fusion and no one would know how to use it
 [12:20] You: then the next was becasue they use ODBC to tie to database
 [12:20] You: lol
 [12:21] Justin Clark-Casey: right, time for me to go too I think
 [12:21] Justin Clark-Casey: see you all later
 [12:21] You: ok i'll post up the log to the website
 [12:21] You: not that anyone really missed much
 [12:21] Justin Clark-Casey: excellent
 [12:21] You: but i will anyway
 [12:21] Neas Bade: yeh, I'm emerging packages on this power box to get opensim up there
 [12:21] Justin Clark-Casey: I think we've missed a few logs recently
 [12:21] Mircea Kitsune: yups.. same here im aadraid. i want to stay too but its getting late and i must finish the daily things for this hour
 [12:22] Justin Clark-Casey: trying to remember but I keep quitting the client before I do
 [12:22] You: alrighty talk soon everyone

[[Category:Chat Logs]]

PhysicsEngines

2008-01-24T05:56:42Z

Krisbfunk: /* Compiling ODE from source (Linux) */

There are several physics engines available for use in OpenSim. Currently, they are "basicphysics", "OpenDynamicsEngine", "RealPhysX" & "BulletX" (modified version). The plugin "basicphysics" is the default and can be seen in the <tt>OpenSim.ini</tt> file.

* When starting OpenSim in either Windows or Linux, one can add <tt>-physics=OpenDynamicsEngine</tt> to run the OpenDynamicsEngine (ODE) instead of basicphysics, or change the corresponding parameter in <tt>OpenSim.ini</tt>.

* When starting OpenSim in Windows, one can add <tt>-physics=RealPhysX</tt> if one has the appropriate DLL's which are not shipped with OpenSim due to license constraints.

* When starting OpenSim in either Windows or Linux, one can add <tt>-physics=modified_BulletX</tt> to run a modified version of the BulletX Physics Engine aka ''Modified BulletX''. See the next [[PhysicsEngines#Modified BulletX|information]] about details and progress.

To conclude, basicphysics & OpenDynamicsEngine both are appropriate for Linux and in addition, RealPhysX is appropriate as an option for Windows if the supporting DLL's are available. Modified BulletX should be fine for Windows and Linux (not the original BulletX).

As of 10/9/07, ODE has received the bulk of testing. It supports basic collision with box-shaped primitives as well as box prims with box-shaped hollows. Bullet supports box-shaped prims and appears stable; there has been little testing yet, and it is known to have issues with friction (you skate around on non-level surfaces). Physx has not been updated in quite a while.

== Compiling ODE from source (Linux) ==
If you want to compile the OpenDynamicsEngine (ODE) by yourself, get the latest OpenSim libraries source code (Ver. 0.9 as of Oct '07) from the SVN: http://opensimulator.org/svn/opensim-lib & switch to the ode(trunk\unmanaged\OpenDynamicsEngine) directory

svn co http://opensimulator.org/svn/opensim-libs/trunk opensim-libs
cd opensim-libs/unmanaged/OpenDynamicsEngine/

and compile it as follows:

./configure --enable-shared
make -k

(I used to suggest --with-trimesh=gimpact, but no longer. As of ODE 0.9, Opcode is the preferred and best-supported collision library)

This should create a <tt>libode.a</tt> and <tt>lidode.so</tt> file in the <tt>src/ode</tt> subdirectory. Copy these two files to the opensim <tt>bin</tt> directory (after having backed up the original files there). [er, I don't think the .a file is necessary to put in bin!]

== Compiling ODE from source (Windows) ==

the standard distribution has a build directory, in which you will find subdirs for several Microsoft compilers.

The standard .sln files (at least for VS2005) compile ode.dll such that it depends on at least two Microsoft runtime dll's. This can cause failure and confusion, so do the following:
Right-click on ode in Solution Explorer, and select properties.
under Configuration Properties/General, change "Use of MFC" to read "Use MFC in a Static Library"

then compile as usual.

== ODE Plugin in OpenSim ==
Currently, the ODE Plugin suports collisions Av2Av, Av2Prim and Prim2Prim. Avies and (active)physical prim movement supported.

The currently collision behavior is:
* For avies, a capsule of .2m of radius and a length of .9m and 50Kg of mass
* For prims, like a Box with a mass of a Box of = 0.5Kg/l = 0.5Kg/dm3 = 500Kg/m3.

* Prim are separated into ~30m spaces with their own bounding box to speed 'near' calculation.

* friction is reduced on avatar to object/ground collisions when the avatar is moving

=== To-do list (next changes) ===
* Tune all collisions
* Introduce Prim Shape Type to have more than the box shape using the Meshmerizer tri-mesh generator
* Fix bugs
* Implement ''grab and throw''
* Linksets
* Vehicles

==== Known bugs ====
* Linkset + Physical/Active are not working: ''Making a linkset physical, leaves the geometries of it's child prim where they are.. even if the root prim moves.''
* Grab is treated like 'move': ''dragging a prim into another prim causes it to interpenetrate instead of bounce against it..''
* Certain distributions of Debian utilize 100% of the CPU while running the ODEPlugin.
* A really tiny timestep. 0.005

==== Recent changes ====
* Avatar height gets gets translated to ODE
* 30m Space separation for prim.

== BulletX Plugin in OpenSim: Modified BulletX ==
BulletX Plugin in OpenSim runs the modified version of BulletX. The original version of BulletX runs under and has code-dependencies with MS.XNA. The orginal BulletX can be found at [http://www.codeplex.com/xnadevru XNADev.ru]. The modified version removes all code dependencies with MS.XNA. On the other hand, it needs another library to work. This library is based on Mono.Xna and it's called MonoCompactMaths. The modified BulletX and the MonoXnaCompactMaths can be found on the svn of OpenSim. Because its code independency of MS.XNA, the modified BulletX should can be run under either MS.Net or Mono and, therefore, either Windows or Linux (obviously you can combine Windows + Mono)

Currently, BulletX Plugin suports collisions Av2Av, Av2Prim and Prim2Prim. Prims and avies movement supported. By the way, collisions needs tunning. The currently collision's behavoir are:
* For avies, like and sphere of 1m of radious and 50Kg of mass
* For prims, like a Box of the prim-size and a mass that it depends of its sizes. The mass it's the mass of Box of water with density = 1Kg/l = 1Kg/dm3 = 1000Kg/m3 (Be water my friend! :D).

=== To-do list (next changes) ===
* Tune collision
* Introduce Prim Shape Type to have more than the box shape.
* More than 1 region in a Sim and then more than 1 sim (grid)
* Fix bugs
==== Known bugs ====
* Icy bug: ''an avatar acts like it is on ice and tends to drift off the edge of the sim after a while''
* Crash on BulletX. You will find the next message in console sometimes: ''Overflow in AABB, object removed from simulation If you can reproduce this, please email bugs@continuousphysics.com Please include above information, your Platform, version of OS. Thanks.''
* <del>Rotation doesn't seem to work</del> 

== POS Plugin in OpenSim ==
POS is Physics Of Simplicity. It is BasicPhysics with collisions.

I took out my old wiki stuff because it was just plain wrong. The algorithm which is implemented in POS does not model the avatar as a sphere; rather, it models it as a rectilinear solid, same as the prims. However, collision detection is always done in the rotational frame of the prim, so depending on which prim you check against, the avatar is actually oriented differently.

=== To-do list (next changes) ===
* TODO

==== Known bugs ====
* TODO

== Physics Testing Videos ==

===ODE===
* 360 Physical Prims (Sim Crashes) [11/08/2007 rev.2308] 
QuickTime > http://www.nebadonizumi.com/vid/opensim/opensim_ODE_physics_test_01.mov
Stage6 > http://stage6.divx.com/user/3dlibre/video/1847652/
YouTube > http://www.youtube.com/watch?v=Y0olsWlTc0A
* 180 Physical Prims (Sim Does Not Crash) [11/08/2007 rev.2308] 
QuickTime > http://www.nebadonizumi.com/vid/opensim/opensim_ODE_physics_test_02.mov
Stage6 > http://stage6.divx.com/user/3dlibre/video/1847715/
YouTube > http://www.youtube.com/watch?v=9lR_2H7VODU
* 90 Physical Prims (Sim Does Not Crash) [11/08/2007 rev.2308] 
Quicktime > http://www.nebadonizumi.com/vid/opensim/opensim_ODE_physics_test_03.mov
Stage6 > http://stage6.divx.com/user/3dlibre/video/1847731/
YouTube > http://www.youtube.com/watch?v=t9ulYO8I26Q

===BulletX===
* 360 Physical Prims (Sim Crashes) [11/08/2007 rev.2308] 
QuickTime > http://www.nebadonizumi.com/vid/opensim/opensim_BulletX_physics_test_01.mov
Stage6 > http://stage6.divx.com/user/3dlibre/video/1847745/
* 180 Physical Prims (Sim Crashes) [11/08/2007 rev.2308] 
QuickTime > http://www.nebadonizumi.com/vid/opensim/opensim_BulletX_physics_test_02.mov
* 90 Physical Prims (Sim Crashes) [11/08/2007 rev.2308] 
QuickTime > http://www.nebadonizumi.com/vid/opensim/opensim_BulletX_physics_test_03.mov

===Second Life Havok 1===
* 360 Physical Prims [11/08/2007] 
http://www.nebadonizumi.com/vid/opensim/SecondLife_physics_test_01.mov

===Second Life Havok 4===
* 360 Physical Prims [11/08/2007] 
http://www.nebadonizumi.com/vid/opensim/SecondLifeBetaHavok_physics_test_01.mov
* 1000 Physical Prims [11/09/2007] 
http://www.nebadonizumi.com/vid/opensim/SecondLifeBetaHavok_physics_test_02.mov
* 1000 Physical Prims [11/09/2007] 
http://www.nebadonizumi.com/vid/opensim/SecondLifeBetaHavok_physics_test_03.mov
[[Category:Development]]

User:Krisbfunk

2008-01-16T20:04:49Z

Krisbfunk: New page: Currently working on an educational project which partly involves OpenSim.

Currently working on an educational project which partly involves OpenSim.

Development Team

2008-01-15T18:38:36Z

Krisbfunk: /* Additional Developers/Testers/Contributors */

== OpenSim Core Developers ==
These people have commit access to our central SVN server and are regular contributors to the codebase.

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

<table border="1" cellpadding="2" cellspacing="0">
<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:MW|MW]]</td>
<td>Michael Wright</td>
<td>Wright Juran</td>
<td></td>
<td>+0</td>
<td> </td>
<td>everything</td>
</tr>
<tr>
<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>[[User:MingChen|MingChen]]</td>
<td> </td>
<td> </td>
<td></td>
<td>-6</td>
<td>DeepThink Pty Ltd</td>
<td> </td>
</tr>
<tr>
<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>[[User:SeanDague|sdague]]</td>
<td>Sean Dague</td>
<td>Neas Bade</td>
<td></td>
<td>-5</td>
<td>IBM</td>
<td>Database, Linux</td>
</tr>
<tr>
<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>[[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>[[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>[[User:dalien|dalien]]</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </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>Tleiades</td>
<td> </td>
<td>Tleiades Hax</td>
<td></td>
<td>+1</td>
<td> </td>
<td>Grid servers/Database</td>
</tr>
<tr>
<td>cfk</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>[[User:chi11ken|chi11ken]]</td>
<td>Jeff Ames</td>
<td>Chillken Proto</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td> </td>
</tr>
<tr>
<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>[[User:adjohn|adjohn]]</td>
<td>Adam Johnson</td>
<td>Zeuz Zenovka</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td> </td>
</tr>
<tr>
<td>[[User:joha1|joha1]]</td>
<td>Johan Berntsson</td>
<td>N/A</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td>Performance, packet handling/libSL</td>
</tr>
<tr>
<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>[[User:Justincc|Justincc]]</td>
<td>Justin Clark-Casey</td>
<td>Lulworth Beaumont</td>
<td>Justin Clark-Casey (osgrid)</td>
<td>+0</td>
<td>IBM</td>
<td>Inventory (avatar and object), Grid, A working sim.</td>
</tr>
<tr>
<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>
</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></td>
<td>Nebadon Izumi</td>
<td></td>
<td>-8</td>
<td></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>Gareth</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </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: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> </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 Beta (DeepGrid)</td>
<td>+0</td>
<td>AIAI, University of Edinburgh http://www.aiai.ed.ac.uk/~ai/</td>
<td>Windows Vista tests</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>MaltosSosa</td>
<td>Maltos Sosa</td>
<td>Maltos Sosa </td>
<td>Maltos Sosa (Central Grid)</td>
<td> </td>
<td>Central Grid</td>
<td>Project Manager, Grid Maintainer, Grid Connections</td>
</tr>

<tr>
<td>granger07</td>
<td>Granger Underwood</td>
<td>Granger Underwood
 </td>
<td></td>
<td> </td>
<td>Central Grid</td>
<td>Tester</td>
</tr>

<tr>
<td>[[User:TayB|TayB]]</td>
<td>Earl B</td>
<td>Taylor Boyau</td>
<td></td>
<td>-10</td>
<td>Vizi</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:Derek|Derek]]</td>
<td>Derek Tang</td>
<td>Derek Timeless</td>
<td></td>
<td>+8</td>
<td>http://opensimulator.org.cn</td>
<td>Running a public WINDOWS sim for testing, Docs, Helping Chinese users, Building Chinese opensim communities, watching</td>
</tr>
<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, translating the OpenSim Wiki into German and 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>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></td>
<td>GMT+1</td>
<td>.NET MCAD Dev/Arch/Trainer</td>
<td>Trying to get into OpenSim code for now. Particularly interrested in data persistence.</td>
</tr>
<tr>
<td>[[daTwitch]]</td>
<td>James G. Stallings II</td>
<td> Lazarus Longstaff</td>
<td>Hiro Protagonist (OSGrid) Takeshi Takahashi (OpenLife)</td>
<td>-5</td>
<td>House Husband</td>
<td>Testing everything to the limits I possibly can 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>Educational mashup, RIA, scripting, intranet, linux, networking</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</td>
<td>Edactive Technologies Nocturnal Eye Productions UPEI</td>
<td>Currently: Testing, bug reports, wiki updating.</td>
</tr>

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

Development Team

2008-01-15T18:33:50Z

Krisbfunk: /* Additional Developers/Testers/Contributors */

== OpenSim Core Developers ==
These people have commit access to our central SVN server and are regular contributors to the codebase.

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

<table border="1" cellpadding="2" cellspacing="0">
<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:MW|MW]]</td>
<td>Michael Wright</td>
<td>Wright Juran</td>
<td></td>
<td>+0</td>
<td> </td>
<td>everything</td>
</tr>
<tr>
<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>[[User:MingChen|MingChen]]</td>
<td> </td>
<td> </td>
<td></td>
<td>-6</td>
<td>DeepThink Pty Ltd</td>
<td> </td>
</tr>
<tr>
<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>[[User:SeanDague|sdague]]</td>
<td>Sean Dague</td>
<td>Neas Bade</td>
<td></td>
<td>-5</td>
<td>IBM</td>
<td>Database, Linux</td>
</tr>
<tr>
<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>[[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>[[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>[[User:dalien|dalien]]</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </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>Tleiades</td>
<td> </td>
<td>Tleiades Hax</td>
<td></td>
<td>+1</td>
<td> </td>
<td>Grid servers/Database</td>
</tr>
<tr>
<td>cfk</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>[[User:chi11ken|chi11ken]]</td>
<td>Jeff Ames</td>
<td>Chillken Proto</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td> </td>
</tr>
<tr>
<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>[[User:adjohn|adjohn]]</td>
<td>Adam Johnson</td>
<td>Zeuz Zenovka</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td> </td>
</tr>
<tr>
<td>[[User:joha1|joha1]]</td>
<td>Johan Berntsson</td>
<td>N/A</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td>Performance, packet handling/libSL</td>
</tr>
<tr>
<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>[[User:Justincc|Justincc]]</td>
<td>Justin Clark-Casey</td>
<td>Lulworth Beaumont</td>
<td>Justin Clark-Casey (osgrid)</td>
<td>+0</td>
<td>IBM</td>
<td>Inventory (avatar and object), Grid, A working sim.</td>
</tr>
<tr>
<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>
</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></td>
<td>Nebadon Izumi</td>
<td></td>
<td>-8</td>
<td></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>Gareth</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </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: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> </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 Beta (DeepGrid)</td>
<td>+0</td>
<td>AIAI, University of Edinburgh http://www.aiai.ed.ac.uk/~ai/</td>
<td>Windows Vista tests</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>MaltosSosa</td>
<td>Maltos Sosa</td>
<td>Maltos Sosa </td>
<td>Maltos Sosa (Central Grid)</td>
<td> </td>
<td>Central Grid</td>
<td>Project Manager, Grid Maintainer, Grid Connections</td>
</tr>

<tr>
<td>granger07</td>
<td>Granger Underwood</td>
<td>Granger Underwood
 </td>
<td></td>
<td> </td>
<td>Central Grid</td>
<td>Tester</td>
</tr>

<tr>
<td>[[User:TayB|TayB]]</td>
<td>Earl B</td>
<td>Taylor Boyau</td>
<td></td>
<td>-10</td>
<td>Vizi</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:Derek|Derek]]</td>
<td>Derek Tang</td>
<td>Derek Timeless</td>
<td></td>
<td>+8</td>
<td>http://opensimulator.org.cn</td>
<td>Running a public WINDOWS sim for testing, Docs, Helping Chinese users, Building Chinese opensim communities, watching</td>
</tr>
<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, translating the OpenSim Wiki into German and 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>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></td>
<td>GMT+1</td>
<td>.NET MCAD Dev/Arch/Trainer</td>
<td>Trying to get into OpenSim code for now. Particularly interrested in data persistence.</td>
</tr>
<tr>
<td>[[daTwitch]]</td>
<td>James G. Stallings II</td>
<td> Lazarus Longstaff</td>
<td>Hiro Protagonist (OSGrid) Takeshi Takahashi (OpenLife)</td>
<td>-5</td>
<td>House Husband</td>
<td>Testing everything to the limits I possibly can 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>Educational mashup, RIA, scripting, intranet, linux, networking</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 Bulman(OSGrid)</td>
<td>PE, Canada</td>
<td>Edactive Technologies Nocturnal Eye Productions UPEI</td>
<td>Currently: Testing, bug reports, wiki updating.</td>
</tr>

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

Development Team

2008-01-15T18:27:54Z

Krisbfunk:

== OpenSim Core Developers ==
These people have commit access to our central SVN server and are regular contributors to the codebase.

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

<table border="1" cellpadding="2" cellspacing="0">
<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:MW|MW]]</td>
<td>Michael Wright</td>
<td>Wright Juran</td>
<td></td>
<td>+0</td>
<td> </td>
<td>everything</td>
</tr>
<tr>
<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>[[User:MingChen|MingChen]]</td>
<td> </td>
<td> </td>
<td></td>
<td>-6</td>
<td>DeepThink Pty Ltd</td>
<td> </td>
</tr>
<tr>
<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>[[User:SeanDague|sdague]]</td>
<td>Sean Dague</td>
<td>Neas Bade</td>
<td></td>
<td>-5</td>
<td>IBM</td>
<td>Database, Linux</td>
</tr>
<tr>
<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>[[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>[[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>[[User:dalien|dalien]]</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </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>Tleiades</td>
<td> </td>
<td>Tleiades Hax</td>
<td></td>
<td>+1</td>
<td> </td>
<td>Grid servers/Database</td>
</tr>
<tr>
<td>cfk</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>[[User:chi11ken|chi11ken]]</td>
<td>Jeff Ames</td>
<td>Chillken Proto</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td> </td>
</tr>
<tr>
<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>[[User:adjohn|adjohn]]</td>
<td>Adam Johnson</td>
<td>Zeuz Zenovka</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td> </td>
</tr>
<tr>
<td>[[User:joha1|joha1]]</td>
<td>Johan Berntsson</td>
<td>N/A</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td>Performance, packet handling/libSL</td>
</tr>
<tr>
<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>[[User:Justincc|Justincc]]</td>
<td>Justin Clark-Casey</td>
<td>Lulworth Beaumont</td>
<td>Justin Clark-Casey (osgrid)</td>
<td>+0</td>
<td>IBM</td>
<td>Inventory (avatar and object), Grid, A working sim.</td>
</tr>
<tr>
<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>
</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></td>
<td>Nebadon Izumi</td>
<td></td>
<td>-8</td>
<td></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>Gareth</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </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: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> </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 Beta (DeepGrid)</td>
<td>+0</td>
<td>AIAI, University of Edinburgh http://www.aiai.ed.ac.uk/~ai/</td>
<td>Windows Vista tests</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>MaltosSosa</td>
<td>Maltos Sosa</td>
<td>Maltos Sosa </td>
<td>Maltos Sosa (Central Grid)</td>
<td> </td>
<td>Central Grid</td>
<td>Project Manager, Grid Maintainer, Grid Connections</td>
</tr>

<tr>
<td>granger07</td>
<td>Granger Underwood</td>
<td>Granger Underwood
 </td>
<td></td>
<td> </td>
<td>Central Grid</td>
<td>Tester</td>
</tr>

<tr>
<td>[[User:TayB|TayB]]</td>
<td>Earl B</td>
<td>Taylor Boyau</td>
<td></td>
<td>-10</td>
<td>Vizi</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:Derek|Derek]]</td>
<td>Derek Tang</td>
<td>Derek Timeless</td>
<td></td>
<td>+8</td>
<td>http://opensimulator.org.cn</td>
<td>Running a public WINDOWS sim for testing, Docs, Helping Chinese users, Building Chinese opensim communities, watching</td>
</tr>
<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, translating the OpenSim Wiki into German and 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>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></td>
<td>GMT+1</td>
<td>.NET MCAD Dev/Arch/Trainer</td>
<td>Trying to get into OpenSim code for now. Particularly interrested in data persistence.</td>
</tr>
<tr>
<td>[[daTwitch]]</td>
<td>James G. Stallings II</td>
<td> Lazarus Longstaff</td>
<td>Hiro Protagonist (OSGrid) Takeshi Takahashi (OpenLife)</td>
<td>-5</td>
<td>House Husband</td>
<td>Testing everything to the limits I possibly can 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>Educational mashup, RIA, scripting, intranet, linux, networking</td>
</tr>

<tr>
<td>[[User:Burnman|Burnman]]</td>
<td>Allen Wilkins</td>
<td> </td>
<td> </td>
<td> </td>
<td> </td>
<td> </td>
</tr>

<tr>
<td>[[User:krisbfunk|krisbfunk]]</td>
<td>Kris Bulman</td>
<td>krisbfunk Vought</td>
<td>krisbfunk Bulman(OSGrid)</td>
<td>PE, Canada</td>
<td>Edactive Technologies Nocturnal Eye Productions UPEI</td>
<td>Currently: Testing, bug reports, wiki updating.</td>
</tr>

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

Development Team

2008-01-15T18:16:39Z

Krisbfunk: /* Additional Developers/Testers/Contributors */

== OpenSim Core Developers ==
These people have commit access to our central SVN server and are regular contributors to the codebase.

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

<table border="1" cellpadding="2" cellspacing="0">
<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:MW|MW]]</td>
<td>Michael Wright</td>
<td>Wright Juran</td>
<td></td>
<td>+0</td>
<td> </td>
<td>everything</td>
</tr>
<tr>
<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>[[User:MingChen|MingChen]]</td>
<td> </td>
<td> </td>
<td></td>
<td>-6</td>
<td>DeepThink Pty Ltd</td>
<td> </td>
</tr>
<tr>
<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>[[User:SeanDague|sdague]]</td>
<td>Sean Dague</td>
<td>Neas Bade</td>
<td></td>
<td>-5</td>
<td>IBM</td>
<td>Database, Linux</td>
</tr>
<tr>
<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>[[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>[[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>[[User:dalien|dalien]]</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </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>Tleiades</td>
<td> </td>
<td>Tleiades Hax</td>
<td></td>
<td>+1</td>
<td> </td>
<td>Grid servers/Database</td>
</tr>
<tr>
<td>cfk</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>[[User:chi11ken|chi11ken]]</td>
<td>Jeff Ames</td>
<td>Chillken Proto</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td> </td>
</tr>
<tr>
<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>[[User:adjohn|adjohn]]</td>
<td>Adam Johnson</td>
<td>Zeuz Zenovka</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td> </td>
</tr>
<tr>
<td>[[User:joha1|joha1]]</td>
<td>Johan Berntsson</td>
<td>N/A</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td>Performance, packet handling/libSL</td>
</tr>
<tr>
<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>[[User:Justincc|Justincc]]</td>
<td>Justin Clark-Casey</td>
<td>Lulworth Beaumont</td>
<td>Justin Clark-Casey (osgrid)</td>
<td>+0</td>
<td>IBM</td>
<td>Inventory (avatar and object), Grid, A working sim.</td>
</tr>
<tr>
<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>
</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></td>
<td>Nebadon Izumi</td>
<td></td>
<td>-8</td>
<td></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>Gareth</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </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: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> </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 Beta (DeepGrid)</td>
<td>+0</td>
<td>AIAI, University of Edinburgh http://www.aiai.ed.ac.uk/~ai/</td>
<td>Windows Vista tests</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>MaltosSosa</td>
<td>Maltos Sosa</td>
<td>Maltos Sosa </td>
<td>Maltos Sosa (Central Grid)</td>
<td> </td>
<td>Central Grid</td>
<td>Project Manager, Grid Maintainer, Grid Connections</td>
</tr>

<tr>
<td>granger07</td>
<td>Granger Underwood</td>
<td>Granger Underwood
 </td>
<td></td>
<td> </td>
<td>Central Grid</td>
<td>Tester</td>
</tr>

<tr>
<td>[[User:TayB|TayB]]</td>
<td>Earl B</td>
<td>Taylor Boyau</td>
<td></td>
<td>-10</td>
<td>Vizi</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:Derek|Derek]]</td>
<td>Derek Tang</td>
<td>Derek Timeless</td>
<td></td>
<td>+8</td>
<td>http://opensimulator.org.cn</td>
<td>Running a public WINDOWS sim for testing, Docs, Helping Chinese users, Building Chinese opensim communities, watching</td>
</tr>
<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, translating the OpenSim Wiki into German and 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>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></td>
<td>GMT+1</td>
<td>.NET MCAD Dev/Arch/Trainer</td>
<td>Trying to get into OpenSim code for now. Particularly interrested in data persistence.</td>
</tr>
<tr>
<td>[[daTwitch]]</td>
<td>James G. Stallings II</td>
<td> Lazarus Longstaff</td>
<td>Hiro Protagonist (OSGrid) Takeshi Takahashi (OpenLife)</td>
<td>-5</td>
<td>House Husband</td>
<td>Testing everything to the limits I possibly can 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>Educational mashup, RIA, scripting, intranet, linux, networking</td>
</tr>

<tr>
<td>[[User:Burnman|Burnman]]</td>
<td>Allen Wilkins</td>
<td> </td>
<td> </td>
<td> </td>
<td> </td>
<td> </td>
</tr>

<tr>
<td>[[User:krisbfunk|krisbfunk]]</td>
<td>Kris Bulman</td>
<td>krisbfunk Vought</td>
<td>krisbfunk Bulman(OSGrid)</td>
<td>PE, Canada</td>
<td>Edactive Technologies Nocturnal Eye Productions UPEI</td>
<td>Currently: Testing, bug reports, wiki updating.</td>
</tr>

</table>
[[Category:Main]]

Development Team

2008-01-15T18:14:38Z

Krisbfunk: /* Additional Developers/Testers/Contributors */

== OpenSim Core Developers ==
These people have commit access to our central SVN server and are regular contributors to the codebase.

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

<table border="1" cellpadding="2" cellspacing="0">
<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:MW|MW]]</td>
<td>Michael Wright</td>
<td>Wright Juran</td>
<td></td>
<td>+0</td>
<td> </td>
<td>everything</td>
</tr>
<tr>
<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>[[User:MingChen|MingChen]]</td>
<td> </td>
<td> </td>
<td></td>
<td>-6</td>
<td>DeepThink Pty Ltd</td>
<td> </td>
</tr>
<tr>
<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>[[User:SeanDague|sdague]]</td>
<td>Sean Dague</td>
<td>Neas Bade</td>
<td></td>
<td>-5</td>
<td>IBM</td>
<td>Database, Linux</td>
</tr>
<tr>
<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>[[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>[[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>[[User:dalien|dalien]]</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </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>Tleiades</td>
<td> </td>
<td>Tleiades Hax</td>
<td></td>
<td>+1</td>
<td> </td>
<td>Grid servers/Database</td>
</tr>
<tr>
<td>cfk</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>[[User:chi11ken|chi11ken]]</td>
<td>Jeff Ames</td>
<td>Chillken Proto</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td> </td>
</tr>
<tr>
<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>[[User:adjohn|adjohn]]</td>
<td>Adam Johnson</td>
<td>Zeuz Zenovka</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td> </td>
</tr>
<tr>
<td>[[User:joha1|joha1]]</td>
<td>Johan Berntsson</td>
<td>N/A</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td>Performance, packet handling/libSL</td>
</tr>
<tr>
<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>[[User:Justincc|Justincc]]</td>
<td>Justin Clark-Casey</td>
<td>Lulworth Beaumont</td>
<td>Justin Clark-Casey (osgrid)</td>
<td>+0</td>
<td>IBM</td>
<td>Inventory (avatar and object), Grid, A working sim.</td>
</tr>
<tr>
<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>
</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></td>
<td>Nebadon Izumi</td>
<td></td>
<td>-8</td>
<td></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>Gareth</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </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: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> </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 Beta (DeepGrid)</td>
<td>+0</td>
<td>AIAI, University of Edinburgh http://www.aiai.ed.ac.uk/~ai/</td>
<td>Windows Vista tests</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>MaltosSosa</td>
<td>Maltos Sosa</td>
<td>Maltos Sosa </td>
<td>Maltos Sosa (Central Grid)</td>
<td> </td>
<td>Central Grid</td>
<td>Project Manager, Grid Maintainer, Grid Connections</td>
</tr>

<tr>
<td>granger07</td>
<td>Granger Underwood</td>
<td>Granger Underwood
 </td>
<td></td>
<td> </td>
<td>Central Grid</td>
<td>Tester</td>
</tr>

<tr>
<td>[[User:TayB|TayB]]</td>
<td>Earl B</td>
<td>Taylor Boyau</td>
<td></td>
<td>-10</td>
<td>Vizi</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:Derek|Derek]]</td>
<td>Derek Tang</td>
<td>Derek Timeless</td>
<td></td>
<td>+8</td>
<td>http://opensimulator.org.cn</td>
<td>Running a public WINDOWS sim for testing, Docs, Helping Chinese users, Building Chinese opensim communities, watching</td>
</tr>
<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, translating the OpenSim Wiki into German and 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>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></td>
<td>GMT+1</td>
<td>.NET MCAD Dev/Arch/Trainer</td>
<td>Trying to get into OpenSim code for now. Particularly interrested in data persistence.</td>
</tr>
<tr>
<td>[[daTwitch]]</td>
<td>James G. Stallings II</td>
<td> Lazarus Longstaff</td>
<td>Hiro Protagonist (OSGrid) Takeshi Takahashi (OpenLife)</td>
<td>-5</td>
<td>House Husband</td>
<td>Testing everything to the limits I possibly can 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>Educational mashup, RIA, scripting, intranet, linux, networking</td>
</tr>

<tr>
<td>[[User:Burnman|Burnman]]</td>
<td>Allen Wilkins</td>
<td>krisbfunk Vought</td>
<td>krisbfunk Bulman(OSGrid)</td>
<td>PE, Canada</td>
<td>Edactive Technologies Nocturnal Eye Productions UPEI</td>
<td>Currently: Testing, bug reports, wiki updating.</td>
</tr>
</table>
[[Category:Main]]

Development Team

2008-01-15T18:13:33Z

Krisbfunk: /* Additional Developers/Testers/Contributors */

== OpenSim Core Developers ==
These people have commit access to our central SVN server and are regular contributors to the codebase.

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

<table border="1" cellpadding="2" cellspacing="0">
<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:MW|MW]]</td>
<td>Michael Wright</td>
<td>Wright Juran</td>
<td></td>
<td>+0</td>
<td> </td>
<td>everything</td>
</tr>
<tr>
<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>[[User:MingChen|MingChen]]</td>
<td> </td>
<td> </td>
<td></td>
<td>-6</td>
<td>DeepThink Pty Ltd</td>
<td> </td>
</tr>
<tr>
<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>[[User:SeanDague|sdague]]</td>
<td>Sean Dague</td>
<td>Neas Bade</td>
<td></td>
<td>-5</td>
<td>IBM</td>
<td>Database, Linux</td>
</tr>
<tr>
<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>[[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>[[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>[[User:dalien|dalien]]</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </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>Tleiades</td>
<td> </td>
<td>Tleiades Hax</td>
<td></td>
<td>+1</td>
<td> </td>
<td>Grid servers/Database</td>
</tr>
<tr>
<td>cfk</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>[[User:chi11ken|chi11ken]]</td>
<td>Jeff Ames</td>
<td>Chillken Proto</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td> </td>
</tr>
<tr>
<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>[[User:adjohn|adjohn]]</td>
<td>Adam Johnson</td>
<td>Zeuz Zenovka</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td> </td>
</tr>
<tr>
<td>[[User:joha1|joha1]]</td>
<td>Johan Berntsson</td>
<td>N/A</td>
<td></td>
<td>+9</td>
<td>3Di</td>
<td>Performance, packet handling/libSL</td>
</tr>
<tr>
<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>[[User:Justincc|Justincc]]</td>
<td>Justin Clark-Casey</td>
<td>Lulworth Beaumont</td>
<td>Justin Clark-Casey (osgrid)</td>
<td>+0</td>
<td>IBM</td>
<td>Inventory (avatar and object), Grid, A working sim.</td>
</tr>
<tr>
<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>
</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></td>
<td>Nebadon Izumi</td>
<td></td>
<td>-8</td>
<td></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>Gareth</td>
<td> </td>
<td> </td>
<td></td>
<td> </td>
<td> </td>
<td> </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: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> </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 Beta (DeepGrid)</td>
<td>+0</td>
<td>AIAI, University of Edinburgh http://www.aiai.ed.ac.uk/~ai/</td>
<td>Windows Vista tests</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>MaltosSosa</td>
<td>Maltos Sosa</td>
<td>Maltos Sosa </td>
<td>Maltos Sosa (Central Grid)</td>
<td> </td>
<td>Central Grid</td>
<td>Project Manager, Grid Maintainer, Grid Connections</td>
</tr>

<tr>
<td>granger07</td>
<td>Granger Underwood</td>
<td>Granger Underwood
 </td>
<td></td>
<td> </td>
<td>Central Grid</td>
<td>Tester</td>
</tr>

<tr>
<td>[[User:TayB|TayB]]</td>
<td>Earl B</td>
<td>Taylor Boyau</td>
<td></td>
<td>-10</td>
<td>Vizi</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:Derek|Derek]]</td>
<td>Derek Tang</td>
<td>Derek Timeless</td>
<td></td>
<td>+8</td>
<td>http://opensimulator.org.cn</td>
<td>Running a public WINDOWS sim for testing, Docs, Helping Chinese users, Building Chinese opensim communities, watching</td>
</tr>
<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, translating the OpenSim Wiki into German and 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>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></td>
<td>GMT+1</td>
<td>.NET MCAD Dev/Arch/Trainer</td>
<td>Trying to get into OpenSim code for now. Particularly interrested in data persistence.</td>
</tr>
<tr>
<td>[[daTwitch]]</td>
<td>James G. Stallings II</td>
<td> Lazarus Longstaff</td>
<td>Hiro Protagonist (OSGrid) Takeshi Takahashi (OpenLife)</td>
<td>-5</td>
<td>House Husband</td>
<td>Testing everything to the limits I possibly can 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>Educational mashup, RIA, scripting, intranet, linux, networking</td>
</tr>

<tr>
<td>[[User:Burnman|Burnman]]</td>
<td>Allen Wilkins</td>
<td>krisbfunk Vought</td>
<td>krisbfunk Bulman(OSGrid)</td>
<td>PE, Canada</td>
<td>Edactive Technologies UPEI Nocturnal Eye Productions</td>
<td>Testing, testing, and more testing! Getting familiar with the source, interested in all aspects of the project.</td>
</tr>
</table>
[[Category:Main]]

LSL OSSL Standards

2008-01-15T17:59:33Z

Krisbfunk:

POLICY PROPOSAL:
This document is a proposal for naming standards and is not yet active.

Base Syntax: osCategoryFunction()

=Naming=
Function should be clearly named & indicative of purpose, eg:

osSendAnnounce - Mediocre
osRegionAnnounce - Good
osRegionAnnouncement - Better

==Get/Set Functions==
Get/Set functions should be clearly named & use a common syntax for both Get and Set. In Get/Set examples, Get/Set are the first letters after 'os'.

Eg, llSetOffsetTexture and llTextureOffset are particularly good examples of how not to do it.

The Os() equivilent if they were to be created again should be something along the lines of

osGetTextureOffset()
osSetTextureOffset()

This could be complemented with:

osGetTextureURL()
osSetTextureURL()

etc.

==Category Examples==

* Region - region admin and region-wide scoped functions.
** osRegionAnnouncement()
** osRegionRestart()
* Permission - answers yes/no boolean questions as to whether the owner of the primitive, or the primitive has permission to do something.
** osGetPermissionEditLand()
* Texture - anything to do with textures on the primitive
** osGetTextureURL()
** osSetTextureText()
* Shape - anything to do with the primitives shape
** osSetShapePath()
** osSetShapePattern()
** osSetShapeColour()

etc.
[[Category:Development]]

LSL:PrimitiveParams

2008-01-15T17:58:29Z

Krisbfunk:

Here's some data to give you an idea of how 'taper' converts into PathScale for a 'box'

{| border="1"
! SL Client Edit UI Value !! LSL PrimitiveParams top_size !! PathScale
|-
| -1 || 2 || 0
|-
| -0,75 || 1,75 || 25
|-
| -0,25 || 1,25 || 75
|-
| 0 || 1 || 100
|-
| 0,75 || 0,25 || 175
|-
| 1 || 0 || 200
|}

(basically, PathScale is ((2-lsl) * 100)

Main Page

2008-01-15T17:56:43Z

Krisbfunk:

__NOTOC__
{|width="100%" style="padding-left:5px;"
|[[Image:possible360.gif|left|thumbnail|'''[[Alt_Logos|Submit Your Alt Logo]]''']]
|OpenSim is a BSD Licensed Open Source project to develop a functioning virtual worlds server platform capable of supporting multiple clients and servers in a heterogeneous grid structure. OpenSim is written in [http://www.ecma-international.org/publications/standards/Ecma-334.htm C#], and can run under [http://www.mono-project.com/Main_Page Mono] or the [http://www.microsoft.com/net/ Microsoft .NET] runtimes.

OpenSim is currently in the alpha development stage, with active testing of SVN trunk versions encouraged. Please read our [[Contributions_Policy]] before contributing, and to learn what OpenSim's values are.
|}
{|width="100%" valign="top" style="margin-left:auto;margin-right:auto;"
|{{Layout_box2|1=
{{Template:Getting Started}}
}}
|[[Image:opensim_avatar2.png|right]]
|}

== Participating in the OpenSim Community ==

OpenSim is an [http://en.wikipedia.org/wiki/Open_source open source] project. This means that it is developed by anyone who wants to participate. This could be you! We welcome testers and developers alike.
* [[Contributions Policy]] - Read about the contribution policy before contributing to the OpenSim project

===Getting online===
There are several public grids and several standalone arrays running 24/7. For the casual user as well as those who want to run their own public regions, there is a list of available sims at [[OpenSim: Grids]]. Most of these grids have representation on the #opensim chat channel for asking and answering questions.

While OpenSim is not affiliated with any one grid there are many prominent [[OpenSim: Grids|Grids]].

===Support===
IRC
* [[Development|IRC-Support]] - You can receive/give help via the IRC channels

Mailing lists

Various mailing lists are available for communication between users and developers. A list is available to subscribe to email SVN commit notifications.
* [https://lists.berlios.de/mailman/listinfo/opensim-users opensim-users] - a user support forum for OpenSim
* [https://lists.berlios.de/mailman/listinfo/opensim-dev opensim-dev] - development discussion of OpenSim
* [https://lists.berlios.de/mailman/listinfo/opensim-commits opensim-commits] - an email list for svn commits

== News ==

* Custom osFunction Ideas wanted
OpenSim's own scripting team is accepting ideas/requests/wishlists for custom functions. Have a look at [[LSL_osFunctions|the full list]] over here.

You can browse older news items [[News|at the news archive]].

== OpenSim Development ==
<div style="background:#FFF;float:right;width:600px;padding:2px;padding-top:0px;margin:3px;border:1px solid #CCC"><h3>[[Svn_extended | Recent SVN Commits]]</h3><rss>http://cia.vc/stats/project/opensim/.rss|max=2|title=none</rss></div>
The [[Development Team|OpenSim Team]] is currently working towards the 0.5 release of OpenSim. See the [[Roadmap]] for details.

For more information on OpenSim development and on how you can make your mark, check out the [[Development|development]] section.

=== Bugs ===
Please use the SecondLife official 1.18.5.3 client on Linux, Mac OS X, and Windows- third party viewers and modified viewers add more variables to a bug, making it harder to track down. The bug may not even be an OpenSim one! Make sure you use ''only'' the official client. See notes on configuring your client over at the [[Client Setup|client setup]] page.

You can report bugs at the [http://opensimulator.org/mantis/ Mantis bugtracker].

''Note:'' Some email providers are tagging Mantis emails as spam. If you sign up for a Mantis Account and don't get a confirmation email:
* Check your spam folder, see if it is there. GMail is consistently tagging these as spam.
* If you are using Yahoo, you'll need to wait ~ 8 hrs to receive any email from opensimulator.org.

==Wiki options==
Languages:[[OpenSimSpanish | Spanish]], [[OpenSimGerman | German]], [[fr | Francais]], [[OpenSimItalian | Italian]]

Wiki stats: Pages:{{NUMBEROFPAGES}} Edits:{{NUMBEROFEDITS}} Users:{{NUMBEROFUSERS}}
[[Category:Main]]
[[Category:Getting Started]]
[[Category:Development]]
[[Category:Office Hours]]

Using L3DT

2008-01-15T17:54:23Z

Krisbfunk:

== Quick intro on creating a terrain with L3DT==

To create a terrain for a single region:

1. Create a NEW MAP by clicking on that icon in the title bar. 
2. Highlight Design/Inflate, and click Next. 
3. Make the size X=4, y=4. This will give you a 256x256 terrain, the same size as a region. Click Next. 
4. Play with the sliders in the parameters window. You can just leave the defaults to start with. Click Next. 
5. Check Design Map, and click OK. 
6. Now click the CALC icon in the menu bar, then click OK. 
7. You now have your terrain. If you don't like it, start over and play with the settings. 
8. To save it: File=>Export=>Export Map. 
9. Highlight Heightfield, and then click OK. 
10. Choose File Format RAW, then click the Options button. 
11. Double click "Mode", and select "float (meters)", then click OK, and OK again. 
12. Name the file whatever you want, and click OK to save it. 
 
To load the terrain into opensim: 
 
Assume your file is called "terrain.raw".At the region console, type: 
 
terrain load f32 terrain.raw 
 
You now have your new terrain! You can at this point use the terrain add, terrain scale, or terrain multiply to rescale it to your liking.
[[Category:Getting Started]]

Network Settings

2008-01-15T17:51:26Z

Krisbfunk:

== Network settings ==

OpenSim/Grid can be pretty tricky when it comes to setting it up on a private network this document covers what OpenSim needs in terms of network resources.

== Ports used by OpenSim ==

OGS1 Grid Modes - Standard Port List

* TCP/8000 - Reserved
* TCP/8001 - Grid Server
* TCP/8002 - User Server and Login Services
* TCP/8003 - Asset Services
* TCP/8004 - Inventory Services
* TCP/8005 - Reserved (Dispatch Services)

== Simulators ==

* UDP+TCP/9000 - Default First Simulator
* UDP+TCP/9001 - Default Second Simulator
etc.

Note: If you use your simulator in standalone mode, it is enough to open the UDP+TCP/9000 on your firewall.

== Issues with NAT and Port Forwarding ==

If your host does not have a public IP address (eg it is hidden behind a home router) you will have issues hosting grid and region servers if you plan on connecting clients to it on both sides of the router, however this can be worked around through very careful application of port forwarding and use of DNS host files. Please note this is not guarunteed to work (and is most likely to fail), it is highly recommended to have a internet accessible public static IP for the server which is hosting the regions.

Method:
* Set the simulator listening IP address to your public facing IP address (that of the router concerned)
* Port forward the above ports through to the simulator on both UDP and TCP.
* Use an “ExternalAddress” of “somesimulator.somedomain.com” where you control the DNS for somedomain.com and can enter a “A Record” for ‘somesimulator.’ to your routers IP address.
* Create a “hosts” file (on windows, this is C:\Windows\System32\Drivers\etc\hosts and on Unix-type systems, this is /etc/hosts) entry on your internal client machines, for somesimulator.somedomain.com to your local LAN address for the simulator.

== A solution for local connections if you have a ZyXEL DSL modem/router with NAT and Port Forwarding ==

This solution works with the ZyXEL Prestige 660ME-61 DSL Router. It may work with other models made by ZyXEL.

Method:
* Connect by TELNET to your ZyXEL DSL modem. Use the same IP address that you would if you were using the web interface. For example, the default ip on most Embarq ZyXEL DSL modems is 192.168.2.1.

telnet 192.168.2.1

* Enter your password. If you do not know it, try just pressing <ENTER> or ask your ISP for the password. They may or may not give it to you.

* Select menu option "24. System Maintenance" from the menu.

Copyright (c) 1994 - 2004 ZyXEL Communications Corp.
Prestige 660ME-61 Main Menu
Getting Started Advanced Management
1. General Setup 21. Filter Set Configuration
2. WAN Backup Setup 22. SNMP Configuration
3. LAN Setup 23. System Password
4. Internet Access Setup 24. System Maintenance
25. IP Routing Policy Setup
Advanced Applications 26. Schedule Setup
11. Remote Node Setup
12. Static Routing Setup
15. NAT Setup 99. Exit
Enter Menu Selection Number:

* Select menu option "8. Command Interpreter Mode" from the menu

Menu 24 - System Maintenance
1. System Status
2. System Information and Console Port Speed
3. Log and Trace
4. Diagnostic
5. Backup Configuration
6. Restore Configuration
7. Upload Firmware
8. Command Interpreter Mode
9. Call Control
10. Time and Date Setting
11. Remote Management
Enter Menu Selection Number:

* At the prompt type "ip nat loopback on".

Copyright (c) 1994 - 2004 ZyXEL Communications Corp.
Sprint > ip nat loopback on

* At the prompt type "exit".

Sprint> exit

* Select menu option "99. Exit"

* Follow all other steps for configuring and starting your server as outlined in [http://opensimulator.org/wiki/Main_Page#Getting_Started_with_OpenSim Getting Started].

== A Solution for local connections if you have the DLink GamerLounge Extreme N router ==

Networking and router configurations have been responsible for 98% of all trouble I have had setting up and operating OpenSimulator region server software. Insuring that you have a capable router properly configured should be the first thing on the list of configuration checkpoints for a smooth and trouble-free path to OpenSimulator software operations in GridMode.

Below is a series of screen snapshots with the key pages of my router configuration interface with proper settings displayed.

The settings below assume that you have an otherwise working connection and do not touch on such subjects as port conflicts or logging your network onto your ISP's provider network.

== ** your status page should resemble this except for embedded site-specific details ** ==

[[Image:router config snapshot1.png]]

== ** Clicking the 'Advanced' tab, follwed by the 'Gaming' menu item, you should match what is shown here ** ==

[[Image:router config snapshot2.png]]

== ** Proceeding to Routing menu item, make sure it looks like this: ** ==

[[Image:router config snapshot3.png]]

== ** Now on to the firewall menu item ** ==

[[Image:router config snapshot4.png]]

== ** and lastly but equally important, the advanced network settings menu item ** ==

[[Image:router config snapshot5.png]]

* provided that all information supplied in ~opensim/bin/OpenSim.ini and in your ~opensim/Regions/*.xml are properly configured, this should have you up and running.

NOTE: Contrary to what is displayed above, DHCP services are not required to operate OpenSimulator server software.
[[Category:Configuration]]