Hyppää sisältöön

Docs CSC now features an automatic Finnish translation. Click here for more information.

Warning!

Puhti and Mahti will be decommissioned after Roihu becomes available. Users should clean up unnecessary files and move any required data by the end of August 2026. See the Roihu data preparation instructions for details.

Puhti scratch is very full: keep only active data there and move or delete everything else. No new Puhti scratch quota will be granted.

Roihun käytön aloittaminen

Roihu ei ole vielä käytettävissä

Roihu ei ole vielä käytettävissä eikä sitä voi vielä lisätä palveluksi MyCSC:ssä.

Voit käyttää tätä ohjetta tutustuaksesi Roihuun siirtymiseen ja käytön aloittamiseen ennen kuin se tulee saataville kesäkuun 2026 lopussa.

Tässä oppaassa oletetaan, että CSC:n supertietokoneet, kuten Puhti, Mahti tai LUMI, ovat sinulle ennestään tuttuja.

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

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

Keskeiset erot verrattuna Puhtiin ja Mahtiin

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

  • SSH-todennus 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 laajennuksia ei siirretä automaattisesti aiemmista projekteista Puhdissa/Mahdissa

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 siihen palveluksi.

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

Roihun lisääminen palveluksi:

  1. Mene osoitteeseen my.csc.fi ja kirjaudu sisään esimerkiksi HAKA-tunnistautumisella
  2. Siirry kohtaan "Profile" ja tarkista oikeasta alakulmasta, että henkilöllisyyden varmuustasosi (LoA) on medium tai high
  3. Siirry kohtaan "Projects" ja avaa projektisi.
  4. Napsauta oikeanpuoleisella Services-välilehdellä vaihtoehtoa "+ Add services".
  5. Valitse Roihu, napsauta Next ja vahvista valinta.

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

Entä jos tarvitsen enemmän 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 projektille levykiintiön korotusta MyCSC:ssä.

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

Katso lisätietoja sekä suurimmat haettavat levykiintiö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:

  1. Mene osoitteeseen my.csc.fi ja kirjaudu sisään esimerkiksi HAKA-tunnistautumisella
  2. Siirry kohtaan "Profile" ja tarkista oikeasta alakulmasta, että henkilöllisyyden varmuustasosi (LoA) on medium tai high
  3. Siirry kohtaan "Projects" ja avaa projektisi.
  4. Avaa Roihu oikeanpuoleiselta Services-välilehdeltä
  5. 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-asiakasohjelma

Yhdistä SSH:n kautta näin:

  1. Ota SSH-avaimet käyttöön (samoin kuin Puhdissa/Mahdissa)
  2. Uutta: Allekirjoita julkinen avaimesi ja lataa varmenne

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:

  1. roihu-cpu.csc.fi
  2. 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ää.

  1. Mene osoitteeseen www.roihu.csc.fi.
  2. 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ä:

  1. Käyt aineistosi huolellisesti läpi – siirrä vain se, mitä todella tarvitset
  2. Tarkistat käytettävissä olevan levytilasi Roihussa (esimerkiksi komennolla csc-workspaces)
  3. 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:

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

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

C-, C++- tai Fortran-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.

Peruskontteja on saatavilla:

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

Rakennusmääritystiedosto:

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älimuistihakemistoksi $TMPDIR, 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

Rakennusmääritystiedosto:

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älimuistihakemistoksi $TMPDIR, 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-moduuli)
  • satama.csc.fi/r_installation_aida/vllm:0.19.1_cuda12.9_roihu - vLLM-kontti (sama kuin CSC-moduuli)

Rakennusmääritystiedosto:

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älimuistihakemistoksi $TMPDIR, 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 paketinhallintatyökalu, 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-paketinhallintatyökalua, 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 erityiskäyttötapauksiin.

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

Python/R-ympäristöt

Parhaat käytännöt 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:

  1. Luo työskripti, jossa
    • Määrittelet työsi resurssit (aika, muisti, ytimet)
    • Lataat tarvittavat moduulit
    • Käynnistät suoritettavan ohjelman
  2. Lähetä eräajotyösi jonotusjärjestelmään
  3. Odota työn valmistumista ja tarkista sen tuloste

Katso yksityiskohtaiset tiedot alla olevasta dokumentaatiosta:

  1. Saatavilla olevat eräajopartiot
  2. Eräajoskriptin luominen
  3. Esimerkkityöskriptit
  4. Lähetä eräajotyö
  5. Suorituskyvyn tarkistuslista

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

Lisätietoja

Suomenkielinen tekoälykäännös

Sisällössä voi esiintyä virheellistä tietoa tekoälykäännöksestä johtuen.

Klikkaa tästä antaaksesi palautetta

Ymmärrän.