opensim/README.txt

IMPORTANT NOTES

* Please note that at the moment, the sandbox login server has temporary changed from 8080 to 9000 - this will (probably) change back.

---

BUILD INSTRUCTIONS

=== Microsoft Visual Studio 2005 Sandbox Build ===

* Check out the trunk code

* Build the /OpenSim.sln solution

* open cmd window, go to /bin and launch 
OpenSim.exe -sandbox -loginserver

* open another cmd window, locate the secondlife executable
(In something like C:\Program Files\SecondLife )

* run the viewer with
secondlife.exe -loginuri http://localhost:9000/

* Have fun with your own sandbox!

== Linux/mono sandbox build ==

* check out the trunk code

* ensure you have nant (http://nant.sf.net) installed

* cd to the trunk root directory and type "nant"

* cd to bin/ and run "mono OpenSim.exe -sandbox -loginserver"


RUNNING SANDBOX WITH USER ACCOUNTS

* open cmd window, go to /bin and launch 
OpenSim.exe -sandbox -loginserver -useraccounts

* launch web browser, go to
http://localhost:9000/Admin
enter password 'Admin'

* Select 'Accounts', enter credentials, press 'Create'

* Now, log on thru your viewer (see above) with your newly created credentials.

* Have Fun!



PREBUILD

We use Prebuild to generate vs2005 solutions and nant build scripts.

=== Building Prebuild ===

At the moment, the Prebuild exe is shipped as /bin/Prebuild.exe so you shouldn't really have to build it.

But here's the instructions anyway :

The Prebuild master project is /prebuild.xml

To build it with vs2005 :

* build the solution /Prebuild/Prebuild.sln

To build it with nant :

* cd to /Prebuild/
* type 'nant'

After you've built it, it will land in the root /bin/ directory,

=== Modyfying the OpenSim solution ===

When adding or changing projects, modify the prebuild.xml and then execute

bin/Prebuild.exe /target {target}

where target is either 
vs2005 - to generate new vs2005 solutions and projects
nant - to generate new nant build scripts

Remember to run prebuild whenever you've added or removed files as well.


LOCAL SET-UP OF OGS CONFIGURATION

**NOTE: At the moment OGS is non-functionable, so this WON'T WORK **NOTE

* start up bin/OpenGridServices.GridServer.exe (listens on http://localhost:8001/gridserver)
  * just press enter to keep the defaults

* start up bin/OpenGridServices.UserServer.exe (listens on http://localhost:8002/userserver)
  * just press enter to keep the defaults

* start up bin/OpenSim.exe ( listens for udp on port 9000 )
  * just press enter to keep the defaults

* start the secondlife viewer with -loginuri http://localhost:8080/

=== Trying Prototype Scripting Engine out ===

* Update, build and run in sandbox mode.
* Use the admin web front localhost:9000/Admin, password Admin
* Create an account, then log in with the viewer
* Press 'Entities' in the admin view and memorize the guids (well, try to)
* Create a new object in the viewer
* Refresh the entities view (You might have to empty cache....)
* Locate the new guid, that's the primitive you just created
* Be sure to see both the object in the viewer and the admin web front.
* Press 'add test script'.
* Enjoy the blinkenlichten!