ZOMG! A release-engineering setup (or rather, 2 scripts, working on it)
gareth
parent
19da87da0c
commit
cce4963735
|
|
@ -0,0 +1,4 @@
|
||||||
|
!!!!!!!!!!!!! DANGER DANGER !!!!!!!!!!!!!!!!!!!!!!!!!!!
|
||||||
|
DO NOT RUN ANY OF THE SCRIPTS IN THIS DIRECTORY WITHOUT
|
||||||
|
READING THEM!!!!!!!!!!!!!
|
||||||
|
!!!!!!!!!!!!! DANGER DANGER !!!!!!!!!!!!!!!!!!!!!!!!!!!
|
||||||
118
releng/README
118
releng/README
|
|
@ -1,116 +1,2 @@
|
||||||
IMPORTANT NOTES
|
This directory contains scripts etc for creating a tarball/package out of the SVN tree.
|
||||||
|
It is designed to be run before releases or by developers/users before a local install from source.
|
||||||
* 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!
|
|
||||||
|
|
|
||||||
|
|
@ -1,116 +0,0 @@
|
||||||
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!
|
|
||||||
|
|
@ -0,0 +1,33 @@
|
||||||
|
INSTALLING FROM SOURCE WITH WINDOWS
|
||||||
|
|
||||||
|
1 - Ensure you have visual studio express (the C# edition)
|
||||||
|
|
||||||
|
2 - Check you have a clean source tree with the latest VS2005 solution, if unsure run prebuild (See README file)
|
||||||
|
|
||||||
|
3 - Open the solution in visual studio and build it
|
||||||
|
|
||||||
|
4 - Look in bin/ for the output
|
||||||
|
|
||||||
|
5 - ???
|
||||||
|
|
||||||
|
6 - Profit
|
||||||
|
|
||||||
|
INSTALLING FROM SOURCE WITH LINUX/BSD/*NIX
|
||||||
|
|
||||||
|
1 - Ensure you have a clean source tree with latest nant build files, if not, get one or run prebuild (See README file)
|
||||||
|
|
||||||
|
2 - Go to a shell prompt and change to the correct directory
|
||||||
|
|
||||||
|
3 - Type the following:
|
||||||
|
|
||||||
|
nant
|
||||||
|
|
||||||
|
4 - Look in bin/ for the output
|
||||||
|
|
||||||
|
5 - ???
|
||||||
|
|
||||||
|
6 - Profit
|
||||||
|
|
||||||
|
INSTALLING BINARY RELEASE
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
@ -0,0 +1,70 @@
|
||||||
|
For installation notes, please read INSTALL
|
||||||
|
|
||||||
|
RUNNING SANDBOX MODE (the standard way)
|
||||||
|
|
||||||
|
To get up and running in sandbox mode, please start up opensim like this from the command line:
|
||||||
|
|
||||||
|
(first ensure you are in the right directory)
|
||||||
|
|
||||||
|
OpenSim.exe -sandbox (windows)
|
||||||
|
|
||||||
|
mono OpenSim.exe -sandbox (linux/BSD/MacOS X)
|
||||||
|
|
||||||
|
Then startup your second life viewer with the following parameters:
|
||||||
|
|
||||||
|
-loginuri http://yourserver:9000/
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
Loading…
Reference in New Issue