Roihun käytön aloittaminen

Tämä opas olettaa, että CSC:n supertietokoneet, kuten Puhti, Mahti tai LUMI, ovat sinulle ennestään tuttuja.

Jos CSC:n järjestelmät ovat sinulle uusia, aloita supertietokoneiden käytön aloitusoppaasta.

Roihun käyttöä varten tarvitset CSC-käyttäjätunnuksen ja projektin, jossa Roihu-palvelu on käytössä. Lue lisää CSC-käyttäjätunnuksista ja projekteista.

Roihun käytön aloittaminen

Keskeiset erot verrattuna Puhtiin ja Mahtiin

Ennen kuin aloitat, huomioi seuraavat tärkeät erot:

SSH-tunnistautuminen vaatii lyhytikäisiä varmenteita (24 h)
Erilliset kirjautumissolmut ja CPU-arkkitehtuurit CPU- (x86) ja GPU- (ARM) -ympäristöille
CPU-solmuilla rakennettua ohjelmistoa ei voi käyttää GPU-solmuilla (eikä päinvastoin)
Levykiintiöiden laajennukset eivät siirry automaattisesti aiemmista projekteista Puhtiin/Mahtiin

Nämä erot vaikuttavat useimpiin työnkulkuihin, joten lue alla olevat osiot huolellisesti.

Lisää Roihu palveluksi

Ennen kuin alat käyttää Roihua, sinun täytyy ottaa se käyttöön projektisi palveluna MyCSC:ssä.

Projektipäälliköt

Jos sinulla on jo laskentaprojekti esimerkiksi Mahtia tai Puhtia varten, voit lisätä Roihun kyseisen projektin palveluksi. Olemassa olevia CPU-, GPU- ja tallennuksen laskutusyksiköitä (BUs) voi käyttää myös Roihussa, joten sinun ei tarvitse hakea lisää laskutusyksiköitä (BUs) Roihua varten, jos projektissasi on vielä BUs-yksiköitä käytettävissä.

Jos sinulla ei vielä ole laskentaprojektia, hae sellaista MyCSC:ssä noudattamalla ohjeita kohdassa uuden projektin luominen.

Roihun lisääminen palveluksi:

Mene osoitteeseen my.csc.fi ja kirjaudu sisään esimerkiksi HAKA-tunnistautumisella
Siirry kohtaan "Profile" ja tarkista oikeasta alakulmasta, että henkilöllisyyden varmuustasosi (LoA) on medium tai high
- Jos LoA-tasosi on low, sinun täytyy nostaa sitä päästäksesi käyttämään Roihua. Katso ohjeet LoA-tason nostamiseen.
Siirry kohtaan "Projects" ja avaa projektisi.
Napsauta oikeanpuoleisella Services-välilehdellä vaihtoehtoa "+ Add services".
Valitse Roihu, napsauta Next ja vahvista valinta.

Huomaa, että voi kestää muutaman minuutin ennen kuin Roihu tulee sinun ja muiden projektin jäsenten käyttöön.

Entä jos tarvitsen lisää levykiintiötä Roihussa?

Oletuslevykiintiöt ovat Roihussa tiukemmat kuin Mahdissa ja Puhdissa.

	Kapasiteetti	Tiedostojen määrä
home	15 GiB	150 000 tiedostoa
projappl	15 GiB	150 000 tiedostoa
scratch	250 GiB	500 000 tiedostoa

Kun olet lisännyt Roihu-palvelun projektiisi, voit hakea projektillesi levykiintiön kasvattamista MyCSC:ssä.

Siirry MyCSC:ssä projektiisi, jossa Roihu on käytössä.
Etsi "Services"-välilehdeltä Roihu ja napsauta Configure.
Määritä kohdassa "Quota settings", kuinka paljon kiintiötä tarvitset, ja perustele pyyntösi tekstikentässä.

Katso lisätietoja ja haettavissa olevat enimmäislevykiintiöt osiosta "levykiintiöiden kasvattaminen".

Projektin jäsenet

Kun projektipäällikkösi on hakenut Roihu-palvelua, saat sähköpostin, jonka otsikko on "Roihu supercomputer for your use".

Hyväksy sen jälkeen Roihun käyttöehdot seuraavien ohjeiden mukaisesti:

Mene osoitteeseen my.csc.fi ja kirjaudu sisään esimerkiksi HAKA-tunnistautumisella
Siirry kohtaan "Profile" ja tarkista oikeasta alakulmasta, että henkilöllisyyden varmuustasosi (LoA) on medium tai high
- Jos LoA-tasosi on low, sinun täytyy nostaa sitä päästäksesi käyttämään Roihua. Katso ohjeet LoA-tason nostamiseen.
Siirry kohtaan "Projects" ja avaa projektisi.
Avaa Roihu oikeanpuoleiselta Services-välilehdeltä
Hyväksy käyttöehdot.

Kun Roihu on lisätty projektiisi, voit muodostaa yhteyden järjestelmään. Huomaa, että yhteyden muodostaminen voi onnistua vasta muutaman minuutin viiveen jälkeen.

Yhdistäminen

