diff options
-rw-r--r-- | releng/CAUTION | 4 | ||||
-rw-r--r-- | releng/README | 118 | ||||
-rw-r--r-- | releng/README.txt | 116 | ||||
-rw-r--r-- | releng/dist/INSTALL | 33 | ||||
-rw-r--r-- | releng/dist/README | 70 |
5 files changed, 109 insertions, 232 deletions
diff --git a/releng/CAUTION b/releng/CAUTION new file mode 100644 index 0000000..6418046 --- /dev/null +++ b/releng/CAUTION | |||
@@ -0,0 +1,4 @@ | |||
1 | !!!!!!!!!!!!! DANGER DANGER !!!!!!!!!!!!!!!!!!!!!!!!!!! | ||
2 | DO NOT RUN ANY OF THE SCRIPTS IN THIS DIRECTORY WITHOUT | ||
3 | READING THEM!!!!!!!!!!!!! | ||
4 | !!!!!!!!!!!!! DANGER DANGER !!!!!!!!!!!!!!!!!!!!!!!!!!! | ||
diff --git a/releng/README b/releng/README index 0d552bf..b4771a5 100644 --- a/releng/README +++ b/releng/README | |||
@@ -1,116 +1,2 @@ | |||
1 | IMPORTANT NOTES | 1 | This directory contains scripts etc for creating a tarball/package out of the SVN tree. |
2 | 2 | It is designed to be run before releases or by developers/users before a local install from source. | |
3 | * Please note that at the moment, the sandbox login server has temporary changed from 8080 to 9000 - this will (probably) change back. | ||
4 | |||
5 | --- | ||
6 | |||
7 | BUILD INSTRUCTIONS | ||
8 | |||
9 | === Microsoft Visual Studio 2005 Sandbox Build === | ||
10 | |||
11 | * Check out the trunk code | ||
12 | |||
13 | * Build the /OpenSim.sln solution | ||
14 | |||
15 | * open cmd window, go to /bin and launch | ||
16 | OpenSim.exe -sandbox -loginserver | ||
17 | |||
18 | * open another cmd window, locate the secondlife executable | ||
19 | (In something like C:\Program Files\SecondLife ) | ||
20 | |||
21 | * run the viewer with | ||
22 | secondlife.exe -loginuri http://localhost:9000/ | ||
23 | |||
24 | * Have fun with your own sandbox! | ||
25 | |||
26 | == Linux/mono sandbox build == | ||
27 | |||
28 | * check out the trunk code | ||
29 | |||
30 | * ensure you have nant (http://nant.sf.net) installed | ||
31 | |||
32 | * cd to the trunk root directory and type "nant" | ||
33 | |||
34 | * cd to bin/ and run "mono OpenSim.exe -sandbox -loginserver" | ||
35 | |||
36 | |||
37 | RUNNING SANDBOX WITH USER ACCOUNTS | ||
38 | |||
39 | * open cmd window, go to /bin and launch | ||
40 | OpenSim.exe -sandbox -loginserver -useraccounts | ||
41 | |||
42 | * launch web browser, go to | ||
43 | http://localhost:9000/Admin | ||
44 | enter password 'Admin' | ||
45 | |||
46 | * Select 'Accounts', enter credentials, press 'Create' | ||
47 | |||
48 | * Now, log on thru your viewer (see above) with your newly created credentials. | ||
49 | |||
50 | * Have Fun! | ||
51 | |||
52 | |||
53 | |||
54 | PREBUILD | ||
55 | |||
56 | We use Prebuild to generate vs2005 solutions and nant build scripts. | ||
57 | |||
58 | === Building Prebuild === | ||
59 | |||
60 | At the moment, the Prebuild exe is shipped as /bin/Prebuild.exe so you shouldn't really have to build it. | ||
61 | |||
62 | But here's the instructions anyway : | ||
63 | |||
64 | The Prebuild master project is /prebuild.xml | ||
65 | |||
66 | To build it with vs2005 : | ||
67 | |||
68 | * build the solution /Prebuild/Prebuild.sln | ||
69 | |||
70 | To build it with nant : | ||
71 | |||
72 | * cd to /Prebuild/ | ||
73 | * type 'nant' | ||
74 | |||
75 | After you've built it, it will land in the root /bin/ directory, | ||
76 | |||
77 | === Modyfying the OpenSim solution === | ||
78 | |||
79 | When adding or changing projects, modify the prebuild.xml and then execute | ||
80 | |||
81 | bin/Prebuild.exe /target {target} | ||
82 | |||
83 | where target is either | ||
84 | vs2005 - to generate new vs2005 solutions and projects | ||
85 | nant - to generate new nant build scripts | ||
86 | |||
87 | Remember to run prebuild whenever you've added or removed files as well. | ||
88 | |||
89 | |||
90 | LOCAL SET-UP OF OGS CONFIGURATION | ||
91 | |||
92 | **NOTE: At the moment OGS is non-functionable, so this WON'T WORK **NOTE | ||
93 | |||
94 | * start up bin/OpenGridServices.GridServer.exe (listens on http://localhost:8001/gridserver) | ||
95 | * just press enter to keep the defaults | ||
96 | |||
97 | * start up bin/OpenGridServices.UserServer.exe (listens on http://localhost:8002/userserver) | ||
98 | * just press enter to keep the defaults | ||
99 | |||
100 | * start up bin/OpenSim.exe ( listens for udp on port 9000 ) | ||
101 | * just press enter to keep the defaults | ||
102 | |||
103 | * start the secondlife viewer with -loginuri http://localhost:8080/ | ||
104 | |||
105 | === Trying Prototype Scripting Engine out === | ||
106 | |||
107 | * Update, build and run in sandbox mode. | ||
108 | * Use the admin web front localhost:9000/Admin, password Admin | ||
109 | * Create an account, then log in with the viewer | ||
110 | * Press 'Entities' in the admin view and memorize the guids (well, try to) | ||
111 | * Create a new object in the viewer | ||
112 | * Refresh the entities view (You might have to empty cache....) | ||
113 | * Locate the new guid, that's the primitive you just created | ||
114 | * Be sure to see both the object in the viewer and the admin web front. | ||
115 | * Press 'add test script'. | ||
116 | * Enjoy the blinkenlichten! \ No newline at end of file | ||
diff --git a/releng/README.txt b/releng/README.txt deleted file mode 100644 index 0d552bf..0000000 --- a/releng/README.txt +++ /dev/null | |||
@@ -1,116 +0,0 @@ | |||
1 | IMPORTANT NOTES | ||
2 | |||
3 | * Please note that at the moment, the sandbox login server has temporary changed from 8080 to 9000 - this will (probably) change back. | ||
4 | |||
5 | --- | ||
6 | |||
7 | BUILD INSTRUCTIONS | ||
8 | |||
9 | === Microsoft Visual Studio 2005 Sandbox Build === | ||
10 | |||
11 | * Check out the trunk code | ||
12 | |||
13 | * Build the /OpenSim.sln solution | ||
14 | |||
15 | * open cmd window, go to /bin and launch | ||
16 | OpenSim.exe -sandbox -loginserver | ||
17 | |||
18 | * open another cmd window, locate the secondlife executable | ||
19 | (In something like C:\Program Files\SecondLife ) | ||
20 | |||
21 | * run the viewer with | ||
22 | secondlife.exe -loginuri http://localhost:9000/ | ||
23 | |||
24 | * Have fun with your own sandbox! | ||
25 | |||
26 | == Linux/mono sandbox build == | ||
27 | |||
28 | * check out the trunk code | ||
29 | |||
30 | * ensure you have nant (http://nant.sf.net) installed | ||
31 | |||
32 | * cd to the trunk root directory and type "nant" | ||
33 | |||
34 | * cd to bin/ and run "mono OpenSim.exe -sandbox -loginserver" | ||
35 | |||
36 | |||
37 | RUNNING SANDBOX WITH USER ACCOUNTS | ||
38 | |||
39 | * open cmd window, go to /bin and launch | ||
40 | OpenSim.exe -sandbox -loginserver -useraccounts | ||
41 | |||
42 | * launch web browser, go to | ||
43 | http://localhost:9000/Admin | ||
44 | enter password 'Admin' | ||
45 | |||
46 | * Select 'Accounts', enter credentials, press 'Create' | ||
47 | |||
48 | * Now, log on thru your viewer (see above) with your newly created credentials. | ||
49 | |||
50 | * Have Fun! | ||
51 | |||
52 | |||
53 | |||
54 | PREBUILD | ||
55 | |||
56 | We use Prebuild to generate vs2005 solutions and nant build scripts. | ||
57 | |||
58 | === Building Prebuild === | ||
59 | |||
60 | At the moment, the Prebuild exe is shipped as /bin/Prebuild.exe so you shouldn't really have to build it. | ||
61 | |||
62 | But here's the instructions anyway : | ||
63 | |||
64 | The Prebuild master project is /prebuild.xml | ||
65 | |||
66 | To build it with vs2005 : | ||
67 | |||
68 | * build the solution /Prebuild/Prebuild.sln | ||
69 | |||
70 | To build it with nant : | ||
71 | |||
72 | * cd to /Prebuild/ | ||
73 | * type 'nant' | ||
74 | |||
75 | After you've built it, it will land in the root /bin/ directory, | ||
76 | |||
77 | === Modyfying the OpenSim solution === | ||
78 | |||
79 | When adding or changing projects, modify the prebuild.xml and then execute | ||
80 | |||
81 | bin/Prebuild.exe /target {target} | ||
82 | |||
83 | where target is either | ||
84 | vs2005 - to generate new vs2005 solutions and projects | ||
85 | nant - to generate new nant build scripts | ||
86 | |||
87 | Remember to run prebuild whenever you've added or removed files as well. | ||
88 | |||
89 | |||
90 | LOCAL SET-UP OF OGS CONFIGURATION | ||
91 | |||
92 | **NOTE: At the moment OGS is non-functionable, so this WON'T WORK **NOTE | ||
93 | |||
94 | * start up bin/OpenGridServices.GridServer.exe (listens on http://localhost:8001/gridserver) | ||
95 | * just press enter to keep the defaults | ||
96 | |||
97 | * start up bin/OpenGridServices.UserServer.exe (listens on http://localhost:8002/userserver) | ||
98 | * just press enter to keep the defaults | ||
99 | |||
100 | * start up bin/OpenSim.exe ( listens for udp on port 9000 ) | ||
101 | * just press enter to keep the defaults | ||
102 | |||
103 | * start the secondlife viewer with -loginuri http://localhost:8080/ | ||
104 | |||
105 | === Trying Prototype Scripting Engine out === | ||
106 | |||
107 | * Update, build and run in sandbox mode. | ||
108 | * Use the admin web front localhost:9000/Admin, password Admin | ||
109 | * Create an account, then log in with the viewer | ||
110 | * Press 'Entities' in the admin view and memorize the guids (well, try to) | ||
111 | * Create a new object in the viewer | ||
112 | * Refresh the entities view (You might have to empty cache....) | ||
113 | * Locate the new guid, that's the primitive you just created | ||
114 | * Be sure to see both the object in the viewer and the admin web front. | ||
115 | * Press 'add test script'. | ||
116 | * Enjoy the blinkenlichten! \ No newline at end of file | ||
diff --git a/releng/dist/INSTALL b/releng/dist/INSTALL new file mode 100644 index 0000000..f67fe43 --- /dev/null +++ b/releng/dist/INSTALL | |||
@@ -0,0 +1,33 @@ | |||
1 | INSTALLING FROM SOURCE WITH WINDOWS | ||
2 | |||
3 | 1 - Ensure you have visual studio express (the C# edition) | ||
4 | |||
5 | 2 - Check you have a clean source tree with the latest VS2005 solution, if unsure run prebuild (See README file) | ||
6 | |||
7 | 3 - Open the solution in visual studio and build it | ||
8 | |||
9 | 4 - Look in bin/ for the output | ||
10 | |||
11 | 5 - ??? | ||
12 | |||
13 | 6 - Profit | ||
14 | |||
15 | INSTALLING FROM SOURCE WITH LINUX/BSD/*NIX | ||
16 | |||
17 | 1 - Ensure you have a clean source tree with latest nant build files, if not, get one or run prebuild (See README file) | ||
18 | |||
19 | 2 - Go to a shell prompt and change to the correct directory | ||
20 | |||
21 | 3 - Type the following: | ||
22 | |||
23 | nant | ||
24 | |||
25 | 4 - Look in bin/ for the output | ||
26 | |||
27 | 5 - ??? | ||
28 | |||
29 | 6 - Profit | ||
30 | |||
31 | INSTALLING BINARY RELEASE | ||
32 | |||
33 | Simply extract the tarball into a good location and run straight out of bin/. You may also wish to put all the binaries into /opt/opensim on *nix systems and adjust your path accordingly. At time of writing there is no official way yet to do this. Watch this space. | ||
diff --git a/releng/dist/README b/releng/dist/README new file mode 100644 index 0000000..125d5da --- /dev/null +++ b/releng/dist/README | |||
@@ -0,0 +1,70 @@ | |||
1 | For installation notes, please read INSTALL | ||
2 | |||
3 | RUNNING SANDBOX MODE (the standard way) | ||
4 | |||
5 | To get up and running in sandbox mode, please start up opensim like this from the command line: | ||
6 | |||
7 | (first ensure you are in the right directory) | ||
8 | |||
9 | OpenSim.exe -sandbox (windows) | ||
10 | |||
11 | mono OpenSim.exe -sandbox (linux/BSD/MacOS X) | ||
12 | |||
13 | Then startup your second life viewer with the following parameters: | ||
14 | |||
15 | -loginuri http://yourserver:9000/ | ||
16 | |||
17 | The method to do this is dependent upon your OS. "yourserver" will be 127.0.0.1 if you accept the defaults when starting opensim. | ||
18 | |||
19 | |||
20 | RUNNING SANDBOX WITH USER ACCOUNTS | ||
21 | |||
22 | * open cmd window, go to /bin and launch | ||
23 | OpenSim.exe -sandbox -loginserver -useraccounts | ||
24 | |||
25 | * launch web browser, go to | ||
26 | http://localhost:9000/Admin | ||
27 | enter password 'Admin' | ||
28 | |||
29 | * Select 'Accounts', enter credentials, press 'Create' | ||
30 | |||
31 | * Now, log on thru your viewer (see above) with your newly created credentials. | ||
32 | |||
33 | * Have Fun! | ||
34 | |||
35 | |||
36 | PREBUILD | ||
37 | |||
38 | We use Prebuild to generate vs2005 solutions and nant build scripts. | ||
39 | |||
40 | === Building Prebuild === | ||
41 | |||
42 | At the moment, the Prebuild exe is shipped as /bin/Prebuild.exe so you shouldn't really have to build it. | ||
43 | |||
44 | But here's the instructions anyway : | ||
45 | |||
46 | The Prebuild master project is /prebuild.xml | ||
47 | |||
48 | To build it with vs2005 : | ||
49 | |||
50 | * build the solution /Prebuild/Prebuild.sln | ||
51 | |||
52 | To build it with nant : | ||
53 | |||
54 | * cd to /Prebuild/ | ||
55 | * type 'nant' | ||
56 | |||
57 | After you've built it, it will land in the root /bin/ directory, | ||
58 | |||
59 | === Modyfying the OpenSim solution === | ||
60 | |||
61 | When adding or changing projects, modify the prebuild.xml and then execute | ||
62 | |||
63 | bin/Prebuild.exe /target {target} | ||
64 | |||
65 | where target is either | ||
66 | vs2005 - to generate new vs2005 solutions and projects | ||
67 | nant - to generate new nant build scripts | ||
68 | |||
69 | Remember to run prebuild whenever you've added or removed files as well. | ||
70 | |||