Install storage node on Linux

Storage Node Installers are available in the Downloads section of the Management Console. They can also be downloaded from here.

Download the Storage Node Installer for Linux
Open your terminal emulator and set executable rights for the script:

root# chmod +x mxb-cloud-sn-linux-x86_64.run

Launch the script. You can run a general command as shown in the example below. In this case you will be asked to provide some settings at the next step (the system will prompt you to enter them one at a time):

root# ./mxb-cloud-sn-linux-x86_64.run

Alternatively, you can enter these settings straight away and skip further questions. This is convenient if you have multiple storage nodes to install. This installation method is also more flexible for options as it supports an extra set of parameters. The installation command will look as follows:

root# ./mxb-cloud-sn-linux-x86_64.run -- -installation-mode install -cloud-partner-name 'Smart Telecom' -cloud-partner-user-name root@email.com -cloud-partner-user-password 029HgatEoauba1 -storage-name 'Primary' -storage-directory /opt/mxb/storage -storage-node-name 'Smart Telco Node 3' -nginx-bind-host 192.168.0.222 -nginx-bind-port 443 -external-addresses '192.168.0.222:443' -web-rcg-bind-host 192.168.0.222 -web-rcg-bind-port 2999 -web-rcg-external-addresses '192.168.0.222:2999'

When setting up the storage node, you must use the email address. You can use the email associated to the root account or you can create a separate user account specifically for use by the Storage node.

When installing storage nodes, please be aware that you must use IPv4 as IPv6 is not supported.

Submit the remaining installation parameters (if applicable)
Review the settings you have submitted. Enter Y (Yes) if everything is correct or enter N (No) to start over:

Please review all the information once again:
============================================================
Storage directory:          /opt/mxb/storage
------------------------------------------------------------
Cloud address:              cloudbackup.management:443
Cloud partner name:         Smart Telecom
Cloud user:                 root@email.com
Cloud password:             ********
------------------------------------------------------------
Storage name:               Primary
Storage node name:          Smart Telco Node 3
------------------------------------------------------------
NGINX bind address:         192.168.0.222:443
External addresses:         192.168.0.222:443
RCG bind address:           192.168.0.222:1999
RCG external address:       192.168.0.222:1999
Web RCG bind address:       192.168.0.222:2999
Web RCG external addresses: 192.168.0.222:2999
============================================================
Is everything correct? (Y/n) Y

When the installation is complete, the new node will appear among the partner's nodes

To view it in the Cloud Management Console (Legacy), open the Manage menu, and then click View storage statistics.

If you need any help with the installation, please contact our support team.

Installation parameters

Required parameters

Parameter	Definition
`-installation-mode`	The action you want to perform: `install` (install a new storage node or update an existing one) `upgrade` (upgrade from FTP storage to a cloud storage node)
`-cloud-partner-name`	The name of the partner company you are installing the storage node for (can be copied from your cloud management software)
`-cloud-partner-user-name`	The email address of the user from the partner company who has full access to Customer Management in your cloud management software. The SuperUser role is required.
`-cloud-partner-user-password`	The password associated with `-cloud-partner-user-name`.
`-storage-name`	The name of the storage pool where the new node will be located. Use `Primary` to enable the default storage assigned to the partner company. If you enter a new name, the storage pool will be created automatically.
`-storage-directory`	A path to the directory where backup data will be stored. Use `/opt/mxb/storage` to enable the default directory assigned to the partner or type in your own directory.
`-storage-node-name`	The name you want to assign to the new storage node
`-nginx-bind-host`	The internal IP address of the Nginx server that will be used to upload cabinets to the storage node. Enter `0.0.0.0` if you want the system to choose an available IP address automatically or type in your own IP address.
`-nginx-bind-port`	The port number of the Nginx server. The default port is `443`.
`-external-addresses`	The external IP address and port number of the Nginx server. If the Backup Manager is installed in the same network as the storage node, you can speed up data transfer by entering several addresses. Use a comma or a semicolon to separate them, for example `192.168.0.222:443;192.168.0.333:443`. Spaces between values are optional. Avoid using the same external IP address for two or more servers in a local network (it can result in connectivity issues).
`-web-rcg-bind-host`	The internal IP address of the web RCG server that will be used to establish remote connections to the partner's devices. Use `0.0.0.0` to let the system accept connections on all available network interfaces or specify your own host.
`-web-rcg-bind-port`	The internal port number of the web RCG server. `2999` is the default port.
`-web-rcg-external-addresses`	The external IP address and port number of the web RCG server. You can enter several addresses separated by a comma or a semicolon. Spaces between values are optional.

Optional parameters

Parameter	Definition
`-skip-questions`	Lets you skip the final review of the settings submitted. Enter the parameter without any values to enable the feature.
`-no-web-rcg`	Lets you skip entering remote connection settings: `-web-rcg-bind-host`, `-web-rcg-bind-port` and `-web-rcg-external-addresses`. Remote connections to backup clients will be unavailable without these settings. The parameter requires Storage Node Installer 16.2 or a greater version.
`-install-path`	A path to the storage node software installation (set to `/opt/mxb` by default)
`-auth-user`	A login name that the Backup Manager will use for basic HTTP authentication when communicating with the new storage node. If no name is set, a default value will be used (`data`).
`-auth-password`	A password that the Backup Manager will use for basic HTTP authentication when communicating with the new storage node. If no value is set, a random password will be generated.
`-no-state-reporting`	Lets you disable storage node disk usage statistics submission to the management node. Enter the parameter without any values to enable the feature.

Remote connection settings for legacy backup clients

If your storage node hosts devices running Backup Manager version 13x, you can configure remote connection settings for these devices.

Parameter	Definition
`-rcg-bind-host`	The internal IP address of the RCG server that will be used to establish remote connections to legacy devices. Use `0.0.0.0` if you want the system to accept connections on all available network interfaces or specify your own IP address.
`-rcg-bind-port`	The internal port number of the RCG server. `1999` is the default port.
`-rcg-external-host`	The external IP address of the RCG server. You can use the same IP address that you provided in `-external addresses`.
`-rcg-external-port`	The external port number of the RCG server. `1999` is the default port.
`-no-rcg`	Lets you skip entering remote connection settings for legacy backup clients: `-rcg-bind-host`, `-rcg-bind-port`, `-rcg-external-host`, and `-rcg-external-port`. Remote connections to legacy backup clients will be unavailable without these settings. The parameter requires Storage Node Installer 16.2 or a greater version.