From 553748e76cbbf18ae9d29b3d081a3b44aff7474e Mon Sep 17 00:00:00 2001 From: onefang Date: Mon, 20 May 2019 20:10:57 +1000 Subject: Initial tweaks of the installation stuff. --- INSTALL.md | 161 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 161 insertions(+) create mode 100644 INSTALL.md (limited to 'INSTALL.md') diff --git a/INSTALL.md b/INSTALL.md new file mode 100644 index 0000000..bfab985 --- /dev/null +++ b/INSTALL.md @@ -0,0 +1,161 @@ +NOTE - this is the OpenSim 0.9.0.1 version in the SledjChisel branch, +which isn't quite ready yet. Use 0.8.2.1 in the master branch for the +stable well tested version. + + +Use this to create a sim that links into Infinite Grid or Misfitz Grid +from Linux. + +It's only been tested on Ubuntu 10.04, 11.04, 12.04, 16.04, as well as +Debian 8, and Devuan 9, YMMV. This is also a WIP, use it at your own +risk. It's been used to set up a few freshly installed servers though. + +The directory layout. +--------------------- + +The various directories are - + +.git Used by git for it's internal accounting, and the older versions. + +.nant Used by the nant build tool. + +OpenSim OpenSim source code. + +Prebuild Used by the build system. + +ThirdParty For third party OpenSim modules. +ThirdPartyLicenses + +addon-modules Also for third party modules. Don't ask me why there's two. + +bin The OpenSim binaries, and other files. + +doc Supposedly for documentation, which I wish OpenSim devs would write some. + +example An example of how to set this all up. + +scripts Various Linux scripts for managing OpenSim. + +share No idea really. + +Also, the installation script moves the following directories from the +example directory, to outside of this main directory, they are all used +for writing various things. Makes it easy to upgrade, and separates them +from actual executable stuff. + +AssetFiles Stores assets if running in grid mode. + +backups All sim and inventory backups are stored here. + +caches Various cached things. + +config All your configurtion files. + +db If you are not using MySQL, your data lives here. + +logs Log files get stored here. + + +Follow these steps. +------------------- + +Go to - + +https://www.infinitegrid.org/drupal/content/How_to_link_your_OpenSim_region_to_Infinite_Grid_LinuxMySQL + +and follow the directions to create an admin user account. You can skip +that bit if you already have a suitable user with sudo access. + +Note that these scripts pretty much follow that above wiki description, +with some exceptions. The configuration information per sim has been +rearranged so that there is only ONE copy of the OpenSim installation. + +Next you need to figure out what password you want to use for OpenSims +access to the database. We will call this "DatabasePassword". Run the +following script, from inside the OpenSim directory - + +./InstallItAll.sh DatabasePassword + +This will do most of the work for you, except for creating sims. There +is a final step that needs to be done manually for now. Edit +/etc/rc.local, make sure it has the following line in it somewhere, +probably at the end - + +/opt/opensim/current/scripts/fix_var_run.sh + + +Creating sims. +-------------- + +A separate script is here for sim creation, you can use it to create many +sims. You will need - + +Your host name, or it could be your IP, we will use "sims.example.net". + +A name for your sim, we will use "My new sim". It should be unique on +the grid. + +A location for your sim, we will use "1234,5678". You can use the +Infinite Grid web based map to poke around and find a good location. +Choose an empty spot. + +Once you have all that information sorted out, run this script from the +installed scripts directory - + +./create_sim.sh "My new sim" "1234,5678" "sims.example.net" + +Or this if you want to override the detected IP address - + +./create_sim.sh "My new sim" "1234,5678" "sims.example.net" "1.2.3.4" + +Also, you can create a varregion with something like - + +./create_sim.sh "My new sim" "1234,5678" "sims.example.net" "1.2.3.4" 512 + +Note that the size has to be a multiple of 256, so 512, 768, 1024, etc. + +Running sims. +------------- + +Now you can go to /opt/opensim/config/sim01 and run the following script +to start it up - + +./start-sim + +You will see the screen console. You can run the screen console again by +running that command once more, or running the sim-console command. + +You can stop the sim with - + +./stop-sim + +You can backup the sim with - + +./backup-sim + + + +Finishing up. +------------- + +Once it's all tested, you can use this to finish things off (back in +the scripts directory) - + +./go_live.sh + +Which sets up the monit control file/s, though you should double check +it all, and you still have to do the basic configuration and enabling of +monit yourself. This is in case you already have monit set the way you +like. + + +NOTES - + +This attempts to use only one copy of the OS install for all sims. We +are running one instance of OS for each sim though, as this prevents one +sim crashing from bringing down the others. OS however really wants to +write data to directories within it's own bin directory. I'm not at all +certian if that data can be shared. For the same reason, so far I've +not been able to get to the point where we can make the OS directory +read only. This complicates things during upgrades. + -- cgit v1.1