jupyter.md

-# Installation von »Jupyter Notebook« und »Jupyter Lab«
+# Installation von »Jupyter Lab«
+
+**Wichtiger Hinweis**: Die im Folgenden beschriebenen Anweisungen zur
+Installation des eigentlichen »Jupyter Lab« (nicht Apache usw.) sind nicht
+mehr aktuell. Stattdessen ist so vorzugehen, wie im Abschnitt »Installation
+›Jupyter Lab‹ (März 2023)« beschrieben wird.
 
 ## Jupyter Notebook
 
@@ -201,10 +206,113 @@ systemctl start ipython-lab.service
 systemctl status ipython-lab.service
 ```
 
+## Installation »Jupyter Lab« (März 2023)
+
+Es hat sich herausgestellt, dass die Installation nur auf Basis von
+Systempaketen nicht gut gelingt (weitere Python-Bibliotheken müssen per `pip`
+installiert werden). Das wiederum führt möglicherweise zu schwer zu
+behebenden Konflikten. Ein bessere Lösung ist daher, den »Jupyter Lab«-Server
+gänzlich in einer virtuellen Python-Umgebung laufen zu lassen. Eine solche
+Installation wird im Folgenden beschrieben. Alle nachfolgenden Befehle müssen
+mit root-Privilegien ausgeführt werden:
+
+```
+ssh root@a73435
+...
+```
 
+Ausgehend von Hinweisen im Netz, sollte die virtuellen Python-Umgebung auf
+»Python 3.9« basieren, was die Installation der zugehörigen System-Pakete
+erfordert:
 
+```
+zypper in python39 python39-base python39-pip
+```
+
+Als nächstes wird unterhalb von `/usr/local/share/` die virtuelle Python-Umgebung erzeugt:
+
+```
+cd /usr/local/share/
+/usr/bin/python3.9 -m venv JupyterLab
+```
 
+Die eigentliche Installation von »Jupyter Lab« erfordert nun die Aktivierung
+der virtuellen Python-Umgebung (wichtig!):
 
+```
+cd JupyterLab
+source ./bin/activate
+```
+
+Alle nachfolgend zu installierenden Python-Bibliotheken werden nur lokal
+unterhalb des aktuellen Verzeichnisses `/usr/local/share/JupyterLab`
+gespeichert. Voraussetzung für ihre Wirksamkeit ist der activate-Aufruf.
+
+```
+# pip aktualisieren
+python3 -m pip install --upgrade pip
+# Jupyter Lab
+pip3 install ipykernel jupyterlab nbconvert jupyter_contrib_nbextensions
+# Zusätzliche Nutzer-Bibliotheken
+pip3 install matplotlib statistics datetime numpy pandas couchdb
+deactivate
+```
+
+Um den »Jupyter Lab«-Server automatisch zu starten ist eine Systemd-Service-Datei notwendig. Sie wird folgendermaßen erzeugt:
+
+```
+cat <<EOF > JupyterLab.service
+[Unit]
+Description=JupyterLab Service
+
+[Service]
+Type=simple
+WorkingDirectory=/usr/local/share/JupyterLab
+EnvironmentFile=-/etc/environment
+ExecStart=/bin/bash -lc 'source ./bin/activate ; \
+  jupyter lab --notebook-dir=/home/ipynb/notebooks \
+  --no-browser --ServerApp.allow_origin="http://127.0.0.1:82"'
+User=ipynb
+Group=ipynb
+Restart=on-failure
+RestartSec=60s
+
+[Install]
+WantedBy=multi-user.target
+
+EOF
+```
+
+(TODO: Vielleicht kann auf den Apache-Zugang per `http://127.0.0.1:82`
+verzichtet werden durch Verwendung der Parameter `--ip=0.0.0.0 --port=82`;
+testen!)
+
+Mit den folgenden Schritten wird die Systemd-Service-Datei installiert und aktiviert sowie der Serverprozess gestartet.
+
+```
+systemctl stop   JupyterLab.service
+systemctl link   $PWD/JupyterLab.service
+systemctl daemon-reload 
+systemctl enable JupyterLab.service
+systemctl start  JupyterLab.service
+systemctl status JupyterLab.service
+#
+exit
+```
+
+Sollen später weitere Python-Nutzer-Bibliotheken installiert werden, muss wiederum auf das Aktivieren der virtuellen Python-Umgebung geachtet werden.
+
+```
+ssh root@a73435
+...
+cd /usr/local/share/JupyterLab
+source ./bin/activate
+pip3 install xyz uvw abc
+deactivate
+#
+exit
+```
 
 
 
+=========== 2023-03-30 ==============