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:
- 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):
- 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:
- Submit the remaining installation parameters (if applicable)
- Review the settings you have submitted. Enter
Y
(Yes) if everything is correct or enterN
(No) to start over:
root# chmod +x mxb-cloud-sn-linux-x86_64.run
root# ./mxb-cloud-sn-linux-x86_64.run
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.
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, 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:
|
-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 |
-storage-directory
|
A path to the directory where backup data will be stored. Use |
-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: 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: The parameter requires Storage Node Installer 16.2 or a greater version. |