Upgrade

Before every update, check the version of installed packages. The database version is particularly important.

yum info vprotect-server vprotect-node mariadb-server
# Or
rpm -qa | egrep -e "vprotect|Maria"

If the host computer has an Internet connection, use the yum command - you'll also see the new package versions provided by the repositories.

For a Debian-based OS use the following:

dpkg -l | grep vprotect
dpkg -l | grep Maria

RPM-based OS Upgrade

Server

• Make sure you have the Storware Backup & Recovery database backup.

  • You can use this command manually to back it up on-demand on the Storware Backup & Recovery Server:/opt/vprotect/server/scripts/backup_db.sh /path/to/backup/file.sql.gz

• If Storware Backup & Recovery was installed on a virtual machine (not a physical one), it would be a good move to take a snapshot.

• After backing up the database, we should carefully stop the Storware Backup & Recovery service to make sure that we don't have any tasks running (a running task may cause problems updating the database).

  • View all tasks, if you see even one on the list, clear it (wait for the ongoing tasks to finish)

  • You can do this from the WebUI (it's faster)

• Now, if you don't have any tasks on the list, you can stop the service.

[root@vprotect ~]# systemctl disable vprotect-server --now

• To make sure that no scheduler has started a task before stopping the service, let's query the database.

  • If the table is not empty, start the Storware Backup & Recovery-Server service and clear the tasks again.

mysql -u root -p -e "Select * FROM vprotect.task;"

• Make sure you have MariaDB up-to-date - currently Storware Backup & Recovery by default uses version 10.11, while 10.6 is the minimum version supported.

  • Otherwise, minor MariaDB versions should be updated with yum update

  • rpm -e --nodeps "MariaDB-server-YOUR_VERSION_OF_PACKAGE"

  • Update the MariaDB repository to the correct version vi /etc/yum.repos.d/MariaDB.repo

  • Install the new MariaDB-Server yum install -y mariadb-server

  • Update all other components of MariaDB yum update -y mariadb

  • Start the MariaDB engine systemctl enable mariadb --now

  • Run mysql_upgrade to update the Storware Backup & Recovery Database mysql_upgrade --user=root --password

• If the database update is successful, now we can start with the Storware Backup & Recovery Update. Make sure you configure our new repository for Storware Backup & Recovery - new base URL:

Note: use one of this URL's

• https://repo.storware.eu/storware/current/el8/
• https://repo.storware.eu/storware/current/el9/

vim /etc/yum.repos.d/vProtect.repo

• Update the Server (it may take a while, the service is being restarted):

  yum -y update vprotect-server

• If the server service was not running before update, you may also need to execute:

  systemctl enable vprotect-server --now

Node

1. Update each Node:

   systemctl stop vprotect-node
   yum -y update vprotect-node

2. Run the script to configure the OS for Node:

   vprotect-node-configure

3. If the node service was not running before the update, you may also need to execute:

   systemctl enable vprotect-node --now

4. Log in to the web UI and check if the nodes are running.

Note: You may need to refresh your browser cache after update:

Chrome use CTRL+SHIFT+R (Windows/Linux) / CMD+SHIFT+R (MacOS)

Debian-based OS Upgrade

Cleaning the tasks list and backuping the internal database procedure does not change for that version, therefore, once you did that, proceed with the following:

Server

Firstly, disable the server service:

systemctl stop vprotect-server

Open the file with the vprotect name found under this path:

/etc/apt/sources.list.d/

and edit the link to the repository with the version you are interested in.

Once finished, use the following two commands (remember to have the root priveleges):

apt-get update
apt-get install --only-upgrade vprotect-server

When both commands have been executed, start the server again:

systemctl start vprotect-server

Node

Firstly, stop the node:

If you have not done that earlier, repeat the file editing steps from this path:

/etc/apt/sources.list.d/

with the link to the version you are interested in and run the following two commands with the root priveleges:

apt-get update
apt-get install --only-upgrade vprotect-node

After executing the above, you can start and reconfigure the node:

systemctl start vprotect-node
vprotect-node-configure