{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "1ac42493",
   "metadata": {},
   "source": [
    "# Oppstart\n",
    "\n",
    "Vi skal kjøre programmene via tjenesten [Educloud On Demand](https://www.uio.no/tjenester/it/forskning/beregning/open-on-demand/). Educloud On Demand er en del av Universitetet i Oslo sin databehandlingsplattform [Educloud Research](https://www.uio.no/tjenester/it/forskning/plattformer/edu-research/index.html/). Educloud On Demand kjører i nettleseren, og du behøver ikke å innstallere noen ekstra programmer."
   ]
  },
  {
   "cell_type": "markdown",
   "id": "5fb375e4",
   "metadata": {},
   "source": [
    "## Tilgang\n",
    "\n",
    "For å logge inn, må du søke medlemsskap i Educloud project ec443. Hvordan du gjør det, kommer an på om du allerede har en aktiv konto på Educloud.\n",
    "\n",
    "- Hvis du har en konto, kan du søke om medlemsskap i Educloud prosjektet ec443. Følg denne veiledningen: [Søk om tilgang til et eksisterende Educloud Research-prosjekt](https://www.uio.no/tjenester/it/forskning/plattformer/edu-research/hjelp/sok-medlemskap-prosjekt.html).  \n",
    "- Hvis du ikke har en konto, må du lage en. Utfør punkt 1b, 2 and 3 i denne veiledningen: [Førstegangsoppsett av Educloud Research](https://www.uio.no/tjenester/it/forskning/plattformer/edu-research/hjelp/kom-i-gang-med-educloud.html). I punkt 1b fører du opp prosjekt ec443.  "
   ]
  },
  {
   "cell_type": "markdown",
   "id": "afdbe425",
   "metadata": {},
   "source": [
    "## Innlogging\n",
    "\n",
    "Logg inn i [Educloud On Demand](https://ondemand.educloud.no) med ditt Educloud brukernavn og passord.\n",
    "\n",
    "\n",
    "```{note}\n",
    "Ditt brukernavn i Educloud er forskjellig fra det vanlige UiO brukernavnet. Educloud brukernavn starter alltid med de tre tegnene “ec-“. Educloud har også en egen to-faktor autentisering (2FA).\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "523f9d52",
   "metadata": {},
   "source": [
    "## Oppstart med JupyterLab\n",
    "\n",
    "Etter du har logget inn, kan du se [Educlouds instrumentpanel](https://ondemand.educloud.no/pun/sys/dashboard). Klikk på [JupyterLab](https://ondemand.educloud.no/pun/sys/dashboard/batch_connect/sys/fox-ood-jupyter/session_contexts/new), for å konfigurere sesjonen.\n",
    "\n",
    "- I feltet “Choose the Educloud project to run under:”, velger du ec443.  \n",
    "\n",
    "- I feltet “Choose resources:”, kan du velge “GPU (1x Nvidia MIG 20G VRAM, 24 CPU cores, 100GB RAM)”.\n",
    "\n",
    "- evt “GPU (1x Nvidia RTX3090 24GB, 24 CPU cores, 64GB RAM)”\n",
    "  \n",
    "- I feltet “Runtime (in hours)” kan du velge 1t av gangen. Prøv å unngå å reservere en GPU lenger enn nødvendig, fordi GPUer er begrensede, delte ressurser. Det er også en fordel etterhvert som du lærer deg prosessen i dette kurset, å gå over på SLURM, slik vi legger til rette for i noen av de avanserte oppgavene.\n",
    "\n",
    "- I feltet “Choose Jupyter module (required)” bør du velge “4.2.5-GCCcore-13.3.0”.\n",
    "\n",
    "\n",
    "\n",
    "De andre feltene skal ikke fylles ut. Oppsettet ditt skal se ut som bildet under.\n",
    "\n",
    "![ml_node_users.png](../ml_node_users.png)\n",
    "\n",
    "Start JupyterLab ved å klikke på den blå “Launch” knappen nederst i skjemaet. Dette lager en jobb som blir sendt til køen. Når de påkrevde ressursene er tilgjengelige, starter jobben din opp.\n",
    "\n",
    "Når jobben har startet, klikk på “Connect to Jupyter” for å åpne JupyterLab.\n",
    "\n",
    "\n",
    "```{admonition} Valgfri OCR Støtte\n",
    ":class: dropdown\n",
    "\n",
    "Som en valgfri løsning, er det mulig å legge til støtte for optisk tegngjenkjenning (OCR). OCR lar deg konvertere bilder til tekst. Last modulen ``tesseract/3.5.4.GCCore-12.3.0`` ved å den legge til i feltet \"additional modules\". For at modulen skal passe inn, må du også endre feltet “Choose Jupyter module (required)” til “4.0.5-GCCcore-12.3.0”, slik at versjonene stemmer overens.\n",
    "\n",
    "![jupyter_lab_tesseract.png](../jupyter_lab_tesseract.png)\n",
    "```\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "1f439b3e",
   "metadata": {},
   "source": [
    "## Oppgaver"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "8bc56e2d",
   "metadata": {},
   "source": [
    "\n",
    "```{admonition} Oppgave 2.1: Dokumentmappe\n",
    "Du trenger en mappe til å lagre dokumentene dine på Educloud. Når du åpner JupyterLab, vil du få filmenyen til venstre. Den peker til ditt hjemmeområde/ home directory som du finner igjen på Educloud. Her kan du lagre filene dine. \n",
    "\n",
    "Hvis du ikke allerede har en mappe som kalles “documents”, lag en. For å lage en ny mappe, klikk den grå , “New Folder” knappen i toppmenyen. Nå dukker det en ny mappe opp på listen, med forslag til navn “Untitled Folder”. Skriv “documents” istedenfor “Untitled Folder” og trykk enter på tastaturet for å lagre.\n",
    "```\n",
    "\n",
    "```{admonition} Oppgave 2.2: Laste opp filer til Fox\n",
    "Du kan laste opp dokumenter som du ønsker å jobbe med på Fox. Prøv å unngå dokumenter som inneholder sensitive data. Vi anbefaler å teste med offentlig tilgjengelige dokumenter som kun inneholder [grønne data](https://www.uio.no/tjenester/it/sikkerhet/lsis/tillegg/lagring/infoklasser.html).\n",
    "\n",
    "Velg folderen “documents” som du etablerte på ditt hjemmeområde i forrige oppgave. Velg den blå opplastingsknappen fra toppmenyen. Deretter velger du “browse files” og laster opp det du skal ha. Til slutt velger du den grønne “Upload x files” knappen i nedre venstre hjørne.\n",
    "```"
   ]
  }
 ],
 "metadata": {
  "date": 1772447236.782034,
  "language_info": {
   "name": "python"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}