SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor

Doppelte machine-id nach VPS-Klon beheben

Geklonte VPS mit derselben /etc/machine-id können um DHCP-Leases konkurrieren. Leeren, neu erzeugen und vor dem Golden-Image-Snapshot abschneiden.

Was /etc/machine-id ist und warum ein Duplikat relevant ist

Ein geklonter VPS startet mit derselben /etc/machine-id wie der Server, von dem er geklont wurde. Dieser Wert darf jedoch genau einer Installation zugeordnet sein. Die Lösung besteht aus vier Befehlen: Datei leeren, die D-Bus-Kopie entfernen, sofern es sich um eine echte Datei handelt, die ID neu generieren und einen Reboot durchführen. Der Reboot wird häufig übersprungen. Er sorgt dafür, dass die Änderung wirksam wird.

/etc/machine-id enthält eine durch einen Zeilenumbruch abgeschlossene Hexadezimalzeichenfolge mit 32 Zeichen in Kleinbuchstaben. Decodiert entspricht sie einem 16 Byte (128 Bit) großen Wert. Die Handbuchseite zu machine-id(5) bezeichnet diesen Wert als vertraulich. Sie weist darauf hin, dass er nicht über das Netzwerk offengelegt werden darf, weil jeder, der ihn ausliest, Ihren Rechner später wiedererkennen kann. Normalerweise wird der Wert während der Installation oder beim ersten Boot generiert und bleibt bei allen folgenden Boots unverändert.

Drei Bezeichner werden hier häufig verwechselt. Deshalb sollten sie getrennt betrachtet werden. Der Hostname ist eine von Ihnen gewählte Bezeichnung und kann jederzeit geändert werden. Die DMI-Produkt-UUID (Desktop Management Interface) in /sys/class/dmi/id/product_uuid stammt vom Hypervisor und kann nur von root ausgelesen werden. Die Machine-ID ist der dritte Bezeichner: Das Betriebssystem generiert sie, und jeder Benutzer auf dem System kann sie auslesen.

Was tatsächlich die Machine-ID liest

Der DHCP-Client-Identifier. Das ist der kritische Punkt. ClientIdentifier= im Abschnitt [DHCPv4] einer .network-Datei greift auf den in networkd.conf(5) gesetzten Wert zurück, der standardmäßig duid ist: eine RFC-4361-Client-ID, die aus einer IAID und einer DUID (DHCP Unique Identifier) besteht. networkd.conf(5) dokumentiert den DUID-Standardtyp als vendor. Dabei wird der DUID-Wert anhand der Herstellerkennung 43793 (systemd) und des Hashs der Machine-ID erzeugt. DHCPv6 verwendet dieselbe DUID. Zwei Klone mit derselben Machine-ID erzeugen denselben Hash und damit dieselbe Standard-DUID. Stimmen zusätzlich ihre IAIDs überein, senden sie einen bytegleichen Client-Identifier. Die automatisch erzeugte IAID wird aus einem von udev ermittelten persistenten Namen gehasht. Wenn kein vorhersehbarer Name verfügbar ist, wird auf die MAC-Adresse zurückgegriffen. Übereinstimmende aktuelle Interface-Namen allein garantieren daher keine übereinstimmenden IAIDs. Unterschiedliche MAC-Adressen können trotz identischer Machine-IDs und Interface-Namen unterschiedliche Client-Identifier erzeugen. Stimmen die vollständigen Client-Identifier überein, sieht der DHCP-Server einen Client statt zwei und bietet beiden Systemen dieselbe Lease an. Das äußert sich darin, dass eine Adresse zwischen den beiden Servern wechselt oder ein Server seine Adresse verliert, sobald der andere die Lease erneuert.

journald. Persistente Journal-Dateien liegen in /var/log/journal/<machine-id>/. Flüchtige Journals liegen unter /run/log/journal/. Das Verzeichnis trägt wörtlich den Namen der ID. Ein Collector, der Journals nach Machine-ID gruppiert, führt die Identitäten der Klone zusammen. systemd-journal-remote trennt die Ausgabedateien dagegen nach dem Hostnamen oder der Adresse des Quellendpunkts.

