Zum Inhalt

Linux / Raspberry Pi

Diese Anleitung beschreibt die Installation eines Confire Cloud Agenten auf einem Raspberry Pi oder einem 64-bit ARM-basierten Linux-System.

Welche Instanzversion habe ich?

Hinweis

Um von allen neuesten Funktionen und Fehlerbehebungen zu profitieren, stellen Sie bitte sicher, dass Ihre Agents die aktuelle Agent-Software verwenden, die mit Ihrer Instanzversion übereinstimmt

Bitte installieren Sie einen Agenten pro Netzwerk, das Sie verwalten möchten.

Voraussetzungen

  • Bevor Sie mit der Installation des Agenten beginnen, überprüfen Sie bitte die Mindestanforderungen für den Rechner:
Komponente Anforderung
Prozessor ARM Cortex-A53 oder besser (ARMv8-A 64-bit)
RAM mind. 1 GB (2 GB oder mehr empfohlen)
Speicher mind. 10 GB frei (20 GB empfohlen)
Bildschirmausgabe Optional – nur erforderlich bei Desktop-UI
Netzwerk Ethernet oder WLAN (für Online-Funktionen/Updates)

Empfohlene Plattformen

Der Agent läuft zuverlässig auf:

  • Raspberry Pi 4 (Model B oder neuer) – mit 64-bit OS
  • Raspberry Pi 5 – mit 64-bit OS
  • Virtualisierte oder emulierte 64-bit ARM-Linux-Umgebungen (z. B. QEMU, Docker-ARM64-Container)

Installation

Agent in Confire Cloud anlegen

  1. Im linken Menü auf Agenten/Netzwerke klicken:

  1. Auf die drei Punkte oben rechts klicken und + Add auswählen:

  1. Einen Namen für den Agenten eingeben und einen Mandanten (Tenant) auswählen:

  1. Agent-ID notieren und auf OK klicken.

Agent-Software herunterladen und installieren

  • Agent-Software herunterladen:
curl -O https://download.stueber.de/doc/de/confirecloud/agent/confirecloudagent.tgz
  • Programmverzeichnis erstellen:
sudo mkdir -p /opt/ConfireCloud/Agent/
  • Archiv entpacken:
sudo tar -xzf confirecloudagent.tgz -C /opt/ConfireCloud/Agent/
  • appsettings.Production.json herunterladen:
sudo curl -o /opt/ConfireCloud/Agent/appsettings.Production.json https://download.stueber.de/doc/de/confirecloud/agent/appsettings.Production.json

Produktionsdatei anpassen

  • Öffnen Sie die Datei appsettings.Production.json in einem Texteditor:
sudo nano /opt/ConfireCloud/Agent/appsettings.Production.json

  • ScanIpAddresses IP-Bereich oder Broadcast-Adresse angeben, den der Agent durchsuchen soll Beispiel für Broadcast: "192.168.1.255" (Akzeptiert auch Einzel-IPs oder CIDR-Netze, z. B. "192.168.1.0/24")

  • RabbitMQ – Zugangsdaten aus der E-Mail eintragen (Host, VirtualHost, Username, Password)

  • AgentId – die notierte Agent-ID einfügen

  • Datei speichern und schließen.

ConfireCloudAgent als Dienst registrieren

  • Service-Datei kopieren:
sudo cp /opt/ConfireCloud/Agent/ConfireCloudAgent.service /etc/systemd/system
  • Dienst aktivieren (beim Boot starten):
sudo systemctl enable ConfireCloudAgent
  • Dienst starten:
sudo systemctl start ConfireCloudAgent
  • Status prüfen:
sudo systemctl status ConfireCloudAgent

Konfiguration

Manuelle Gerätespezifikation

Anstatt die automatische Erkennung per Broadcast zu verwenden, können Sie die zu verwaltenden Geräte direkt per IP-Adresse angeben. Dies ist besonders nützlich, wenn:

  • Broadcast-Erkennung im Netzwerk eingeschränkt ist

  • Geräte in unterschiedlichen Subnetzen liegen

Im untenstehenden Beispiel wurden fünf Geräte per Broadcast-Erkennung erkannt:

Anstatt die Broadcast-Erkennung zu verwenden, möchten wir jetzt nur zwei spezifische Geräte, DIRECT-Raum-001 und DIRECT-Raum-002 erkennen. Dann müssen die Geräte manuell in der Datei appsettings.Production.json eingetragen werden:

  • Unter ScanIpAddresses löschen Sie den Eintrag "192.168.1.255":

  • Tragen Sie die IP-Adressen der gewünschten Geräte ein. Stellen Sie sicher, dass die letzte Zeile kein Komma enthält:

  • Speichern Sie die Datei appsettings.Production.json und starten Sie den Dienst ConfireCloudAgent neu:
sudo systemctl restart ConfireCloudAgent
  • Es werden nun nur die zwei angegebenen Geräte erkannt:

Upgrade durchführen

Um alle neuen Funktionen nutzen zu können, verwenden Sie immer die aktuellste Version des Agents.

  • Dienst stoppen:
sudo systemctl stop ConfireCloudAgent
  • Alte Dateien löschen, außer der Produktionsdatei (optional, aber empfohlen):
sudo find /opt/ConfireCloud/Agent/ -mindepth 1 ! -name 'appsettings.Production.json' -exec rm -rf {} +
  • Neueste Version herunterladen:
curl -O https://download.stueber.de/doc/de/confirecloud/agent/confirecloudagent.tgz
  • Entpacken:
sudo tar -xzf confirecloudagent.tgz -C /opt/ConfireCloud/Agent/
  • Dienst starten:
sudo systemctl start ConfireCloudAgent
  • Status prüfen:
sudo systemctl status ConfireCloudAgent