bibliotheks-und-archivinformatik/notes_virtualbox-appliance-erstellen.md

VirtualBox Appliance erstellen

Den Studierenden wird eine vorkonfigurierte Arbeitsumgebung mit JupyterLab in Form einer VirtualBox Appliance (.ova) bereitgestellt. Hier wird dokumentiert, wie diese Appliance hergestellt wird:

1. Neue Virtuelle Maschine erstellen

   • Name: lubuntu-bain
   • Type: Linux / Ubuntu (64-bit)
   • Memory: 2048 MB
   • Hard Disk: VDI, dynamically allocated, 20 GB

2. VM settings

   • General > Advanced > Shared Clipboard: Bidirectional
   • General > Advanced > Shared Clipboard: user: bain, pass: bain2019
   • System > Processor: 2 CPUs, Enable PAE/NX

3. Installation Lubuntu 18.04

   1. Download der ISO-Datei: http://cdimage.ubuntu.com/lubuntu/releases/18.04.2/release/lubuntu-18.04.3-desktop-amd64.iso
   2. VM starten und heruntergeladene ISO-Datei auswählen
   3. Standardinstallation mit folgenden Parametern:
      • Language: Deutsch
      • Minimale installation
      • Ort: Berlin
      • Name: bain
      • Passwort: bain2019
      • Automatisch anmelden aktivieren

4. Installation Gasterweiterungen

   1. Abhängigkeiten installieren

      sudo apt update && \
      sudo apt install build-essential dkms linux-headers-$(uname -r)
      

   2. VirtualBox Fenstermenü > Devices > Insert Guest Addtions CD image... abbrechen und eingeben:

      sudo /media/$USER/VBox*/VBoxLinuxAdditions.run
      

   3. Nutzer der Gruppe vboxsf hinzufügen (für shared folder)

      sudo adduser $USER vboxsf
      

   4. CD auswerfen im Dateimanager und neustarten

5. Sudo ohne Passwort erlauben

   sudo echo "$USER ALL=(ALL) NOPASSWD: ALL" | sudo tee --append /etc/sudoers
   

6. Updates installieren und neustarten

   sudo apt update && \
   sudo apt upgrade && \
   sudo shutdown -r now
   

7. Installation JupyterLab via pip mit jupyter-server-proxy und bash_kernel

   sudo apt install python3-pip python3-dev && \
   sudo -H pip3 install --upgrade pip && \
   sudo -H pip3 install jupyter && \
   sudo -H pip3 install jupyterlab && \
   sudo -H pip3 install jupyter-server-proxy && \
   sudo -H pip3 install bash_kernel && \
   sudo -H python3 -m bash_kernel.install
   

8. Jupyter einmal manuell starten für den Cookie im Browser

   jupyter notebook
   

9. JupyterLab als Systemd Service einrichten

   echo "[Unit]
   Description=JupyterLab
   [Service]
   User=$USER
   ExecStart=/usr/local/bin/jupyter-lab
   ExecStop=/usr/local/bin/jupyter-notebook stop
   WorkingDirectory=/
   Restart=always
   [Install]
   WantedBy=default.target" | sudo tee /etc/systemd/system/jupyter.service
   sudo systemctl enable jupyter.service
   sudo systemctl start jupyter.service
   

10. GitHub Repo clonen

    sudo apt install git && \
    git clone https://github.com/felixlohmeier/bibliotheks-und-archivinformatik.git
    

11. Desktop-Links

    1. Jupyter Notebook

       echo "[Desktop Entry]
       Encoding=UTF-8
       Name=JupyterLab
       Type=Link
       URL=http://localhost:8888/lab/tree/home/$USER/bibliotheks-und-archivinformatik
       Icon=text-html" >> ~/Desktop/jupyter-notebook
       

    2. Gemeinsames Dokument

       echo "[Desktop Entry]
       Encoding=UTF-8
       Name=Gemeinsames Dokument
       Type=Link
       URL=https://pad.gwdg.de/7X8eCDVoQB2Ng6DZlG40LQ?both
       Icon=text-html" >> ~/Desktop/gemeinsames-dokument
       

    3. Ordner

       ln -s ~/bibliotheks-und-archivinformatik ~/Desktop/bibliotheks-und-archivinformatik
       

12. Konfiguration Startleiste

    • Leafpad starten und mit rechter Maustaste zum Starter hinzufügen
    • LX-Terminal starten und mit rechter Maus zum Starter hinzufügen

13. Konfiguration Browser

    • Startseite auf http://localhost:8888/lab/tree/home/bain/bibliotheks-und-archivinformatik setzen

14. Virtuelle Maschine als Appliance exportieren über Dialog im Menü Machine > Export to OCI