aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/releng
diff options
context:
space:
mode:
authorgareth2007-05-05 17:42:48 +0000
committergareth2007-05-05 17:42:48 +0000
commitcce49637356c2110fd696c4ab0af33bf451d4c7d (patch)
treedd66a0cfbc6711dde164238c1eb76f29b1cecc5c /releng
parent(no commit message) (diff)
downloadopensim-SC_OLD-cce49637356c2110fd696c4ab0af33bf451d4c7d.zip
opensim-SC_OLD-cce49637356c2110fd696c4ab0af33bf451d4c7d.tar.gz
opensim-SC_OLD-cce49637356c2110fd696c4ab0af33bf451d4c7d.tar.bz2
opensim-SC_OLD-cce49637356c2110fd696c4ab0af33bf451d4c7d.tar.xz
ZOMG! A release-engineering setup (or rather, 2 scripts, working on it)
Diffstat (limited to '')
-rw-r--r--releng/CAUTION4
-rw-r--r--releng/README118
-rw-r--r--releng/README.txt116
-rw-r--r--releng/dist/INSTALL33
-rw-r--r--releng/dist/README70
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 !!!!!!!!!!!!!!!!!!!!!!!!!!!
2DO NOT RUN ANY OF THE SCRIPTS IN THIS DIRECTORY WITHOUT
3READING 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 @@
1IMPORTANT NOTES 1This directory contains scripts etc for creating a tarball/package out of the SVN tree.
2 2It 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
7BUILD 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
16OpenSim.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
22secondlife.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
37RUNNING SANDBOX WITH USER ACCOUNTS
38
39* open cmd window, go to /bin and launch
40OpenSim.exe -sandbox -loginserver -useraccounts
41
42* launch web browser, go to
43http://localhost:9000/Admin
44enter 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
54PREBUILD
55
56We use Prebuild to generate vs2005 solutions and nant build scripts.
57
58=== Building Prebuild ===
59
60At the moment, the Prebuild exe is shipped as /bin/Prebuild.exe so you shouldn't really have to build it.
61
62But here's the instructions anyway :
63
64The Prebuild master project is /prebuild.xml
65
66To build it with vs2005 :
67
68* build the solution /Prebuild/Prebuild.sln
69
70To build it with nant :
71
72* cd to /Prebuild/
73* type 'nant'
74
75After you've built it, it will land in the root /bin/ directory,
76
77=== Modyfying the OpenSim solution ===
78
79When adding or changing projects, modify the prebuild.xml and then execute
80
81bin/Prebuild.exe /target {target}
82
83where target is either
84vs2005 - to generate new vs2005 solutions and projects
85nant - to generate new nant build scripts
86
87Remember to run prebuild whenever you've added or removed files as well.
88
89
90LOCAL 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 @@
1IMPORTANT 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
7BUILD 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
16OpenSim.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
22secondlife.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
37RUNNING SANDBOX WITH USER ACCOUNTS
38
39* open cmd window, go to /bin and launch
40OpenSim.exe -sandbox -loginserver -useraccounts
41
42* launch web browser, go to
43http://localhost:9000/Admin
44enter 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
54PREBUILD
55
56We use Prebuild to generate vs2005 solutions and nant build scripts.
57
58=== Building Prebuild ===
59
60At the moment, the Prebuild exe is shipped as /bin/Prebuild.exe so you shouldn't really have to build it.
61
62But here's the instructions anyway :
63
64The Prebuild master project is /prebuild.xml
65
66To build it with vs2005 :
67
68* build the solution /Prebuild/Prebuild.sln
69
70To build it with nant :
71
72* cd to /Prebuild/
73* type 'nant'
74
75After you've built it, it will land in the root /bin/ directory,
76
77=== Modyfying the OpenSim solution ===
78
79When adding or changing projects, modify the prebuild.xml and then execute
80
81bin/Prebuild.exe /target {target}
82
83where target is either
84vs2005 - to generate new vs2005 solutions and projects
85nant - to generate new nant build scripts
86
87Remember to run prebuild whenever you've added or removed files as well.
88
89
90LOCAL 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 @@
1INSTALLING FROM SOURCE WITH WINDOWS
2
31 - Ensure you have visual studio express (the C# edition)
4
52 - Check you have a clean source tree with the latest VS2005 solution, if unsure run prebuild (See README file)
6
73 - Open the solution in visual studio and build it
8
94 - Look in bin/ for the output
10
115 - ???
12
136 - Profit
14
15INSTALLING FROM SOURCE WITH LINUX/BSD/*NIX
16
171 - Ensure you have a clean source tree with latest nant build files, if not, get one or run prebuild (See README file)
18
192 - Go to a shell prompt and change to the correct directory
20
213 - Type the following:
22
23nant
24
254 - Look in bin/ for the output
26
275 - ???
28
296 - Profit
30
31INSTALLING BINARY RELEASE
32
33Simply 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 @@
1For installation notes, please read INSTALL
2
3RUNNING SANDBOX MODE (the standard way)
4
5To 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
9OpenSim.exe -sandbox (windows)
10
11mono OpenSim.exe -sandbox (linux/BSD/MacOS X)
12
13Then startup your second life viewer with the following parameters:
14
15-loginuri http://yourserver:9000/
16
17The 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
20RUNNING SANDBOX WITH USER ACCOUNTS
21
22* open cmd window, go to /bin and launch
23OpenSim.exe -sandbox -loginserver -useraccounts
24
25* launch web browser, go to
26http://localhost:9000/Admin
27enter 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
36PREBUILD
37
38We use Prebuild to generate vs2005 solutions and nant build scripts.
39
40=== Building Prebuild ===
41
42At the moment, the Prebuild exe is shipped as /bin/Prebuild.exe so you shouldn't really have to build it.
43
44But here's the instructions anyway :
45
46The Prebuild master project is /prebuild.xml
47
48To build it with vs2005 :
49
50* build the solution /Prebuild/Prebuild.sln
51
52To build it with nant :
53
54* cd to /Prebuild/
55* type 'nant'
56
57After you've built it, it will land in the root /bin/ directory,
58
59=== Modyfying the OpenSim solution ===
60
61When adding or changing projects, modify the prebuild.xml and then execute
62
63bin/Prebuild.exe /target {target}
64
65where target is either
66vs2005 - to generate new vs2005 solutions and projects
67nant - to generate new nant build scripts
68
69Remember to run prebuild whenever you've added or removed files as well.
70