Anleitung für Herstellung VirtualBox Appliance
This commit is contained in:
Felix Lohmeier
parent
69bf302bf7
commit
a6662b19f3
|
|
@ -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
|
||||||
Loading…
Reference in New Issue