Suomi.fi Data Exchange Layer production environment has been updated to X-Road 7.4.2 version 22.05.2024

Please read this announcement before upgrading your security server. 

Upgrade instructions

For RHEL 7/8:

1. Postgresql upgrade (from version 9->12) for X-Road 7.4.2

#Before postgresql upgrade take backup or snapshot from security server! Then stop xroad 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 X-Road to version 7.4.2

#Upgrade xroad to version 7.4.1 with
yum yum update

# After that start xroad 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-prod-current/niis.public.asc| sudo apt-key add -
- apt update
- apt full-upgrade

To note:

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

Full Release Notes for the new version can be found at: 

• https://nordic-institute.atlassian.net/wiki/spaces/XRDKB/pages/279511050/X-Road+v7.4.0+Release+Notes
• https://nordic-institute.atlassian.net/wiki/spaces/XRDKB/pages/345800712/X-Road+v7.4.1+Release+Notes
• https://nordic-institute.atlassian.net/wiki/spaces/XRDKB/pages/414187521/X-Road+v7.4.2+Release+Notes