Installation with RPMs

Prerequisites

  1. 1.
    Install CentOS/RHEL 8 minimal
    • if you plan to use deduplication with VDO we recommend using RHEL to have Red Hat's support available
    • you also can use version CentOS/RHEL 7
  2. 2.
    Make sure your OS is up to date:
    dnf -y update
    If the kernel is updated, then you need to reboot your operating system.
  3. 3.
    Install the Storware Backup & Recovery repository
  • create a file /etc/yum.repos.d/vProtect.repo:
    # Storware Backup & Recovery - Enterprise backup solution for virtual environments repository
    [vprotect]
    name = vProtect
    baseurl = https://repo.storware.eu/vprotect/5.0.0/el8/
    gpgcheck = 0
  • optionally change el8 to el7 for older CentOS/RHEL and current can also be pointed to the specific version of vProtect, i.e. 3.9.2 (not the one that is always up to date) i.e.
    • http://repo.storware.eu/vprotect/current/el7
    • http://repo.storware.eu/vprotect/3.9.2/el8
  1. 1.
    Install the MariaDB repository (Storware Backup & Recovery Server host only
  • generate .repo file at MariaDB download site
  • copy and paste the generated repo file into /etc/yum.repos.d/MariaDB.repo, so it looks similar to this (this one for CentOS/RHEL 8):
    # MariaDB 10.4 CentOS repository list - created 2020-06-01 16:14 UTC
    # http://downloads.mariadb.org/mariadb/repositories/
    [mariadb]
    name = MariaDB
    baseurl = http://yum.mariadb.org/10.4/centos8-amd64
    module_hotfixes=1
    gpgkey=https://yum.mariadb.org/RPM-GPG-KEY-MariaDB
    gpgcheck=1

Storware Backup & Recovery Server installation

Storware Backup & Recovery consists of a server (a central management point with a WebUI) and one or multiple nodes (which can be installed on the same host as the server or on other machines). The first step is always to install the server.
  1. 1.
    Install the Storware Backup & Recovery server using DNF package manager:
    dnf -y install vprotect-server
  2. 2.
    Set up the DB for Storware Backup & Recovery:
    • Please provide a MariaDB password
    • Please remember to not re-run this command on running/production Storware Backup & Recovery instance. This can cause problems with the Storware Backup & Recovery database.
    vprotect-server-configure
  3. 3.
    Start the Storware Backup & Recovery Server (it can take around a minute for the server to start):
    systemctl start vprotect-server
  4. 4.
    You may need to open the 8181 port (for HTTPS, HTTP requires port 8080) on your firewall. Here is an example:
    firewall-cmd --add-port=8181/tcp --permanent
    firewall-cmd --complete-reload
    # To check open ports:
    firewall-cmd --list-all
    or if you prefer to have the Storware Backup & Recovery console running on the default HTTPS port (443), there is a script in the /opt/vprotect/scripts directory to set up forwarding from port 443 to 8181:
    cd /opt/vprotect/scripts
    ./ssl_port_forwarding_firewall-cmd.sh
  5. 5.
    Now you should be able to log in to the web console using the URL: https://STORWARE_HOST:8181, where STORWARE_HOST is the hostname or IP of your Storware Backup & Recovery Server
    • by default, Storware Backup & Recovery has one admin account - admin with the password vPr0tect (with a zero)
  6. 6.
    Optionally, if you are going to connect nodes running on remote hosts, proceed with the steps related to the Storware Backup & Recovery Server described in the section: Enabling HTTPS connectivity for remote nodes

Storware Backup & Recovery Node installation

Storware Backup & Recovery Node is a component that executes all tasks. It can be installed together with the Server (it is common to have 1 server and just 1 node). More nodes can always be added later.
  1. 1.
    Install the Storware Backup & Recovery node using DNF: Remember to add our repository to the host machine
    dnf -y install vprotect-node
  2. 2.
    Prepare your staging space (on the Storware Backup & Recovery Node host only):
    • If you just started with Storware Backup & Recovery, and do not know what is staging space please follow the steps described in the Staging space configuration
    • if your path is different than /vprotect_data it is recommended to create a symlink /vprotect_data pointing to your staging space mount point, e.g.:
      ln -s /mnt/staging /vprotect_data
  3. 3.
    Register the node with the NODE_NAME of your choice, the ADMIN_USER user name which you would like to use and the URL to the Storware Backup & Recovery API, and provide a password when prompted:
    • Syntax:
      vprotect node -r NODE_NAME ADMIN_USER http(s)://STORWARE_SERVER:PORT/api
    • If you are going to connect nodes running on remote hosts, please proceed with the steps related to the Storware Backup & Recovery Node described in the section: Enabling HTTPS connectivity for remote nodes
    • Example for default local installation - over HTTP (port 8080):
      vprotect node -r node1 admin http://localhost:8080/api
  4. 4.
    Start the Storware Backup & Recovery Node:
    systemctl start vprotect-node
    Now you should be able to see a new entry in the Node section of the web UI with your node in RUNNING state.
  5. 5.
    Run the script to configure the OS for Node, which includes changing the QEMU user/group to vprotect, disabling SELinux, adding Storware Backup & Recovery to the disk group and sudoers to allow it to run privileged commands:
    vprotect-node-configure
  6. 6.
    Reboot the Storware Backup & Recovery VM to apply the OS-specific settings:
    reboot
Storware Backup & Recovery is installed - you can now proceed with the steps described in the Initial configuration.