D-Bus. /var/lib/dbus/machine-id ist der Ursprung dieses Dateiformats. Es kann ein Symlink auf /etc/machine-id oder eine separate reguläre Datei mit einer eigenen Kopie sein. Diese Kopie ist der kritische Punkt im folgenden Verfahren.

Agenten pro Host. Monitoring-Agenten, Lizenzprüfungen, Inventarisierungstools und Backup-Clients verwenden die Machine-ID häufig als standardmäßige Host-ID, weil sie stabil ist und keine Konfiguration benötigt. Wenn zwei Server dieselbe Identität melden, entsteht entweder eine zusammengeführte Metrikreihe oder ein Lizenzplatz deckt zwei Maschinen ab. Prüfen Sie, wie Ihr Agent seine Host-ID ermittelt, statt anzunehmen, dass er den Hostnamen verwendet.

So erkennen Sie, ob eine doppelte Instanz vorliegt

Führen Sie diesen Befehl auf beiden Servern aus und vergleichen Sie die Ausgabe.

cat /etc/machine-id
ls -l /var/lib/dbus/machine-id
sudo cat /sys/class/dmi/id/product_uuid

Identische Machine-IDs auf zwei laufenden Servern bedeuten, dass einer vom anderen geklont wurde. hostnamectl gibt denselben Wert in seiner Zeile Machine ID: aus, wenn Sie dafür lieber einen einzelnen Befehl verwenden.

Das Ergebnis von ls -l bestimmt den nächsten Schritt. Ein symbolischer Link sieht so aus:

lrwxrwxrwx 1 root root 15 Aug 21 09:12 /var/lib/dbus/machine-id -> /etc/machine-id

Eine mit -rw-r--r-- beginnende Zeile bedeutet, dass es sich um eine echte Datei handelt, die eine eigene Kopie der alten ID enthält. Sie müssen diese Datei entfernen, weil systemd-machine-id-setup sie liest, bevor der Hypervisor-UUID oder dem Zufallszahlengenerator überhaupt Beachtung geschenkt wird.

Die Product-UUID ist ebenfalls relevant. systemd-machine-id-setup(1) verwendet zunächst die KVM-UUID und greift erst danach auf die Zufallsgenerierung zurück. Wenn Ihr Provider beiden Klonen dieselbe SMBIOS-UUID (System-Management-BIOS-UUID) zugewiesen hat, erzeugt eine erneute Generierung aus dieser Quelle daher zweimal dieselbe Machine-ID. Unterschiedliche Product-UUIDs verhindern diese konkrete Kollision. Frühere ID-Quellen haben jedoch weiterhin Vorrang.

Maschinen-ID auf einem geklonten VPS neu generieren

Die Reihenfolge ist entscheidend. systemd-machine-id-setup(1) prüft zuerst /run/machine-id, danach eine gültige D-Bus-Maschinen-ID und anschließend die system.machine_id-Anmeldeinformation, bevor das Tool eine konfigurierte VM- oder Container-UUID und zuletzt eine zufällige Generierung versucht. Belassen Sie eine echte /var/lib/dbus/machine-id, regenerieren Sie ohne Priorität von /run/machine-id genau den Wert, den Sie eigentlich entfernen wollten. Wenn das Tool /run/machine-id oder eine Anmeldeinformation wiederverwendet und die ID unverändert bleibt, löschen Sie die Maschinen-ID des Images im heruntergefahrenen Zustand und starten Sie es mit eindeutigen Identitätsquellen.

sudo truncate -s 0 /etc/machine-id
sudo rm -f /var/lib/dbus/machine-id       # only if ls -l showed a real file
sudo systemd-machine-id-setup
sudo ln -sf /etc/machine-id /var/lib/dbus/machine-id
cat /etc/machine-id

Das vorherige Kürzen ist erforderlich, weil das Tool nur arbeitet, wenn die Datei fehlt oder leer ist. Bei einer Datei, die bereits eine gültige ID enthält, führt es keine Aktion aus. systemd-machine-id-setup meldet seine Aktion auf der Standardfehlerausgabe. Auf einem KVM-VPS mit systemd 258 oder höher sehen Sie bei der Auswahl der Hypervisor-UUID:

Initializing machine ID from SMBIOS/DMI UUID.

