SSD Nodes Learn Hosting plans →
Gidsen Matt ConnorDoor Matt Connor

Duplicate machine-id na VPS clone oplossen

Heeft u na het klonen van een VPS problemen met DHCP leases door een dubbele /etc/machine-id? Volg deze vier stappen om de ID veilig te regenereren en uw image correct voor te bereiden.

Wat /etc/machine-id is en waarom een duplicaat een probleem vormt

Een gekloonde VPS start op met dezelfde /etc/machine-id als de server waarvan deze is gekloond, terwijl die waarde bij precies één installatie hoort. De oplossing bestaat uit vier commando's: maak het bestand leeg, verwijder de D-Bus-kopie als dit een echt bestand is, genereer een nieuwe waarde en start opnieuw op. De herstart is de stap die mensen vaak overslaan, terwijl dit juist de stap is die de wijziging effectief maakt.

/etc/machine-id bevat een hexadecimale tekenreeks van 32 tekens in kleine letters, afgesloten met een regeleinde. Gedecodeerd is dit een waarde van 16 bytes (128-bit). De man-page van machine-id(5) noemt dit vertrouwelijk en stelt dat het niet mag worden blootgesteld aan het netwerk, omdat alles wat het kan lezen uw machine later opnieuw kan herkennen. Het wordt normaal gesproken gegenereerd tijdens de installatie of de eerste keer opstarten en blijft constant bij volgende opstartsessies.

Er worden hier drie identificatoren door elkaar gehaald, dus het is zinvol om deze te scheiden. De hostname is een label dat u zelf kiest en op elk gewenst moment kunt wijzigen. De DMI (desktop management interface) product-UUID in /sys/class/dmi/id/product_uuid is afkomstig van de hypervisor en is alleen leesbaar door root. De machine ID is de derde: het besturingssysteem genereert deze en elke gebruiker op de machine kan deze lezen.

Wat leest daadwerkelijk de machine ID

De DHCP-client-identifier. Dit is het punt dat problemen veroorzaakt. ClientIdentifier= in de [DHCPv4] sectie van een .network bestand valt terug op de waarde die is ingesteld in networkd.conf(5), en die is standaard duid: een RFC 4361 client ID opgebouwd uit een IAID en een DUID (DHCP unique identifier). networkd.conf(5) documenteert het standaard DUID-type als vendor, waarbij de DUID-waarde wordt gegenereerd met 43793 als vendor-identifier (systemd) en de gehashte inhoud van de machine ID. DHCPv6 gebruikt dezelfde DUID. Twee klonen met dezelfde machine ID resulteren in dezelfde standaard DUID, en als hun IAID's ook overeenkomen, sturen ze een byte-identieke client-identifier. De automatisch gegenereerde IAID hasht een persistente naam verkregen via udev, waarbij wordt teruggevallen op het MAC-adres wanneer er geen voorspelbare naam beschikbaar is. Het enkel matchen van huidige interfacenamen garandeert geen overeenkomende IAID's, dus verschillende MAC-adressen kunnen verschillende client-identifiers produceren ondanks identieke machine ID's en interfacenamen. Wanneer de volledige client-identifiers overeenkomen, ziet de DHCP-server één client in plaats van twee en biedt beide systemen dezelfde lease aan. Het symptoom is een adres dat verspringt tussen de twee servers, of één server die zijn adres verliest telkens wanneer de andere vernieuwt.

journald. Persistente journal-bestanden bevinden zich in /var/log/journal/<machine-id>/; vluchtige journals bevinden zich onder /run/log/journal/. De map is letterlijk vernoemd naar de ID. Een collector die journals groepeert op machine ID voegt de identiteiten van de klonen samen; systemd-journal-remote scheidt daarentegen uitvoerbestanden op basis van de hostname of het adres van het bron-eindpunt.

D-Bus. /var/lib/dbus/machine-id is waar dit bestandsformaat is begonnen. Het kan een symlink zijn naar /etc/machine-id of een afzonderlijk echt bestand dat zijn eigen kopie bevat, en die kopie is de valstrik in de onderstaande procedure.

Per-host agents. Monitoring-agents, licentiecontroles, inventarisatietools en back-upclients gebruiken vaak de machine ID als hun standaard host-identifier, omdat deze stabiel is en geen configuratie vereist. Twee servers die één identiteit rapporteren, betekent één samengevoegde metriekreeks, of één licentieplaats die twee machines dekt. Controleer hoe uw agent zijn host ID afleidt in plaats van aan te nemen dat deze de hostname gebruikt.

