Hyppää sisältöön

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

Warning!

Puhti and Mahti are being decommissioned in stages, and their storage areas will become fully unavailable from 15 October 2026. Clean up unnecessary files and move any data you need to keep by 31 August 2026. See the Roihu data migration guide for instructions on transferring your data to Roihu.

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

Kurssin järjestäminen CSC:n resursseilla

CSC:n palveluita voidaan käyttää opetustarkoituksiin maksuttoman käytön ehtojemme mukaisesti.

Opetuskäyttöä varten on oma projektikategoriansa – CSC Course -projekti. CSC Course -projektin enimmäiskesto kaikkine käyttöön otettuine palveluineen on kuusi kuukautta. Olemassa olevaa CSC Course -projektia ei voi jatkaa eikä siirtää.

Tässä oppaassa kuvataan palvelukohtaiset yksityiskohdat siitä, miten kursseja järjestetään CSC Course -projektityypin piiriin kuuluvilla palveluilla:

Myös Noppe-palvelu, jonka käyttö ei edellytä CSC-projektia, käsitellään tässä.

Jos et ole varma, mitkä palvelut sopisivat kurssillesi, katso alla oleva taulukko.

Mitkä palvelut sopivat kurssilleni?

Kurssini tarvitsee ... Allas cPouta Noppe Puhti & Mahti Pukki Rahti SD-palvelut
Laskentaresursseja
Paljon laskentaresursseja
GPU-laskentaresursseja
Tiedostotallennusresursseja
Objektitallennusresursseja
Tietokannan
Pääsyn esiasennettuihin (tieteellisiin) ohjelmistoihin
Sensitiivisen datan käsittelyyn tai säilytykseen
Monikäyttöisen palvelun joustaviin kurssitoteutuksiin
Haka-kirjautumisen opiskelijoille (CSC-käyttäjätunnusta ei tarvita)

Palvelukohtaiset ohjeet

Info

Huomaa, että data on saatavilla vain CSC Course -projektin keston ajan.

Allas on Ceph-pohjainen objektitallennusjärjestelmä. Se on suunniteltu suurten datamäärien tallentamiseen ja jakamiseen. Dataan voidaan päästä käsiksi muista CSC:n palveluista, kuten cPoudasta, Puhdista ja Mahdista, tai suoraan Allaksen selainkäyttöliittymän kautta.

Dataan voidaan päästä käsiksi työkaluilla ja ohjelmointikielillä, jotka perustuvat S3- tai Swift-rajapintoihin.

Allasta voidaan käyttää myös kurssimateriaalien jakamiseen. Jos materiaalit ovat julkisia, opiskelijat eivät tarvitse CSC-käyttäjätunnuksia.

Ohjeet

Opettaja

  1. Luo CSC-käyttäjätunnus.
  2. Luo CSC Course -projekti.
  3. Lisää Allas-palvelun käyttöoikeus projektiin.
  4. Jos sinun täytyy rajata pääsy dataan vain opiskelijoille, kutsu heidät projektiin:
    1. kutsulinkin avulla (suositeltu)
    2. tai suoraan.
  5. Valmistele kurssisisältö.
    1. Tutustu dokumentaatioon.
    2. Ota yhteyttä CSC:n asiakastukeen, jos tarvitset tukea.

Opiskelija

Jos kurssiin liittyvä data ei ole julkisesti saatavilla, vaan se on jaettu vain kurssiprojektin jäsenille:

  1. Luo CSC-käyttäjätunnus.
  2. Liity kurssiprojektiin:
    1. Jos sinulle on lähetetty projektin kutsulinkki, hyväksy kutsu MyCSC:ssä.
    2. Jos sinut on lisätty suoraan kurssiprojektiin, muita toimenpiteitä ei tarvita kurssiprojektiin liittymiseksi.
  3. Hyväksy asiaankuuluvat palveluehdot MyCSC:ssä.

Info

Huomaa, että resurssit ovat saatavilla vain CSC Course -projektin keston ajan. Jos lisäksi jokaisen opiskelijan täytyy hallita omaa virtuaali-infrastruktuuriaan, heidän tulee luoda CSC Student -projekti ja aktivoida cPouta-palvelu siinä projektissa.

