Yhdistäminen CSC:n supertietokoneisiin

SSH keys are required to connect to Puhti and Mahti over SSH

Since April 14th 2025, connecting to Puhti and Mahti over SSH only works using SSH keys added in MyCSC. Password authentication and public keys stored in users' personal ~/.ssh/authorized_keys file on the supercomputer no longer works.

Read the detailed instructions on setting up and using SSH keys.

CSC:n supertietokoneisiin voi yhdistää kahdella pääasiallisella tavalla.

Perinteinen tapa yhdistää supertietokoneeseen on käyttämällä SSH-asiakasohjelmaa.
Tarjoamme järjestelmiimme myös selainkäyttöliittymän, jonka avulla voi käyttää sekä graafisia sovelluksia että komentorivikuoria.

Ohjeet LUMI-supertietokoneeseen yhdistämiseen löytyvät LUMIn käyttöoppaan Get Started -sivulta.

Kirjautumissolmujen käyttöehdot

Kun yhdistät supertietokoneeseen SSH-asiakasohjelmalla tai Login node shell -sovelluksella, sinut ohjataan kirjautumissolmulle. Kirjautumissolmuja ei ole tarkoitettu pitkäkestoiseen tai raskaaseen laskentaan. Kirjautumissolmujen sallitut käyttötavat on määritelty kirjautumissolmujen käyttöehdoissa.

Selainkäyttöliittymän käyttäminen

Selainkäyttöliittymä on hyvä alusta graafisten sovellusten käyttöön Puhdin ja Mahdin supertietokoneilla. Se tarjoaa interaktiivisia sovelluksia valituille ohjelmille, kuten Jupyterille ja RStudiolle, ja muiden GUI-ohjelmien käyttöön voit käyttää etätyöpöytä-käyttöliittymää.

On myös mahdollista avata komentotulkki kirjautumissolmulla tai laskentasolmulla. Laskentasolmun komentotulkki on pysyvä, mikä tarkoittaa, että se jatkaa toimintaansa, vaikka sulkisit selaimen tai internetyhteytesi katkeaisi. Komentotulkkisovellukset ovat erityisen käteviä käyttäjille, joiden työasemassa on Windows-käyttöjärjestelmä, sillä Windowsissa ei yleensä ole valmiiksi asennettua SSH-asiakasohjelmaa. Katso ohjeet Puhdin ja Mahdin selainkäyttöliittymiin yhdistämiseen.

SSH-asiakasohjelman käyttäminen

Puhtiin ja Mahtiin kirjautuminen SSH-asiakasohjelmalla edellyttää, että olet määrittänyt SSH-avaimet ja lisännyt julkisen avaimesi MyCSC:hen. Perinteinen salasanaan perustuva tunnistautuminen ja henkilökohtaiseen ~/.ssh/authorized_keys-tiedostoosi tallennetut julkiset avaimet eivät toimi.

Unix-pohjaisissa järjestelmissä, kuten macOS:ssä ja Linuxissa, on yleensä valmiiksi asennettuna pääteohjelma nimeltä Terminal. Ohjeissa SSH-asiakasohjelman käyttämisestä macOS:ssä ja Linuxissa näytetään, miten CSC:n supertietokoneeseen yhdistetään pääteohjelman avulla.

Vaikka Windows-järjestelmissä ei ole vastaavaa valmiiksi olemassa olevaa ratkaisua SSH-yhteyden muodostamiseen, tähän on käytettävissä useita ohjelmia. Ohjeissa SSH-asiakasohjelman käyttämisestä Windowsissa esitellään muutamia suosittuja vaihtoehtoja.

Kun olet määrittänyt SSH-avaimet ja lisännyt julkisen avaimesi MyCSC:hen, käytä alla olevan kaltaista komentoa SSH-yhteyden muodostamiseen:

# Replace <username> with the name of your CSC user account and
# <host> with "puhti" or "mahti"

ssh <username>@<host>.csc.fi

Note

Voi kestää jopa tunnin, ennen kuin uusi avaimesi aktivoituu sen jälkeen, kun olet lisännyt sen MyCSC:hen.

Kun SSH-yhteys supertietokoneeseen on avattu, voit käyttää sitä suorittamalla Linux-komentoja Bash-komentotulkin avulla. Johdanto Linuxin komentorivillä työskentelyyn löytyy CSC:n Linux-perusteet-oppaasta. Voit pitää useita yhteyksiä CSC:n supertietokoneisiin auki samanaikaisesti.

Ensimmäinen yhteys