Hoe u vaststelt of er sprake is van een duplicaat

Voer dit uit op beide servers en vergelijk de uitvoer.

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

cat /etc/machine-id

Identieke machine-ID's op twee actieve servers betekenen dat de ene vanaf de andere is gekloond. hostnamectl toont dezelfde waarde op de Machine ID:-regel als u de voorkeur geeft aan één commando.

Het ls -l-resultaat bepaalt de volgende stap. Een symlink ziet er als volgt uit:

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

ls -l /etc/machine-id

Een regel die begint met -rw-r--r-- betekent dat het een echt bestand is dat zijn eigen kopie van het oude ID bevat. U moet dit verwijderen, omdat systemd-machine-id-setup dit bestand leest voordat het ooit naar de hypervisor UUID of de random generator kijkt.

De product-UUID is ook van belang. systemd-machine-id-setup(1) gebruikt de KVM UUID voordat het terugvalt op willekeurige generatie. Als uw provider beide klonen dus dezelfde SMBIOS (system management BIOS) UUID heeft meegegeven, levert regeneratie vanuit die bron u tweemaal hetzelfde machine-ID op. Verschillende product-UUID's voorkomen die specifieke botsing, maar eerdere ID-bronnen krijgen nog steeds voorrang.

De machine-ID opnieuw genereren op een gekloonde VPS

De volgorde is van belang. systemd-machine-id-setup(1) controleert eerst /run/machine-id, vervolgens een geldige D-Bus machine-ID, daarna de system.machine_id-referentie voordat wordt geprobeerd een geconfigureerde VM- of container-UUID te gebruiken en ten slotte een willekeurige generatie. Laat een echte /var/lib/dbus/machine-id staan; tenzij /run/machine-id voorrang krijgt, genereert u exact de waarde opnieuw waar u vanaf wilde. Als de tool /run/machine-id of een referentie hergebruikt en de ID ongewijzigd blijft, wis dan de machine-ID van de image terwijl deze is afgesloten en start de machine op met unieke identiteitsbronnen.

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

Het eerst afkappen (truncating) is vereist, omdat de tool alleen actie onderneemt wanneer het bestand ontbreekt of leeg is en niets doet met een bestand dat al een geldige ID bevat. systemd-machine-id-setup rapporteert wat het heeft gedaan via de standaardfoutuitvoer (standard error). Op een KVM VPS met systemd 258 of later ziet u het volgende wanneer de hypervisor-UUID wordt geselecteerd:

Initializing machine ID from SMBIOS/DMI UUID.

systemd 255 verwoordt dezelfde stap als Initializing machine ID from VM UUID.. Initializing machine ID from random generator. is de melding wanneer geen eerdere ID-bron bruikbaar is. Beide resultaten zijn in orde, zolang cat /etc/machine-id nu iets anders afdrukt dan op de andere server.

De symbolische link houdt D-Bus en systemd op één waarde. Als u de voorkeur geeft aan een afzonderlijk echt bestand, voer dan sudo dbus-uuidgen --ensure uit in plaats van het commando voor de symbolische link: wanneer het D-Bus-bestand afwezig is, kopieert het de geldige ID van /etc/machine-id. Als /var/lib/dbus afwezig is, faalt ln met No such file or directory en kunt u beide regels overslaan.

Start daarna opnieuw op.

sudo reboot

Waarom een herstart niet optioneel is

Elk proces dat de oude waarde al heeft gelezen, gebruikt deze nog steeds. sd_id128_get_machine() slaat de ID per thread op in een cache: een thread die de waarde al heeft gelezen, blijft de oude waarde retourneren. Alleen een thread die de waarde nog niet heeft opgevraagd, leest het gewijzigde bestand. Een draaiende daemon kan de oude ID dus in zijn bestaande threads vasthouden en de nieuwe pas oppikken in threads die later worden gestart. journald heeft /var/log/journal/<old-id>/system.journal al geopend en blijft hierin schrijven. systemd-networkd heeft zijn DUID bepaald bij de start en blijft bij elke vernieuwing de oude client-identifier sturen; dit is meestal precies de fout die u probeerde te herstellen. D-Bus heeft zijn ID ook bij het opstarten gelezen. U kunt services één voor één herstarten, maar u zult er een missen, en PID 1 houdt de oude waarde eveneens vast.

Controleer na de herstart beide helften:

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

