OpenSimulator - User contributions [en]

User:Tildeampersand

2007-08-28T23:54:19Z

Tildeampersand: /* My Links */

User:Tildeampersand

2007-08-18T14:29:26Z

Tildeampersand: /* Windows Setup */

User:Tildeampersand

2007-08-18T11:46:26Z

Tildeampersand: Windows Setup reworked

User:Tildeampersand

2007-08-17T16:56:05Z

Tildeampersand:

= Welcome! =
A friend and I are wanting to start a medeval themed grid based on some of the
old games my father used to play when he was younger.

Since about June 1, I have been unable to install or compile a working set of
sim or grid software. At some point in the bootup, each server fails miserably.
Since the last attempt (with the msi installer) I cant even get the svn to come
up in order to download a newer version.

== My Links ==
[http://tildeampersand.bravehost.com/ My Website] That is about to be redone.

== WishList ==
Things I'd like to see in the project (aside from the basic functionality)

Directly piping in music from WinAmp or other player into each sim. What would be cooler is to have the ability to create a playlist for each sim so that a box running 2 or more sims could have different playlists on each.

The ability to directly modify the default inventory by adding or removing items from the directory. This would work for text files and textures, of the appropriate formats.

The addition of an operator control list for both the grid and the sims. Grid controllers (ala Lindens) would have superuser status across the entire grid. Each sim would have its own list of region-wide superusers. These users would bypass ALL parcel limiters (like build, fly, etc). Right now, on the LL Main Grid, an estate manager can not do this, which is rather stupid.

== My OpenSim Experience ==
Lord, after the hair-pulling 2 weeks I have had, I deserve a day at the spa. The actual process of getting 4 regions up and running is not really that hard, but the gathering of info and the proper programs was a bit of a pain in the butt. This is made even more elusive by the fact that most of the documentation in this wiki is biased towards 'nix machines, while I run a winblows box.

With this in mind, here is a short 'todo' list for windows machines:

=== Programs gathered ===
*Photoshop (or [http://www.gimp.org/ Gimp], for a freeware alternative)
*[http://www.bundysoft.com/L3DT/ L3DT Standard] and [http://www.planetside.co.uk/ Terragen]
*[http://www.mysql.com/ MySQL 5.0 and Tools for 5.0] (clock the 'downloads' under the free trial button, get 'community server' and find the link to grab 'tools' as well, both are FREE)
*[http://sqlite.org/ SQLite3]
*Tortoise SVN (to get the source code) - see useful links, below

As well as some of the day-to-day utilities I use, like UltraEdit (which handles xml files real well) and MS Visual Studio 2005 (you're on your own to get this)

=== Setup ===
Ok, First off, you need the source code. Right now, the only way to get that is to use the SVN. If you use the Tortoise SVN shell extension, type this line into your browser: svn://openmv.org/opensim/ and the new shell extension should pop up, showing you what's there. You should see a tree view with a folder named the url above.

Open that folder and select 'trunk' (dont open it). Right click 'trunk' and select 'export'. Change ONLY the export directory. Find a place on your computer and, using the Tortoise browser, create a folder (i name mine opensl-date, to keep different versions seperate). Since Tortoise will dump the contents of 'trunk' to wherever you point to, NOT making a trunk folder, you will want to point it at an empty folder.

Takes a minute or two on a 7mbit cable. Once you have that, close Tortoise and navigate to your new collection of files (My Computer...). Run the 'runprebuild.bat' file. It will create a couple of new files in the base source directory.

Now, you need to COMPILE the source. I use VS2005, thanks to my dad's addiction to having neat gadgets he never uses. With VS, i simply double-click the OpenSim.sln file and build the project. This will create all the files you need inside the /bin folder. You can copy /bin and rename it to something more memorable, if you want (this leaves the untouched version inside the downloaded folder, a nice backup for if you screw up).

Now it is time for the stand alone testing. The current info elsewhere in this wiki works well, so I wont repeat it here. Make SURE you can connect to your stand-alone (sandbox) server, then go create and account on deep grid and make sure you can log in there before trying the next step.

Ok, so, one region just isn't big enough for you? join the club :)

Now you get to have the joy of setting up an entire grid - which isn't as hard as it looks, IF you do it right. Let's start with configuring multiple regions.

Inside the /bin (or whatever you named it to a few steps ago), you will see a folder named 'Regions'. In here is where your region configuration files go. Config files are simple xml files that you could create yourself in notepad. Here is the contents of my region #1 (with the names and passwords changed). This is the config of a WORKING region in my grid.

<Root>
<Config sim_UUID="19c8cd3e32ed42f6a322d87ae3e69ad9" sim_name="EagleGrid 0.0" sim_location_x="0"
sim_location_y="0" datastore="sim00prims.db" internal_ip_address="0.0.0.0" internal_ip_port="9000"
external_host_name="127.0.0.1" master_avatar_first="Your" master_avatar_last="Name"
master_avatar_pass="password" />
</Root>

A little confusing? let me break it up a bit...
*The <Root> and <Config are standard and wont change.
*sim_UUID="19c8cd3e32ed42f6a322d87ae3e69ad9" is the unique 'serial number' for each sim you plan to run. If you use the uuid generator webpage, remove the dashes (-) that it provides.
*sim_name="EagleGrid 0.0" is the name of each sim. I use a grid location naming method for testing simplicity.
*sim_location_x="0" sim_location_y="0" is the location that gets sent to GridServer. Each sim needs to have its own - and, yes, each region requires a single grid point, not 256 or some other amount (so, to make 4 sims in a row, you can use 0 0, 0 1, 0 2, 0 3).
*datastore="sim00prims.db" is only used if you desire prim storage. You need to follow the instructions for that elsewhere in this wiki. I created the databases but do NOT run sqlite3 along with my grid... seems to work fine. Each region needs its own database tho (once you make a database in sqlite, you can just copy and rename it).
*internal_ip_address="0.0.0.0" Leave this alone, DO NOT ALTER if you are running your regions and grid server on the same box. If you aren't running everything on one box, sorry, you're on your own.
*internal_ip_port="9000" This port needs to be unique for each region. Again, I use a grid location scheme. my last two digits are my grid location, which will work fine for 10 or fewer sims in a row. (9000 = grid 0,0 9010 = grid 1,0...)
*external_host_name="127.0.0.1" should point at the ip of your user, grid and assets server. IF you run them on the same machine as the region server (opensim.exe) leave this as 127.0.0.1.
*The rest (about master avatar) can be whatever you want as the owner of the region. the password MUST be the master avatar's login password (which is why I changed it for the example :p )

That better? I hope so.

Ok, now to configure your little world as a whole. You will definately want the FREE MySQL community server and the tools package. IT's free and it's stable and it makes all this actually work fine.

Follow the mysql configuration steps elsewhere in the wiki to create the initial database, but DO NOT try to create the tables with that guide (wont work on a windows machine).

To create your tables on Windows, open the MySQL Administrator (you installed the Tools for 5.0, right?), find that database you created, under the 'catalogs' icon. Select it and then use the top menu 'Tools' > 'MySQL Query Browser. This will open a new window.

In the new browser, you will need to right-click your prefered database on the right side and select 'make default schema'. You also need to navigate to the /bin/share/sql folder of the downloaded source code.

You will find seven files named mysql-*.sql. They should open fine in notepad or ultraedit and look something like this:

SET FOREIGN_KEY_CHECKS=0;
-- ----------------------------
-- Table structure for agents
-- ----------------------------
CREATE TABLE `agents` (
`UUID` varchar(36) NOT NULL,
`sessionID` varchar(36) NOT NULL,
`secureSessionID` varchar(36) NOT NULL,
`agentIP` varchar(16) NOT NULL,
`agentPort` int(11) NOT NULL,
`agentOnline` tinyint(4) NOT NULL,
`loginTime` int(11) NOT NULL,
`logoutTime` int(11) NOT NULL,
`currentRegion` varchar(36) NOT NULL,
`currentHandle` bigint(20) unsigned NOT NULL,
`currentPos` varchar(64) NOT NULL,
PRIMARY KEY (`UUID`),
UNIQUE KEY `session` (`sessionID`),
UNIQUE KEY `ssession` (`secureSessionID`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8;

-- ----------------------------
-- Records
-- ----------------------------

(that looks better in the edit window, but bear with me)

You will need to copy and paste everything from Create Table to utf8; into the query browser. A few of the files in the build I am using for example are missing the last semi-colon. IF YOURS ARE MISSING, ADD IT BEFORE YOU COPY.

Ok, copy the first one, switch to the Query window. At the top, centered directly under the main menu, you should see a small window with greyed out icons on either side. PASTE the info in here. It should format and color nice and pretty for you. Select the EXECUTE icon to the right of that window.

Query will run for a second or two, with no real indication it is done. Look down at the status bar, it should say 'query returned no results' (or something similar). Fear not, your table has been created. Repeat for the remaining 6 .sql files. DO NOT DO THIS WITH THE sqlite3* files, just the mysql* files.

When all 7 files have been processed, you can close the query window. On the Admin panel, click 'refresh' in the lower right and select your database again.
See? Now you have 7 tables in there. Close Admin.

== Useful Links ==
(08/14/2007) - Ok, for those of you that do NOT know wtf to do with an svn:// url, I have this neat little tool for you:
[http://tortoisesvn.net/ Tortoise SVN]
To use this, simply type in the url, starting with svn://, into your browser's address bar. I have noticed it is best to just type in the ROOT url, since Tortise sometimes sees 'directory not found' if you type in the whole thing.

...more to come, I am sure...

User:Tildeampersand

2007-08-17T16:39:58Z

Tildeampersand: /* My Links */

= Welcome! =
A friend and I are wanting to start a medeval themed grid based on some of the
old games my father used to play when he was younger.

Since about June 1, I have been unable to install or compile a working set of
sim or grid software. At some point in the bootup, each server fails miserably.
Since the last attempt (with the msi installer) I cant even get the svn to come
up in order to download a newer version.

== My Links ==
[http://tildeampersand.bravehost.com/ My Website] That is about to be redone.
[svn://openmv.org/opensim/trunk SVN Link] - cuz I'm lazy

== WishList ==
Things I'd like to see in the project (aside from the basic functionality)

Directly piping in music from WinAmp or other player into each sim. What would be cooler is to have the ability to create a playlist for each sim so that a box running 2 or more sims could have different playlists on each.

The ability to directly modify the default inventory by adding or removing items from the directory. This would work for text files and textures, of the appropriate formats.

The addition of an operator control list for both the grid and the sims. Grid controllers (ala Lindens) would have superuser status across the entire grid. Each sim would have its own list of region-wide superusers. These users would bypass ALL parcel limiters (like build, fly, etc). Right now, on the LL Main Grid, an estate manager can not do this, which is rather stupid.

== My OpenSim Experience ==
Lord, after the hair-pulling 2 weeks I have had, I deserve a day at the spa. The actual process of getting 4 regions up and running is not really that hard, but the gathering of info and the proper programs was a bit of a pain in the butt. This is made even more elusive by the fact that most of the documentation in this wiki is biased towards 'nix machines, while I run a winblows box.

With this in mind, here is a short 'todo' list for windows machines:

=== Programs gathered ===
*Photoshop (or [http://www.gimp.org/ Gimp], for a freeware alternative)
*[http://www.bundysoft.com/L3DT/ L3DT Standard] and [http://www.planetside.co.uk/ Terragen]
*[http://www.mysql.com/ MySQL 5.0 and Tools for 5.0] (clock the 'downloads' under the free trial button, get 'community server' and find the link to grab 'tools' as well, both are FREE)
*[http://sqlite.org/ SQLite3]
*Tortoise SVN (to get the source code) - see useful links, below

As well as some of the day-to-day utilities I use, like UltraEdit (which handles xml files real well) and MS Visual Studio 2005 (you're on your own to get this)

=== Setup ===
Ok, First off, you need the source code. Right now, the only way to get that is to use the SVN. If you use the Tortoise SVN shell extension, type this line into your browser: svn://openmv.org/opensim/ and the new shell extension should pop up, showing you what's there. You should see a tree view with a folder named the url above.

Open that folder and select 'trunk' (dont open it). Right click 'trunk' and select 'export'. Change ONLY the export directory. Find a place on your computer and, using the Tortoise browser, create a folder (i name mine opensl-date, to keep different versions seperate). Since Tortoise will dump the contents of 'trunk' to wherever you point to, NOT making a trunk folder, you will want to point it at an empty folder.

Takes a minute or two on a 7mbit cable. Once you have that, close Tortoise and navigate to your new collection of files (My Computer...). Run the 'runprebuild.bat' file. It will create a couple of new files in the base source directory.

Now, you need to COMPILE the source. I use VS2005, thanks to my dad's addiction to having neat gadgets he never uses. With VS, i simply double-click the OpenSim.sln file and build the project. This will create all the files you need inside the /bin folder. You can copy /bin and rename it to something more memorable, if you want (this leaves the untouched version inside the downloaded folder, a nice backup for if you screw up).

Now it is time for the stand alone testing. The current info elsewhere in this wiki works well, so I wont repeat it here. Make SURE you can connect to your stand-alone (sandbox) server, then go create and account on deep grid and make sure you can log in there before trying the next step.

Ok, so, one region just isn't big enough for you? join the club :)

Now you get to have the joy of setting up an entire grid - which isn't as hard as it looks, IF you do it right. Let's start with configuring multiple regions.

Inside the /bin (or whatever you named it to a few steps ago), you will see a folder named 'Regions'. In here is where your region configuration files go. Config files are simple xml files that you could create yourself in notepad. Here is the contents of my region #1 (with the names and passwords changed). This is the config of a WORKING region in my grid.

<Root>
<Config sim_UUID="19c8cd3e32ed42f6a322d87ae3e69ad9" sim_name="EagleGrid 0.0" sim_location_x="0"
sim_location_y="0" datastore="sim00prims.db" internal_ip_address="0.0.0.0" internal_ip_port="9000"
external_host_name="127.0.0.1" master_avatar_first="Your" master_avatar_last="Name"
master_avatar_pass="password" />
</Root>

A little confusing? let me break it up a bit...
*The <Root> and <Config are standard and wont change.
*sim_UUID="19c8cd3e32ed42f6a322d87ae3e69ad9" is the unique 'serial number' for each sim you plan to run. If you use the uuid generator webpage, remove the dashes (-) that it provides.
*sim_name="EagleGrid 0.0" is the name of each sim. I use a grid location naming method for testing simplicity.
*sim_location_x="0" sim_location_y="0" is the location that gets sent to GridServer. Each sim needs to have its own - and, yes, each region requires a single grid point, not 256 or some other amount (so, to make 4 sims in a row, you can use 0 0, 0 1, 0 2, 0 3).
*datastore="sim00prims.db" is only used if you desire prim storage. You need to follow the instructions for that elsewhere in this wiki. I created the databases but do NOT run sqlite3 along with my grid... seems to work fine. Each region needs its own database tho (once you make a database in sqlite, you can just copy and rename it).
*internal_ip_address="0.0.0.0" Leave this alone, DO NOT ALTER if you are running your regions and grid server on the same box. If you aren't running everything on one box, sorry, you're on your own.
*internal_ip_port="9000" This port needs to be unique for each region. Again, I use a grid location scheme. my last two digits are my grid location, which will work fine for 10 or fewer sims in a row. (9000 = grid 0,0 9010 = grid 1,0...)
*external_host_name="127.0.0.1" should point at the ip of your user, grid and assets server. IF you run them on the same machine as the region server (opensim.exe) leave this as 127.0.0.1.
*The rest (about master avatar) can be whatever you want as the owner of the region. the password MUST be the master avatar's login password (which is why I changed it for the example :p )

That better? I hope so.

Ok, now to configure your little world as a whole. You will definately want the FREE MySQL community server and the tools package. IT's free and it's stable and it makes all this actually work fine.

Follow the mysql configuration steps elsewhere in the wiki to create the initial database, but DO NOT try to create the tables with that guide (wont work on a windows machine).

To create your tables on Windows, open the MySQL Administrator (you installed the Tools for 5.0, right?), find that database you created, under the 'catalogs' icon. Select it and then use the top menu 'Tools' > 'MySQL Query Browser. This will open a new window.

In the new browser, you will need to right-click your prefered database on the right side and select 'make default schema'. You also need to navigate to the /bin/share/sql folder of the downloaded source code.

You will find seven files named mysql-*.sql. They should open fine in notepad or ultraedit and look something like this:

SET FOREIGN_KEY_CHECKS=0;
-- ----------------------------
-- Table structure for agents
-- ----------------------------
CREATE TABLE `agents` (
`UUID` varchar(36) NOT NULL,
`sessionID` varchar(36) NOT NULL,
`secureSessionID` varchar(36) NOT NULL,
`agentIP` varchar(16) NOT NULL,
`agentPort` int(11) NOT NULL,
`agentOnline` tinyint(4) NOT NULL,
`loginTime` int(11) NOT NULL,
`logoutTime` int(11) NOT NULL,
`currentRegion` varchar(36) NOT NULL,
`currentHandle` bigint(20) unsigned NOT NULL,
`currentPos` varchar(64) NOT NULL,
PRIMARY KEY (`UUID`),
UNIQUE KEY `session` (`sessionID`),
UNIQUE KEY `ssession` (`secureSessionID`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8;

-- ----------------------------
-- Records
-- ----------------------------

(that looks better in the edit window, but bear with me)

You will need to copy and paste everything from Create Table to utf8; into the query browser. A few of the files in the build I am using for example are missing the last semi-colon. IF YOURS ARE MISSING, ADD IT BEFORE YOU COPY.

Ok, copy the first one, switch to the Query window. At the top, centered directly under the main menu, you should see a small window with greyed out icons on either side. PASTE the info in here. It should format and color nice and pretty for you. Select the EXECUTE icon to the right of that window.

Query will run for a second or two, with no real indication it is done. Look down at the status bar, it should say 'query returned no results' (or something similar). Fear not, your table has been created. Repeat for the remaining 6 .sql files. DO NOT DO THIS WITH THE sqlite3* files, just the mysql* files.

When all 7 files have been processed, you can close the query window. On the Admin panel, click 'refresh' in the lower right and select your database again.
See? Now you have 7 tables in there. Close Admin.

== Useful Links ==
(08/14/2007) - Ok, for those of you that do NOT know wtf to do with an svn:// url, I have this neat little tool for you:
[http://tortoisesvn.net/ Tortoise SVN]
To use this, simply type in the url, starting with svn://, into your browser's address bar. I have noticed it is best to just type in the ROOT url, since Tortise sometimes sees 'directory not found' if you type in the whole thing.

...more to come, I am sure...

User:Tildeampersand

2007-08-17T14:20:32Z

Tildeampersand:

User:Tildeampersand

2007-08-16T11:55:54Z

Tildeampersand: added a guide for windows machines - working copy, may make page later.

= Welcome! =
A friend and I are wanting to start a medeval themed grid based on some of the
old games my father used to play when he was younger.

Since about June 1, I have been unable to install or compile a working set of
sim or grid software. At some point in the bootup, each server fails miserably.
Since the last attempt (with the msi installer) I cant even get the svn to come
up in order to download a newer version.

== WishList ==
Things I'd like to see in the project (aside from the basic functionality)

Directly piping in music from WinAmp or other player into each sim. What would be cooler is to have the ability to create a playlist for each sim so that a box running 2 or more sims could have different playlists on each.

The ability to directly modify the default inventory by adding or removing items from the directory. This would work for text files and textures, of the appropriate formats.

The addition of an operator control list for both the grid and the sims. Grid controllers (ala Lindens) would have superuser status across the entire grid. Each sim would have its own list of region-wide superusers. These users would bypass ALL parcel limiters (like build, fly, etc). Right now, on the LL Main Grid, an estate manager can not do this, which is rather stupid.

== My OpenSim Experience ==
Lord, after the hair-pulling 2 weeks I have had, I deserve a day at the spa. The actual process of getting 4 regions up and running is not really that hard, but the gathering of info and the proper programs was a bit of a pain in the butt. This is made even more elusive by the fact that most of the documentation in this wiki is biased towards 'nix machines, while I run a winblows box.

With this in mind, here is a short 'todo' list for windows machines:

=== Programs gathered ===
*Photoshop (or [http://www.gimp.org/ Gimp], for a freeware alternative)
*[http://www.bundysoft.com/L3DT/ L3DT Standard] and [http://www.planetside.co.uk/ Terragen]
*[http://www.mysql.com/ MySQL 5.0 and Tools for 5.0] (clock the 'downloads' under the free trial button, get 'community server' and find the link to grab 'tools' as well, both are FREE)
*[http://sqlite.org/ SQLite3]
*Tortoise SVN (to get the source code) - see useful links, below

As well as some of the day-to-day utilities I use, like UltraEdit (which handles xml files real well) and MS Visual Studio 2005 (you're on your own to get this)

=== Setup ===
Ok, First off, you need the source code. Right now, the only way to get that is to use the SVN. If you use the Tortoise SVN shell extension, type this line into your browser: svn://openmv.org/opensim/ and the new shell extension should pop up, showing you what's there. You should see a tree view with a folder named the url above.

Open that folder and select 'trunk' (dont open it). Right click 'trunk' and select 'export'. Change ONLY the export directory. Find a place on your computer and, using the Tortoise browser, create a folder (i name mine opensl-date, to keep different versions seperate). Since Tortoise will dump the contents of 'trunk' to wherever you point to, NOT making a trunk folder, you will want to point it at an empty folder.

Takes a minute or two on a 7mbit cable. Once you have that, close Tortoise and navigate to your new collection of files (My Computer...). Run the 'runprebuild.bat' file. It will create a couple of new files in the base source directory.

Now, you need to COMPILE the source. I use VS2005, thanks to my dad's addiction to having neat gadgets he never uses. With VS, i simply double-click the OpenSim.sln file and build the project. This will create all the files you need inside the /bin folder. You can copy /bin and rename it to something more memorable, if you want (this leaves the untouched version inside the downloaded folder, a nice backup for if you screw up).

Now it is time for the stand alone testing. The current info elsewhere in this wiki works well, so I wont repeat it here. Make SURE you can connect to your stand-alone (sandbox) server, then go create and account on deep grid and make sure you can log in there before trying the next step.

Ok, so, one region just isn't big enough for you? join the club :)

Now you get to have the joy of setting up an entire grid - which isn't as hard as it looks, IF you do it right. Let's start with configuring multiple regions.

Inside the /bin (or whatever you named it to a few steps ago), you will see a folder named 'Regions'. In here is where your region configuration files go. Config files are simple xml files that you could create yourself in notepad. Here is the contents of my region #1 (with the names and passwords changed). This is the config of a WORKING region in my grid.

<Root>
<Config sim_UUID="19c8cd3e32ed42f6a322d87ae3e69ad9" sim_name="EagleGrid 0.0" sim_location_x="0"
sim_location_y="0" datastore="sim00prims.db" internal_ip_address="0.0.0.0" internal_ip_port="9000"
external_host_name="127.0.0.1" master_avatar_first="Your" master_avatar_last="Name"
master_avatar_pass="password" />
</Root>

A little confusing? let me break it up a bit...
*The <Root> and <Config are standard and wont change.
*sim_UUID="19c8cd3e32ed42f6a322d87ae3e69ad9" is the unique 'serial number' for each sim you plan to run. If you use the uuid generator webpage, remove the dashes (-) that it provides.
*sim_name="EagleGrid 0.0" is the name of each sim. I use a grid location naming method for testing simplicity.
*sim_location_x="0" sim_location_y="0" is the location that gets sent to GridServer. Each sim needs to have its own - and, yes, each region requires a single grid point, not 256 or some other amount (so, to make 4 sims in a row, you can use 0 0, 0 1, 0 2, 0 3).
*datastore="sim00prims.db" is only used if you desire prim storage. You need to follow the instructions for that elsewhere in this wiki. I created the databases but do NOT run sqlite3 along with my grid... seems to work fine. Each region needs its own database tho (once you make a database in sqlite, you can just copy and rename it).
*internal_ip_address="0.0.0.0" Leave this alone, DO NOT ALTER if you are running your regions and grid server on the same box. If you aren't running everything on one box, sorry, you're on your own.
*internal_ip_port="9000" This port needs to be unique for each region. Again, I use a grid location scheme. my last two digits are my grid location, which will work fine for 10 or fewer sims in a row. (9000 = grid 0,0 9010 = grid 1,0...)
*external_host_name="127.0.0.1" should point at the ip of your user, grid and assets server. IF you run them on the same machine as the region server (opensim.exe) leave this as 127.0.0.1.
*The rest (about master avatar) can be whatever you want as the owner of the region. the password MUST be the master avatar's login password (which is why I changed it for the example :p )

That better? I hope so.

Ok, now to configure your little world as a whole. You will definately want the FREE MySQL community server and the tools package. IT's free and it's stable and it makes all this actually work fine.

Follow the mysql configuration steps elsewhere in the wiki to create the initial database, but DO NOT try to create the tables with that guide (wont work on a windows machine).

To create your tables on Windows, open the MySQL Administrator (you installed the Tools for 5.0, right?), find that database you created, under the 'catalogs' icon. Select it and then use the top menu 'Tools' > 'MySQL Query Browser. This will open a new window.

In the new browser, you will need to right-click your prefered database on the right side and select 'make default schema'. You also need to navigate to the /bin/share/sql folder of the downloaded source code.

You will find seven files named mysql-*.sql. They should open fine in notepad or ultraedit and look something like this:

SET FOREIGN_KEY_CHECKS=0;
-- ----------------------------
-- Table structure for agents
-- ----------------------------
CREATE TABLE `agents` (
`UUID` varchar(36) NOT NULL,
`sessionID` varchar(36) NOT NULL,
`secureSessionID` varchar(36) NOT NULL,
`agentIP` varchar(16) NOT NULL,
`agentPort` int(11) NOT NULL,
`agentOnline` tinyint(4) NOT NULL,
`loginTime` int(11) NOT NULL,
`logoutTime` int(11) NOT NULL,
`currentRegion` varchar(36) NOT NULL,
`currentHandle` bigint(20) unsigned NOT NULL,
`currentPos` varchar(64) NOT NULL,
PRIMARY KEY (`UUID`),
UNIQUE KEY `session` (`sessionID`),
UNIQUE KEY `ssession` (`secureSessionID`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8;

-- ----------------------------
-- Records
-- ----------------------------

(that looks better in the edit window, but bear with me)

You will need to copy and paste everything from Create Table to utf8; into the query browser. A few of the files in the build I am using for example are missing the last semi-colon. IF YOURS ARE MISSING, ADD IT BEFORE YOU COPY.

Ok, copy the first one, switch to the Query window. At the top, centered directly under the main menu, you should see a small window with greyed out icons on either side. PASTE the info in here. It should format and color nice and pretty for you. Select the EXECUTE icon to the right of that window.

Query will run for a second or two, with no real indication it is done. Look down at the status bar, it should say 'query returned no results' (or something similar). Fear not, your table has been created. Repeat for the remaining 6 .sql files. DO NOT DO THIS WITH THE sqlite3* files, just the mysql* files.

When all 7 files have been processed, you can close the query window. On the Admin panel, click 'refresh' in the lower right and select your database again.
See? Now you have 7 tables in there. Close Admin.

== Useful Links ==
(08/14/2007) - Ok, for those of you that do NOT know wtf to do with an svn:// url, I have this neat little tool for you:
[http://tortoisesvn.net/ Tortoise SVN]
To use this, simply type in the url, starting with svn://, into your browser's address bar. I have noticed it is best to just type in the ROOT url, since Tortise sometimes sees 'directory not found' if you type in the whole thing.

...more to come, I am sure...

FAQ

2007-08-16T10:18:53Z

Tildeampersand: typos and minor errors fixed

= 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 [http://www.famkruithof.net/uuid/uuidgen 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.

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

=== 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 :) - [[User:Tildeampersand|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 [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.

OpenSim: FAQ

2007-08-16T10:18:53Z

Tildeampersand: typos and minor errors fixed

FAQ

2007-08-15T23:05:05Z

Tildeampersand: A few new notes for customizing multiple sims with terrain files

= 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 [http://www.famkruithof.net/uuid/uuidgen 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.

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

=== 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 'unsigned'). 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 the GRID console and type in:

terrain multiply 0.1
terrain add 20

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 :) - [[User:Tildeampersand|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 [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.

OpenSim: FAQ

2007-08-15T23:05:05Z

Tildeampersand: A few new notes for customizing multiple sims with terrain files

= 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 [http://www.famkruithof.net/uuid/uuidgen 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.

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

=== 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 'unsigned'). 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 the GRID console and type in:

terrain multiply 0.1
terrain add 20

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 :) - [[User:Tildeampersand|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 [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.

Build Instructions

2007-08-15T22:20:18Z

Tildeampersand: Changed svn link, as requested by the boys :)

=Installing from source=

==MS Windows==

OpenSim requires either the .Net framework version 2.0, or the latest Mono. It also is compiled with the C# and not the C++ IDE for those who are using the no-cost Express Editions from MS.

=== Subversion Repository ===

1. Get the source code from the svn repository:

svn://openmv.org/opensim/trunk

=== Building ===

2. In the top-level directory, run the 'runprebuild.bat' file. This will create both a VS2005 solution file, and a nant build file.

3. Open the resulting sln file with visual studio, and build it there, or if you prefer to use nant, run nant in the same top-level directory. This will build the executables.

=== Running ===

Double-click on the OpenSim.exe executable file in the 'bin' directory. This will start up OpenSim in standalone mode.

The debugger in VS2005 C# may be used to step through the code. For those that use a Cygwin shell, you may find that one or more dll's have permissions that cause problems running. Most find that a "chmod 777 *" from the bin directory solves this.

==Linux==

=== Subversion Repository ===

To check out the latest revision:

svn co svn://opensecondlife.org/opensim/trunk opensim.new/trunk

Note: The libopenjpeg-libsl-...so is not really working. For this reason you should download the newest libsecondlife from http://www.libsecondlife.org, and build your own libopenjpeg library. If you use this instead of the SVN version, your sim will work fine.

=== Building (Mono) ===

cd opensim.new/trunk

mono bin/Prebuild.exe /target nant
nant -buildfile:OpenSim.build

mono bin/Prebuild.exe /target nant
nant -buildfile:OpenSim.build

(Yes, you must rerun the prebuild again after the first build, and then build again!)

=== Running (Mono) ===

cd bin
mono OpenSim.exe

=Binary releases=

Some recent pre-compiled releases are available at [http://www.lotusbell.com/opensim/ OpenSim binaries]. These are usually a few revs out-of-date.

OpenSim: Install

2007-08-15T22:20:18Z

Tildeampersand: Changed svn link, as requested by the boys :)

Configuration

2007-08-15T20:13:40Z

Tildeampersand: added multi-sim on one box notes

It is recommended that you first get OpenSim running in standalone mode, before you attempt to connect it to a grid, either your own grid or a public grid.

A simulator actually consists of four services, known as UGAS which stand for User, Grid, Asset & Simulator. They are started in that order.

A simulator running in its default standalone mode has all the services self-contained, but they are very modest. This means any first/last/password works. It also means inventory is all local with no region or grid-wide connections.

A simulator running as a local grid runs all four services on the same computer. Multiple sims can be run, across-region crossing including teleporting and a set of inventory items that are within this local grid.

A simulator running as part of a public grid runs only OpenSim.exe and the other three services are running on a server common to many regions. This also means that understanding the needed UUID, X,Y location, server handshake passwords, master avatar first/last/password and a couple of other settings. These are not difficult, but do require a little care in setting up.

=Command Line arguments passed to OpenSim.exe=

OpenSim.exe responds to various command line arguments. These include "inifile", "-configfile", "-gridmode", "-physics", "-config" & "-noverbose" as of r1514.

Most users in standalone mode will not add any command line arguments. For local grid or public grid, the "-gridmode=true" is usually the only argument used. The rest are for more advanced configuration.

=Standalone mode=

When you start OpenSim in standalone mode, it will ask you several question at the console. The first set of prompts that start with "NETWORK SERVERS INFO", you can just hit return to accept the defaults if you will be running in standalone mode.

The prompts that start with "DEFAULT REGION CONFIG" are where you need to start paying attention. Some are self-explanatory. Here are explanations for the others:

* Grid Location. OpenSim regions can be placed anywhere on a 65536 by 65536 grid. In standalone mode, it is safe to leave these X and Y locations at their defaults.

* Filename for local storage. Safe to leave at default.

* Internal IP address; This should always be 0.0.0.0

* Internal IP port for incoming UDP client connection. You can make this any port you want, but it is safe to leave at the default 9000.

* External host name. If you will only be attaching to your sim from a SecondLife client on the same machine, you can leave this at the default 127.0.0.1. If you will be wanting to connect to it from a client on another machine, this should be the IP address or hostname of the machine you are running this sim on.

To connect to your new sim, start up secondlife with the following command line switches:

-loginuri http://127.0.0.1:9000/

This assumes you are running the secondlife client on the same box. If you are running it on a separate box, substitute the IP address of your sim machine.

=Grid mode=

You want to run your own grid. Great! Assuming that you already got your sim running in standalone mode, here is what you need to do:

1. Current builds of OpenSim grid mode are using mysql to store the grid information. You must have this installed and configured if you want to run your own grid. See [[mysql-config]] for more information.

2. The servers should be started in a certain order. UGAS: UserServer, GridServer, AssetServer, Sim. These are all found in the bin directory. In windows, you can just double-click on the executables to start them. In linux, you will probably have to start them with mono. The executable names are:

OpenSim.Grid.UserServer.exe
OpenSim.Grid.GridServer.exe
OpenSim.Grid.AssetServer.exe
OpenSim.exe

3. Start the UserServer. If you will be running the GridServer on the same box, hit enter to accept the defaults, until it gives you the prompt

OpenUser#

This is the main prompt for the user server. If you will be running the GridServer on another box, change the Default Grid Server URI as appropriate.

4. Start the GridServer. Again, you can hit return at all the prompts if you are running them all on the same machine. If not, change the URIs for the Asset Server and User server to point to where you are running them. You will finally get to the console prompt for the GridServer which looks like this:

OpenGrid#

5. Start the AssetServer. This is not used at the current time, so you don't need to start it. The console prompt for this server will be:

OpenAsset#

6. If you are running all of these servers on the same box, which would be the normal configuration. You should be ready to start up your sim. Since the OpenSim.exe starts up by default in standalone mode, you will need to give it a command line switch to tell it to use gridmode instead:

OpenSim.exe -gridmode

or
mono OpenSim.exe -gridmode

NOTE: starting at version 0.3.1512, the syntax has changed to

-gridmode=true

With any luck, everything will come up without too many arrors.

7. Go to the UserServer console, and type 'create user' to create a new avatar. It will prompt you for the name and password, and the X and Y of the sim that should be his home location. Use 1000 and 1000, or wherever you told your sim to live when you brought it up in standalone mode.

At the console of any of these servers, you should be able to type 'help' to get a list of commands.

You should now be able to connect to your new grid with your secondlife client. You need to tell your client to point at the UserServer rather than direclty at the sim, though:

secondlife -loginuri http://127.0.0.1:8002/

8002 is the default port for the UserServer, and that IP address should be changed to the server you are running the UserServer on, if they are not all on the same box.

Happy OpenSimming!

=== Technical Addendum ===
For running multiple regions on the same box, you simply make multiple copies of the 'default.xml' file inside the /bin/regions/ directory. Name them anything you want (I name mine x.y.xml, where x znd y are the grid coords)

Open each xml file and edit the uuid (each must be unique, a generator is listed in this wiki, remove the dashes), region name, x & y positions, datastore (if you are using the prim thing) and internal ip port. EACH OF THESE MUST BE UNIQUE!

Once you have 2 or more xml files in the regions folder, you can run a SINGLE COPY of opensim.exe and it will boot all of your sims! If you come across any errors, there is, most likely, an error in the xml files.

=Attaching your sim to someone else's grid=

** [[OpenSim: SampleConfigs]] (Yin, Bao & Yang config files as samples)

In your bin directory, you will find a file called

network_servers_information.xml

This file has the configuration for telling your sim how to attach to a grid. You can edit this file with any text editor.

The grid owner should provide you with the following information to configure this file so that you can attach to their grid:

* GridServerURL

* GridSendKey

* GridRecvKey

* UserServerURL

* UserSendKey

* UserRecvKey

* AssetServerURL

The keys are used to make sure that you can both know that you are connecting to the correct box at the other end. This offers a level of security.

The other file you may have to change is in your bin/Regions directory. This is where your individual region config files are. If you only have one region, it will by default be called:

default.xml

This can be edited with any text editor. The grid owner may tell you what X and Y location you can place your sim at (you can't have multiple sims at the smae location on the grid). If so, the fields you will need to change in this file are sim_location_x, and sim_location_y.

A list of public grids that you can attach your sim to are at [[OpenSim:_Grids]]

OpenSim: Configuration

2007-08-15T20:13:40Z

Tildeampersand: added multi-sim on one box notes

FAQ

2007-08-15T17:32:11Z

Tildeampersand: Added Terrain Help

= 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 [http://www.famkruithof.net/uuid/uuidgen 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.

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

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

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|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 [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.

OpenSim: FAQ

2007-08-15T17:32:11Z

Tildeampersand: Added Terrain Help

= 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 [http://www.famkruithof.net/uuid/uuidgen 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.

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

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

Terrain Tidbits brought to you by Tilde, with a few questions in IRC :) - [[User:Tildeampersand|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 [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.

User:Tildeampersand

2007-08-14T23:11:37Z

Tildeampersand:

A friend and I are wanting to start a medeval themed grid based on some of the
old games my father used to play when he was younger.

Since about June 1, I have been unable to install or compile a working set of
sim or grid software. At some point in the bootup, each server fails miserably.
Since the last attempt (with the msi installer) I cant even get the svn to come
up in order to download a newer version.

Things I'd like to see in the project (aside from the basic functionality)

Directly piping in music from WinAmp or other player into each sim. What would be cooler is to have the ability to create a playlist for each sim so that a box running 2 or more sims could have different playlists on each.

The ability to directly modify the default inventory by adding or removing items from the directory. This would work for text files and textures, of the appropriate formats.

The addition of an operator control list for both the grid and the sims. Grid controllers (ala Lindens) would have superuser status across the entire grid. Each sim would have its own list of region-wide superusers. These users would bypass ALL parcel limiters (like build, fly, etc). Right now, on the LL Main Grid, an estate manager can not do this, which is rather stupid.

(08/14/2007) - Ok, for those of you that do NOT know wtf to do with an svn:// url, I have this neat little tool for you:
[http://tortoisesvn.net/ Windows XP Shell Extension: SVN]
To use this, simply type in the url, starting with svn://, into your browser's address bar. I have noticed it is best to just type in the ROOT url, since Tortise sometimes sees 'directory not found' if you type in the whole thing.

...more to come, I am sure...

User:Tildeampersand

2007-08-14T23:08:15Z

Tildeampersand: Added link to Windows SVN client

Talk:Mysql-config

2007-08-08T12:16:26Z

Tildeampersand:

hello. I continually get an error at all source commands, stating:

Failed to open file 'mysql-agents.sql', error: 2

I have also tried to use the winblows gui program and it claims I need to create at least 1 column in the table... any suggestions?

[[User:Tildeampersand|Tilde]] 05:16, 8 August 2007 (PDT)

Talk:Main Page

2007-08-08T02:44:05Z

Tildeampersand:

Just hoping someone updates the IRC channels soon.
I want to become a part of the development community soon.

Just a note, hoping someone can fix this problem. When I attempt to use the SVN Browser link, I get the following error:

-snip-

An Exception Has Occurred
Python Traceback

Traceback (most recent call last):
File "/usr/local/viewvc-1.0.3/lib/viewvc.py", line 3629, in main
request.run_viewvc()
File "/usr/local/viewvc-1.0.3/lib/viewvc.py", line 253, in run_viewvc
import vclib.svn
File "/usr/local/viewvc-1.0.3/lib/vclib/svn/__init__.py", line 25, in ?
from svn import fs, repos, core, delta
ImportError: No module named svn

-snip-

[[User:Tildeampersand|Tilde]] 19:44, 7 August 2007 (PDT)

User:Tildeampersand

2007-08-06T19:33:57Z

Tildeampersand: Initial creation, wishlist, problems...