Yhdistä Roihuun joko käyttämällä:

SSH-asiakasohjelmaa
Roihun selainkäyttöliittymää

SSH-asiakasohjelma

Yhdistä SSH:n kautta seuraavasti:

Ota SSH-avaimet käyttöön (samoin kuin Puhdissa/Mahdissa)
Uutta: Allekirjoita julkinen avaimesi ja lataa varmenne
- Varmenteet ovat voimassa 24 tuntia
- Katso ohjeemme varmenteiden hallintaan: Julkisten SSH-avainten allekirjoittaminen

Alustakohtaiset ohjeet löydät täältä:

Lue yksityiskohtaiset ohjeet SSH-avainten ja varmenteiden hallintaan.

Erilliset CPU- ja GPU-ympäristöt

Roihussa on eri CPU-arkkitehtuurit Roihu-CPU:ssa (x86) ja Roihu-GPU:ssa (ARM). Siksi ohjelmien rakentamiseen ja töiden lähettämiseen niiden omille solmuilleen on erilliset kirjautumissolmut:

roihu-cpu.csc.fi
roihu-gpu.csc.fi

Yhteysesimerkki (Roihu-CPU):

# Replace <username> with the name of your CSC user account.

ssh <username>@roihu-cpu.csc.fi

Tärkeää:
- Roihu-CPU-solmuilla käännetty ohjelmisto toimii vain Roihu-CPU-solmuilla
- Roihu-GPU-solmuilla käännetty ohjelmisto toimii vain Roihu-GPU-solmuilla
- Tämä koskee myös Python-ympäristöjä

Kaikki kirjautumissolmut käyttävät silti samaa tiedostojärjestelmää, joten tiedostosi ovat käytettävissä kaikista niistä.

Roihun selainkäyttöliittymä

Yksinkertaisin tapa yhdistää Roihuun on käyttää selainkäyttöliittymää.

Mene osoitteeseen www.roihu.csc.fi.
Kirjaudu sisään HAKA-, Virtu- tai CSC-käyttäjätunnuksellasi. Monivaiheinen tunnistautuminen (MFA) vaaditaan.

Tutkimusdatan siirtäminen

Jos sinun täytyy siirtää dataa Puhdista tai Mahdista Roihuun, edellytämme, että:

Käyt aineistosi huolellisesti läpi – siirrä vain se, mitä todella tarvitset
Tarkistat käytettävissä olevan levytilasi Roihussa (esimerkiksi komennolla csc-workspaces)
Siirrät datan suoraan Puhdista tai Mahdista Roihuun.

Huomaa, että aiempia laajennettuja levykiintiöitä Puhdissa tai Mahdissa ei siirretä automaattisesti Roihuun. Roihun kiintiölaajennuksia täytyy hakea erikseen, ja ne on perusteltava asianmukaisesti.

Lue yksityiskohtaiset ohjeet Roihun datansiirto-oppaasta.

Ohjelmistojen asentaminen

Ennen kuin asennat mitään, tarkista, onko ohjelmisto jo saatavilla:

Esiasennettujen sovellusten luettelo
module spider <software name>

Jos ohjelmisto ei ole saatavilla moduulina, valitse tarpeidesi mukaan jokin seuraavista lähestymistavoista:

C/C++/Fortran-koodin kääntäminen

C:tä, C++:aa tai Fortrania käyttävillä ohjelmointikielillä kirjoitettu HPC-ohjelmisto täytyy kääntää ennen asentamista.

Ohjeet saatavilla olevista kääntäjistä ja suositelluista vaihtoehdoista löydät ohjelmistojen kääntämistä koskevista ohjeista:

Kontit

Roihu tukee Apptainer/Singularity-kontteja konttipohjaisiin asennuksiin. Useimmissa tapauksissa valmiit Docker-kontit voidaan helposti muuntaa Apptainer-kuvaksi. Toinen vaihtoehto on rakentaa oma kontti alusta alkaen. Voit rakentaa kontteja Roihun peruskonttien päälle, joissa on sama ohjelmistopino kuin moduulijärjestelmän kautta natiivisti saatavilla. Peruskontit on rakennettu Rocky Linux 9:n päälle.

Roihun CPU-peruskontti (~4 GB)Roihun GPU-peruskontti (~16 GB)Roihun ML/AI GPU -peruskontit

Peruskontteja on saatavilla:

satama.csc.fi/r_installation_spack/core-cpu-gcc-15.2.0:v2026_03

Määritystiedosto rakentamista varten:

container.def

Bootstrap: docker
From: satama.csc.fi/r_installation_spack/core-cpu-gcc-15.2.0:v2026_03

%post
    # Activate module environment and load default modules.
    . /opt/activate.sh
    # Build your application here:

%runscript
    . /opt/activate.sh
    exec "$@"

Kun rakennat kontteja, aseta Apptainerin välimuistihakemisto osoittamaan $TMPDIR-hakemistoon, jotta kotihakemistosi kiintiö ei täyty.

export APPTAINER_CACHEDIR=$TMPDIR
apptainer build --fakeroot container.sif container.def

Nyt voit suorittaa komentoja kontin sisällä ympäristö aktivoituna seuraavasti:

