Revision as of 06:20, 17 August 2007

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

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 Gimp, for a freeware alternative)
• L3DT Standard and Terragen
• 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)
• 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:

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