Met persistente logging ingeschakeld, bevat /var/log/journal/ nu een tweede map die is vernoemd naar de nieuwe ID, en nieuwe logboekvermeldingen worden daar opgeslagen. Een standaard journalctl leest alleen de map van de huidige machine, waardoor uw geschiedenis van vóór het klonen verdwijnt uit het standaardoverzicht. Deze staat nog wel op de schijf: journalctl --merge leest elke journal-map, inclusief de oude. Verwijder de oude map zodra u zeker weet dat u die logs niet meer nodig heeft.

Dit is ook de reden waarom een container de verkeerde plek is om de procedure te oefenen. Een container deelt de kernel van de host. Deze kan systemd als zijn eigen PID 1 draaien, maar start nooit een eigen kernel op. Binnen een container gebruikt systemd-machine-id-setup pas een geconfigureerde container-UUID nadat eerdere ID-bronnen zijn mislukt; zonder bruikbare bron genereert deze een willekeurige ID. Test het zoals het in productie gebeurt: kloon een VM, voer de commando's uit, start opnieuw op en vergelijk de ID met die van de bronmachine.

Truncateer vóór de snapshot, niet na het klonen

Het één voor één herstellen van klonen werkt. Het bronimage corrigeren is echter beter, omdat elke server die vanuit een foutieve snapshot wordt hersteld, dezelfde waarde overneemt. Voer dit uit als laatste stap voordat u de template afsluit.

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

Maak het bestand leeg. Verwijder het niet. machine-id(5) adviseert een leeg bestand voor images die op meerdere machines worden gebruikt. Een aanwezig leeg bestand maakt het namelijk mogelijk om een tijdelijk bestand via een bind-mount over het echte bestand te plaatsen wanneer het image in read-only modus wordt gebruikt. Op een read-only /etc verblijft de bij het opstarten gegenereerde ID in dat tijdelijke bestand, en systemd-machine-id-setup --commit schrijft dit weg zodra het bestandssysteem schrijfbaar is.

Een bijwerking hangt af van hoe u het bestand achterlaat. machine-id(5) is expliciet: als /etc/machine-id bestaat en leeg is, wordt een boot niet als de eerste boot beschouwd. Het lege bestand hierboven activeert dus geen units die ConditionFirstBoot=yes bevatten. Een ontbrekend bestand, of een bestand dat de string uninitialized bevat, maakt van de volgende boot wel een eerste boot: die units worden uitgevoerd en systemd past ook de presets voor units toe. Controleer met grep -rl ConditionFirstBoot /usr/lib/systemd/system/ wat uw image zou uitvoeren voordat u de template bouwt.

Een template en een snapshot zijn verschillende objecten, en dit verschil bepaalt of de identiteit wordt gekopieerd. Een template is een build-artifact dat u doelbewust voorbereidt, terwijl een snapshot een kopie op een specifiek tijdstip van één draaiende server is en de identiteit van die server samen met de data overneemt.

Waarom cloud-images dit correct afhandelen en uw snapshot niet

Cloud-images van distributies zijn ontworpen om gekloond te worden. Daarom worden ze geleverd met een leeg machine-ID, dat bij de eerste boot wordt ingevuld. cloud-init bevat een gedocumenteerde stap voor precies dit proces. cloud-init clean --machine-id stelt /etc/machine-id in op de letterlijke tekenreeks uninitialized op systemd-systemen. De cloud-init CLI-referentie beschrijft dit als de best practice bij het klonen van een golden image, zodat de volgende boot van die image een uniek machine-ID genereert.

Een snapshot die u zelf heeft gemaakt, is een ander verhaal. Het bestand was al ingevuld op het moment dat u op snapshot klikte. Elke server die hiervan wordt hersteld, draagt dus diezelfde waarde, tenzij het herstelproces deze expliciet wist of vervangt. Dit is hetzelfde type probleem als het verplaatsen van een draaiende server naar een nieuwe VPS, waarbij de kopie identiek is en de identiteit juist het onderdeel is dat u niet wilde kopiëren.

