Pallax Agent

Der Pallax Agent ist ein kleines Programm, das du auf einem Linux-basierten Gateway installierst. Er verbindet das Gateway automatisch und sicher mit der Plattform und liefert dir zusätzliche Funktionen, die ein Gateway ohne Agent nicht hat.

Was der Agent für dich übernimmt

• Verbindung und Zertifikate automatisch. Beim Koppeln (Pairing) erhält der Agent sein Zertifikat direkt von der Plattform und installiert es selbst. Du lädst dafür nichts herunter und kopierst keine Dateien von Hand — das unterscheidet den Agent-Weg grundlegend vom manuellen Anschluss (siehe Gateway ohne Agent verbinden).
• Laufende Zustandsdaten. CPU, Speicher, Festplatte und Laufzeit des Gateways erscheinen auf dem Monitoring-Reiter der Gateway-Detailseite.
• Fernzugriff, wenn du ihn brauchst. Mit Agent kannst du auf der Gateway-Detailseite den Reiter Remote-Befehl nutzen, der auch die Live-Konsole enthält. Ohne Agent ist der Reiter sichtbar, aber deaktiviert.
• Zertifikatserneuerung ohne dein Zutun. Läuft ein Zertifikat aus, stellt die Plattform ein neues aus und der Agent übernimmt es selbstständig — du musst nichts erneut herunterladen oder installieren.

Installation und Kopplung

Die Kopplung (Pairing) beginnt im Assistenten, wenn du im Arbeitsbereich ein neues Gateway anlegst und den Schritt Agent-Verbindung erreichst. Dort zeigt dir die Plattform einen zeitlich begrenzten Pairing-Code sowie die passenden Installationsbefehle für dein System.

Debian / Ubuntu:

curl -fsSL https://packages.pxdc.io/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/pallax.gpg
echo "deb [signed-by=/usr/share/keyrings/pallax.gpg] https://packages.pxdc.io/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/pallax.list
sudo apt update && sudo apt install -y pallax-agent

OpenWrt:

wget -O /tmp/install.sh https://packages.pxdc.io/install.sh && sh /tmp/install.sh

Anschließend koppelst du das Gateway mit dem im Assistenten angezeigten Code:

pallax-agent --pair <CODE> --type <lorawan|mioty> --endpoint https://agent.pxdc.io

Der Assistent zeigt dir den Pairing-Befehl mit dem für deine Umgebung passenden Endpunkt direkt an — verwende bei Abweichungen immer den dort angezeigten Befehl statt des Beispiels oben.

Dieser eine Befehl fordert das Zertifikat an, empfängt es und speichert es lokal — danach startet der Agent automatisch und verbindet sich. Der Assistent erkennt die erfolgreiche Kopplung von selbst und zeigt „Gateway verbunden!“ an; ein manueller Zertifikats-Download ist an keiner Stelle dieses Ablaufs nötig oder vorgesehen.

Prüfen, ob der Agent läuft

• Im Assistenten: Solange die Plattform noch auf die Kopplung wartet, zeigt der Bildschirm „Warte auf Agent-Verbindung …“. Nach erfolgreicher Kopplung wechselt die Anzeige auf „Gateway verbunden!“.
• Auf der Gateway-Detailseite, Reiter Monitoring: Die Kacheln für CPU, Speicher, Festplatte und Uptime füllen sich mit echten Werten, sobald der Agent seine erste Telemetrie gesendet hat. Bis dahin steht dort „Agent-Telemetrie ausstehend“ — das ist keine Fehlermeldung, sondern der normale Zustand kurz nach der Kopplung.
• Reiter Remote-Befehl (inkl. Live-Konsole): Nur nutzbar, wenn ein Agent verbunden ist. Fehlt die Verbindung, bleibt der Reiter sichtbar, aber deaktiviert.
• Auf dem Gateway selbst (systemd-Systeme): systemctl status pallax-agent und journalctl -u pallax-agent -f. Auf OpenWrt: /etc/init.d/pallax-agent status und logread -e pallax-agent -f.

Verwandte Kapitel

• Geräte — Gateways anlegen und ihren Zertifikatsstatus einsehen.
• Gateway ohne Agent verbinden — wenn kein Agent installiert werden kann oder soll.