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 installeri686
- 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.
- Start the installer and submit your installation parameters. Additional parameters can be found in the Installation parameters for Backup Manager for GNU/Linux page.
- 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
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
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.
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.
- Log in to the system as a root:
- Download the RUN installer suitable for your distribution from the Management Console's Downloads page:
- Grant the installer execute permissions:
- If required, you may change the predefined installation folder:
- Start the installer without additional installation parameters:
- 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
- If a previous installation is detected for the device details given, you will receive a message stating:
- 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
% sudo -i
# wget https://cdn.cloudbackup.management/maxdownloads/mxb-linux-i686.run
# chmod +x mxb-linux-i686.run
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
# ./mxb-linux-i686.run
The device name and installation key can both be found in the Settings tab of the device in the Management Console.
You can either use this contract, abort configuration or install application in restore only mode [u/a/R]:
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:
- 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
- Close the file by using Ctrl+X
- Save the changes to the file
- Restart the service
sudo nano -w /opt/MXB/etc/config.ini
This is case sensitive so please ensure it is added correctly and without spaces.
Y
$ 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:
- Open the the config.ini file. The following example command with Nano installed will open the config.ini file for editing:
- 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 nano -w /opt/MXB/etc/config.ini
Y
$ sudo service ProcessController restart
OR
$ sudo /etc/init.d/ProcessController restart