Wat een kloon nog meer dupliceert

  • SSH host keys. /etc/ssh/ssh_host_* wordt ook gekopieerd, waardoor beide servers dezelfde vingerafdruk aan clients presenteren. Verwijder deze bestanden en voer sudo ssh-keygen -A uit, of sudo dpkg-reconfigure openssh-server op Debian en Ubuntu. Uw clients zullen daarna waarschuwen voor een gewijzigde host key; dit is het juiste gedrag.
  • De hostname. Stel deze in met sudo hostnamectl set-hostname app02 en controleer vervolgens of /etc/hosts de nieuwe naam nog steeds correct omzet.
  • Statische netwerkconfiguratie. Een kloon van een machine met een statisch adres veroorzaakt een conflict met het origineel zodra deze opstart. Lees /etc/netplan/ voordat de kloon verbinding maakt met het netwerk.
  • De klok. Het herstellen van een snapshot inclusief het actieve geheugen kan ertoe leiden dat de klok van de guest achterloopt totdat de guest of hypervisor dit corrigeert. Een grote sprong in de kloktijd op een herstelde VPS verstoort de validatie van TLS-certificaten en brengt de volgorde van logs in de war totdat de tijdsynchronisatie is bijgewerkt.

Doorloop ook de checklist voor de eerste tien minuten van een nieuwe VPS op de kloon. Een gekloonde machine erft de gebruikersaccounts, SSH-keys, firewallregels en geplande taken van de bronmachine over, en niets daarvan is gecontroleerd voor de nieuwe taak die de kloon gaat uitvoeren.

FAQ

Moet ik opnieuw opstarten na het wijzigen van /etc/machine-id?

Ja. Software die de machine-ID al heeft gelezen, behoudt de kopie in de cache, waardoor de nieuwe waarde de relevante onderdelen van een draaiend systeem niet bereikt. journald blijft schrijven naar de journal-map die is vernoemd naar de oude ID, en de DHCP-client blijft een client-identifier sturen die is afgeleid van de oude waarde; dit is meestal de reden waarom u deze heeft gewijzigd. Het herstarten van individuele services lost sommige problemen op, maar PID 1 houdt de oude waarde ook vast. Start opnieuw op en bevestig dit met cat /etc/machine-id en door te vergelijken met de andere server.

Is /etc/machine-id hetzelfde als de hardware-UUID?

Nee. De DMI-product-UUID in /sys/class/dmi/id/product_uuid is afkomstig van de hypervisor en is alleen leesbaar door root. De machine-ID wordt gegenereerd door het besturingssysteem en staat in een tekstbestand dat elke gebruiker kan lezen. Ze zijn in één richting verbonden: op een KVM-guest haalt systemd-machine-id-setup een nieuwe machine-ID uit de hypervisor-UUID wanneer er geen eerdere ID-bron van toepassing is. Als twee klonen dezelfde product-UUID delen en de regeneratie deze gebruikt, zullen ze dezelfde machine-ID genereren. Vergelijk dat bestand dus ook voordat u het resultaat vertrouwt.

Moet ik /etc/machine-id verwijderen of leeg laten?

Laat het bestand leeg wanneer u een image voorbereidt. machine-id(5) geeft de voorkeur aan een leeg bestand, omdat systemd een tijdelijk bestand over het origineel kan mounten (bind-mount) wanneer de image draait met een alleen-lezen /etc. Het verwijderen van het bestand werkt op een beschrijfbaar systeem en sommige kloonscripts doen het op die manier, maar een leeg bestand is de veiligere standaard. cloud-init schrijft het woord uninitialized in het bestand. Die waarde zorgt, net als een ontbrekend bestand, voor een eerste opstart bij de volgende boot, waardoor units met ConditionFirstBoot=yes worden uitgevoerd. Een leeg bestand doet dat niet.

Waarom kregen mijn twee gekloonde servers hetzelfde DHCP-adres?

Omdat beide dezelfde client-identifier stuurden. systemd-networkd gebruikt standaard ClientIdentifier=duid voor DHCPv4, en de standaard DUID is opgebouwd uit een hash van /etc/machine-id. Identieke machine-ID's produceren dus identieke standaard-DUID's. De volledige client-identifiers komen alleen overeen wanneer ook de IAID's gelijk zijn: systemd genereert een IAID op basis van een persistente naam verkregen van udev, met de MAC-adres als fallback wanneer er geen voorspelbare naam beschikbaar is. Het enkel matchen van huidige interfacenamen garandeert dit niet. Wanneer de volledige identifiers overeenkomen, matcht de DHCP-server op die identifier, behandelt beide verzoeken als één client en verstrekt één lease. Geef elke machine een eigen machine-ID en start beide opnieuw op. Als de server nog steeds het oude adres aanbiedt, wis dan de verouderde lease op de DHCP-server zelf.

Was dit artikel nuttig?

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