Suomi.fi-palveluväylän tuotantoympäristön (FI) keskuspalvelinympäristö on päivitetty uuteen X-Road 7.5.1 versioon 15.1.2025
Julkaistu 15.1.2025
Suomi.fi-palveluväylän tuotantoympäristön (FI) keskuspalvelinympäristö on päivitetty uuteen X-Road 7.5.1 versioon 15.1.2025. X-Road 7.5.1 versio tukee uusia RHEL9 ja Ubuntu 24.04LTS käyttöjärjestelmiä.
Uuden X-Road version asennuspaketit on vapautettu repoihin ja liityntäpalvelimet voi päivittää uuteen versioon. HUOM! Huomioittehan, että X-Road Ubuntu käyttäjien tietojärjestelmien portit 80 ja 443 vaihtuvat portteihin 8080 ja 8443. Tarkempi maininta asiasta löytyy alla olevasta xroadin release noteista. Sama huomio koskee myös X-Road konttiversion käyttäjiä, tietojärjestelmän kuunteluportit tarvitsee vaihtaa 8080 ja 8443 portteihin jos niitä ei ole käytetty aiemmin.
Tarkemmat Release Notet uudelle versiolle:
https://nordic-institute.atlassian.net/wiki/spaces/XRDKB/pages/541491202/X-Road+v7.5.0+Release+NotesAvautuu uuteen ikkunaan.
ja
https://nordic-institute.atlassian.net/wiki/spaces/XRDKB/pages/665419777/X-Road+v7.5.1+Release+NotesAvautuu uuteen ikkunaan.
Päivitysohjeet:
RHEL 7/8 (xroad 7.4.x -> 7.5.1 versioon):
yum update
RHEL 7/8 (xroad 7.3.x -> 7.5.1 versioon):
1. Postgresin päivitys (versiosta 9 tai 12 -> 16) X-Road 7.4.2 varten
# Ennen päivityksen alkua ota liityntäpalvelimesta varmuuskopio tai snapshot! Tämän jälkeen xroad ohjelmisto tarvitsee pysäyttää ennen postgresin päivitystä
sudo systemctl stop "xroad-*"
# Sammuta postgresql kanta
sudo systemctl stop postgresql
# RPM repositorion asennus postgresql varten:
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
# Deprekoituneen Postgres 9.2 unix_socket_directory ominaisuuden väliaikainen korjaus päivityksen ajaksi
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
# Asenna postgresql 16 paketit
sudo yum -y install postgresql16 postgresql16-server postgresql16-contrib
# Alusta tietokanta
sudo su - postgres
/usr/pgsql-16/bin/initdb -D /var/lib/pgsql/16/data/
# Aja kannan päivitys (tarkista, että kannan päivitys menee ongelmitta läpi!)
/usr/pgsql-16/bin/pg_upgrade --old-datadir /var/lib/pgsql/data/ --new-datadir /var/lib/pgsql/16/data/ --old-bindir /usr/bin/ --new-bindir /usr/pgsql-16/bin/
exit
# Disabloi vanha postgesql kanta
sudo systemctl disable postgresql
# Enabloi uusi postgresql 16 kanta
sudo systemctl enable postgresql-16
sudo systemctl start postgresql-16
# Poista vanha postgresql instanssi
sudo yum remove postgresql
# Asennetaan postgres16 uudestaan. Tätä ei voitu tehdä aikaisemmin, koska pg_upgrade tarvitsi aiemmin tiedon vanhoista ajotiedostoista.
sudo yum reinstall postgresql16
# Poista väliaikainen Postgres 9.2 unix_socket_directory korjaus
sudo mv -f /usr/bin/pg_ctl{-orig,}
2. Java 17 Temurin version asennus
# Java version tarkistus
java -version
# Jos Java on vielä vanhassa versiossa 11 pitää tehdä 17 version päivitys. Luodaan adoptium.repo aluksi (esimerkissä Vim editori mutta voit käyttää sinulle sopivaa editoria repositorion luomiseen)
vim /etc/yum.repos.d/adoptium.repo
# Repon sisältö
[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
# Asennetaan Java 17 temurin
yum install temurin-17-jdk
# Asennuksen jälkeen tarkistetaan mikä Java versio on ajossa ja vaihdetaan versioon 17 ennen xroad päivitystä
sudo alternatives --config java
# Tarkistetaan, että ajossa on versio 17
java -version
3. Päivitä RHEL palvelimen X-Road uuteen 7.4.2 lopuksi
# Lopuksi ajetaan xroadin päivitys
yum update
# Käynnistä xroad ohjelmisto päivityksen lopuksi
systemctl start --all "xroad-*"
Ubuntun lyhyet päivitysohjeet:
Ubuntu 20.04 LTS / Ubuntu 22.04 LTS:
1. Xroadin päivitys 7.5.1 versioon
- 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
2. Xroad kuuntelee päivityksen jälkeen tietojärjestelmää pelkästään porteissa 8080 ja 8443.
Käyttöliittymänäkymän saa korjattua kommentoimalla local.ini tiedostosta alla olevat client rivit pois ja käynnistämällä xroad-proxy.service palvelun uudestaan:
/etc/xroad/conf.d/local.ini
[proxy]
allow-get-wsdl-request = true
#client-http-port = 80
#client-https-port = 443
#Käynnistetään xroad-proxy.service uudestaan muutosten jälkeen
systemctl restart xroad-proxy.service