Upgrade VeridiumID from 3.x to 3.4

This document will provide a step by step procedure to upgrade to VeridiumID 3.4.

The procedure will provide information regarding both update methods:

• using a configured YUM repository

• using local packages

The update is done without downtime, one node at a time. Please start with WEBAPP nodes and after that do the installation on PERSISTENCE nodes. In order to have no impact, please take out from the balancer the node on which install is running.
WEBAPP node is a server where websecadmin is installed, PERSISTENCE node is a server where cassandra is installed.

The application 3.x is compatible with 3.4 database schema.

Summary:

1) Download packages

2) Pre-requirements

3) Start Update

4) Post update steps

5) Other referrences

1) Download packages

For update procedure, with local packages, please download only “VeridiumID Update packages” archive containing all RPMs.

For Update using a YUM repository, please download all packages and make them available within your own local repository

2) Pre-requirements

2.1) (MANDATORY) User requirements

We recommend using any user with sudo rights or root directly.

Python 3 must be installed. To check if you have a working Python 3 version run the following command:

python3 --version

If Python 3 is not installed, please see section 5.1 - How to install python 3

2.2) (OPTIONAL) Cassandra Backup

By default, the database backup procedure is scheduled on Saturday mornings at 04:00 AM. Please check under /opt/veridiumid/backup/cassandra directory on persistence layer nodes to see when the last successfull backup was executed.

ls -l /opt/veridiumid/backup/cassandra

If you wish to perform an additional backup of the Cassandra database, run the following script on persistence layer nodes as any user that has sudo rights or directly as root:

bash /opt/veridiumid/backup/cassandra/cassandra_backup.sh \
-c=/opt/veridiumid/backup/cassandra/cassandra_backup.conf

3) Start Update

The commands must be executed on ALL machines sequentially, first on WEBAPP and after that on PERSISTENCE, in order to update your VeridiumID platform to the latest 3.4 version.

Please execute all commands as root.

3.1) Update using a YUM repository

Please execute steps 3.1.1 on all servers in parallel. Please execute steps 3.1.2 and 3.1.3 on each server, one at a time, starting with WEBAPP and after that PERISTENCE. After 3.1.3, the server will be updated to desired version.

3.1.1) Install the necessary Update procedure on ALL machines

yum clean metadata
yum install -y veridiumid_update_procedure-8.1.18

The next steps will all be done from within the /etc/veridiumid/update-procedure/current/ directory.

cd /etc/veridiumid/update-procedure/current/

3.1.2) Run preUpdateSteps.py

Run the following command to stop the services on one node.

python3 preUpdateSteps.py --version 8.1.18 --use-repo

There might be ERROR messages in the output of the script but as long as the script does not stop its execution, it means that it’s not a stopping event.

3.1.3) Run startUpdate.py

Run the following command to install services on that specific node.

python3 startUpdate.py --version 8.1.18 --use-repo

There might be ERROR messages in the output of the script but as long as the script does not stop its execution, it means that it’s not a stopping event.

3.2) Update using local packages

Please execute steps 3.2.1 and 3.2.2 on all servers in parallel. Please execute steps 3.2.3 and 3.2.4 on each server, one at a time, starting with WEBAPP and after that PERISTENCE. After 3.2.4, the server will be updated to desired version.

3.2.1) Download the necessary Update packages on all nodes

To download the latest veridiumid-update-packages.zip, use the following link.

We recommend downloading to veridiumid’s HOME folder. As such, all the examples will feature this folder. If you wish to use another location, please avoid using /tmp/.

After downloading the veridiumid-update-packages-8.1.18.zip archive, you can run the following command to access its contents. This will create a directory called update-34 and another named packages inside of it:

cd /home/veridiumid
unzip veridiumid-update-packages-8.1.18.zip -d update-34

3.2.2) Install Update procedure on all nodes (no downtime while this package is installing)

cd update-34/packages/
yum localinstall -y veridiumid_update_procedure-8.1.18-20230728.x86_64.rpm
cd /etc/veridiumid/update-procedure/current/

3.2.3) Run preUpdateSteps.py

Run the following command to stop the services on one node.

python3 preUpdateSteps.py --version 8.1.18 \
--rpm-path /home/veridiumid/update-34/packages

There might be ERROR messages in the output of the script but as long as the script does not stop its execution, it means that it’s not a stopping event.
Use the –rpm-path parameter to define where the RPMs have been copied locally, for example: /home/veridiumid/update-34/packages/

3.2.4) Run startUpdate.py

Run the following command to install services on that specific node.

python3 startUpdate.py --version 8.1.18 \
--rpm-path /home/veridiumid/update-34/packages

There might be ERROR messages in the output of the script but as long as the script does not stop its execution, it means that it’s not a stopping event.
Use the –rpm-path parameter to define where the RPMs have been copied locally, for example: /home/veridiumid/update-34/packages/

3.3) Check the status of the VeridiumID Services

In order to check the status of the VeridiumID Services, you can run the following command. All services needs to have status Started.

bash /etc/veridiumid/check_services.sh

4) Post update steps

5) Other referrences.

5.1) How to install python 3

In order to run the update procedure all nodes must have Python 3 installed or the alternative provided by VeridiumID.

To check if the VeridiumID Python 3 package (this is optional) is present use the following command as root:

yum list installed veridiumid_python

If not installed please use the RPM from the following link.

To install the RPM run the following command as root:

# if using YUM repository:
yum -y install veridiumid_python

# or, if using local package:
yum localinstall -y veridiumid_python-3.6.8-20230728.x86_64.rpm