Deinstallieren¶

Wie Sie den Agenten von einem Gateway entfernen, das wie unter Manuell installieren eingerichtet wurde, wie Sie ihn wieder installieren und was zurückbleibt. Die Schritte liefen auf dem Labor-Gateway (zuletzt am 11.11.2026, beim Entfernen von cproto-v0.2.0-rc.2). Die Pfade sind die dieser Seite (/mnt/data/bootstrap-agent; nehmen Sie Ihre). your-software steht für die Namen, die Sie den Platzhalter-Units gegeben haben.

Den Agenten entfernen¶

Auf dem Gateway als root. Halten Sie zuerst Ihre Software an, dann den Agenten:

systemctl disable --now your-software.path your-software.service
systemctl disable --now bootstrap-agent.service
rm -f /etc/systemd/system/bootstrap-agent.service \
  /etc/systemd/system/your-software.path /etc/systemd/system/your-software.service
rm -rf /etc/systemd/system/bootstrap-agent.service.d
rm -f /etc/tmpfiles.d/bootstrap-agent.conf
systemctl daemon-reload
rm -rf /run/bootstrap-agent /run/wlpc
rm -rf /mnt/data/bootstrap-agent /etc/bootstrap-agent

Der erste Befehl kann Disabling 'your-software.service', but its triggering units are still active ausgeben; derselbe Befehl deaktiviert auch die .path-Unit.

Danach auf dem Labor-Gateway geprüft:

systemd antwortet Unit bootstrap-agent.service could not be found., und kein Agenten-Prozess läuft.
/run/bootstrap-agent, /run/wlpc, /mnt/data/bootstrap-agent und /etc/bootstrap-agent (mit dem gespeicherten Schlüssel und agent.env) sind weg.
Alle drei transienten TPM-Plätze sind frei.
/etc/iot-config ist erhalten, siehe Was bleibt.

Was bleibt¶

/etc/iot-config: die gespeicherte Konfiguration und die Aufzeichnungen des Agenten, darunter der Eintrag des Attestierungsschlüssels und das Geburtszertifikat. Damit macht eine neue Installation als dasselbe Gerät weiter, siehe Wieder installieren.
Das TPM: Der Attestierungsschlüssel und die Objekte des Herstellers bleiben im TPM. Das Entfernen oben berührt sie nicht. Wie der eigene Schlüssel des Agenten vor einem Zurücksetzen auf Werkseinstellungen entfernt wird, steht unter Das TPM; das war nicht Teil dieses Tests.
Der Benutzer und die Gruppen: Der Benutzer bootstrap-agent und die Gruppen tss und wlpc blieben auf dem Labor-Gateway bestehen.
Das Gerät in der Konsole bleibt, wie es ist.

Wieder installieren¶

Führen Sie die Schritte 1 bis 7 von Manuell installieren unverändert aus.

Auf dem Labor-Gateway lieferte der Agent die gespeicherte Konfiguration wieder aus, ohne neue Einrichtung. Sein Log zeigte restored profile is fully acked; its confirmation rides on the next check-in, dann beim ersten Check-in pending confirmation delivered on check-in und check-in complete: unchanged, nothing fetched. tmpfiles --create legte /run/bootstrap-agent und /run/wlpc wieder an (das zweite als root:wlpc, Modus 2775). Die .path-Unit und der Dienst aus dem Ordner examples/ im Archiv, umbenannt, liefen unverändert: Der Dienst schrieb die Bestätigungsmarkierung unter seiner eigenen Benutzer-ID. Alle drei transienten TPM-Plätze waren frei.

Auch die gespeicherte Konfiguration entfernen¶

Für ein Labor-Gateway

Auf dem Labor-Gateway am 11.11.2026 ausgeführt: Nach den Befehlen unten und einem neuen Geräteeintrag in der Konsole richtete die neue Installation das Gateway als neues Gerät ein (PROVISIONED). Nutzen Sie den Schritt nur auf einem Labor-Gateway.

Damit sich das Gateway als neues Gerät wieder selbst einrichtet, entfernen Sie den Agenten wie oben und löschen dann die gespeicherte Konfiguration und die Aufzeichnungen des Agenten in /etc/iot-config:

cd /etc/iot-config && rm -rf profile profile-ready acks checkin checkin-attempt confirmed last-error

Löschen Sie danach das Gerät in der Konsole und legen Sie es neu an. Behalten Sie den Eintrag des Attestierungsschlüssels (ak) und das Geburtszertifikat (birth-cert.pem): Sie identifizieren das Gateway.

Auf einem Yocto-Image¶

Auf einem Produkt-Image ist der Agent Teil des Images. Ihn zu deinstallieren heißt, das Paket aus Ihrem Image zu entfernen und das neue Image als RAUC-Update auszuliefern. Das wurde nicht getestet. Der Zustand in /etc/iot-config liegt auf der Datenpartition und bleibt, sofern Ihr Zurücksetzen auf Werkseinstellungen ihn nicht löscht; Ihr Zurücksetzen führt zuerst bootstrap-agent --release-ak aus, siehe Das TPM.