Agent aktualisieren, diagnostizieren und entfernen

Prüfen, aktualisieren oder entfernen

Nutzen Sie status für den Zustand, doctor zur Diagnose und logs für aktuelle Meldungen. agent start, stop und restart steuern den Dienst auf Ihrem Gerät. Aktualisieren Sie mit update oder Ihrer Paketverwaltung. agent uninstall entfernt den verwalteten Dienst; Schlüssel, Konfiguration und wartende Daten bleiben ohne ausdrücklich gewähltes --purge erhalten. Verwirf eine unerwünschte unvollständige Verbindung mit --reset-link vor einem neuen Start.

metribeacon status --json
metribeacon doctor --json
metribeacon logs --lines 100
metribeacon agent restart
metribeacon update
metribeacon agent uninstall

Wenn die Verbindung ausfällt

Der Agent speichert wartende Werte lokal und wiederholt sie mit denselben Kennungen, auch nach einem Neustart. Sein Standardpuffer ist auf 64 MiB und 24 Stunden begrenzt. Bei Platz- oder Altersüberschreitung werden die ältesten Batches verworfen und Verluste gezählt. Auch ungültige Daten können verworfen werden. Beheben Sie Schlüssel- oder Rechtefehler zeitnah. Erstes Lebenszeichen und erster Messwert im Monitor bestätigen die Einrichtung; ein laufender Prozess allein reicht nicht.

Download auswählen

Nutzen Sie ein für Ihre Plattform angebotenes Paket und lesen Sie seinen Unterstützungshinweis. Pakete für Linux ARM64, macOS x64 und Windows ARM64 sind nicht auf dieser Plattform getestet. macOS- und Windows-Installer haben derzeit keine Betriebssystem-Codesignatur und können eine Warnung anzeigen. Folgen Sie den Hinweisen zur Manifestprüfung; deaktivieren Sie den Systemschutz nicht pauschal. Ersetzen Sie ein fehlendes Paket nicht durch eine andere Prozessorarchitektur.

Installierten Agent aktualisieren

Neue native Installationen aktivieren Fernupdates mit einem eigenen Schlüsselrecht. Sobald eine neuere freigegebene Version verfügbar ist, erscheint ein Symbol in der Serverliste. Der Arbeitsbereichsbesitzer bestätigt jedes Update; warten Sie anschließend auf die Bestätigung nach dem Neustart. Konfigurationsschreibrechte sind davon unabhängig. Vorübergehende Belegung liefert 503 mit update_busy und Retry-After: 1. Wiederholen Sie mit derselben operation_id und demselben bestätigten Ziel; die Oberfläche versucht dies bis zu zehn Sekunden. Bereits angenommene Anfragen liefern denselben Auftrag zurück. Die opake target_id bindet freigegebenes Release und Ausgangsinstallation/-version; bei Änderungen erneut laden und bestätigen.

Native Dienste aktivieren vom Besitzer bestätigte Fernupdates standardmäßig. Lokal stehen Administratoren metribeacon agent remote-updates disable, enable und status zur Verfügung; eine gespeicherte lokale Abschaltung bleibt erhalten. Auch das Schlüsselrecht „Fernupdates erlauben“ lässt sich abschalten. npm- und Vordergrundinstallationen werden lokal aktualisiert.

Für eine native Neuinstallation mit bestehendem Serverschlüssel verwenden Sie setup --non-interactive --device-id SERVER_ID --key-file /protected/device.key mit authentifizierter Verwaltungsidentität. Die Einrichtung aktiviert das Updaterecht einmalig. Der Schlüssel muss aktiv und auf genau diesen Server begrenzt sein; breite oder widerrufene Schlüssel sind ungeeignet. Neustarts und normale Updates ändern keine Berechtigungen.

Ältere Installationen benötigen zunächst ein lokales Upgrade. Führen Sie danach als Administrator metribeacon agent remote-updates enable aus, um den Updater einzurichten. Für Offline-Server werden keine unerwarteten späteren Updates vorgemerkt.