diff options
-rw-r--r-- | INSTALL.md | 56 |
1 files changed, 50 insertions, 6 deletions
@@ -12,6 +12,50 @@ risk. It's been used to set up a few freshly installed servers though. | |||
12 | It should work on recent Debian based Linux distros. | 12 | It should work on recent Debian based Linux distros. |
13 | 13 | ||
14 | 14 | ||
15 | For those in a hurry. | ||
16 | --------------------- | ||
17 | |||
18 | On a recent Debian based Linux (Debian, Devuan, Ubuntu, Mint, ...) | ||
19 | terminal, run the following command - | ||
20 | |||
21 | ./InstallItAll.sh | ||
22 | |||
23 | This will install the prerequisites (MariaDB, monit, MONO, tmux, | ||
24 | uuid-runtime); create a database in MariaDB called opensim_SC and a | ||
25 | database user called opensim_SC with a random password; add a Linux user | ||
26 | to your system called opensimsc; create the /opt/opensim_SC directory to | ||
27 | run it all from; copy everything to /opt/opensim_SC/opensim-SC_0.9.0.1; | ||
28 | setup the directory structure needed to run it all; create some default | ||
29 | configuration files; build OpenSim-SC; and finally change ownership and | ||
30 | file permissions for everything. | ||
31 | |||
32 | Next go to /opt/opensim_SC/current/scripts/install and run - | ||
33 | |||
34 | sudo ./create_sim.sh | ||
35 | |||
36 | This will create a randomly named sim at a randomly chosen position. Or | ||
37 | for something less random - | ||
38 | |||
39 | sudo ./create_sim.sh "My new sim" "1234,5678" | ||
40 | |||
41 | At this point /opt/opensim_SC/config/config.ini will be a symlink | ||
42 | pointing to config_localhost.ini, which is for a standalone sim. If you | ||
43 | want your new random sim to be part of Infinite Grid (IG) or Misfitz Grid | ||
44 | (MG) then you'll have to change that syml/ink to point to config_IG.ini or | ||
45 | config_MG.ini respectively. | ||
46 | |||
47 | /opt/opensim_SC/config/sim01 now contains the aactual configuration of | ||
48 | your randomly created sim. Edit the .xml file to make that sim a little | ||
49 | less random. | ||
50 | |||
51 | Finally run - | ||
52 | |||
53 | cd /opt/opensim_SC/config/sim01 | ||
54 | ./start-sim | ||
55 | |||
56 | To actually startup your sim. | ||
57 | |||
58 | |||
15 | The directory layout. | 59 | The directory layout. |
16 | --------------------- | 60 | --------------------- |
17 | 61 | ||
@@ -40,7 +84,7 @@ scripts Various Linux scripts for managing OpenSim. | |||
40 | 84 | ||
41 | share No idea really. | 85 | share No idea really. |
42 | 86 | ||
43 | Also, the installation script moves the following directories from the | 87 | Also, the installation script copies the following directories from the |
44 | example directory, to outside of this main directory, they are all used | 88 | example directory, to outside of this main directory, they are all used |
45 | for writing various things. Makes it easy to upgrade, and separates them | 89 | for writing various things. Makes it easy to upgrade, and separates them |
46 | from actual executable stuff. | 90 | from actual executable stuff. |
@@ -51,7 +95,7 @@ backups All sim and inventory backups are stored here. | |||
51 | 95 | ||
52 | caches Various cached things. | 96 | caches Various cached things. |
53 | 97 | ||
54 | config All your configurtion files. | 98 | config All your configuration files. |
55 | 99 | ||
56 | db If you are not using MySQL, your data lives here. | 100 | db If you are not using MySQL, your data lives here. |
57 | 101 | ||
@@ -87,17 +131,17 @@ Creating sims. | |||
87 | A separate script is here for sim creation, you can use it to create many | 131 | A separate script is here for sim creation, you can use it to create many |
88 | sims. You will need - | 132 | sims. You will need - |
89 | 133 | ||
90 | Your host name, or it could be your IP, we will use "sims.example.net". | ||
91 | |||
92 | A name for your sim, we will use "My new sim". It should be unique on | 134 | A name for your sim, we will use "My new sim". It should be unique on |
93 | the grid. | 135 | the grid. |
94 | 136 | ||
137 | Your host name, or it could be your IP, we will use "sims.example.net". | ||
138 | |||
95 | A location for your sim, we will use "1234,5678". You can use the | 139 | A location for your sim, we will use "1234,5678". You can use the |
96 | Infinite Grid web based map to poke around and find a good location. | 140 | Infinite Grid web based map to poke around and find a good location. |
97 | Choose an empty spot. | 141 | Choose an empty spot. |
98 | 142 | ||
99 | Once you have all that information sorted out, run this script from the | 143 | Once you have all that information sorted out, run this script from the |
100 | installed scripts directory - | 144 | scripts/install directory - |
101 | 145 | ||
102 | ./create_sim.sh "My new sim" "1234,5678" "sims.example.net" | 146 | ./create_sim.sh "My new sim" "1234,5678" "sims.example.net" |
103 | 147 | ||
@@ -152,7 +196,7 @@ This attempts to use only one copy of the OS install for all sims. We | |||
152 | are running one instance of OS for each sim though, as this prevents one | 196 | are running one instance of OS for each sim though, as this prevents one |
153 | sim crashing from bringing down the others. OS however really wants to | 197 | sim crashing from bringing down the others. OS however really wants to |
154 | write data to directories within it's own bin directory. I'm not at all | 198 | write data to directories within it's own bin directory. I'm not at all |
155 | certian if that data can be shared. For the same reason, so far I've | 199 | certain if that data can be shared. For the same reason, so far I've |
156 | not been able to get to the point where we can make the OS directory | 200 | not been able to get to the point where we can make the OS directory |
157 | read only. This complicates things during upgrades. | 201 | read only. This complicates things during upgrades. |
158 | 202 | ||