Bakmiup: Setup

From Zysys Product Wiki
Jump to: navigation, search

Contents

Necessary Prerequisites

  • Apache
  • PHP
  • MySQL
  • Perl (with the following Modules)
    • Ragnarok
  • Git
  • openSSH

For 3rd party software that has configuration options (like openSSH), use the configuration files found in Bakmiup: Recommended Settings for 3rd Party Software instead of the defaults.

Recommended Prerequisetes

  • A static ip address

Windows Git Installation For Bakmiup

To install Git for Bakmiup, make sure that you overwrite the Windows tools when installing (this is the third option in the set of options during instalation). Everything else, leave as the default.

Setup

Depending on the distribution of Linux you choose for the bakmiup server, the instructions for installing software are very different. Consult your distribution's manual to install all the necessary prerequisites.

Because git is installed on the server, we can use it to get the most recent version of bakmiup. Note, due to the variable location of the Document Root of the webserver, we will use the generic /webserver to describe the webserver's Document Root (it is usually one of the following: /var/www, /var/www/html, /srv/http, /home/www/, /home/www/html).

cd /webserver
git clone https://github.com/zachbornheimer/bakmiup.git
cd bakmiup
yes | rm -R .git

Because you will not be committing changes to the repository, you do not need the .git directory. .gitignore and .gitignore_global are unnecessary to the execution of bakmiup on the server, but are there in case you ever do decide to contribute to the upstream (these files ensure that your custom configurations will remain private).

Now edit the configuration-template.php file with the correct data and save it as configuration.php (every update overwrites configuration-template.php) (see [#Configuration] for more information). Make sure that the webserver and database server are running.

Open a web browser and navigate to your sever's ip address. If you are running on the local server, navigate to 127.0.0.1/bakmiup. This will run the setup script. Refresh the page and you see a message telling you to execute runme.sh. This script fixes any problems that the program cannot fix itself. To run this, you must be root:

cd /webserver/bakmiup
sh runme.sh

Once you successfully execute this script, you can refresh the page and see that you are able to log in.

Configuration

The configuration template has a few options that must be filled out. They are structured into four sections:

  1. Internals
  2. Updating
  3. UI Preferences
  4. SSH Server Settings

To get bakmiup online doing the bare minimum, you need to edit the following:

  • $GLOBALS['drive'] in Internals
  • $GLOBALS['registrationOpen'] in UI Preferences
  • $GLOBALS['server'] in SSH Server Settings
  • $GLOBALS['port'] in SSH Server Settings

drive

Drive is a subdirectory that will contain all the backups. Depending on how much space you need, it might be smart to put it on a dedicated raid array, it's own partition, or on an external drive. If you move it off disk or outside of the /webserver/bakmiup directory, you need to create a symlink (see Bakmiup: Skills#Setting up a Symlink for more information).

registrationOpen

registrationOpen is a boolean value that tells the login page to display a registration form. If this is set to false, no registration form is visible or processable.

server

server is the vehicle in which the program accesses the server. If you have a domain name for this server, you can use that domain name. If not, you can use a static ip address. Before setting the server configuration, test to make sure that you can go to $server/bakmiup (ie 192.168.1.111/bakmiup) and access bakmiup.

port

port tells the computer the correct door to the server. If you think of the server as a building, to get to the right office, you need to know the door, or the port. The port is set in the sshd_config file; the setting must be the same as the number in that file.

Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox