ZOMG! A release-engineering setup (or rather, 2 scripts, working on it)

0.1-prestable
gareth 2007-05-05 17:42:48 +00:00
parent 19da87da0c
commit cce4963735
5 changed files with 109 additions and 232 deletions

4
releng/CAUTION Normal file
View File

@ -0,0 +1,4 @@
!!!!!!!!!!!!! DANGER DANGER !!!!!!!!!!!!!!!!!!!!!!!!!!!
DO NOT RUN ANY OF THE SCRIPTS IN THIS DIRECTORY WITHOUT
READING THEM!!!!!!!!!!!!!
!!!!!!!!!!!!! DANGER DANGER !!!!!!!!!!!!!!!!!!!!!!!!!!!

View File

@ -1,116 +1,2 @@
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!
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.

View File

@ -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!

33
releng/dist/INSTALL vendored Normal file
View File

@ -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.

70
releng/dist/README vendored Normal file
View File

@ -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.