diff options
Diffstat (limited to '')
-rw-r--r-- | INSTALL.md | 161 |
1 files changed, 161 insertions, 0 deletions
diff --git a/INSTALL.md b/INSTALL.md new file mode 100644 index 0000000..bfab985 --- /dev/null +++ b/INSTALL.md | |||
@@ -0,0 +1,161 @@ | |||
1 | NOTE - this is the OpenSim 0.9.0.1 version in the SledjChisel branch, | ||
2 | which isn't quite ready yet. Use 0.8.2.1 in the master branch for the | ||
3 | stable well tested version. | ||
4 | |||
5 | |||
6 | Use this to create a sim that links into Infinite Grid or Misfitz Grid | ||
7 | from Linux. | ||
8 | |||
9 | It's only been tested on Ubuntu 10.04, 11.04, 12.04, 16.04, as well as | ||
10 | Debian 8, and Devuan 9, YMMV. This is also a WIP, use it at your own | ||
11 | risk. It's been used to set up a few freshly installed servers though. | ||
12 | |||
13 | The directory layout. | ||
14 | --------------------- | ||
15 | |||
16 | The various directories are - | ||
17 | |||
18 | .git Used by git for it's internal accounting, and the older versions. | ||
19 | |||
20 | .nant Used by the nant build tool. | ||
21 | |||
22 | OpenSim OpenSim source code. | ||
23 | |||
24 | Prebuild Used by the build system. | ||
25 | |||
26 | ThirdParty For third party OpenSim modules. | ||
27 | ThirdPartyLicenses | ||
28 | |||
29 | addon-modules Also for third party modules. Don't ask me why there's two. | ||
30 | |||
31 | bin The OpenSim binaries, and other files. | ||
32 | |||
33 | doc Supposedly for documentation, which I wish OpenSim devs would write some. | ||
34 | |||
35 | example An example of how to set this all up. | ||
36 | |||
37 | scripts Various Linux scripts for managing OpenSim. | ||
38 | |||
39 | share No idea really. | ||
40 | |||
41 | Also, the installation script moves the following directories from the | ||
42 | example directory, to outside of this main directory, they are all used | ||
43 | for writing various things. Makes it easy to upgrade, and separates them | ||
44 | from actual executable stuff. | ||
45 | |||
46 | AssetFiles Stores assets if running in grid mode. | ||
47 | |||
48 | backups All sim and inventory backups are stored here. | ||
49 | |||
50 | caches Various cached things. | ||
51 | |||
52 | config All your configurtion files. | ||
53 | |||
54 | db If you are not using MySQL, your data lives here. | ||
55 | |||
56 | logs Log files get stored here. | ||
57 | |||
58 | |||
59 | Follow these steps. | ||
60 | ------------------- | ||
61 | |||
62 | Go to - | ||
63 | |||
64 | https://www.infinitegrid.org/drupal/content/How_to_link_your_OpenSim_region_to_Infinite_Grid_LinuxMySQL | ||
65 | |||
66 | and follow the directions to create an admin user account. You can skip | ||
67 | that bit if you already have a suitable user with sudo access. | ||
68 | |||
69 | Note that these scripts pretty much follow that above wiki description, | ||
70 | with some exceptions. The configuration information per sim has been | ||
71 | rearranged so that there is only ONE copy of the OpenSim installation. | ||
72 | |||
73 | Next you need to figure out what password you want to use for OpenSims | ||
74 | access to the database. We will call this "DatabasePassword". Run the | ||
75 | following script, from inside the OpenSim directory - | ||
76 | |||
77 | ./InstallItAll.sh DatabasePassword | ||
78 | |||
79 | This will do most of the work for you, except for creating sims. There | ||
80 | is a final step that needs to be done manually for now. Edit | ||
81 | /etc/rc.local, make sure it has the following line in it somewhere, | ||
82 | probably at the end - | ||
83 | |||
84 | /opt/opensim/current/scripts/fix_var_run.sh | ||
85 | |||
86 | |||
87 | Creating sims. | ||
88 | -------------- | ||
89 | |||
90 | A separate script is here for sim creation, you can use it to create many | ||
91 | sims. You will need - | ||
92 | |||
93 | Your host name, or it could be your IP, we will use "sims.example.net". | ||
94 | |||
95 | A name for your sim, we will use "My new sim". It should be unique on | ||
96 | the grid. | ||
97 | |||
98 | A location for your sim, we will use "1234,5678". You can use the | ||
99 | Infinite Grid web based map to poke around and find a good location. | ||
100 | Choose an empty spot. | ||
101 | |||
102 | Once you have all that information sorted out, run this script from the | ||
103 | installed scripts directory - | ||
104 | |||
105 | ./create_sim.sh "My new sim" "1234,5678" "sims.example.net" | ||
106 | |||
107 | Or this if you want to override the detected IP address - | ||
108 | |||
109 | ./create_sim.sh "My new sim" "1234,5678" "sims.example.net" "1.2.3.4" | ||
110 | |||
111 | Also, you can create a varregion with something like - | ||
112 | |||
113 | ./create_sim.sh "My new sim" "1234,5678" "sims.example.net" "1.2.3.4" 512 | ||
114 | |||
115 | Note that the size has to be a multiple of 256, so 512, 768, 1024, etc. | ||
116 | |||
117 | Running sims. | ||
118 | ------------- | ||
119 | |||
120 | Now you can go to /opt/opensim/config/sim01 and run the following script | ||
121 | to start it up - | ||
122 | |||
123 | ./start-sim | ||
124 | |||
125 | You will see the screen console. You can run the screen console again by | ||
126 | running that command once more, or running the sim-console command. | ||
127 | |||
128 | You can stop the sim with - | ||
129 | |||
130 | ./stop-sim | ||
131 | |||
132 | You can backup the sim with - | ||
133 | |||
134 | ./backup-sim | ||
135 | |||
136 | |||
137 | |||
138 | Finishing up. | ||
139 | ------------- | ||
140 | |||
141 | Once it's all tested, you can use this to finish things off (back in | ||
142 | the scripts directory) - | ||
143 | |||
144 | ./go_live.sh | ||
145 | |||
146 | Which sets up the monit control file/s, though you should double check | ||
147 | it all, and you still have to do the basic configuration and enabling of | ||
148 | monit yourself. This is in case you already have monit set the way you | ||
149 | like. | ||
150 | |||
151 | |||
152 | NOTES - | ||
153 | |||
154 | This attempts to use only one copy of the OS install for all sims. We | ||
155 | are running one instance of OS for each sim though, as this prevents one | ||
156 | sim crashing from bringing down the others. OS however really wants to | ||
157 | write data to directories within it's own bin directory. I'm not at all | ||
158 | certian if that data can be shared. For the same reason, so far I've | ||
159 | not been able to get to the point where we can make the OS directory | ||
160 | read only. This complicates things during upgrades. | ||
161 | |||