JupyterHub er en platform hvor flere brukere kan kjøre Jupyter notebooks, og på UiO brukes JupyterHub i programmeringsundervisningen.

UiO JupyterHub er tilgjengelig på https://jupyterhub.uio.no.

Denne siden handler om JupyterHub-løsningen på UiO. For en introduksjon til Jupyter, se f.eks. Notebook basics.

Kom i gang med JupyterHub

1. Gå til https://jupyterhub.uio.no, og klikk på Sign in with Dataporten.

2. Velg Universitetet i Oslo som tilhørighet.

3. Logg inn med ditt vanlige brukernavn og passord ved UiO.

4. Etter at du har logget inn, kan du velge hvilken type notebook du vil starte. For de fleste kurs, trenger du: «UiO default image». Klikk på «Spawn», og deretter må du vente noen sekunder mens det startes en Jupyter-instans for deg.

5. Hvis det er første gang du logger inn, vil siden se slik ut. Åpne «Viktig informasjon.ipynb» og les gjennom. I den filen kan du også velge hvilke kurs du vil synkronisere materiell fra.

Velge emner for synkronisering

1. I «Viktig informasjon.ipynb» velger du først kommandoblokken under «Velg hvilke emner som skal synkroniseres» (1), deretter kjører du den, for eksempel med å trykke «Run» (2).

2. Kryss av for emnene du vil synkronisere, velg «Save» for å lagre (3), og deretter kan du trykke «Sync» (4) for å synkronisere på nytt. Vær oppmerksom på at filer normalt ikke overskrives.

Stoppe/starte server

Øverst til høyre på siden, ligger en meny som er spesiell for JupyterHub (avgrenset av det røde rektangelet i bildet under).

Hvis du trenger å restarte serveren din, kan du gå til kontrollpanelet og trykke på Stop My Server.

Når serveren er ferdig nedstengt, vil du kunne trykke på Start My Server for å starte en ny server.

Begrensninger

• Det er ikke mulig å gi andre brukere tilgang til dine filer.
• Du kan bruke maksimalt 1 GB minne, så vær forsiktig med å bruke veldig store array. Hvis du prøver å allokere mer enn 1 GB minne, vil det ta litt tid før det feiler, og Jupyter kan henge litt underveis. Merk at denne kvoten er delt mellom alle notebooks du har kjørende. Hvis du vil sjekke hvor mye minne du har brukt, kan du åpne htop i en terminal.

Kjente problemer og andre tips

• I enkelte nettlesere får man en feilmelding når man laster ned en notebook mens man er inne i den. Det er mulig filen lastes ned riktig likevel, men hvis man vil unngå feilmeldingen, kan man lukke notebooken, velge filen fra filtreet og så laste ned.
• Vi har fjernet «selfadmin»-nettstedet som enkelte kjenner fra forrige semester. Notebooks kan nå bli stoppet fra https://jupyterhub.uio.no/hub/home. Dersom du vil laste ned alt fra en notebook, kan du lage en arkivfil ved å kjøre !tar cvzf arkivfil.tgz * fra en notebook. Når kommandoen er fullført, kan du laste ned denne ene filen (og du kan gjerne slette den fra serveren etterpå, siden den tar stor plass).

Hjelp og feilmeldinger

• Ta kontakt med emnet ditt for generell hjelp når det gjelder bruk av Jupyter Notebook.
• For tekniske spørsmål eller feilmeldinger, send e-post til jupyterhub-core@usit.uio.no og lim inn hele nettadressen din. Ta gjerne skjermdump.