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 DPX vPlus database backup.

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

• If DPX vPlus 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 DPX vPlus 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 DPX vPlus-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 DPX vPlus 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 DPX vPlus Database mysql_upgrade --user=root --password

• If the database update is successful, now we can start with the DPX vPlus Update. Make sure you configure our new repository for DPX vPlus - 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