systemd 255 bezeichnet denselben Schritt als Initializing machine ID from VM UUID.. Initializing machine ID from random generator. ist die Meldung, wenn keine frühere ID-Quelle verwendet werden kann. Beide Ergebnisse sind in Ordnung, solange cat /etc/machine-id jetzt einen anderen Wert als auf dem anderen Server ausgibt.

Der symbolische Link sorgt dafür, dass D-Bus und systemd denselben Wert verwenden. Wenn Sie eine separate echte Datei bevorzugen, führen Sie sudo dbus-uuidgen --ensure anstelle des Befehls für den symbolischen Link aus: Wenn die D-Bus-Datei fehlt, kopiert es die gültige ID aus /etc/machine-id. Wenn /var/lib/dbus fehlt, schlägt ln mit No such file or directory fehl. Sie können dann beide Zeilen überspringen.

Starten Sie das System anschließend neu.

sudo reboot

Warum der Reboot nicht optional ist

Jeder Prozess, der den alten Wert bereits gelesen hat, verwendet ihn weiterhin. sd_id128_get_machine() cached die ID pro Thread: Ein Thread, der sie bereits gelesen hat, liefert weiterhin den alten Wert zurück. Nur ein Thread, der sie noch nicht abgefragt hat, liest die geänderte Datei. Ein laufender Daemon kann die alte ID daher in seinen vorhandenen Threads halten und die neue ID erst in Threads übernehmen, die er später startet. journald hat /var/log/journal/<old-id>/system.journal bereits geöffnet und hängt weiterhin Einträge daran an. systemd-networkd hat seine DUID beim Start ermittelt und sendet bei jeder Erneuerung weiterhin die alte Client-ID. Das ist normalerweise genau der Fehler, den Sie beheben wollten. Auch D-Bus hat seine ID beim Start gelesen. Sie können Dienste einzeln neu starten, werden dabei aber einen übersehen. Außerdem hält PID 1 den alten Wert ebenfalls.

Prüfen Sie nach dem Reboot beide Seiten:

cat /etc/machine-id
ls /var/log/journal/

Bei aktiviertem persistentem Logging enthält /var/log/journal/ jetzt ein zweites Verzeichnis, das nach der neuen ID benannt ist. Neue Einträge werden dort abgelegt. Einfaches journalctl liest nur das Verzeichnis des aktuellen Rechners. Daher verschwindet Ihre Historie vor dem Klonen aus der Standardansicht. Sie befindet sich weiterhin auf der Festplatte: journalctl --merge liest jedes Journalverzeichnis, auch das alte. Löschen Sie das alte Verzeichnis, sobald Sie sicher sind, dass Sie diese Logs nicht mehr benötigen.

Das ist auch der Grund, warum ein Container der falsche Ort ist, um das Verfahren zu testen. Ein Container verwendet den Kernel des Hosts gemeinsam mit diesem. Er kann systemd als eigenen PID 1 ausführen, startet aber niemals einen eigenen Kernel. Innerhalb eines Containers verwendet systemd-machine-id-setup eine konfigurierte Container-UUID erst, nachdem vorherige ID-Quellen fehlgeschlagen sind. Ohne eine nutzbare Quelle erzeugt es eine zufällige ID. Testen Sie das Verfahren so, wie es in der Produktion abläuft: Klonen Sie eine VM, führen Sie die Befehle aus, starten Sie sie neu und vergleichen Sie anschließend die ID mit der des Ausgangsrechners.

Vor dem Snapshot leeren, nicht nach dem Klonen

Einzelne Klone nacheinander zu korrigieren, funktioniert. Besser ist es, das Image zu korrigieren, weil jeder aus einem fehlerhaften Snapshot wiederhergestellte Server denselben Wert übernimmt. Führen Sie diesen Schritt als Letztes aus, bevor Sie die Vorlage herunterfahren.

sudo truncate -s 0 /etc/machine-id
sudo rm -f /var/lib/dbus/machine-id
sudo ln -s /etc/machine-id /var/lib/dbus/machine-id
sudo shutdown -h now

