OpenSimulator - User contributions [en]

RemoteAdmin

2008-07-28T01:41:06Z

BBen: /* Example in PHP */

<div style="background-color:#ffa0a0; padding:15px">
Caution ! The RemoteAdmin feature is unsecured at this time. For testing uses only.
</div>

== How to Setup the Remote Admin ==

=== Setup OpenSim ===

First you should enable the remote admin interface to do so just add the following lines to your OpenSim.ini file:

[RemoteAdmin]
enabled = true
access_password = secret

=== Example in Python ===
# Author : DrScofield
# Source : http://xyzzyxyzzy.net/2008/01/23/using-pythons-xmlrpclib-with-opensim/
# License : BSD License

#!/usr/bin/python
import xmlrpclib

# XML-RPC URL (http_listener_port)
gridServerURL = ‘http://127.0.0.1:9000′

# instantiate server object
gridServer = xmlrpclib.Server(gridServerURL)

# invoke admin_alert: requires password and message
gridServer.admin_broadcast({’password’: ’secret’, ‘message’: ‘the answer is 42′})

=== RemoteAdmin executable for Windows ===

The RemoteAdmin executable for Windows is a command line tool based on the RemoteAdmin PHP Class.

Downloads and documentation on the [http://lab.newworldgrid.com/index.php/RemoteAdmin_Executable RemoteAdmin Executable webpage]

=== Example in PHP ===

This example needs the RemoteAdmin PHP Class file available [http://code.google.com/p/opensimtools/wiki/RemoteAdminPHPClass here].

<pre>
<?php

// Author : Olish Newman
// Source : http://code.google.com/p/opensimtools/wiki/RemoteAdminPHPClass
// Licence : BSD License

// Including the RemoteAdmin PHP class. It can be downloaded from the link above.
include('RemoteAdmin.php');

// Instantiate the class with parameters identical to the Python example above
$myRemoteAdmin = new RemoteAdmin('127.0.0.1', 9000, 'secret');

// Invoke admin_broadcast
$parameters = array('message' => 'the answer is 42');
$myRemoteAdmin->SendCommand('admin_broadcast', $parameters);

// Invoke admin_shutdown (example for use without parameters)
$myRemoteAdmin->SendCommand('admin_shutdown');

// Invoke admin_create_user (multiple parameters)
$parameters = array('user_firstname' => 'Ruth', 'user_lastname' => 'OpenSim', 'user_password' => 'MyPassword', 'start_region_x' => '1000', 'start_region_y' => '1000');
$myRemoteAdmin->SendCommand('admin_create_user', $parameters);

?></pre>

Note: This script does not appear to work for create user because it tries to pass the start region x and y as a string when the RemoteAdmin needs a string. The class needs to be edited to pass it as a number or edit the remoteadmin source to convert the string to a unsigned int.

== RemoteAdmin Commands ==
<table border="1" cellspacing="0" cellpadding="4">
<tr>
<th>Name</th>
<th>Status</th>
<th>Description</th>
<th>Parameters</th>
</tr>
<tr>
<td>[[remoteadmin:admin_create_region | admin_create_region]]</td>
<td></td>
<td>Create a new region</td>
<td>region_name, region_master_first,
region_master_last, region_master_password, listen_ip, external_address</td>
</tr>
<tr>
<td>[[remoteadmin:admin_shutdown | admin_shutdown]]</td>
<td></td>
<td>Shut down the simulator</td>
<td>''No parameter needed''</td>
</tr>
<tr>
<td>[[remoteadmin:admin_broadcast| admin_broadcast]]</td>
<td></td>
<td>Send a general alert</td>
<td>message</td>
</tr>
<tr>
<td>[[remoteadmin:admin_restart| admin_restart]]</td>
<td></td>
<td>Restart Region</td>
<td>regionid</td>
</tr>
<tr>
<td>[[remoteadmin:admin_load_heightmap| admin_load_heightmap]]</td>
<td></td>
<td>Load Height Map...</td>
<td>filename, regionid</td>
</tr>
<tr>
<td>[[remoteadmin:admin_create_user| admin_create_user]]</td>
<td></td>
<td>Create a new user</td>
<td>user_firstname, user_lastname, user_password,
start_region_x, start_region_y</td>
</tr>
<tr>
<td>[[remoteadmin:admin_load_xml| admin_load_xml]]</td>
<td></td>
<td>Execute the Load XML command</td>
<td>filename</td>
</tr>
</table>

== Credits ==
Thanks to DrScofield for the Python Script
Sources : http://xyzzyxyzzy.net/2008/01/23/using-pythons-xmlrpclib-with-opensim/

[[Category:Development]]

FAQ

2008-07-27T21:53:30Z

BBen: /* In World Questions */

[[Category:Users]]
==About OpenSim==
===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.

==Configuring OpenSim==
First, read [[OpenSim Configuration]].
===Where can I get a new UUID for my sim config?===
* See [[OpenSim Configuration]]

===Duplicate "Lost And Found" folder?===
* A grid manager, from the mysql prompt may do:

select type from inventoryfolders where folderName="Lost And Found";
delete from inventoryfolders where foldername="Lost And Found" and type="3";

Per Justin's r4011 checkin, these two steps should delete "Lost And Found" duplicates of type 3 and leave any of type 13.

===Can I run multiple regions with OpenSim?===
* See [[OpenSim Configuration]]

===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?===
* See [[OpenSim Configuration]]

===SVN Support for Prims===
So far I tested it under Linux and I heard it crashes under XP. So this description is for Linux please feel free to add the windows description.
First install the apr pages (apt-get install or yum install)
*apr-util
*apr-devel
*apr

Then make symbolic links in your opensim bin directory
*svn_client-1 -> /usr/lib/libsvn_client-1.so.0
*libapr.so -> /usr/lib/libapr-1.so.0

Set up an SVN repository with
svnadmin create <directory>

Edit Opensim.ini
[SVN]
Enabled = true
Directory = sandbox01
URL = "file:///home/opensim/svn/01"
Username = "opensim"
Password = "********"
ImportOnStartup = false
Autosave = true
AutoSavePeriod = 15

===How to set the LandOwner===
Edit Regions/<regionfile> and set the AvatarName and AvatarUUID. Furthermore edit the SQL Database and set the OwnerUUID in the land table. When you are using SQLite use the sqlite3 tool.
sqlite3 Opensim.db
update land set OwnerUUID="AvatarUUID";

==Running OpenSim==

===I get a bunch of ERROR: There was an error while scanning assembly:... errors on startup, but OpenSim appears to run normally. Is this a problem?===
No. These errors are being put out by the third party plugin scanning code. As we have it scanning the entire bin/ directory, it picks up dlls which don't have the correct information to be scanned, and so puts out this error. Don't worry about it :)

For the record, the current set of errors are

ERROR: There was an error while scanning assembly: /home/caseyj/jc/it/v/virtual-worlds/second-life/servers/opensim/src/opensim-svn-minim/bin/PhysX-wrapper.dll (Could not load file or assembly '/home/caseyj/jc/it/v/virtual-worlds/second-life/servers/opensim/src/opensim-svn-minim/bin/PhysX-wrapper.dll' or one of its dependencies. An attempt was made to load a program with an incorrect format.)

ERROR: There was an error while scanning assembly: /home/caseyj/jc/it/v/virtual-worlds/second-life/servers/opensim/src/opensim-svn-minim/bin/ode-debug.dll (Could not load file or assembly '/home/caseyj/jc/it/v/virtual-worlds/second-life/servers/opensim/src/opensim-svn-minim/bin/ode-debug.dll' or one of its dependencies. An attempt was made to load a program with an incorrect format.)

ERROR: There was an error while scanning assembly: /home/caseyj/jc/it/v/virtual-worlds/second-life/servers/opensim/src/opensim-svn-minim/bin/ode.dll (Could not load file or assembly '/home/caseyj/jc/it/v/virtual-worlds/second-life/servers/opensim/src/opensim-svn-minim/bin/ode.dll' or one of its dependencies. An attempt was made to load a program with an incorrect format.)

ERROR: There was an error while scanning assembly: /home/caseyj/jc/it/v/virtual-worlds/second-life/servers/opensim/src/opensim-svn-minim/bin/openjpeg-libsl.dll (Could not load file or assembly '/home/caseyj/jc/it/v/virtual-worlds/second-life/servers/opensim/src/opensim-svn-minim/bin/openjpeg-libsl.dll' or one of its dependencies. An attempt was made to load a program with an incorrect format.)

ERROR: There was an error while scanning assembly: /home/caseyj/jc/it/v/virtual-worlds/second-life/servers/opensim/src/opensim-svn-minim/bin/sqlite3.dll (Could not load file or assembly '/home/caseyj/jc/it/v/virtual-worlds/second-life/servers/opensim/src/opensim-svn-minim/bin/sqlite3.dll' or one of its dependencies. An attempt was made to load a program with an incorrect format.)

===Errors about modules not found and RegionBanListItem could not be loaded===

This is caused if you upgrade from trunk through svn and copy new files in the same directory.
To solve these errors during the startup of opensim.exe remove the following files from your bin folder:

OpenSIm.DataStore.MSSQL.dll

OpenSIm.DataStore.MSSQL.dll.mdm

==OpenSim in the Wild==
===Are there test servers running OpenSim I can connect to?===
Yes. Check out our [[Grid List]]! There are 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.

==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".

===Why don't my terrain settings and prims don't stay through restarts?===
You haven't set it up to use a database. See [[OpenSim_Database_support|OpenSim Database support]] for info on how to set it up to use a database. (SqLite is the easiest of these to set up and should probably be used by anyone unfamiliar with any of the options).

==Grid Mode==
=== 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.

==region size==
=== region size is fixed 256*256, I found it to change the size larger is diffcult,because there are lots of magic number in codes.

[[Category:Users]]

Tips

2008-07-27T21:49:48Z

BBen: /* Making the server remember terrain, prims and other region storage changes after reboot */

[[Category:Users]]
==Terrain Tidbits==
===How can I flatten a region?===
When you have multiple regions, that you need to terraform to a certain height, the quickest way to do it is by selecting a region, and fill the terrain to the specified height:
change-region YourRegionName
script terrain fill 20

''Note:'' Remember to change to the region you wish to modify if that is the only region wish to make changes to. Without using the change-region command, you may very well end up flattening multiple regions!

As of SVN 4061
terrain fill 25

[[Category:Getting Started]]

=== 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), It is very important that you rename the file extension to .r32 for the import to properly work.
Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:
script terrain load-tile <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:
script terrain load-tile simalpha.r32 512 512 0 0
Next, before you log in, you may want to go to type in: *(THIS FUNCTION MAY NOT WORK)
script 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>script terrain load-tile ...</tt>" and "<tt>script terrain multiply ...</tt>" one per line.

