Suomi.fi-palveluväylän versio 6.21.0 julkaistaan 30.4.2019

Seuraava Suomi.fi-palveluväylän ohjelmistoversio julkaistaan 30.4.2019

Suomi.fi-palveluväylän seuraava uusi ohjelmistoversio 6.21.0 julkaistaan 30.4. Tämän ohjelmistoversion julkaisun ja kaikki asennuspaketit tekee Suomen ja Viron yhteinen Nordic Institute for Interoperability Solutions– instituutti (NIIS).

Palveluväylän keskusympäristöt päivitetään FI-DEV ja FI-TEST osalta toukokuun 2019 aikana edellä mainittuun julkaistavaan versioon. Tuotannon keskusympäristö päivitetään elokuussa 2019.

Päivitysten suunnitellut alustavat ajankohdat ovat (muutokset mahdollisia):

  • Kehitysympäristö (FI-DEV) toukokuussa
  • Testiympäristö (FI-TEST) toukokuussa
  • Tuotantoympäristö (FI) elokuussa

Huomioitavaa on myös se, että keskusympäristön uuden ohjelmistoversion päivityksen aikana uusien liityntäpalvelinten tai organisaatioiden lisääminen Palveluväylään ei ole mahdollista. Päivityksen tarkka ajankohta ilmoitetaan ympäristökohtaisilla jakelulistoilla viikkoa ennen päivitystä.

Ylläpito lähettää tarkemmat päivitystä koskevat ohjeet liityntäpalvelinten teknisille yhteyshenkilöille keskusympäristöjen päivityksen jälkeen. Keskusympäristön päivityksen jälkeen on suositeltavaa päivittää liityntäpalvelimet uuteen ohjelmistoversioon 6.21.0 neljän viikon kuluessa. Uuden version päivityksen myötä liityntäpalvelimen uudet sekä parannetut ominaisuudet tuovat lisää tehokkuutta palveluväylän toimintaan sekä tietoturvaan, joten versiopäivitys kannattaa tehdä ensi tilassa.

Version 6.21.0 uusia ominaisuuksia ja parannuksia

Huhtikuun lopussa julkaistavan version 6.21.0 julkaisutiedote sisältää tarkemmat tiedot uuteen versioon tehdyistä ominaisuuksista ja parannuksista.Lue NIIS:in julkaisema oma versiotiedote täältä. Muun muassa seuraavat ominaisuudet ja parannukset on sisällytetty julkaistavaan versioon.

  • Tuki REST-palveluiden käyttöön ja tuottamiseen
    • Liityntäpalvelin tukee sekä SOAP- että REST-palveluiden käyttöä ja tuottamista.
    • REST-pohjaiset järjestelmät voidaan integroida Suomi.fi-palveluväylään ilman teknisiä muutoksia ja erillistä sovitinpalvelukomponenttia.
    • SOAP-palveluiden käyttäminen ja tuottaminen ovat edelleen tuettuja eikä olemassa oleviin SOAP-pohjaisiin palveluihin tarvitse tehdä muutoksia.
  • fi-palveluväylän liittymisprosessin tehostaminen
    • Lisätty mahdollisuus uusien liityntäpalvelinten ja alijärjestelmien rekisteröintipyyntöjen automaattiseen hyväksyntään
    • Operaattori (Suomi.fi-palveluväylän osalta CSC) voi valita automaattisen ja manuaalisen hyväksynnän Suomi.fi-palveluväylän liittymisen osalta.
    • Automaattinen hyväksyntä nopeuttaa rekisteröintiprosessia ja vähentää operaattorin päivittäisiä hallintatehtäviä.
    • Ominaisuuden käyttöönotosta Suomi.fi-palveluväylän osalta tehdään erillinen päätös ja siitä tiedotetaan myöhemmin. Muutos vaikuttaa prosesseihin.
  • Valmiiksi konfiguroitu, itsenäinen Docker imagena jaeltava liityntäpalvelin testaukseen ja kehittämiseen (Standalone Security Server)
    • Valmis käytettäväksi muutamassa minuutissa ilman normaalia liityntäpalvelimen asennus-, määritys- ja rekisteröintiprosessia.
    • Tarkoitettu testaustarkoituksiin X-Road-palvelun kehittämisessä, eikä se voi olla yhteydessä muihin liityntäpalvelimiin.
    • Toteutus on suunnattu erityisesti kehittäjille ja organisaatioille, jotka kehittävät palveluja julkaistavaksi ​​Suomi.fi-palveluväylässä.
    • Julkaistaan Docker Hub -alustalla touko-kesäkuussa 2019 – ei siis saatavilla vielä version 6.21.0 virallisena julkaisupäivänä.

Asennukseen ja päivitykseen liittyvää ohjeistusta

Uusi liityntäpalvelimen ohjelmistoversio eri Palveluväylän ympäristöihin (FI-DEV, FI-TEST ja FI) tulee saataville kun Palveluväylän ylläpito päivittää kyseisen ympäristön keskuspalvelimen uuteen versioon. Kun keskusympäristön päivitys on valmis, ylläpito ilmoittaa liityntäpalvelimen ohjelmistoversion latauslinkin kyseiseen ympäristöön. Ylläpito lähettää sähköpostilla myös tarkemmat päivitystä koskevat ohjeet liityntäpalvelinten teknisille yhteyshenkilöille keskusympäristöjen päivityksen jälkeen.

