diff options
| author | MW | 2007-05-26 13:40:19 +0000 |
|---|---|---|
| committer | MW | 2007-05-26 13:40:19 +0000 |
| commit | 3436961bb5c01d659d09be134368f4f69460cef9 (patch) | |
| tree | 3753ba4d7818df2a6bce0bbe863ff033cdfd568a /releng/dist | |
| download | opensim-SC_OLD-3436961bb5c01d659d09be134368f4f69460cef9.zip opensim-SC_OLD-3436961bb5c01d659d09be134368f4f69460cef9.tar.gz opensim-SC_OLD-3436961bb5c01d659d09be134368f4f69460cef9.tar.bz2 opensim-SC_OLD-3436961bb5c01d659d09be134368f4f69460cef9.tar.xz | |
Start of rewrite 5279!
Diffstat (limited to 'releng/dist')
| -rw-r--r-- | releng/dist/INSTALL | 33 | ||||
| -rw-r--r-- | releng/dist/README | 70 | ||||
| -rw-r--r-- | releng/dist/bin/OpenSim | 3 |
3 files changed, 106 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 @@ | |||
| 1 | INSTALLING FROM SOURCE WITH WINDOWS | ||
| 2 | |||
| 3 | 1 - Ensure you have visual studio express (the C# edition) | ||
| 4 | |||
| 5 | 2 - Check you have a clean source tree with the latest VS2005 solution, if unsure run prebuild (See README file) | ||
| 6 | |||
| 7 | 3 - Open the solution in visual studio and build it | ||
| 8 | |||
| 9 | 4 - Look in bin/ for the output | ||
| 10 | |||
| 11 | 5 - ??? | ||
| 12 | |||
| 13 | 6 - Profit | ||
| 14 | |||
| 15 | INSTALLING FROM SOURCE WITH LINUX/BSD/*NIX | ||
| 16 | |||
| 17 | 1 - Ensure you have a clean source tree with latest nant build files, if not, get one or run prebuild (See README file) | ||
| 18 | |||
| 19 | 2 - Go to a shell prompt and change to the correct directory | ||
| 20 | |||
| 21 | 3 - Type the following: | ||
| 22 | |||
| 23 | nant | ||
| 24 | |||
| 25 | 4 - Look in bin/ for the output | ||
| 26 | |||
| 27 | 5 - ??? | ||
| 28 | |||
| 29 | 6 - Profit | ||
| 30 | |||
| 31 | INSTALLING BINARY RELEASE | ||
| 32 | |||
| 33 | 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 @@ | |||
| 1 | For installation notes, please read INSTALL | ||
| 2 | |||
| 3 | RUNNING SANDBOX MODE (the standard way) | ||
| 4 | |||
| 5 | To get up and running in sandbox mode, please start up opensim like this from the command line: | ||
| 6 | |||
| 7 | (first ensure you are in the right directory) | ||
| 8 | |||
| 9 | OpenSim.exe -sandbox (windows) | ||
| 10 | |||
| 11 | mono OpenSim.exe -sandbox (linux/BSD/MacOS X) | ||
| 12 | |||
| 13 | Then startup your second life viewer with the following parameters: | ||
| 14 | |||
| 15 | -loginuri http://yourserver:9000/ | ||
| 16 | |||
| 17 | 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. | ||
| 18 | |||
| 19 | |||
| 20 | RUNNING SANDBOX WITH USER ACCOUNTS | ||
| 21 | |||
| 22 | * open cmd window, go to /bin and launch | ||
| 23 | OpenSim.exe -sandbox -loginserver -useraccounts | ||
| 24 | |||
| 25 | * launch web browser, go to | ||
| 26 | http://localhost:9000/Admin | ||
| 27 | enter password 'Admin' | ||
| 28 | |||
| 29 | * Select 'Accounts', enter credentials, press 'Create' | ||
| 30 | |||
| 31 | * Now, log on thru your viewer (see above) with your newly created credentials. | ||
| 32 | |||
| 33 | * Have Fun! | ||
| 34 | |||
| 35 | |||
| 36 | PREBUILD | ||
| 37 | |||
| 38 | We use Prebuild to generate vs2005 solutions and nant build scripts. | ||
| 39 | |||
| 40 | === Building Prebuild === | ||
| 41 | |||
| 42 | At the moment, the Prebuild exe is shipped as /bin/Prebuild.exe so you shouldn't really have to build it. | ||
| 43 | |||
| 44 | But here's the instructions anyway : | ||
| 45 | |||
| 46 | The Prebuild master project is /prebuild.xml | ||
| 47 | |||
| 48 | To build it with vs2005 : | ||
| 49 | |||
| 50 | * build the solution /Prebuild/Prebuild.sln | ||
| 51 | |||
| 52 | To build it with nant : | ||
| 53 | |||
| 54 | * cd to /Prebuild/ | ||
| 55 | * type 'nant' | ||
| 56 | |||
| 57 | After you've built it, it will land in the root /bin/ directory, | ||
| 58 | |||
| 59 | === Modyfying the OpenSim solution === | ||
| 60 | |||
| 61 | When adding or changing projects, modify the prebuild.xml and then execute | ||
| 62 | |||
| 63 | bin/Prebuild.exe /target {target} | ||
| 64 | |||
| 65 | where target is either | ||
| 66 | vs2005 - to generate new vs2005 solutions and projects | ||
| 67 | nant - to generate new nant build scripts | ||
| 68 | |||
| 69 | Remember to run prebuild whenever you've added or removed files as well. | ||
| 70 | |||
diff --git a/releng/dist/bin/OpenSim b/releng/dist/bin/OpenSim new file mode 100644 index 0000000..9b46075 --- /dev/null +++ b/releng/dist/bin/OpenSim | |||
| @@ -0,0 +1,3 @@ | |||
| 1 | #!/bin/sh | ||
| 2 | |||
| 3 | mono OpenSim.exe $* | ||