*** Notice this method is no longer required and should be considered a legacy function, Terrain persistance is now working 100%.

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 (file extension now determines the format, use .r32 for L3DT terrains)

script terrain load <filename>

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

=== Other useless or useful 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

==General Setup Tricks==
=== Changing viewer start webpage in standalone mode ===

In order to change the page that the viewer starts in /opensim/bin/ there is a http_loginform.html.example page. Removing the .example will make this page be the start webpage which you can edit etc. Since the login html code is no longer needed this can be modified at will.

=== Making the server remember terrain, prims and other region storage changes after reboot ===
In order for the server to remember these things you must select a database to be used in the OpenSim.ini file. For more info on setting this up see [[OpenSim_Database_support]]. The easiest to set up is SqLite which has a guide on the linked page.

Tips

2008-07-27T21:40:52Z

BBen: /* Making the server remember terrain, prims and other region storage changes after reboot */

[[Category:Users]]
==Terrain Tidbits==
===How can I flatten a region?===
When you have multiple regions, that you need to terraform to a certain height, the quickest way to do it is by selecting a region, and fill the terrain to the specified height:
change-region YourRegionName
script terrain fill 20

''Note:'' Remember to change to the region you wish to modify if that is the only region wish to make changes to. Without using the change-region command, you may very well end up flattening multiple regions!

