= 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