Liityntäpalvelimen suositellut muistiasetukset ja ohjeet niiden muuttamiseen

Tässä artikkelissa kuvataan Suomi.fi-palveluväylän liityntäpalvelimen ohjelmiston suositellut muistiasetukset, jotka riippuvat liityntäpalvelimen alustakoneen keskusmuistin määrästä. Lisäksi artikkelissa annetaan ohjeet muistiasetusten muuttamiseksi.

Liityntäpalvelimen Proxy- ja Signer-prosessien muistiasetukset keskusmuistin määrästä riippuen

Oletusarvoinen Proxyn muistiasetus on liian pieni, ellei käytössä ole alustakoneen aivan minimikokoonpano. Jos muistiasetus on liian pieni, liityntäpalvelimen suorituskyky ei ole optimaalinen. Proxyn muistiasetusta suositellaankin kasvatettavan koneen käytettävissä olevan keskusmuistin mukaan. Myös Signerin muistia kannattaa kasvattaa, mutta sen merkitys ei ole yhtä suuri.

Taulukossa 1 on esitetty Proxy- ja Signer-prosessien suositellut muistiasetukset suhteessa alustakoneen käytettävissä olevaan muistin määrään. Suositukset on pyritty tekemään konservatiivisesti. Joka tilanteeseen sopivaa suositusta ei voida antaa, koska optimaalinen muistin määrä riippuu liityntäpalvelimesta ja sen käyttötapauksista.

Taulukko 1. Proxy- ja Signer-prosessien suositellut muistiasetukset keskusmuistin määrän mukaan.

*) Esimerkkinä on käytetty AWS-ympäristössä käytössä olevien koneiden yleisiä instanssityyppejä. Instanssien tyypit saattavat vaihdella käyttöympäristön mukaan.

Liityntäpalvelimen Proxy- ja Signer-prosessien muistiasetusten muuttaminen

Liityntäpalvelimen muistiasetukset (sekä Proxy- että Signer-prosessit) muutetaan tarvittaessa tiedostoon /etc/xroad/services/local.conf. Alla on ohjeet Proxy- ja Signer-prosessien muistiasetusten muuttamiseen X-Road version mukaan.

Proxy- ja Signer-prosessit lukevat konfiguraatiotiedostoja, jotka sijaitsevat liityntäpalvelimella poluissa /etc/xroad/services/proxy.conf ja /etc/xroad/services/signer.conf. Molemmat prosessit lukevat myös local.conf-tiedoston liityntäpalvelimen ohjelmiston käynnistyksen yhteydessä, joten tiedostoon voidaan tehdä paikalliset, oletusarvoista poikkeavat muutokset. Jotta muistiasetusmuutokset tulevat voimaan, oikea paikka tehdä ne on nimenomaan local.conf-tiedosto (proxy.conf- ja signer.conf-tiedostot ylikirjoitetaan asennuksen yhteydessä).

Suositellut muistiasetukset Proxy-prosessille

Proxy (X-Road 7):

1. Muuta alla oleva parametri määrittääksesi Proxy-prosessille 200–2000 megatavun dynaamisen muistialueen (heap, maksimi 2000, minimi 200):

XROAD_PROXY_PARAMS=-Xms200m -Xmx2000m

2. Tallenna tiedosto muutosten jälkeen

3. Käynnistä Proxy-prosessi uudestaan alla olevan komennon avulla:

systemctl restart xroad-proxy

Proxy (X-Road 6):

1. Muuta alla oleva parametri määrittääksesi Proxy-prosessille 200–2000 megatavun dynaamisen muistialueen (heap, maksimi 2000, minimi 200):

PROXY_PARAMS="$PROXY_PARAMS -Xms200m -Xmx2000m "

2. Tallenna tiedosto muutosten jälkeen

3. Käynnistä Proxy-prosessi uudestaan alla olevan komennon avulla:

# Ubuntu
service xroad-proxy restart

# RHEL
systemctl restart xroad-proxy

Lue lisää Proxy-prosessin muistiasetusten muuttamisesta NIIS:n dokumentaatiostaAvautuu uuteen ikkunaan..

Suositellut muistiasetukset Signer-prosessille

Signer (X-Road 7):

1. Muuta alla oleva parametri määrittääksesi Signer-prosessille 50–200 megatavun dynaamisen muistialueen (heap, maksimi 200, minimi 50):

XROAD_SIGNER_PARAMS=-Xms50m -Xmx200m

2. Tallenna tiedosto muutosten jälkeen

3. Käynnistä Signer-prosessi uudestaan alla olevan komennon avulla:

systemctl restart xroad-signer

Signer (X-Road 6):

1. Muuta alla oleva parametri määrittääksesi Signer-prosessille 50–200 megatavun dynaamisen muistialueen (heap, maksimi 200, minimi 50):

SIGNER_PARAMS="$SIGNER_PARAMS -Xms50m -Xmx200m "

2. Tallenna tiedosto muutosten jälkeen

3. Käynnistä Proxy-prosessi uudestaan alla olevan komennon avulla:

# Ubuntu
service xroad-signer restart 

# RHEL
systemctl restart xroad-signer

Lue lisää Signer-prosessin muistiasetusten muuttamisesta NIIS:n dokumentaatiostaAvautuu uuteen ikkunaan..