From cce49637356c2110fd696c4ab0af33bf451d4c7d Mon Sep 17 00:00:00 2001 From: gareth Date: Sat, 5 May 2007 17:42:48 +0000 Subject: ZOMG! A release-engineering setup (or rather, 2 scripts, working on it) --- releng/CAUTION | 4 ++ releng/README | 118 +--------------------------------------------------- releng/README.txt | 116 --------------------------------------------------- releng/dist/INSTALL | 33 +++++++++++++++ releng/dist/README | 70 +++++++++++++++++++++++++++++++ 5 files changed, 109 insertions(+), 232 deletions(-) create mode 100644 releng/CAUTION delete mode 100644 releng/README.txt create mode 100644 releng/dist/INSTALL create mode 100644 releng/dist/README diff --git a/releng/CAUTION b/releng/CAUTION new file mode 100644 index 0000000..6418046 --- /dev/null +++ b/releng/CAUTION @@ -0,0 +1,4 @@ +!!!!!!!!!!!!! DANGER DANGER !!!!!!!!!!!!!!!!!!!!!!!!!!! +DO NOT RUN ANY OF THE SCRIPTS IN THIS DIRECTORY WITHOUT +READING THEM!!!!!!!!!!!!! +!!!!!!!!!!!!! DANGER DANGER !!!!!!!!!!!!!!!!!!!!!!!!!!! diff --git a/releng/README b/releng/README index 0d552bf..b4771a5 100644 --- a/releng/README +++ b/releng/README @@ -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! \ No newline at end of file +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. 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 @@ -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! \ 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 @@ +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. 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 @@ +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. + -- cgit v1.1