cPouta on OpenStack-teknologiaan perustuva Infrastructure-as-a-Service (IaaS) -alusta. Se soveltuu erinomaisesti käyttötapauksiin, joissa tarvitaan internetistä saavutettava Linux-palvelin.

Saatavilla on erilaisia virtuaalikonevaihtoehtoja pienistä koneista I/O-intensiivisiin tai GPU-varustettuihin koneisiin. Näihin virtuaalikoneisiin voidaan muodostaa yhteys internetistä julkisen IPv4-osoitteen kautta. Jos kurssisi vaatii merkittäviä laskentaresursseja, suosittelemme sen sijaan HPC-alustoja Puhti ja Mahti.

OpenStack-alustaa voidaan hallita joko selainkäyttöliittymän kautta tai komentorivityökaluilla.

Ohjeet

Opettaja

  1. Luo CSC-käyttäjätunnus.
  2. Luo CSC Course -projekti.
  3. Lisää cPouta-palvelun käyttöoikeus projektiin.
  4. Kurssisi luonteen perusteella:
    1. Jos käytössä on jaettu infrastruktuuri, jossa on vain muutama kone, käytä Linuxin omia työkaluja opiskelijatilejen luomiseen. Katso ohje tästä.
    2. Jos jokainen opiskelija tarvitsee oman virtuaali-infrastruktuurin, pyydä heitä luomaan student project.
    3. Jos opiskelijoiden täytyy muokata jaettua infrastruktuuria, kutsu heidät projektiin:
      1. kutsulinkin avulla (suositeltu)
      2. tai suoraan.
  5. Valmistele kurssisisältö.
    1. Tutustu dokumentaatioon.
    2. Ota yhteyttä CSC:n asiakastukeen, jos tarvitset tukea.

Riittävä kiintiö

Jos päädyt käyttämään jaettua cPouta-virtuaali-infrastruktuuria suuren opiskelijamäärän kanssa, varmista, että projektin kiintiö on riittävä. Jos ei ole, joko pyydä kiintiön kasvattamista tai pyydä opiskelijoita luomaan omat CSC Student -projektinsa.

Opiskelija

  1. Jaetun virtuaali-infrastruktuurin tapauksessa:
    1. Muodosta siihen yhteys ohjeiden mukaisesti.
  2. Jos tarvitaan pääsy opettajan CSC Course -projektin OpenStackin hallintatasoon:
    1. Luo CSC-käyttäjätunnus.
    2. Liity kurssiprojektiin:
      1. Jos sinulle on lähetetty projektin kutsulinkki, hyväksy kutsu MyCSC:ssä.
      2. Jos sinut on lisätty suoraan kurssiprojektiin, muita toimenpiteitä ei tarvita kurssiprojektiin liittymiseksi.
    3. Hyväksy asiaankuuluvat palveluehdot MyCSC:ssä.
  3. Jos jokainen opiskelija ottaa käyttöön oman cPouta-virtuaali-infrastruktuurinsa:
    1. Luo CSC-käyttäjätunnus ja student project näiden ohjeiden mukaisesti.
    2. Lisää cPouta-palvelu student projectiin.

Noppe-palvelu on pilvialusta, joka tarjoaa käyttäjille helpon pääsyn selainsovelluksiin, kuten JupyterLabiin, RStudioon ja VS Code Serveriin. Sovellukset tarjoavat yhtenäiset, asennusvapaat ympäristöt, jotka on räätälöity erityisesti opetuskäyttöön.

Info

Huomaa, että opiskelijat eivät tarvitse CSC-käyttäjätunnusta tai projektia Noppe-palvelun käyttämiseen. Opettaja tarvitsee kuitenkin CSC-käyttäjätunnuksen. Opiskelijat voivat kirjautua sisään useilla tavoilla, mukaan lukien Haka ja Virtu.

Ohjeet

Opettajat voivat luoda työtiloja ja käyttää omia opetusmateriaalejaan. Opiskelijat voivat sitten joko liittyä näihin työtiloihin tai käyttää itseopiskeluun tarkoitettuja selainsovelluksia.

