Installing the root server is actually extremely easy. It is done through a “wizard” interface that walks you through the process.
Getting the Root Server
You get the software from its location in the GitHub Open Source Repository.
You should download the zipped-up server directory from the release branch. Click on “Downloads”, and then choose a file format. You will get a file named something like “MAGSHARE-BMLT-Root-Server-1.8.30-0-gc5706c2.zip”. Unzip this file, and take the “main_server” directory from the resulting directory.
Installing the Root Server Files
The file needs to be installed, unzipped, in the HTML directory of a server that fits the criteria we laid out in this page. You will generally place the files up there by FTP.
Once the files have been uploaded, you should make the configuration file writable. This file is located at main_server/server/config/auto-config.inc.php, and you need to give it a chmod 0666 or 0777 (If 0666 bothers you). This makes the file writable. After the wizard completes, it will instruct you to make it read-only (chmod 0644).
Running the Root Server Install Wizard
Before you begin, you should create a new, empty database, and a user with full rights on that database. You will need to give the wizard this information during the install. You can use an existing database that is used for other things (like a CMS system). The “Table Header” fields will allow you to change the first few characters of the BMLT tables, so they won’t overwrite existing ones. The default table prefix is "na_XXX". It is safe to do this. Even though you are warned that the process will “reset the database,” it is only referring to the tables created and managed by the BMLT. Any other tables in the database will be unaffected.
To invoke the wizard, simply point your browser at the main_server directory (or whatever else you may have named it). The wizard will show up as pages with a yellow background.
If you have forgotten to unlock the config file, you will be given instructions by the wizard. The case will be the same for locking it when the configuration is complete.
Run through the wizard, following all the instructions. When it is done, you will have a new, empty root server, with one Service Body, and one user (the Server Administrator).