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

2 files changed, 103 insertions, 0 deletions

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.

+