Alternative installation of Backup Manager for GNU/Linux

Some system administrators prefer using alternative installers instead of the recommended RUN installer. There are two alternative installers to chose from, the file format you need depends on your Linux distribution:

  • DEB Instructions – This method is available for modern Debian and Ubuntu distributions
  • RPM Instructions – This method is available for modern CentOS, RHEL and SUSE distributions

Both of the installers come in 32- and 64-bit versions.

Backup on devices using Operating Systems which are not officially supported may still work, but as we no longer test these versions, we cannot guarantee full functionality. In situations where the device cannot be upgraded to a supported OS, you may encounter issues with new features, or there may be abnormalities so please test the backup by doing a restore as soon as possible.

Precursor check:

Before beginning, check the bitness of your system first by running the following command in the command line of the device:

# uname -a

Where uname is replaced with the username you are logged in to (ideally the Admin user)

The response will be one of two:

  • amd64 for DEB or x86_64 for RPM - you have a 64-bit system so you require the amd64 or x86_64 installer
  • i386- you have a 32-bit system so you require the i386 installer

Installation steps

DEB Instructions

These steps detail running commands for a 32-bit system. If your device is a 64-bit system, replace i386 everywhere below with amd64

  1. Download the 32- or 64-bit installer from the Management Console's Downloads page

    % wget https://cdn.cloudbackup.management/maxdownloads/mxb_~linux-1_i386.deb

  2. Run the installer you have downloaded.

    # dpkg -i mxb_~linux-1_i386.deb

  3. Run configure-fp.sh and submit parameters for the current installation. Additional parameters can be found in the Installation parameters for Backup Manager for GNU/Linux page.

    Do not forget to enclose values containing spaces or punctuation inside quotation marks.

    # /opt/MXB/sbin/configure-fp.sh --user="admin-ubuntu-3a" --password=f701a2ca3255 --encryption-key="SECUR_ITY2014a" --use-proxy=false

  4. If you submit without entering the parameters, you will be prompted to enter them one at a time at the next step
  5. Once all parameters have been entered the installer will run

RPM Instructions

These steps detail running commands for a 32-bit system. If your device is a 64-bit system, replace i386 everywhere below with x86_64

  1. Install the "libaio" library if you don't have it on your machine.
  2. # yum -y install libaio

  3. Download the 32- or 64-bit installer from the Management Console's Downloads page

    % wget https://cdn.cloudbackup.management/maxdownloads/mxb_linux-1.i386.rpm

  4. Run the installer you have downloaded.

    # rpm -ihv mxb-linux-1.i386.rpm

  5. Run configure-fp.sh and submit parameters for the current installation. Additional parameters can be found in the Installation parameters for Backup Manager for GNU/Linux page.

    Do not forget to enclose values containing spaces or punctuation inside quotation marks.

    # /opt/MXB/sbin/configure-fp.sh --user="admin-ubuntu-3a" --password=f701a2ca3255 --encryption-key="SECUR_ITY2014a" --use-proxy=false

  6. If you submit without entering the parameters, you will be prompted to enter them one at a time at the next step
  7. Once all parameters have been entered the installer will run

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. % sudo -i

  3. Download the RUN installer suitable for your distribution from the Management Console's Downloads page:
    • For DEB

      % wget https://cdn.cloudbackup.management/maxdownloads/mxb_~linux-1_i386.deb

    • For RPM

      # wget https://cdn.cloudbackup.management/maxdownloads/mxb_linux-1.i386.rpm

  4. Grant the installer execute permissions:
    • For DEB

      # chmod +x mxb_~linux-1_i386.deb

    • For RPM

      # chmod +x mxb_linux-1.i386.rpm

  5. If required, you may change the predefined installation folder:
  6. 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:

    # ln -s /usr/local/MXB /opt/MXB

  7. Start the installer without additional installation parameters:
    • For DEB

      # mxb_~linux-1_i386.deb

    • For RPM

      # mxb_linux-1.i386.rpm

  8. You will be asked to provide parameters for the installation including device name, installation key (previously known as password) and security code/encryption key/passphrase
  9. The device name and installation key can both be found in the Settings tab of the device in the Management Console.

  10. If a previous installation is detected for the device details given, you will receive a message stating:
  11. 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
  12. Select R here for Restore-Only mode installation
  13. 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 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
  4. If this exists change =0 to =1
  5. If this does not exist, add it as above to the [General] section
  6. This is case sensitive so please ensure it is added correctly and without spaces.

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

  10. Restart the service
  11. $ 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
  4. If this exists change =1 to =0 or remove the line entirely
  5. Close the file by using Ctrl+X
  6. Save the changes to the file
  7. Y

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

    OR

    $ sudo /etc/init.d/ProcessController restart