Opettaja

Katso opettajien opas tarkempia ohjeita varten.

Opiskelija

Katso opiskelijan opas tarkempia ohjeita varten.

Info

Puhti ja Mahti poistuvat käytöstä vuonna 2026, ja ne korvataan Roihulla, CSC:n seuraavan sukupolven supertietokoneella, joka tarjoaa paremman suorituskyvyn ja laajemmat ominaisuudet. Ota tämä huomioon, kun suunnittelet kursseja vuodelle 2026.

Lue lisää Roihusta

CSC:n supertietokoneet Mahti ja Puhti soveltuvat erinomaisesti sellaisten kurssien järjestämiseen, jotka hyötyvät HPC-resursseista tai joiden tavoitteena on opettaa laskentaa ja laskentatehtävien ajamista supertietokonealustoilla. Tämä koskee tilanteita, joissa kurssin osallistujat tarvitsevat pääsyn GPU-resursseihin tai suurempiin CPU-resursseihin, sekä tilanteita, joissa kurssitehtävissä käytetään olemassa olevaa ohjelmistovalikoimaa.

Järjestelmät tukevat sekä perinteisiä komentorivipohjaisia eräajolaskentatehtäviä että selainpohjaisia työkaluja, kuten Jupyter Notebookeja ja RStudioa, selainkäyttöliittymien kautta. Kurssin järjestäjät voivat jopa luoda kurssilleen räätälöityjä Jupyter Notebook -ympäristöjä Jupyter for Courses -sovelluksella.

Huomaa, että CSC:n supertietokoneita käyttävillä kursseilla voi olla enintään 50 opiskelijaa. Ihannetapauksessa opettajien tulisi tähdätä pienempään, noin 25 osallistujan ryhmään. Suuremmilla kursseilla maksuttomat resurssit ja sallitut resurssivaraukset eivät välttämättä riitä pyydetylle käyttäjämäärälle.

On myös suositeltavaa pyytää kursseille ennakkovaraus resursseille, jotta resurssien saatavuus voidaan taata. Lue lisää alta.

Warning

Huomaa, että jokaisen kuukauden ensimmäinen tiistai ja keskiviikko on varattu säännöllisille huoltokatkoille. Palveluiden saatavuuteen ei tule koskaan luottaa näinä päivinä.

Ohjeet

Opettaja

  1. Luo CSC-käyttäjätunnus.
  2. Luo CSC Course -projekti.
  3. Lisää Puhti- ja/tai Mahti-palvelun käyttöoikeus projektiin.
  4. Kutsu opiskelijat projektiin joko
    1. kutsulinkin avulla (suositeltu)
    2. tai suoraan.
  5. Pyydä ennakkovaraus resursseille.
  6. Valmistele kurssisisältö.
    1. Tutustu dokumentaatioon.
    2. Ota yhteyttä CSC:n asiakastukeen, jos tarvitset tukea.

Opiskelija

  1. Luo CSC-käyttäjätunnus.
  2. Liity kurssiprojektiin:
    1. Jos sinulle on lähetetty projektin kutsulinkki, hyväksy kutsu MyCSC:ssä.
    2. Jos sinut on lisätty suoraan kurssiprojektiin, muita toimenpiteitä ei tarvita kurssiprojektiin liittymiseksi.
  3. Hyväksy asiaankuuluvat palveluehdot MyCSC:ssä.

Resurssien ennakkovaraus

Kurssiprojekteihin sovelletaan samoja Slurm-jonotuksen prioriteettiehtoja kuin tavallisiin laskentaprojekteihin, mikä tarkoittaa, että kurssin osallistujat voivat joutua jonottamaan resursseja, jos järjestelmä on kovassa käytössä. Jotta resurssien saatavuus kurssikerran/-kertojen aikana voidaan varmistaa, suosittelemme pyytämään resurssien ennakkovarausta.

