diff options
author | David Walter Seikel | 2016-12-10 23:35:35 +1000 |
---|---|---|
committer | David Walter Seikel | 2016-12-10 23:35:35 +1000 |
commit | a9186b7e1e01dce4662fd9fcd5cfdec431c1479e (patch) | |
tree | 9f34ffed89b94e66dd1e9946d7d9a38baf0ca5f3 | |
parent | Fix up creating sims. (diff) | |
download | opensim-SC-a9186b7e1e01dce4662fd9fcd5cfdec431c1479e.zip opensim-SC-a9186b7e1e01dce4662fd9fcd5cfdec431c1479e.tar.gz opensim-SC-a9186b7e1e01dce4662fd9fcd5cfdec431c1479e.tar.bz2 opensim-SC-a9186b7e1e01dce4662fd9fcd5cfdec431c1479e.tar.xz |
More docs.
-rw-r--r-- | README.md | 63 |
1 files changed, 56 insertions, 7 deletions
@@ -1,8 +1,51 @@ | |||
1 | Use this to create a sim that links into Infinite Grid from Linux. | 1 | Use this to create a sim that links into Infinite Grid from Linux. |
2 | 2 | ||
3 | It's only been tested on Ubuntu 10.04, 11.04, 12.04, and 16.04, YMMV. | 3 | It's only been tested on Ubuntu 10.04, 11.04, 12.04, 16.04' as well as |
4 | This is also a WIP, use it at your own risk. It's been used to set up | 4 | Debian 8, YMMV. This is also a WIP, use it at your own risk. It's been |
5 | a few freshly installed Ubuntu servers though. | 5 | used to set up a few freshly installed Ubuntu servers though. |
6 | |||
7 | The directory layout. | ||
8 | --------------------- | ||
9 | |||
10 | The 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 | |||
16 | OpenSim OpenSim source code. | ||
17 | |||
18 | Prebuild Used by the build system. | ||
19 | |||
20 | ThirdParty For third party OpenSim modules. | ||
21 | |||
22 | addon-modules Also for third party modules. Don't ask me why there's two. | ||
23 | |||
24 | bin The OpenSim binaries, and other files. | ||
25 | |||
26 | doc Supposedly for documentation, which I wish OpenSim devs would write some. | ||
27 | |||
28 | scripts Various Linux scripts for managing OpenSim. | ||
29 | |||
30 | share No idea really. | ||
31 | |||
32 | Also, the installation script moves the following directories to outside | ||
33 | of this main directory, they are all used for writing various things. | ||
34 | Makes it easy to upgrade, and separates them from actual executable | ||
35 | stuff. | ||
36 | |||
37 | AssetFiles Stores assets if running in grid mode. | ||
38 | |||
39 | backups All sim and inventory backups are stored here. | ||
40 | |||
41 | caches Various cached things. | ||
42 | |||
43 | config All your configurtion files. | ||
44 | |||
45 | db If you are not using MySQL, your data lives here. | ||
46 | |||
47 | logs Log files get stored here. | ||
48 | |||
6 | 49 | ||
7 | Follow these steps. | 50 | Follow these steps. |
8 | ------------------- | 51 | ------------------- |
@@ -20,7 +63,7 @@ rearranged so that there is only ONE copy of the OpenSim installation. | |||
20 | 63 | ||
21 | Next you need to figure out what password you want to use for OpenSims | 64 | Next you need to figure out what password you want to use for OpenSims |
22 | access to the database. We will call this "DatabasePassword". Run the | 65 | access to the database. We will call this "DatabasePassword". Run the |
23 | following script - | 66 | following 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, |
30 | probably at the end - | 73 | probably 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 | ||
35 | Creating sims. | 78 | Creating sims. |
@@ -47,7 +90,8 @@ A location for your sim, we will use "1234,5678". You can use the | |||
47 | Infinite Grid web based map to poke around and find a good location. | 90 | Infinite Grid web based map to poke around and find a good location. |
48 | Choose an empty spot. | 91 | Choose an empty spot. |
49 | 92 | ||
50 | Once you have all that information sorted out, run this script - | 93 | Once you have all that information sorted out, run this script from the |
94 | installed 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 | ||
102 | Also, 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 | |||
106 | Note that the size has to be a multiple of 256, so 512, 768, 1024, etc. | ||
58 | 107 | ||
59 | Running sims. | 108 | Running sims. |
60 | ------------- | 109 | ------------- |
@@ -81,7 +130,7 @@ Finishing up. | |||
81 | ------------- | 130 | ------------- |
82 | 131 | ||
83 | Once it's all tested, you can use this to finish things off (back in | 132 | Once it's all tested, you can use this to finish things off (back in |
84 | this setup directory) - | 133 | the scripts directory) - |
85 | 134 | ||
86 | ./go_live.sh | 135 | ./go_live.sh |
87 | 136 | ||