From a6662b19f35ef749cdf0b2e985eb4f738ea939c7 Mon Sep 17 00:00:00 2001
From: Felix Lohmeier <mail@felixlohmeier.de>
Date: Wed, 25 Sep 2019 02:36:50 +0200
Subject: [PATCH] =?UTF-8?q?Anleitung=20f=C3=BCr=20Herstellung=20VirtualBox?=
 =?UTF-8?q?=20Appliance?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 virtualbox-appliance.md | 157 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 157 insertions(+)
 create mode 100644 virtualbox-appliance.md

diff --git a/virtualbox-appliance.md b/virtualbox-appliance.md
new file mode 100644
index 0000000..57fd23b
--- /dev/null
+++ b/virtualbox-appliance.md
@@ -0,0 +1,157 @@
+# VirtualBox Appliance herstellen (Notiz für Lehrende)
+
+Als eine von zwei Optionen wird die Verwendung der Software VirtualBox empfohlen. Den Studierenden wird eine vorkonfigurierte Arbeitsumgebung mit JupyterLab in Form einer Appliance (.ova) bereitgestellt.
+
+Hier wird dokumentiert, wie diese Appliance hergestellt wird.
+
+Die Installation soll funktional gleich zu den für binder verwendeten Dockerfiles sein:
+
+* base-notebook: [Dockerfile für tag 1386e20468](https://github.com/jupyter/docker-stacks/blob/1386e20468332f32a028c6224bbd8439eb406ee4/base-notebook/Dockerfile)
+* minimal-notebook: [Dockerfile für tag 1386e20468](https://github.com/jupyter/docker-stacks/blob/1386e20468332f32a028c6224bbd8439eb406ee4/minimal-notebook/Dockerfile)
+* eigene Erweiterungen: [Dockerfile](https://github.com/felixlohmeier/bibliotheks-und-archivinformatik/blob/master/binder/Dockerfile)
+
+## Installation
+
+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. Updates installieren und neustarten
+
+   ```
+   sudo apt update && \
+   sudo apt upgrade && \
+   sudo shutdown -r now
+   ```
+
+6. Sudo ohne Passwort erlauben
+
+   ```
+   sudo echo "$USER ALL=(ALL) NOPASSWD: ALL" | sudo tee --append /etc/sudoers
+   ```
+
+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 Browser
+
+       - Startseite auf http://localhost:8888/lab/tree/home/bain/bibliotheks-und-archivinformatik setzen
+
+13. Konfiguration Startleiste
+
+       - Leafpad starten und mit rechter Maustaste zum Starter hinzufügen
+
+       - LX-Terminal starten und mit rechter Maus zum Starter hinzufügen
\ No newline at end of file