Kun yhdistät tiettyyn supertietokoneeseen ensimmäistä kertaa, SSH-asiakasohjelma saattaa ilmoittaa, että palvelin on tuntematon, ja pyytää vahvistamaan yhteyden. OpenSSH-asiakasohjelmalla viesti näyttää tältä:

The authenticity of host 'puhti.csc.fi' can't be established.
ECDSA key fingerprint is SHA256:kk0Tar9opQ+6Gq0GWJdWVVvFEMeI6kW1DW1VOYveT5c.
Are you sure you want to continue connecting (yes/no/[fingerprint])?

Jotta voit jatkaa, varmista, että näytetty avaimen sormenjälki löytyy alla olevasta taulukosta, ja kirjoita sitten yes. Sinulta ei kysytä tätä uudelleen, ellei palvelimen avain muutu. Tällöin sinun tulee jälleen tarkistaa uusi avain CSC:n tarjoamia sormenjälkiä vasten.

Palvelinavainten sormenjäljet

PuhtiMahti

SHA256 checksum	Key
kk0Tar9opQ+6Gq0GWJdWVVvFEMeI6kW1DW1VOYveT5c	ssh_host_ecdsa_key.pub (ECDSA)
Q2lpykI43ffs4PrRODZ/qncjUo3eyrRHc5T9yjJEwWY	ssh_host_ed25519_key.pub (ED25519)
WH1Ag2OQtMPZb+hj3YeH9uVMMetXpCvyNUbsdk0Qcpk	ssh_host_rsa_key.pub (RSA)

SHA256 checksum	Key
WC9Lb5tmKDzUJqsQjaZLvp9T7LTs3aMUYSIy2OCdtgg	ssh_host_ecdsa_key.pub (ECDSA)
tE+1jA4Et1enbbat1V3dMRWlLtJgA8t7ZrkyIkU4ooo	ssh_host_ed25519_key.pub (ED25519)
0CxM3ECpD2LhAnMfHnm3YaXresvHrhW4cevvcPb+HNw	ssh_host_rsa_key.pub (RSA)

Graafinen yhteys

Suosittelemme selainkäyttöliittymien käyttöä graafisilla käyttöliittymillä varustettujen sovellusten ajamiseen. Vaihtoehtoisesti grafiikkaa voidaan näyttää myös SSH-yhteyden yli X11-välityksen avulla. Katso käyttöjärjestelmäkohtaiset ohjeet:

Edistynyt käyttö

Yhdistäminen tiettyyn solmuun

Kun yhdistät supertietokoneeseen, sinut ohjataan automaattisesti johonkin järjestelmän kirjautumissolmuista. Voit kuitenkin käyttää SSH-asiakasohjelmaasi myös yhdistääksesi tiettyyn kirjautumissolmuun:

ssh <username>@<host>-login<id>.csc.fi  # e.g. 'puhti-login11.csc.fi'

Käytettävissä olevat kirjautumissolmut ovat:

Puhti	Mahti
`puhti-login11`	`mahti-login11`
`puhti-login12`	`mahti-login12`
`puhti-login14`	`mahti-login14`
`puhti-login15`	`mahti-login15`

Sama koskee myös laskentasolmuja, mutta vain niitä, joilla sinulla on käynnissä oleva työ. Käytä squeue-komentoa nähdäksesi, millä solmulla tai solmuilla työsi on, ja yhdistä sitten solmuun komennolla ssh.

# The nodes hosting the job are
# displayed in the "NODELIST(REASON)" column.

[username@puhti-login11 ~]$ squeue --me
             JOBID PARTITION     NAME     USER ST       TIME  NODES NODELIST(REASON)
          12345678      test     test username  R       0:01      1 r07c01
[username@puhti-login11 ~]$ ssh r07c01
[username@r07c01 ~]$ hostname
r07c01.bullx

Jos yrität yhdistää solmuun, jolla sinulla ei ole aktiivisia töitä, saat seuraavan virheilmoituksen: Access denied by pam_slurm_adopt: you have no active jobs on this node.

SSH-asiakasohjelman määrittäminen

Voit säästää aikaa lisäämällä CSC:n supertietokoneille palvelinkohtaisia asetuksia SSH-asetustiedostoon (esim. ~/.ssh/config).

Host <host>  # e.g. "puhti"
    HostName <host>.csc.fi
    User <csc-username>

Nyt voit yhdistää palvelimeen yksinkertaisesti suorittamalla:

ssh <host>

Etäkehitys

Joitakin editoreja, kuten Visual Studio Codea ja Notepad++:aa, voidaan käyttää tiedostojen etämuokkaukseen sopivan lisäosan avulla. Tätä ei kuitenkaan suositella.