Run Installation of Backup Manager for GNU/Linux

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

The RUN installer comes in 2 versions:

i386 – for 32-bit systems
amd64 – for 64-bit systems

Ensure you use the correct one for the system before beginning

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:

x86_64 - you have a 64-bit system so you require the amd64 installer
i686- you have a 32-bit system so you require the i386 installer

Installation steps

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

Log in to the device as a root user:
% sudo -i
Download the RUN installer suitable for your distribution from the Management Console's Downloads page
# wget https://cdn.cloudbackup.management/maxdownloads/mxb-linux-i686.run
Grant the installer execute permissions
# chmod +x mxb-linux-i686.run
If required, you may change the predefined installation folder.

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

Start the installer and submit your installation parameters. 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.

# ./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.

If you submit the command without the installation parameters, you will be prompted to enter them one at a time
Once all parameters have been entered the installer will run

Possible permission error

If the installer is extracted to your temp partition and that partition is mounted with the noexec option, it is possible to encounter a permissions error. To rectify the error, extract the installer to another directory that has execute permissions:

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

As the TMPDIR is used for additional operations, directing this variable to the same location as the --target variable can help to avoid additional errors.

Bourne-based shells

For use with bash, ksh, zsh, etc. use the command:

# export TMPDIR=/path/to/target

C shells

For use with csh, tsch, etc. use the command:

# setenv TMPDIR /path/to/target

Restore-only installation steps

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

% sudo -i

Download the RUN installer suitable for your distribution from the Management Console's Downloads page:

# wget https://cdn.cloudbackup.management/maxdownloads/mxb-linux-i686.run

Grant the installer execute permissions:

# chmod +x mxb-linux-i686.run

If required, you may change the predefined installation folder:

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

Start the installer without additional installation parameters:

# ./mxb-linux-i686.run

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

The device name and installation key can both be found in the Settings tab of the device in the Management Console.

If a previous installation is detected for the device details given, you will receive a message stating:

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

Select R here for Restore-Only mode installation
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:

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

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

Under the [General] section check for an instance of RestoreOnlyMode=0
If this exists change =0 to =1

If this does not exist, add it as above to the [General] section

This is case sensitive so please ensure it is added correctly and without spaces.

Close the file by using Ctrl+X
Save the changes to the file

Restart the service

$ sudo service ProcessController restart

$ 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:

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

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

Under the [General] section check for an instance of RestoreOnlyMode=1
If this exists change =1 to =0 or remove the line entirely

Close the file by using Ctrl+X
Save the changes to the file

Restart the service

$ sudo service ProcessController restart

$ sudo /etc/init.d/ProcessController restart