As of SVN 4061
terrain fill 25

[[Category:Getting Started]]

=== 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), It is very important that you rename the file extension to .r32 for the import to properly work.
Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:
script terrain load-tile <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:
script terrain load-tile simalpha.r32 512 512 0 0
Next, before you log in, you may want to go to type in: *(THIS FUNCTION MAY NOT WORK)
script 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>script terrain load-tile ...</tt>" and "<tt>script terrain multiply ...</tt>" one per line.

*** Notice this method is no longer required and should be considered a legacy function, Terrain persistance is now working 100%.

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 (file extension now determines the format, use .r32 for L3DT terrains)

script terrain load <filename>

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

=== Other useless or useful 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

==General Setup Tricks==
=== Changing viewer start webpage in standalone mode ===

In order to change the page that the viewer starts in /opensim/bin/ there is a http_loginform.html.example page. Removing the .example will make this page be the start webpage which you can edit etc. Since the login html code is no longer needed this can be modified at will.

=== Making the server remember terrain, prims and other region storage changes after reboot ===
First off you should copy the OpenSim.ini.example to be your OpenSim.ini file. This file has all the settings etc that you need to configure the server. The default has a default of storing to null which does not save anything. In order for terrain and prims to be remembered you must comment out --- storage_plugin = "OpenSim.Data.Null.dll" --- and uncomment one of the others. The easiest one requiring no extra setup is uncommenting --- storage_plugin = "OpenSim.Data.SQLite.dll"--- and make sure ---storage_connection_string="URI=file:OpenSim.db,version=3";--- is already un-commented as well. which will make storage work using sqlite. Other database types can be used. For more info on these see [[OpenSim_Database_support]].

