aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/README.txt
blob: 0d552bfaefb274c59f1f8ab315608a7230221618 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
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!