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