Suomi.fi kehittäjille
Siirry suoraan sisältöön.

Liityntäpalvelimen tekniset vaatimukset

Tässä artikkelissa kuvataan, millaisia teknisiä vaatimuksia Suomi.fi-palveluväylän alustapalvelimeen (RHEL, Ubuntu) pohjautuvalla liityntäpalvelimella on.

Tutustu myös kontitetun liityntäpalvelimen teknisiin vaatimuksiin.

Tuotantoympäristö ja palvelinalusta

  • Fyysinen tai virtualisoitu palvelinympäristö
  • Toimivat aikapalvelut (NTP, Network Time Protocol) - palomuuriavausten NTP-palvelulle pitää olla tehty: UDP-portti 123
  • Toimivat nimipalvelut (DNS, Domain Name System) - palomuuriavausten DNS-palvelulle pitää olla tehty: TCP-portti 53

Käyttöjärjestelmä

  • Ubuntu 20.04 LTS- tai Ubuntu 22.04 LTS -palvelinasennus

TAI

  • RHEL 7 tai RHEL 8 -palvelinasennus

Palvelinten yleisiä mitoitusohjeita

Seuraavassa on esitetty Palveluväylän liityntäpalvelinten yleisiä mitoitusohjeita erilaisiin käyttötilanteisiin.

Testikäyttö

Kevyt testikone, toiminnalliseen testaukseen

  • 2 vcore
  • 4 GB muistia
  • OS-partitio: 10 GB
  • /var/-levyosio: 20–40 GB
  • 1 kpl 1 Gb/s -verkkoyhteys

Testikone, normaaliin toiminnalliseen testaukseen

  • 4–8 vcore
  • 8–16 GB muistia
  • OS-partitio: 10 GB
  • /var/-levyosio: 40–80 GB
  • 1 kpl 1 Gb/s -verkkoyhteys

Testikone, raskaaseen kuormitustestikäyttöön

  • 8 vcore
  • 16 GB muistia
  • OS-partitio: 10 GB
  • /var/-levyosio: 80–160 GB
  • 1 kpl 1 Gb/s -verkkoyhteys

Tuotantokäyttö

Tuotantokone, kevyt tuotantokäyttö

  • 2 vcore
  • 4 GB muistia
  • OS-partitio: 10 GB
  • /var/-levyosio: 20–80 GB
  • 1 kpl 1 Gb/s -verkkoyhteys

Kevyeen tuotantokäyttöön tarkoitettu kone kykenee

  • tekemään < 50 kyselyä minuutissa (sanomakoot 500 K) jatkuvalla tasaisella kuormituksella
  • siirtämään isoja tietomääriä (sanomakoot 0,5 M–10 M) normaalien SOAP-sanomien sisällä muutama kysely minuutissa.

Tuotantokone, normaali tuotantokäyttö

  • 4 vcore
  • 4–8 GB muistia
  • OS-partitio: 10 GB
  • /var/-levyosio: 80–160 GB
  • 1 kpl 1 Gb/s -verkkoyhteys

Normaaliin tuotantokäyttöön tarkoitettu kone kykenee

  • tekemään 50–125 kyselyä minuutissa (sanomakoot 500 K) jatkuvalla tasaisella kuormituksella
  • siirtämään isoja tietomääriä (sanomakoot 0,5 M–10 M) normaalien SOAP-sanomien sisällä kymmenkunta kyselyä minuutissa.

Tuotantokone, raskas tuotantokäyttö

  • 4–8 vcore
  • 8–16 GB muistia
  • OS-partitio: 10 GB
  • /var/-levyosio: 160–320 GB
  • 1 kpl 1 Gb/s -verkkoyhteys

Raskaaseen tuotantokäyttöön tarkoitettu kone kykenee

  • tekemään 150–250 kyselyä minuutissa (sanomakoot 500 K) jatkuvalla tasaisella kuormituksella
  • siirtämään isoja tietomääriä (sanomakoot 0,5 M–10 M) normaalien SOAP-sanomien sisällä useita kymmeniä kyselyjä minuutissa.

Palvelimen tarvitseman levytilan määrän arviointi

Liityntäpalvelimen tarvitseman levytilan määrää arvioitaessa on syytä ottaa huomioon lokimerkintöjen tarvitsema levytila, sillä jokaisen SOAP-kysely- ja -vastaussanoman sisältö lokitetaan tietokantaan. Suomi.fi-palveluväylässä ei kuitenkaan lokiteta SOAP-sanomien body-osaa.