Uusi liityntäpalvelimen ohjelmisto voidaan päivittää toimivan v.6.17.0, v.6.19.0 tai v.6.20.x asennuksen päälle (Huom. Palveluväylän versioita 6.18.x ei ole olemassa Suomessa – versio 6.18.x on vain Virossa käytössä). Päivityksiä muiden vanhempien ohjelmistoversioiden päälle ei ole testattu, mutta hyvin todennäköisesti päivitys onnistuu normaalisti.

Asennus- ja päivitysohjeet löytyvät alla mainituista linkeistä. Uuden ohjelmistoversion julkaisun lähestyessä/tapahtuessa mainittuja ohjeita päivitetään vielä tarpeen vaatiessa ajanmukaiseksi.

HUOM! Versio 6.21.0 on viimeinen palveluväylän versio, joka sisältää Ubuntu 14-asennuspaketit. Versiosta 6.22.0 lähtien asennuspaketit julkaistaan vain Ubuntu 18 ja RHEL7.

Ubuntu 18.04 LTS

  • Testi- ja Tuotantoympäristö
    • Asennus ja päivitysohjeet julkaistaan myöhemmin NIIS:n toimesta.
    • Ohjeet ovat englanninkieliset

Ubuntu 14.04 LTS

Red Hat Enterprise Linux 7

Youtubesta löytyy myös havainnolliset videot liityntäpalvelimen käyttöönottoon liittyen:

 

Ennen päivitysasennusta tai päivitysasennuksen yhteydessä tarkista seuraavat asiat:

  • Liityntäpalvelimen Member-tasolle ei saa olla liitettynä palveluita
    • Versiosta v.6.9.3 lähtien liityntäpalvelimen kautta väylään tarjottavien palveluiden liittäminen suoraan Member-tasolle ei ole mahdollista, vaan palvelut on kytkettävä ainoastaan alijärjestelmän tasolle.
    • Palvelut on kytkettävä ainoastaan alijärjestelmän tasolle, palveluiden kytkemistä Member-tasolle ei enää tueta. Palvelut on siirrettävä käsin Member-tasolta alijärjestelmän tasolle ennen päivitysasennuksen aloittamista. Jos palveluita ei siirretä manuaalisesti pois, kaikki Member-tasolta löytyvät palvelut poistetaan automaattisesti. Huom! Asennusohjelma ei pysäytä asennusta tai anna automaattista virheilmoitusta tästä tilanteesta.
    • Ohjeet palvelujen lisäämisestä/siirtämisestä alijärjestelmän tasolle löytyvät täältä.
  • Versiosta v.6.16.0 lähtien liityntäpalvelimen ohjelmisto validoi liitettävien palveluiden käyttämät WSDL-tiedostot. Versiossa 6.20.0 validointiin tehtiin parannuksia ja validointi tapahtuu silloin kun a) joko kokonaan uuden palvelun WSDL-tiedosto lisätään (importataan) tai b) kun vanhan (jo olemassa olevan) palvelun WSDL-tiedosto päivitetään (refresh-toiminnallisuus). Validoinnin epäonnistuessa WSDL-tiedoston lisääminen (importointi) tai päivittäminen (refresh) ei onnistu. WSDL-tiedosto on muokattava oikean syntaksin mukaiseksi, jotta sen validointi onnistuu. Lisäohjeita WSDL-tiedoston syntaksiin löytyy täältä.
    • WSDL-tiedoston voi validoida etukäteen esimerkiksi erillisellä tietokoneella käyttäen command line -työkalua, joka on saatavilla osoitteesta: http://x-road.ee/valid/
    • Samasta verkko-osoitteesta löytyvät ohjeet työkalun käyttöön.

Mitoita liityntäpalvelin ja säädä muistiasetukset kohdalleen

Suosittelemme huomioimaan sivuillamme julkistetun ohjeistuksen siitä, miten muistiasetuksia kannattaa säätää omalla palvelinalustalla. Ohjeistus auttaa jokaista palveluväylään liittynyttä organisaatiota parantamaan oman liityntäpalvelimensa suorituskykyä, koska liityntäpalvelimen asennuspaketissa asetettavat vakioasetukset eivät useinkaan sovellu suoraan käyttöön, ainakaan optimaalisella tasolla. Lisää muistiasetuksien optimoinnista täältä. Ohjeiden lukeminen ja käyttöönotto todellakin kannattaa, koska se auttaa parantamaan liityntäpalvelimen suorituskykyä merkittävästi.

Muistathan myös tarkistaa, että oma liityntäpalvelimesi on mitoitettu kapasiteetiltaan ja suorituskyvyltään oikein väylän käyttöä varten. Ohjeistusta löydät täältä.

Ulkoisen kuormantasaajan käyttö mahdollista

Ulkoisen kuormantasaajan käyttö on ollut mahdollista palveluväylän versiosta 6.16.0 lähtien.

  • Lue lisää ulkoisen kuormantasaajan käytöstä palveluväylässä täältä.
  • Englanninkielinen asennus- ja konfigurointiohje kuormantasaajan käyttöönottoa varten löytyy täältä.

Uuden version asennukseen ja päivitykseen liittyviä kysymyksiä voit lähettää osoitteeseen palveluvayla(at)palveluvayla.fi.