Huomaa:

  • Resurssivaraus on pyydettävä vähintään 14 päivää ennen kurssin alkua CSC:n asiakastuen kautta.
  • Pyyntö tulee perustella, ja sen tulee sisältää
    1. kurssiprojektin numero,
    2. osallistujien määrä,
    3. kurssille suunnitellut resurssit,
    4. aikataulu, josta käy ilmi kurssin ajankohta.
  • Varattavien resurssien enimmäismäärä ja tyyppi on kuvattu alla olevassa taulukossa.

    Järjestelmä Hyväksyntä CPU-raja GPU-raja Päivittäisen aikaikkunan enimmäispituus Kurssipäivien enimmäismäärä yhteensä
    Puhti Automaattinen 2 solmua (80 ydintä) 0 08:00–17:00 5
    CSC:n resurssienjakoryhmä 5 solmua (200 ydintä) 4 solmua (16 GPU:ta) Enintään 12 h (esim. 08:00–20:00 tai 12:00–24:00) 10
    Mahti Automaattinen 2 solmua (256 ydintä) 14 GPU-siivua 08:00–17:00 5
    CSC:n resurssienjakoryhmä 8 solmua (1024 ydintä) 56 GPU-siivua Enintään 12 h (esim. 08:00–20:00 tai 12:00–24:00) 10

Myönnetty resurssien ennakkovaraus näkyy Puhtin ja Mahdin selainkäyttöliittymissä interaktiivisen istunnon käynnistyslomakkeessa. Huomaa, että vaihtoehto näkyy harmaana ennen varauksen alkamista.

Eräajotyöskripteissä resurssien ennakkovaraus aktivoidaan seuraavalla Slurm-direktiivillä:

#SBATCH --reservation=<reservation name>

Huomaa, että projektin numeron ja osion on vastattava sitä, mitä resurssien ennakkovarausta varten on määritetty.

Pukki on Database-as-a-service-palvelu (DBaaS), jossa voit käynnistää tietokannan "yhdellä napsautuksella". Pukki automatisoi muiden palveluiden tietokantojen ylläpito- ja hallintatehtävät pois, jotta opettaja voi keskittyä tietokantojen varsinaisen aiheen käyttämiseen tai opettamiseen.

Sen sijaan, että perustaisit itse oman tietokannan, jota sinun täytyy ylläpitää, voit käyttää DBaaS-palvelua huolehtimaan työläistä provisioinnista, konfiguroinnista, ylläpidosta, päivityksistä, dokumentoinnista ja varmuuskopioinnista.

Ohjeet

Info

Jos jokainen opiskelija tarvitsee oman Pukki DBaaS -instanssin, hänen tulee luoda CSC Student -projekti ja aktivoida Pukki-palvelu siinä projektissa.

Opettaja

  1. Luo CSC-käyttäjätunnus.
  2. Luo CSC Course -projekti.
  3. Lisää Pukki-palvelun käyttöoikeus projektiin.
  4. Kurssisi luonteen perusteella:
    1. Jos tarvitaan vain yksi tietokanta, käytä sen työkaluja opiskelijatilien luomiseen.
      1. Ohjeet PostgreSQL:lle.
      2. Ohjeet MariaDB:lle.
    2. Jos jokainen opiskelija tarvitsee oman tietokannan, pyydä heitä luomaan student project.
  5. Valmistele kurssisisältö.
    1. Tutustu dokumentaatioon.
    2. Ota yhteyttä CSC:n asiakastukeen, jos tarvitset tukea.

Opiskelija

  1. Jos käytetään jaettua tietokantaa, käytä sitä asianmukaisten ohjeiden mukaisesti:
    1. Ohjeet PostgreSQL:lle.
    2. Ohjeet MariaDB:lle.
  2. Jos jokainen opiskelija tarvitsee oman tietokannan:
    1. Luo CSC-käyttäjätunnus ja student project näiden ohjeiden mukaisesti.
    2. Lisää Pukki-palvelu student projectiin.

Rahti on OKD:llä toimiva konttien orkestrointipalvelu. Opettajat voivat käynnistää kurssilla käytettäviä palveluita, tai Rahti voi olla osa itse kurssia. Palvelu on hyödyllinen esimerkiksi CI/CD-putkien opettamiseen.