Leeren Sie die Datei. Löschen Sie sie nicht. machine-id(5) empfiehlt für Images, die auf mehreren Maschinen verwendet werden, eine leere Datei, weil eine vorhandene leere Datei bei schreibgeschützter Verwendung des Images durch eine temporäre Datei per Bind-Mount über der eigentlichen Datei eingehängt werden kann. Auf einem schreibgeschützten /etc liegt die beim Boot erzeugte ID in dieser temporären Datei. Sobald das Dateisystem beschreibbar ist, schreibt systemd-machine-id-setup --commit sie dauerhaft.

Ein Nebeneffekt hängt davon ab, in welchem Zustand Sie die Datei hinterlassen. machine-id(5) stellt ausdrücklich fest: Wenn /etc/machine-id vorhanden und leer ist, gilt ein Boot nicht als erster Boot. Die leere Datei oben aktiviert daher keine Units mit ConditionFirstBoot=yes. Eine fehlende Datei oder eine Datei mit der Zeichenfolge uninitialized macht den nächsten Boot dagegen zum ersten Boot. Diese Units werden ausgeführt. Außerdem wendet systemd Unit-Presets an. Prüfen Sie mit grep -rl ConditionFirstBoot /usr/lib/systemd/system/, welche Units Ihr Image ausführen würde, bevor Sie die Vorlage erstellen.

Eine Vorlage und ein Snapshot sind unterschiedliche Objekte. Dieser Unterschied entscheidet darüber, ob die Identität kopiert wird. Eine Vorlage ist ein bewusst vorbereitetes Build-Artefakt. Ein Snapshot ist dagegen eine zeitpunktbezogene Kopie eines laufenden Servers und übernimmt dessen Identität zusammen mit den Daten.

Warum Cloud-Images dies korrekt erledigen und Ihr Snapshot nicht

Cloud-Images von Distributionen werden zum Klonen erstellt. Deshalb enthalten sie zunächst keine gesetzte Machine-ID, die beim ersten Bootvorgang generiert wird. cloud-init verfügt genau dafür über einen dokumentierten Schritt. cloud-init clean --machine-id setzt /etc/machine-id auf systemd-Systemen auf die Literalzeichenfolge uninitialized. Die Referenz zur cloud-init-CLI beschreibt dies beim Klonen eines Golden Image als Best Practice. Beim nächsten Bootvorgang dieses Images wird dadurch eine eindeutige Machine-ID generiert.

Ein Snapshot, den Sie selbst erstellt haben, ist ein anderer Fall. Die Datei war bereits befüllt, als Sie den Snapshot erstellt haben. Deshalb übernimmt jeder daraus wiederhergestellte Server denselben Wert, sofern der Wiederherstellungsprozess ihn nicht ausdrücklich löscht oder ersetzt. Dies ist dieselbe Problemklasse wie beim Verschieben eines laufenden Servers auf einen neuen VPS, bei dem die Kopie originalgetreu ist, aber die Identität nicht mitkopiert werden sollte.

Was ein Klon außerdem dupliziert

  • SSH-Hostschlüssel. /etc/ssh/ssh_host_* wird ebenfalls kopiert. Dadurch präsentieren sich beide Server gegenüber Clients mit demselben Fingerabdruck. Löschen Sie diese Dateien und führen Sie sudo ssh-keygen -A aus oder unter Debian und Ubuntu sudo dpkg-reconfigure openssh-server. Ihre Clients warnen danach vor einem geänderten Hostschlüssel. Das ist das korrekte Verhalten.
  • Den Hostnamen. Setzen Sie ihn mit sudo hostnamectl set-hostname app02 und prüfen Sie anschließend, ob /etc/hosts den neuen Namen weiterhin auflöst.
  • Die statische Netzwerkkonfiguration. Ein Klon eines Systems mit statischer Adresse verursacht eine Kollision mit dem Original, sobald er gestartet wird. Lesen Sie /etc/netplan/, bevor der Klon dem Netzwerk beitritt.
  • Die Uhrzeit. Beim Wiederherstellen eines Snapshots, der den laufenden Speicher enthält, kann die Uhr des Gasts zurückbleiben, bis der Gast oder der Hypervisor sie korrigiert. Eine große Zeitsprungkorrektur auf einem wiederhergestellten VPS lässt die Validierung von TLS-Zertifikaten fehlschlagen und bringt die Reihenfolge von Logs durcheinander, bis die Zeitsynchronisierung aufgeholt hat.

