Revision as of 12:30, 25 August 2007

Frequently asked questions

I can't find any build files or solution files

• If you're on windows, run prebuild.bat - on linux prebuild.sh

VS2005 wont open the .sln file

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

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

• Do a 'cd bin' followed by 'chmod 777 *' to make all dll files executable.

I cannot start my sim

• See OpenSim: Running.

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 username@localhost, 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 OpenSim.exe 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 *.xml 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 *.xml and *.yap files in the bin directory if you want to run a full reconfiguration again.

I cannot connect to my OpenSim

• See OpenSim: Connecting.

I 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.

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

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

I need a new UUID for my sim config

Use 'uuidgen' or generate one on the uuidgen webpage.

I want to run multiple sims

Add another xml file to bin/Regions. 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). Restart OpenSim.

• See OpenSim: Configuration.

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 has not the correct (or whatever...) libopenjpeg-libsl library.
• Solution: get the newest code from libsecondlife (svn co svn://opensecondlife.org/libsl/trunk), 'make' manually in the subdir openjpeg-libsl, and copy the resulting libopenjpeg-libsl-2.1.2.0.so into your OpenSim .../bin subdir, overwriting the existing one.
• Recompile & restart OpenSim.

How do I enable prim storage?

• Download sqlite3 (the .exe)
• Create the sqlite database file(s) from the sqlite3-prims.sql in share directory

Example command:

sqlite3 -init share/sql/sqlite3-prims.sql bin/opensim.db

• In the OpenSim.ini file, change the storage_plugin so it points to OpenSim.DataStore.MonoSqlite.dll (storage_plugin = OpenSim.DataStore.MonoSqlite.dll).
• In your region.xml files change the DataStore value so it is the name of your database file (i.e., if you have one region and used opensim.db in the above command, then you point DataStore to that).
• NB: currently, you need a different sqlite3 database file for each region.

Currently, sqlite is the only database provider that works for prim storage.

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 regionassets.yap file, and restart your sim. WARNING: IF YOU DO THIS, YOU WILL LOSE ANY ASSETS THAT YOU HAVE UPLOADED!

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 Gimp. If you want more complex terrains, you will need programs that output to standard 3d raw format (aka r32 or r64). L3DT and Terragen are two of the top commercial programs for this. (anyone know of a freeware one?), or you could, with some practice, use Blender. The free version of L3DT can make terrains up to 2048x2048 in size, or 8x8 regions.

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 /bin directory (right where your opensim.exe 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 done easliy with L3DT's export feature. (use the RAW format and set the oprions to Y flipped = true 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 OpenSim.exe 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.

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

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 #opensim-help, #opensim and #opensim-dev on EFNet. 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 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.