Install Storage Node on Linux and FreeBSD

Last Modified

Tue Oct 31 13:47 GMT 2017

Description

  • Install Storage Node on Linux and FreeBSD

Environment

  • N-able Backup
  • Storage Node Installer

Solution

  • The Cloud is organized as a set of homogeneous storage nodes and a management node that distributes data among them. Partners who are subscribed on the software-only basis should install storage nodes themselves. For all-inclusive partners storage nodes are already set up.
  • Recommendations for best results:
    • A server with a sufficient amount of resources
    • 2+ TB of free hard disk space (depends on the amount of data intended for backup as well as its retention period);
    • 2+ GB of RAM plus 1 extra GB for each additional TB of data.
    • The server can run on any GNU/Linux system (kernel 2.6.9+, GLIBC 2.3.2+ with NPTL) or FreeBSD (9 x64, 10 x64).
    • You should also know the IP address (or addresses) of your server.
    • Internal address (or Bind host) that identifies the server on the local network.
    • External address that is used for remote connections.
      • The external address can coincide with the internal. In this case it will be accessed through different ports depending on the type of connection (by default they are 443, 1999, and 2999). If the external address differs from the internal, it should forward incoming traffic to the internal address (this is achieved with the help of a network adapter).
    • Using the RAID storage virtualization technology is recommended.
  • Installation
  1. Download the Storage Node Installer for your operating system
  2. Open terminal emulator > set executable rights for the script
    • Example: root# chmod +x iaso-cloud-sn-linux-x86_64.run
  3. Launch script, using one of the options below:
    • General command to enter settings one at a time
      • Example: root# ./iaso-cloud-sn-linux-x86_64.run
    • Enter settings at one time. The installation command will look the following way:
      • root# ./iaso-cloud-sn-linux-x86_64.run -- -install-path /opt/iaso-cloud -skip-questions -installation-mode install -cloud-partner-name 'Smart Telecom' -cloud-partner-user-name eric-admin -cloud-partner-user-password eric763a -storage-name 'Primary' -storage-directory /opt/iaso-cloud/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' -rcg-bind-host 192.168.0.222 -rcg-bind-port 1999 -rcg-external-host 192.168.0.222 -rcg-external-port 1999 -web-rcg-bind-host 192.168.0.222 -web-rcg-bind-port 2999 -web-rcg-external-addresses '192.168.0.222:2999'
    • NOTE: Do not forget to enclose values containing spaces or punctuation into quotation marks
  4. Submit all of the required parameters listed in the table below
    • Cloud storage node installation mode (-installation-mode)
    • Cloud partner name (-cloud-partner-name)
    • Cloud user (-cloud-partner-user-name)
    • Cloud password (-cloud-partner-user-password)
    • Storage directory (-storage-directory)
    • Storage name (-storage-name)
    • Storage node name (-storage-node-name)
    • NGINX bind host (-nginx-bind-host)
    • NGINX bind port (-nginx-bind-port)
    • RCG bind host (-rcg-bind-host)
    • RCG bind port (-rcg-bind-port)
    • RCG external host (-rcg-external-host)
    • RCG external port (-rcg-external-port)
    • Web RCG bind host (-web-rcg-bind-host)
    • Web RCG bind port (-web-rcg-bind-port)
    • Web RCG external addresses (-web-rcg-external-addresses)
  5. Review the settings you have submitted.
  6. Enter Y (Yes) if everything is correct or enter N No) to start over
  • Required parameters
Parameter Definition
-installation-mode The action you want to perform:
  • install (install a new or update an existing cloud storage node)
  • upgrade (upgrade from FTP storage to a cloud storage node)
In versions prior to 14.2, use 1 for install and 2 for upgrade.
-cloud-partner-name The name of the partner you are installing the storage node for (can be copied from the Backup Management Console)
-cloud-partner-user-name The user from the partner company who has full access to partner management in the Backup Management Console
-cloud-partner-user-password The user's password for the Backup Management Console
-storage-name The name of the storage where the new node will be located. Use Primary to enable the default storage assigned to the partner or specify your own (existing or new).
-storage-directory A path to the directory where backup data will be stored (namely cabinets and the Backup Register). Use /opt/iaso-cloud/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. Enter0.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).
-rcg-bind-host The internal IP address of the RCG server that will be used to establish remote connections to partner's devices powered by the desktop version of the Backup Manager. Use 0.0.0.0if 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 your 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. It is especially required if you have devices with 13.6 and older versions of the Backup Manager.
-rcg-external-port The external port number of the RCG server. 1999 is the default port. It is especially required if you have devices with 13.6 and older versions of the Backup Manager.
-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 powered by the web version of the Backup Manager. 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.
-install-path A path to the storage node software installation (set to /opt/iaso-cloudby 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 automatically.
-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.