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/dist/INSTALL | 33 +++++++++++++++++++++++++
 releng/dist/README  | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 103 insertions(+)
 create mode 100644 releng/dist/INSTALL
 create mode 100644 releng/dist/README

(limited to 'releng/dist')

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