Installation with RPMs

Prerequisites

Create a Storware repository file

This step is required for both the server and node host

Create the file /etc/yum.repos.d/vProtect.repo with the following content:

# Storware Backup & Recovery - Enterprise backup solution for virtual environments repository
[vprotect]
name = vProtect
baseurl = https://repo.storware.eu/storware/current/el8/
gpgcheck = 0

Optionally change el8 to el9 or el7 depending on your CentOS/Red Hat Enterprise Linux release.

The current folder always points to the latest release of the Storware Backup and Recovery solution. It can be modified if you want to install another version. The available values are:

  • 5.0.0

  • 5.1.0

  • 5.1.1

  • 5.2.0

  • 6.0.0

  • 6.1.0

The current release version is 6.0.0

Examples of repository URLs:

  • http://repo.storware.eu/storware/current/el8

  • http://repo.storware.eu/storware/5.1.0/el8

  • http://repo.storware.eu/storware/5.2.0/el8

Install the MariaDB repository

This step is required only for the server host

  1. Generate repository file at MariaDB download site

  2. Copy and paste the generated repo file into /etc/yum.repos.d/MariaDB.repo, so it looks similar to this (example for CentOS/RHEL 8):

    # MariaDB 10.6 CentOS repository list - created 2023-11-02 15:04 UTC
# https://mariadb.org/download/
[mariadb]
name = MariaDB
# rpm.mariadb.org is a dynamic mirror if your preferred mirror goes offline. See https://mariadb.org/mirrorbits/ for details.
# baseurl = https://rpm.mariadb.org/10.6/centos/$releasever/$basearch
baseurl = https://ftp.icm.edu.pl/pub/unix/database/mariadb/yum/10.6/centos/$releasever/$basearch
# gpgkey = https://rpm.mariadb.org/RPM-GPG-KEY-MariaDB
gpgkey = https://ftp.icm.edu.pl/pub/unix/database/mariadb/yum/RPM-GPG-KEY-MariaDB
gpgcheck = 1
module_hotfixes=true

SUSE Linux Enterprise Server (SLES)

  1. Create repo file in path /etc/zypp/repos.d/vProtect.repo:

    # Storware Backup & Recovery - Enterprise backup solution for virtual environments repository
[vprotect]
name = vProtect
baseurl = https://repo.storware.eu/storware/current/suse15/
gpgcheck = 0

  2. Add Desktop Application Tools module:

    SUSEConnect -p sle-module-desktop-applications/15.4/x86_64

  3. Add Development tools module:

    SUSEConnect -p sle-module-development-tools/15.4/x86_64

  4. Install package "sudo":

    zypper install sudo

Server installation steps

  1. Install the Storware Backup & Recovery server using the following command:

    dnf -y install vprotect-server

  2. Prepare the database root password and run the command:

    vprotect-server-configure

  3. Start the Storware Backup & Recovery server service (it can take around a minute for the server to start):

    systemctl start vprotect-server

  4. After the server service will start, the server will be listening on port 8181. Open port 8181 on the firewall so the node and the administrator can access the server. You can also redirect the default HTTPS port 443 to 8181 for easier management. To open port 8181 using the system firewall use the following commands:

    firewall-cmd --add-port=8181/tcp --permanent
firewall-cmd --complete-reload

    To forward the default HTTPS port (443) to port 8181 you can use the following script:

    /opt/vprotect/scripts/ssl_port_forwarding_firewall-cmd.sh

Node installation steps

  1. Install the Storware Backup & Recovery node using the following command

    dnf -y install vprotect-node

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

    vprotect node -r <node name> <admin user> https://<server address>/api

    where:

    • node name - the name under which the node will appear in the system

    • admin user - the login of the administrative user

    • server address - address of the server installed in the previous steps

    Example for default local installation:

    vprotect node -r node1 admin https://localhost:8181/api

  4. Start the Storware Backup & Recovery node service:

    systemctl start vprotect-node

  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 policy to allow it to run privileged commands:

    vprotect-node-configure

  6. Reboot the Storware Backup & Recovery VM to apply the OS-specific settings:

    reboot

Post-installation

Now you should be able to log in to the Storware Backup & Recovery server using https://IP_OF_YOUR_MACHINE. By default, Storware Backup & Recovery has one admin account - admin with the password vPr0tect (with a zero).

Verify in the node section that the node that you installed is connected to the server.

After the initial log in you can configure single sign-on using LDAP or Keycloak.

Remember to prepare your staging space as described in the Staging space configuration.

Now proceed with the Initial configuration instructions, to configure access to the hypervisors and backup destinations.

PreviousInstallation using Ansible playbookNextDeployment in Microsoft Azure

Last updated