Kuten cPouta, myös Rahti tarjoaa samankaltaista monikäyttöistä teknologiaa, mutta ilman sitä rasitetta, että käyttöjärjestelmää täytyisi ylläpitää itse. Erilaisia valmiita mallipohjia voidaan käyttää yhdellä napsautuksella, mikä säästää sinut palveluiden asentamisen vaivalta kuten cPoudassa.

Ohjeet

Info

Jos opiskelijoilla ei tule olla pääsyä toistensa Rahti-ympäristöihin, heidän tulee käyttää CSC Student -projektia sen sijaan.

Opettaja

  1. Luo CSC-käyttäjätunnus.
  2. Luo CSC Course -projekti.
  3. Lisää Rahti-palvelun käyttöoikeus projektiin.
  4. Kurssisi luonteen perusteella:
    1. Jos jokainen opiskelija tarvitsee eristetyn Rahti-nimiavaruusympäristön, pyydä heitä luomaan student project.
    2. Jos opiskelijoiden ympäristöjen jakaminen ja toistensa ympäristöjen näkeminen ei ole ongelma, kutsu opiskelijat kurssiprojektiin joko:
      1. kutsulinkin avulla (suositeltu)
      2. tai suoraan.
  5. Valmistele kurssisisältö.
    1. Tutustu dokumentaatioon.
    2. Ota yhteyttä CSC:n asiakastukeen, jos tarvitset tukea.

Opiskelija

  1. Jos jokainen opiskelija tarvitsee eristetyn Rahti-nimiavaruusympäristön:
    1. Luo CSC-käyttäjätunnus ja student project näiden ohjeiden mukaisesti.
    2. Lisää Rahti-palvelu student projectiin.
  2. Jos tarvitaan pääsy opettajan perustamaan jaettuun konttiympäristöön:
    1. Luo CSC-käyttäjätunnus.
    2. Liity kurssiprojektiin:
      1. Jos sinulle on lähetetty projektin kutsulinkki, hyväksy kutsu MyCSC:ssä.
      2. Jos sinut on lisätty suoraan kurssiprojektiin, muita toimenpiteitä ei tarvita kurssiprojektiin liittymiseksi.
    3. Hyväksy asiaankuuluvat palveluehdot MyCSC:ssä.

Sensitiivisen datan SD Desktop mahdollistaa sensitiivisen tutkimusdatan turvallisen analysoinnin verkkoselaimessa. Tällä käyttöliittymällä voit helposti hallita virtuaalitietokonetta (tässä nimeltään desktop, teknisesti määriteltynä virtuaalikone). SD Desktop on suunniteltu sensitiivisen datan hallintaan kaikilta tutkimusaloilta ja monenlaisiin tarkoituksiin.

SD Connect on yksinkertainen käyttöliittymä sensitiivisen datan tallentamiseen ja jakamiseen. SD Connectissa oleva data voidaan analysoida SD Desktopissa.

Ohjeet

Opettaja

  1. Luo CSC-käyttäjätunnus.
  2. Luo CSC Course -projekti.
  3. Lisää SD Desktop- ja/tai SD Connect -palvelun käyttöoikeus projektiin.
  4. Kutsu opiskelijat projektiin joko
    1. kutsulinkin avulla (suositeltu)
    2. tai suoraan.
  5. Valmistele kurssisisältö.
    1. Tutustu dokumentaatioon.
    2. Ota yhteyttä CSC:n asiakastukeen, jos tarvitset tukea.

Opiskelija

  1. Luo CSC-käyttäjätunnus.
  2. Liity kurssiprojektiin:
    1. Jos sinulle on lähetetty projektin kutsulinkki, hyväksy kutsu MyCSC:ssä.
    2. Jos sinut on lisätty suoraan kurssiprojektiin, muita toimenpiteitä ei tarvita kurssiprojektiin liittymiseksi.
  3. Hyväksy asiaankuuluvat palveluehdot MyCSC:ssä.

Suomenkielinen tekoälykäännös

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

Klikkaa tästä antaaksesi palautetta