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.

  1. Download the Storage Node Installer for Linux
  2. Open your terminal emulator and set executable rights for the script:
  3. root# chmod +x mxb-cloud-sn-linux-x86_64.run

  4. 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):
  5. root# ./mxb-cloud-sn-linux-x86_64.run

  6. 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:
  7. 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.

  8. Submit the remaining installation parameters (if applicable)
  9. Review the settings you have submitted. Enter Y (Yes) if everything is correct or enter N (No) to start over:
  10. 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.