Suomi.fi Data Exchange Layer development (FI-DEV) and testing environment (FI-TEST) have been updated to X-road 7.4.1 version 6.3.2024 and 13.3.2024

The packages of the new xroad version have been released to the repository, and security servers can be upgraded to the new version.

Upgrade instructions

Upgrade instructions for RHEL 7/8:

1. Postgresql upgrade (from version 9->12) for xroad 7.4.1

#Before postgresql upgrade take backup or snapshot from security server! Then stop X-road services
sudo systemctl stop "xroad-*"

# Stop existing postgreSQL
sudo systemctl stop postgresql

# Install the repository RPM:
sudo yum install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm
sudo yum upgrade -y

# Workaround for Postgres 9.2 unix_socket_directory property deprecation
sudo mv /usr/bin/pg_ctl{,-orig}
sudo echo '#!/bin/bash' > /usr/bin/pg_ctl
sudo echo '"$0"-orig "${@/unix_socket_directory/unix_socket_directories}"' >> \
/usr/bin/pg_ctl
sudo chmod 755 /usr/bin/pg_ctl

# Install packages
sudo yum -y install postgresql12 postgresql12-server postgresql12-contrib

# Init db
sudo su - postgres
/usr/pgsql-12/bin/initdb -D /var/lib/pgsql/12/data/
# Aja kannan päivitys (tarkista, että kannan päivitys menee ongelmitta läpi!)
/usr/pgsql-12/bin/pg_upgrade --old-datadir /var/lib/pgsql/data/ --new-datadir /var/lib/pgsql/12/data/ --old-bindir /usr/bin/ --new-bindir /usr/pgsql-12/bin/
exit

# Disable old services
sudo systemctl disable postgresql
# Enable new services
sudo systemctl enable postgresql-12
sudo systemctl start postgresql-12

# Remove old postgres instance
sudo yum remove postgresql
#to restore symlinks to postgres commands, reinstall postgres12 after uninstalling old version. This cannot be done sooner as pg_upgrade relies on old executables
sudo yum reinstall postgresql12

# Remove Postgres 9.2 workaround
sudo mv -f /usr/bin/pg_ctl{-orig,}

2. Installing Java 17 Temurin JDK

Check the current java version:
java -version

#If security server have old Java version 11 it needs to be updated to Java 17 Temurin JDK version. First add the Adoptium repository to your system (this example uses Vim text editor but you are free to use text editor that you prefer)
vim /etc/yum.repos.d/adoptium.repo
#Add adoptium repository content:
[Adoptium]
name=Adoptium
baseurl=https://packages.adoptium.net/artifactory/rpm/rhel/7/x86_64
enabled=1
gpgcheck=1
gpgkey=https://packages.adoptium.net/artifactory/api/gpg/key/public

#Install Java 17 (Eclipse Temurin JDK):
yum install temurin-17-jdk

#After Java 17 Temurin JDK installation verify current Java version and switch earlier Java version to version 17 with commands:
sudo alternatives --config java
#Verify that security server is using Java 17 Temurin JDK version
java -version

3. Update security server xroad to version 7.4.1

#Upgrade xroad to version 7.4.1 with yum
yum update

# After that start X-road software
systemctl start --all "xroad-*"

Short upgrade instructions for Ubuntu:

Ubuntu 20.04 LTS / Ubuntu 22.04 LTS:
- curl http://www.nic.funet.fi/pub/csc/x-road/client/ubuntu-dev-current/niis.public.asc| sudo apt-key add -
- apt update
- apt full-upgrade

Note!

Please note you can only update to the version 7.4.1 from the software verseion 7.2.x or 7.3.x.

Full Release Notes for the new version can be found here Opens in a new window.and hereOpens in a new window..