aboutsummaryrefslogtreecommitdiffstatshomepage
diff options
context:
space:
mode:
authorDavid Walter Seikel2016-12-10 23:35:35 +1000
committerDavid Walter Seikel2016-12-10 23:35:35 +1000
commita9186b7e1e01dce4662fd9fcd5cfdec431c1479e (patch)
tree9f34ffed89b94e66dd1e9946d7d9a38baf0ca5f3
parentFix up creating sims. (diff)
downloadopensim-SC-a9186b7e1e01dce4662fd9fcd5cfdec431c1479e.zip
opensim-SC-a9186b7e1e01dce4662fd9fcd5cfdec431c1479e.tar.gz
opensim-SC-a9186b7e1e01dce4662fd9fcd5cfdec431c1479e.tar.bz2
opensim-SC-a9186b7e1e01dce4662fd9fcd5cfdec431c1479e.tar.xz
More docs.
-rw-r--r--README.md63
1 files changed, 56 insertions, 7 deletions
diff --git a/README.md b/README.md
index 3ab2339..c31b92d 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,51 @@
1Use this to create a sim that links into Infinite Grid from Linux. 1Use this to create a sim that links into Infinite Grid from Linux.
2 2
3It's only been tested on Ubuntu 10.04, 11.04, 12.04, and 16.04, YMMV. 3It's only been tested on Ubuntu 10.04, 11.04, 12.04, 16.04' as well as
4This is also a WIP, use it at your own risk. It's been used to set up 4Debian 8, YMMV. This is also a WIP, use it at your own risk. It's been
5a few freshly installed Ubuntu servers though. 5used to set up a few freshly installed Ubuntu servers though.
6
7The directory layout.
8---------------------
9
10The various directories are -
11
12.git Used by git for it's internal accounting, and the older versions.
13
14.nant Used by the nant build tool.
15
16OpenSim OpenSim source code.
17
18Prebuild Used by the build system.
19
20ThirdParty For third party OpenSim modules.
21
22addon-modules Also for third party modules. Don't ask me why there's two.
23
24bin The OpenSim binaries, and other files.
25
26doc Supposedly for documentation, which I wish OpenSim devs would write some.
27
28scripts Various Linux scripts for managing OpenSim.
29
30share No idea really.
31
32Also, the installation script moves the following directories to outside
33of this main directory, they are all used for writing various things.
34Makes it easy to upgrade, and separates them from actual executable
35stuff.
36
37AssetFiles Stores assets if running in grid mode.
38
39backups All sim and inventory backups are stored here.
40
41caches Various cached things.
42
43config All your configurtion files.
44
45db If you are not using MySQL, your data lives here.
46
47logs Log files get stored here.
48
6 49
7Follow these steps. 50Follow these steps.
8------------------- 51-------------------
@@ -20,7 +63,7 @@ rearranged so that there is only ONE copy of the OpenSim installation.
20 63
21Next you need to figure out what password you want to use for OpenSims 64Next you need to figure out what password you want to use for OpenSims
22access to the database. We will call this "DatabasePassword". Run the 65access to the database. We will call this "DatabasePassword". Run the
23following script - 66following script, from inside the OpenSim directory -
24 67
25./InstallItAll.sh DatabasePassword 68./InstallItAll.sh DatabasePassword
26 69
@@ -29,7 +72,7 @@ is a final step that needs to be done manually for now. Edit
29/etc/rc.local, make sure it has the following line in it somewhere, 72/etc/rc.local, make sure it has the following line in it somewhere,
30probably at the end - 73probably at the end -
31 74
32/opt/opensim/setup/fix_var_run.sh 75/opt/opensim/current/scripts/fix_var_run.sh
33 76
34 77
35Creating sims. 78Creating sims.
@@ -47,7 +90,8 @@ A location for your sim, we will use "1234,5678". You can use the
47Infinite Grid web based map to poke around and find a good location. 90Infinite Grid web based map to poke around and find a good location.
48Choose an empty spot. 91Choose an empty spot.
49 92
50Once you have all that information sorted out, run this script - 93Once you have all that information sorted out, run this script from the
94installed scripts directory -
51 95
52./create_sim.sh "My new sim" "1234,5678" "sims.example.net" 96./create_sim.sh "My new sim" "1234,5678" "sims.example.net"
53 97
@@ -55,6 +99,11 @@ Or this if you want to override the detected IP address -
55 99
56./create_sim.sh "My new sim" "1234,5678" "sims.example.net" "1.2.3.4" 100./create_sim.sh "My new sim" "1234,5678" "sims.example.net" "1.2.3.4"
57 101
102Also, you can create a varregion with something like -
103
104./create_sim.sh "My new sim" "1234,5678" "sims.example.net" "1.2.3.4" 512
105
106Note that the size has to be a multiple of 256, so 512, 768, 1024, etc.
58 107
59Running sims. 108Running sims.
60------------- 109-------------
@@ -81,7 +130,7 @@ Finishing up.
81------------- 130-------------
82 131
83Once it's all tested, you can use this to finish things off (back in 132Once it's all tested, you can use this to finish things off (back in
84this setup directory) - 133the scripts directory) -
85 134
86./go_live.sh 135./go_live.sh
87 136