aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--README.md104
1 files changed, 104 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c648e6a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,104 @@
1Use this to create a sim that links into Infinite Grid from Linux.
2
3It's only been tested on Ubuntu 10.04, 11.04, and 12.04, YMMV. This is
4also a WIP, use it at your own risk. It's been used to set up two
5freshly installed Ubuntu servers though.
6
7Follow these steps.
8-------------------
9
10Go to -
11
12http://wiki.infinitegrid.org/index.php/Howto_Link_your_Opensim_region_to_Infinite_Grid
13
14and follow the directions to create an admin user account. You can skip
15that bit if you already have a suitable user with sudo access.
16
17Note that these scripts pretty much follow that above wiki description,
18with some exceptions. The configuration information per sim has been
19rearranged so that there is only ONE copy of the OpenSim installation.
20
21Next you need to figure out what password you want to use for OpenSims
22access to the database. We will call this "DatabasePassword". Run the
23following script -
24
25./install_opensim.sh DatabasePassword
26
27This will do most of the work for you, except for creating sims. There
28is 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,
30probably at the end -
31
32/opt/opensim/setup/fix_var_run.sh
33
34
35Creating sims.
36--------------
37
38A separate script is here for sim creation, you can use it to create many
39sims. You will need -
40
41Your host name, or it could be your IP, we will use "sims.example.net".
42
43A name for your sim, we will use "My new sim". It should be unique on
44the grid.
45
46A 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.
48Choose an empty spot.
49
50Once you have all that information sorted out, run this script -
51
52./create_sim.sh "My new sim" "1234,5678" "sims.example.net"
53
54Or this if you want to override the detected IP address -
55
56./create_sim.sh "My new sim" "1234,5678" "sims.example.net" "1.2.3.4"
57
58
59Running sims.
60-------------
61
62Now you can go to /opt/opensim/config/sim01 and run the following script
63to start it up -
64
65./start-sim
66
67You will see the screen console. You can run the screen console again by
68running that command once more, or running the sim-console command.
69
70You can stop the sim with -
71
72./stop-sim
73
74You can backup the sim with -
75
76./backup-sim
77
78Though they all get backed up every six hours anyway.
79
80
81Finishing up.
82-------------
83
84Once it's all tested, you can use this to finish things off (back in
85this setup directory) -
86
87./go_live.sh
88
89Which sets up the monit control file/s, though you should double check
90it all, and you still have to do the basic configuration and enabling of
91monit yourself. This is in case you already have monit set the way you
92like.
93
94
95NOTES -
96
97This attempts to use only one copy of the OS install for all sims. We
98are running one instance of OS for each sim though, as this prevents one
99sim crashing from bringing down the others. OS however really wants to
100write data to directories within it's own bin directory. I'm not at all
101certian if that data can be shared. For the same reason, so far I've
102not been able to get to the point where we can make the OS directory
103read only. This complicates things during upgrades.
104