Arbeiten Sie auch auf dem Klon die Checkliste für die ersten zehn Minuten bei einem neuen VPS durch. Ein geklonter Server übernimmt die Benutzerkonten, SSH-Schlüssel, Firewall-Regeln und geplanten Jobs des Quellsystems. Nichts davon wurde für die Aufgabe überprüft, die der Klon künftig übernehmen soll.

FAQ

Muss ich nach der Änderung von /etc/machine-id einen Reboot durchführen?

Ja. Software, die die Machine-ID bereits gelesen hat, verwendet weiterhin die Kopie aus ihrem Cache. Der neue Wert erreicht daher die relevanten Teile eines laufenden Systems nicht. journald schreibt weiterhin in das Journalverzeichnis, das nach der alten ID benannt ist. Der DHCP-Client sendet weiterhin eine aus dem alten Wert abgeleitete Client-ID. Das ist normalerweise der Grund für die Änderung. Das erneute Starten einzelner Dienste behebt das Problem bei einigen von ihnen. PID 1 hält den alten Wert jedoch ebenfalls. Führen Sie einen Reboot durch. Prüfen Sie anschließend den Wert mit cat /etc/machine-id und vergleichen Sie ihn mit dem anderen Server.

Ist /etc/machine-id dasselbe wie die Hardware-UUID?

Nein. Die DMI-Produkt-UUID in /sys/class/dmi/id/product_uuid stammt vom Hypervisor und kann nur von root gelesen werden. Die Machine-ID wird vom Betriebssystem erzeugt und befindet sich in einer normalen Datei, die jeder Benutzer lesen kann. Die beiden Werte sind nur in eine Richtung miteinander verknüpft: Bei einem KVM-Gast verwendet systemd-machine-id-setup die Hypervisor-UUID als Ausgangswert für eine neue Machine-ID, wenn keine frühere ID-Quelle verfügbar ist. Wenn zwei Klone dieselbe Produkt-UUID verwenden und die Regenerierung diese UUID nutzt, erzeugen beide dieselbe Machine-ID. Vergleichen Sie daher auch diese Datei, bevor Sie dem Ergebnis vertrauen.

Sollte ich /etc/machine-id löschen oder leer lassen?

Lassen Sie die Datei leer, wenn Sie ein Image vorbereiten. machine-id(5) bevorzugt eine leere Datei, weil systemd eine temporäre Datei darüber mounten kann, wenn das Image mit einem schreibgeschützten /etc ausgeführt wird. Das Löschen der Datei funktioniert auf einem beschreibbaren System. Einige Klon-Skripte gehen so vor. Eine leere Datei ist jedoch die sicherere Standardeinstellung. cloud-init schreibt stattdessen das Wort uninitialized in die Datei. Dieser Wert bewirkt, ebenso wie eine fehlende Datei, dass der nächste Boot als erster Boot behandelt wird. Dadurch werden Units mit ConditionFirstBoot=yes bei diesem Boot ausgeführt. Eine leere Datei bewirkt das nicht.

Warum haben meine beiden geklonten Server dieselbe DHCP-Adresse erhalten?

Weil beide dieselbe Client-ID gesendet haben. systemd-networkd verwendet für DHCPv4 standardmäßig ClientIdentifier=duid. Die Standard-DUID wird aus einem Hash von /etc/machine-id erzeugt. Identische Machine-IDs führen daher zu identischen Standard-DUIDs. Die vollständigen Client-IDs stimmen jedoch nur überein, wenn auch die IAIDs identisch sind: systemd erzeugt eine IAID aus einem persistenten Namen, der von udev bezogen wird. Wenn kein vorhersehbarer Name verfügbar ist, verwendet systemd die MAC-Adresse. Übereinstimmende aktuelle Interface-Namen allein garantieren dies nicht. Wenn die vollständigen IDs übereinstimmen, ordnet der DHCP-Server beide Anfragen anhand dieser ID demselben Client zu und vergibt eine Lease. Geben Sie jedem Rechner eine eigene Machine-ID und starten Sie beide neu. Wenn der Server weiterhin die alte Adresse anbietet, löschen Sie die veraltete Lease direkt auf dem DHCP-Server.

War dieser Artikel hilfreich?

#machine-id#systemd#cloning#snapshots#dhcp