Add labs

01-basics/lab01/lab.txt

@@ -0,0 +1,127 @@
+= Installation und Starten eines Mosquitto Brokers
+
+Nutzen Sie eine der folgenden Methoden, um 
+den Mosquitto Broker lokal zu installieren und zu starten.
+
+Lokales Arbeiten ist Teil der Schulung und weitere Labs bauen darauf auf.
+
+Container Technologie ist ein guter Weg, um reproduzierbare Ergebnisse
+zu erhalten und komfortabel zu arbeiten.
+
+Methoden:
+
+- Lokale Installation
+- Docker Container
+
+
+
+= Lokale Installation
+
+== Windows
+
+Gehen Sie auf die offizielle Seite von Eclipse Mosquitto und
+laden Sie den neusten 64 Bit Installer herunter. 
+
+https://mosquitto.org/files/binary/win64/
+
+Führen Sie die Installationsdatei aus und befolgen Sie den Anweisungen.
+
+Merken Sie sich das Installationsverzeichnis.
+
+Standardmäßig wird Mosquitto unter 'C:\Program Files\Mosquitto'
+installiert.
+
+Starten Sie eine Kommandozeile und navigieren Sie in das
+Installationsverzeichnis von Mosquitto.
+
+Installation abgeschlossen, weiter bei "Starten"
+
+
+== Linux
+
+Mosquitto wird nicht mehr als Binärpaket für Linux auf mosquitto.org angeboten.
+Die Installationsmethode ist daher abhängig von der verwendeten Linux Distribution.
+Das Beispiel nutzt Debian/Ubuntu/Armbian.
+
+Zum Testen kann auch das in Docker ausprobiert werden 
+(wobei dann auch direkt ein Mosquiotto Container genutzt werden kann):
+   Dazu:
+   1) Ubuntu Container als "virtuelle Maschine" starten 2) darin die Kommandos ausführen
+   $ docker run --privileged --cgroupns=host --tmpfs /run --tmpfs /run/lock  -v /sys/fs/cgroup:/sys/fs/cgroup:rw geerlingguy/docker-ubuntu2404-ansible 
+   $ docker exec -it $(docker ps -q --latest) /bin/bash
+
+
+Fügen Sie das Mosquitto PPA APT Repository hinzu:
+
+$ sudo apt-add-repository ppa:mosquitto-dev/mosquitto-ppa
+$ sudo apt-get update
+
+Installieren Sie nun Mosquitto:
+
+$ sudo apt-get install mosquitto
+
+Der Broker sollte automatisch als Service gestartet werden.
+
+Um ihn manuell zu starten, und die Kommandozeile zu sehen, stoppen
+Sie den Mosquitto Broker und starten Sie ihn erneut.
+
+$ sudo systemctl stop mosquitto
+# ggf. pruefen ("Active: inactive") mittels  "sudo systemctl status mosquitto"
+
+Installation abgeschlossen, weiter bei "Starten"
+
+
+== MacOS
+
+Installieren Sie den Mosquitto Broker über Brew.
+
+$ brew install mosquitto
+
+Installation abgeschlossen, weiter bei "Starten"
+
+
+
+
+= Starten des Mosquitto Brokers
+
+Führen Sie den Befehl 'mosquitto -h' aus, um unterstützte Befehle von
+Mosquitto zu sehen.
+
+Führen Sie den Befehl 'mosquitto -v' aus um den Broker zu starten und
+um die Aktivität des Brokers in der Kommandozeile mitzuverfolgen können.
+
+
+
+
+= Verwendung Docker
+
+Da das offizielle Container Image von Mosquitto keine anonymen Verbindungen erlaubt, 
+wird eine Konfigurationdatei benötigt, die dann in den Docker Container eingebunden wird.
+
+Erstellen Sie dazu eine Datei mit dem Namen 'mosquitto.conf' und folgendem Inhalt:
+
+allow_anonymous true
+listener 1883
+
+
+Um den Mosquitto Broker als Docker Container zu starten führen Sie
+folgenden Befehl im selben Verzeichnis, wie die Konfigurationsdatei aus:
+
+$ docker run --rm -p 1883:1883 -v $PWD/mosquitto.conf:/mosquitto/config/mosquitto.conf eclipse-mosquitto
+
+Diesel Befehl startet einen Container mit den Mosquitto Broker, verbindet
+den Host Port 1883 mit den Port 1883 des Containers und bindet die
+Konfigurationdatei an passender Stelle ein.
+
+
+= Referenzen
+
+Download Page von Mosquitto https://mosquitto.org/download/
+
+Docker Desktop Installation https://docs.docker.com/desktop/
+
+Docker Standalone Installation https://docs.docker.com/engine/install/
+
+Docker Container Runtime für MacOS https://github.com/abiosoft/colima
+
+Mosquitto Docker Container https://hub.docker.com/_/eclipse-mosquitto

01-basics/lab01/mosquitto.conf

@@ -0,0 +1,2 @@
+listener 1883
+allow_anonymous true