Kyselysanomat sisältävät 9,5 kB metadataa (SOAP-määritykset, -tunnisteet ja -headerit) ja allekirjoituksia. Vastaussanomassa vastaavan informaation määrä on 11,2 kB. Jokainen onnistunut kysely tuottaa siis edestakaisten SOAP-sanomien myötä 21 kB Palveluväylän sisäistä metadataa sanomalokiin. Tämän lisäksi liityntäpalvelimet käyvät minuutin välein allekirjoituttamassa aikaleimapalvelulla tuona aikana kirjatut viestit, jos sellaisia on. Aikaleimojen kiinteä koko on 3,6 kB.

Levytilan tarve aktiiviselle sanomalokille on siis oletusarvoisesti

3,6 kB + N * (21 kB + R + A) = S

jossa

N = kyselyitä minuutissa 

R = kyselyn body-osan koko kilotavuina (kB), Suomen tapauksessa 0 kB 

A = vastauksen body-osan koko kilotavuina (kB), Suomen tapauksessa 0 kB 

S = levyn käyttö minuutissa kilotavuina (kB/min).

Esimerkki 1

Oletetaan, että tietojärjestelmälle tulee 100 kyselyä minuutissa. Kyselysanoman body-osan koko on 4 kB ja vastaussanoman 8 kB. Niitä ei kuitenkaan lokiteta Suomessa, joten sanomien body-osien koko on 0 kB. Tällöin sanomalokin levynkäyttö on

3,6 kB + 100 * (21 kB + 0 kB + 0 kB) = 2 103,6 kB/min = 2,1 MB/min.

Vuorokaudessa levytilaa tarvitaan 2,95 GB. Tietokannassa säilytetään oletusarvoisesti 30 päivän sanomalokit, joten tilaa tarvitaan 88,5 GB.

Laskuihin tulee ottaa mukaan vielä arkistoidut viestit. Ne vaativat tilaa noin 43 prosenttia aktiivisesti tietokannassa säilytettävästä lokin määrästä. Lisälevytilaa tarvitaan siis seuraavasti:

  • 1,3 GB/vuorokausi
  • 39 GB/kuukausi
  • 468 GB/vuosi.

Yhteensä levytilan tarve on siis

  • 2,95 + 1,3 GB = 4,25 GB/vuorokausi
  • 88,5 + 39 GB = 127,6 GB/kuukausi
  • 1 062 + 468 GB = 1 530 GB/vuosi.

Esimerkki 2

Oletetaan, että tietojärjestelmälle tulee 1 000 kyselyä minuutissa. Kyselysanoman body-osan koko on 4 kB ja vastaussanoman 8 kB. Niitä ei kuitenkaan lokiteta Suomessa, joten sanomien body-osien koko on 0 kB. Tällöin sanomalokin levynkäyttö on

3,6 kB + 1 000 * (21 kB + 0 kB + 0 kB) = 21 003,6 kB/min = 20,5 MB/min.

Vuorokaudessa levytilaa tarvitaan 28,8 GB. Tietokannassa säilytetään oletusarvoisesti 30 päivän sanomalokit, joten tilaa tarvitaan 864 GB.

Laskuihin tulee ottaa mukaan vielä arkistoidut viestit. Ne vaativat tilaa noin 43 prosenttia aktiivisesti tietokannassa säilytettävästä lokin määrästä. Lisälevytilaa tarvitaan siis seuraavasti:

  • 12,4 GB/vuorokausi
  • 371,5 GB/kuukausi
  • 4,4 TB/vuosi.

Yhteensä levytilan tarve on siis

  • 28,8 + 12,4 GB = 41,2 GB/vuorokausi
  • 864 + 371,5 GB = 1 235,5 GB/kuukausi
  • 10,4 TB + 4,4 TB = 14,8 TB/vuosi.

Suurten liitetiedostojen siirtoon liittyviä mitoitusohjeita

Palveluväylässä suurten tietomäärien siirtämisessä suositellaan käytettävän liitetiedostoja. Suuriksi tiedostoiksi luokitellaan noin 10 MB:n kokoiset ja sitä isommat tiedostot.

Tutustu tarkemmin suurten liitetiedostojen siirtämiseen Palveluväylässä.

Erityisesti suurten liitetiedostojen siirrossa on otettava huomioon levytilan määrä. Liitetiedostot tallennetaan levyvälimuistiin. Levytilaa on siis oltava vapaana vähintään sen verran, että liitetiedosto voidaan tallentaa levylle.


Päivitetty: 7.10.2024

Oletko tyytyväinen tämän sivun sisältöön?