apptainer run container.sif mycmd

Peruskontteja on saatavilla:

satama.csc.fi/r_installation_spack/core-gpu-gcc-15.2.0-cuda-13.1.1:v2026_03
satama.csc.fi/r_installation_spack/core-gpu-gcc-14.3.0-cuda-12.9.1:v2026_03
satama.csc.fi/r_installation_spack/core-gpu-gcc-13.4.0-cuda-12.6.3:v2026_03

Määritystiedosto rakentamista varten:

container.def

Bootstrap: docker
From: satama.csc.fi/r_installation_spack/core-gpu-gcc-14.3.0-cuda-12.9.1:v2026_03

%post
    # Activate module environment and load default modules.
    . /opt/activate.sh
    # Build your application here:

%runscript
    . /opt/activate.sh
    exec "$@"

Kun rakennat kontteja, aseta Apptainerin välimuistihakemisto osoittamaan $TMPDIR-hakemistoon, jotta kotihakemistosi kiintiö ei täyty.

export APPTAINER_CACHEDIR=$TMPDIR
apptainer build --fakeroot container.sif container.def

Nyt voit suorittaa komentoja kontin sisällä ympäristö aktivoituna seuraavasti:

apptainer run --nv container.sif mycmd

Koneoppimisen/tekoälyn peruskontteja on saatavilla.

Nämä kontit on rakennettu Rocky Linux 9.7:n päälle, ja Python 3, MPI sekä CUDA on asennettu RPM-paketeilla. Tämä lähestymistapa tuottaa kontin, joka ei ole identtinen Roihun isäntäjärjestelmän kanssa, mutta jota voi joissakin tapauksissa olla helpompi laajentaa kuin tavallisia peruskontteja.

satama.csc.fi/r_installation_aida/ml-base:rocky9.7_gcc12_py3.12_cuda12.9
satama.csc.fi/r_installation_aida/ml-base:rocky9.7_gcc12_py3.12_cuda13
satama.csc.fi/r_installation_aida/pytorch-base:2.10_cuda13_roihu - ml-base-kuva, johon on lisätty PyTorch 2.10:n peruspaketit
satama.csc.fi/r_installation_aida/pytorch:2.10_cuda13_roihu - täydellinen PyTorch-asennus (sama kuin CSC-moduulissa)
satama.csc.fi/r_installation_aida/vllm:0.19.1_cuda12.9_roihu - vLLM-kontti (sama kuin CSC-moduulissa)

Määritystiedosto rakentamista varten:

container.def

Bootstrap: docker
From: satama.csc.fi/r_installation_aida/ml-base:rocky9.7_gcc12_py3.12_cuda13

%post
    # Build your application here:

Kun rakennat kontteja, aseta Apptainerin välimuistihakemisto osoittamaan $TMPDIR-hakemistoon, jotta kotihakemistosi kiintiö ei täyty.

export APPTAINER_CACHEDIR=$TMPDIR
apptainer build --fakeroot container.sif container.def

Nyt voit suorittaa komentoja kontin sisällä. Esimerkiksi käynnistääksesi python3:n:

apptainer exec --nv --bind=$(csc-common-bind) container.sif python3

Lisätietoja konttien käytöstä CSC:n laskentaympäristössä löydät alla olevista linkeistä:

Spack

Spack on joustava paketinhallintaohjelma, jota voidaan käyttää ohjelmistojen asentamiseen supertietokoneille sekä Linux- ja macOS-järjestelmiin. Perusmoduulipuu, mukaan lukien kääntäjät, MPI-kirjastot ja monet CSC:n supertietokoneilla saatavilla olevat ohjelmistot, on asennettu Spackilla. Spack muistuttaa EasyBuild-paketinhallintaa, jota käytetään laajasti LUMIssa.

CSC tarjoaa Roihussa käyttäjille Spack-moduuleja, joita voidaan käyttää ohjelmistojen rakentamiseen saatavilla olevien kääntäjien ja kirjastojen päälle. On myös mahdollista asentaa moduulipuussa saatavilla olevista paketeista erilaisia räätälöityjä versioita erityisiä käyttötapauksia varten.

Katso tästä lyhyt opastus ohjelmistojen asentamiseen Roihussa Spackin avulla.

Python/R-ympäristöt

Parhaiden käytäntöjen ohjeet omien Python- ja R-pakettien asentamiseen löytyvät alla olevilta Python-, R- ja Tykky-konttikääresivuilta.

Ensimmäisen työn ajaminen

Roihu käyttää Slurmia samaan tapaan kuin Puhti ja Mahti.

Perustyövuo:

Luo työskripti, jossa
- määrittelet työsi resurssit (aika, muisti, ytimet)
- lataat tarvittavat moduulit
- käynnistät suoritettavan ohjelman
Lähetä eräajotyösi jonotusjärjestelmään
Odota työn valmistumista ja tarkista sen tuloste

Katso yksityiskohtaiset tiedot alla olevasta dokumentaatiosta:

Yleisiä Slurm-virheilmoituksia varten katso UKK:mme Miksi eräajotyöni epäonnistuu?.