Recommended Backup Manager installer for GNU/Linux

The most convenient way to install the Backup Manager on a GNU/Linux system is using the RUN installer.

The RUN installer comes in 2 versions. Ensure you use the correct one for the system:

  1. i386 – for 32-bit systems
  2. amd64 – for 64-bit systems

If unsure which installer version you need, check the bitness of your system first:

# uname -a

x86_64 in output means that you have a 64-bit system
i686 in output means that you have a 32-bit system

If your device is a 64-bit system, replace i686 in the below installation steps with x86_64

Installation steps

  1. Log in to the system as a root.
  2. % su

  3. Download the RUN installer suitable for your distribution.
  4. # wget https://cdn.cloudbackup.management/maxdownloads/mxb-linux-i686.run

  5. Grant the installer execute permissions.
  6. # chmod +x mxb-linux-i686.run

  7. Change the predefined installation folder (optional). You can find a list of available parameters for installation here. By default, the Backup Manager is installed to /opt/MXB. If you wish to install the software to the /usr mount (for example because it has more free space), you should create symlinks for it. For example:
  8. # ln -s /usr/local/MXB /opt/MXB

  9. Start the installer and submit your installation parameters. Do not forget to enclose values containing spaces or punctuation in quotation marks. If you submit the command without the installation parameters, you will be prompted to enter them one at a time.
  10. # ./mxb-linux-i686.run -- --user="ubuntu-admin" --password="dg224hs-0091" --encryption-key="SECUR_ITY2014a" --use-proxy=false

The -- attribute after the command name means that the parameters after it are specific to the Backup Manager. If your query contains a combination of parameters, use -- to separate the internal parameters of the RUN package from external ones belonging to the Backup Manager. Here is an example:

# ./mxb-linux-i686.run --target /other/tmp -- --user="ubuntu-admin"

Possible permission error

The installer is extracted to your temp partition. If the partition is mounted with the noexec option, you can get a permission error. To eliminate the error, you should extract the installer to some other directory that has execute permissions.

# ./mxb-linux-i686.run --target /other/tmp

Restore-only installation steps

If you want to install the device in restore-only mode, installation is done through an interactive installation process.

  1. Log in to the system as a root.
  2. % su

  3. Download the RUN installer suitable for your distribution.
  4. # wget https://cdn.cloudbackup.management/maxdownloads/mxb-linux-i686.run

  5. Grant the installer execute permissions.
  6. # chmod +x mxb-linux-i686.run

  7. Change the predefined installation folder (optional). You can find a list of available parameters for installation here. By default, the Backup Manager is installed to /opt/MXB. If you wish to install the software to the /usr mount (for example because it has more free space), you should create symlinks for it. For example:
  8. # ln -s /usr/local/MXB /opt/MXB

  9. Start the installer without additional installation parameters.
  10. # ./mxb-linux-i686.run

  11. You will be asked to provide parameters for the installation including device name, password and security code/encryption key
  12. If a previous installation is detected for the device details given, you will receive a message stating:
  13. This contract is already in use
    You can either use this contract, abort configuration or install application in restore only mode [u/a/R]:
    • u: use contract for normal backup install
    • a: abort the configuration
    • R: install device using restore-only mode
  14. Select R here for Restore-Only mode installation
  15. Allow the installation to complete, this will display -- Done once finished

Convert to restore-only mode

If you have installed Backup Manager on the device using the normal Installation steps above and wish to convert this normal version of backup to use restore-only mode, you can do this by following the below steps:

  1. Open the the config.ini file.

    The following example command with Nano installed will open the config.ini file for editing:

  2. sudo nano -w /opt/MXB/etc/config.ini

  3. Under the [General] section check for an instance of RestoreOnlyMode=0. If this exists change =0 to =1
  4. If this does not exist, add it as above to the [General] section
  5. This is case sensitive so please ensure it is added correctly and without spaces.

  6. Close the file by using Ctrl+X
  7. Save the changes to the file
  8. Y

  9. Restart the service
  10. $ sudo service ProcessController restart

    OR

    $ sudo /etc/init.d/ProcessController restart

Convert from restore-only mode to normal mode

If you have a device which has had Backup Manager installed in restore-only mode and you wish to convert this to a normal version of backup, this can be done by following these steps:

  1. Open the the config.ini file.

    The following example command with Nano installed will open the config.ini file for editing:

  2. sudo nano -w /opt/MXB/etc/config.ini

  3. Under the [General] section check for an instance of RestoreOnlyMode=1. If this exists change =1 to =0 or remove the line entirely.
  4. Close the file by using Ctrl+X
  5. Save the changes to the file
  6. Y

  7. Restart the service
  8. $ sudo service ProcessController restart

    OR

    $ sudo /etc/init.d/ProcessController restart