Tips

2008-07-27T21:38:28Z

BBen: /* Making the server remember terrain, prims and other region storage changes after reboot */

[[Category:Users]]
==Terrain Tidbits==
===How can I flatten a region?===
When you have multiple regions, that you need to terraform to a certain height, the quickest way to do it is by selecting a region, and fill the terrain to the specified height:
change-region YourRegionName
script terrain fill 20

''Note:'' Remember to change to the region you wish to modify if that is the only region wish to make changes to. Without using the change-region command, you may very well end up flattening multiple regions!

As of SVN 4061
terrain fill 25

[[Category:Getting Started]]

=== 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), It is very important that you rename the file extension to .r32 for the import to properly work.
Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:
script terrain load-tile <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:
script terrain load-tile simalpha.r32 512 512 0 0
Next, before you log in, you may want to go to type in: *(THIS FUNCTION MAY NOT WORK)
script 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>script terrain load-tile ...</tt>" and "<tt>script terrain multiply ...</tt>" one per line.

*** Notice this method is no longer required and should be considered a legacy function, Terrain persistance is now working 100%.

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 (file extension now determines the format, use .r32 for L3DT terrains)

script terrain load <filename>

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

=== Other useless or useful 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

==General Setup Tricks==
=== Changing viewer start webpage in standalone mode ===

In order to change the page that the viewer starts in /opensim/bin/ there is a http_loginform.html.example page. Removing the .example will make this page be the start webpage which you can edit etc. Since the login html code is no longer needed this can be modified at will.

=== Making the server remember terrain, prims and other region storage changes after reboot ===
First off you should copy the OpenSim.ini.example to be your OpenSim.ini file. This file has all the settings etc that you need to configure the server. The default has a default of storing to null which does not save anything. In order for terrain and prims to be remembered you must comment out --- storage_plugin = "OpenSim.Data.Null.dll" --- and uncomment one of the others. The easiest one requiring no extra setup is uncommenting --- storage_plugin = "OpenSim.Data.SQLite.dll"--- and make sure ---storage_connection_string="URI=file:OpenSim.db,version=3";--- is already un-commented as well. which will make storage work using sqlite.

Tips

2008-07-27T21:34:36Z

BBen: /* Making the server remember terrain, prims and other region storage changes after reboot */

[[Category:Users]]
==Terrain Tidbits==
===How can I flatten a region?===
When you have multiple regions, that you need to terraform to a certain height, the quickest way to do it is by selecting a region, and fill the terrain to the specified height:
change-region YourRegionName
script terrain fill 20

''Note:'' Remember to change to the region you wish to modify if that is the only region wish to make changes to. Without using the change-region command, you may very well end up flattening multiple regions!

As of SVN 4061
terrain fill 25

[[Category:Getting Started]]

=== 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), It is very important that you rename the file extension to .r32 for the import to properly work.
Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:
script terrain load-tile <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:
script terrain load-tile simalpha.r32 512 512 0 0
Next, before you log in, you may want to go to type in: *(THIS FUNCTION MAY NOT WORK)
script 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>script terrain load-tile ...</tt>" and "<tt>script terrain multiply ...</tt>" one per line.

*** Notice this method is no longer required and should be considered a legacy function, Terrain persistance is now working 100%.

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 (file extension now determines the format, use .r32 for L3DT terrains)

script terrain load <filename>

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

=== Other useless or useful 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

==General Setup Tricks==
=== Changing viewer start webpage in standalone mode ===

In order to change the page that the viewer starts in /opensim/bin/ there is a http_loginform.html.example page. Removing the .example will make this page be the start webpage which you can edit etc. Since the login html code is no longer needed this can be modified at will.

=== Making the server remember terrain, prims and other region storage changes after reboot ===
First off you should copy the OpenSim.ini.example to be your OpenSim.ini file. This file has all the settings etc that you need to configure the server. The default has a default of storing to null which does not save anything. In order for terrain and prims to be remembered you must comment out --- storage_plugin = "OpenSim.Data.Null.dll" --- and uncomment one of the others. The easiest one requiring no extra setup is uncommenting --- storage_plugin = "OpenSim.Data.SQLite.dll"--- and ---storage_connection_string="URI=file:OpenSim.db,version=3";--- which will make storage work using sqlite.

Tips

2008-07-27T21:28:50Z

BBen: /* Making the server remember terrain, prims and other region storage changes after reboot */

[[Category:Users]]
==Terrain Tidbits==
===How can I flatten a region?===
When you have multiple regions, that you need to terraform to a certain height, the quickest way to do it is by selecting a region, and fill the terrain to the specified height:
change-region YourRegionName
script terrain fill 20

''Note:'' Remember to change to the region you wish to modify if that is the only region wish to make changes to. Without using the change-region command, you may very well end up flattening multiple regions!

As of SVN 4061
terrain fill 25

[[Category:Getting Started]]

=== 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), It is very important that you rename the file extension to .r32 for the import to properly work.
Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:
script terrain load-tile <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:
script terrain load-tile simalpha.r32 512 512 0 0
Next, before you log in, you may want to go to type in: *(THIS FUNCTION MAY NOT WORK)
script 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>script terrain load-tile ...</tt>" and "<tt>script terrain multiply ...</tt>" one per line.

*** Notice this method is no longer required and should be considered a legacy function, Terrain persistance is now working 100%.

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 (file extension now determines the format, use .r32 for L3DT terrains)

script terrain load <filename>

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

=== Other useless or useful 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

==General Setup Tricks==
=== Changing viewer start webpage in standalone mode ===

In order to change the page that the viewer starts in /opensim/bin/ there is a http_loginform.html.example page. Removing the .example will make this page be the start webpage which you can edit etc. Since the login html code is no longer needed this can be modified at will.

=== Making the server remember terrain, prims and other region storage changes after reboot ===
First off you should copy the OpenSim.ini.example to be your OpenSim.ini file. This file has all the settings etc that you need to configure the server. The default has a default of storing to null which does not save anything. In order for terrain and prims to be remembered you must comment out --- storage_plugin = "OpenSim.Data.Null.dll" --- and uncomment one of the others. The easiest one requiring no extra setup is --- storage_plugin = "OpenSim.Data.SQLite.dll"--- which un-commenting will make storage work.

Tips

2008-07-27T21:28:29Z

BBen: /* Changing viewer start webpage in standalone mode */

[[Category:Users]]
==Terrain Tidbits==
===How can I flatten a region?===
When you have multiple regions, that you need to terraform to a certain height, the quickest way to do it is by selecting a region, and fill the terrain to the specified height:
change-region YourRegionName
script terrain fill 20

''Note:'' Remember to change to the region you wish to modify if that is the only region wish to make changes to. Without using the change-region command, you may very well end up flattening multiple regions!

As of SVN 4061
terrain fill 25

[[Category:Getting Started]]

=== 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), It is very important that you rename the file extension to .r32 for the import to properly work.
Then, once you have it saved, on the <tt>OpenSim.exe</tt> console, type in:
script terrain load-tile <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:
script terrain load-tile simalpha.r32 512 512 0 0
Next, before you log in, you may want to go to type in: *(THIS FUNCTION MAY NOT WORK)
script 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>script terrain load-tile ...</tt>" and "<tt>script terrain multiply ...</tt>" one per line.

*** Notice this method is no longer required and should be considered a legacy function, Terrain persistance is now working 100%.

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 (file extension now determines the format, use .r32 for L3DT terrains)

script terrain load <filename>

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

=== Other useless or useful 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

==General Setup Tricks==
=== Changing viewer start webpage in standalone mode ===

In order to change the page that the viewer starts in /opensim/bin/ there is a http_loginform.html.example page. Removing the .example will make this page be the start webpage which you can edit etc. Since the login html code is no longer needed this can be modified at will.

=== Making the server remember terrain, prims and other region storage changes after reboot ===
First off you should copy the OpenSim.ini.example to be your OpenSim.ini file. This file has all the settings etc that you need to configure the server. The default has a default of storing to null which does not save anything. In order for terrain and prims to be remembered you must comment out --- storage_plugin = "OpenSim.Data.Null.dll" --- and uncomment one of the others. The easiest one requiring no extra setup is --- storage_plugin = "OpenSim.Data.SQLite.dll"--- which un-commenting will make work.

Tips

2008-07-21T23:51:37Z

BBen: /* Terrain Tidbits */