ProxMenux/web/messages/de/docs/network/config-analysis.json

{
  "meta": {
    "title": "Konfigurationsanalyse und geführte Bereinigung | ProxMenux-Dokumentation",
    "description": "Erkennt iface-Blöcke in /etc/network/interfaces, die auf physische NICs verweisen, die nicht mehr auf dem Host vorhanden sind. Meldet sie und bietet eine 5-schrittgesteuerte Entfernung mit obligatorischem Backup und einer Blockvorschau.",
    "ogTitle": "Konfigurationsanalyse und geführte Bereinigung | ProxMenux-Dokumentation",
    "ogDescription": "Finden und entfernen Sie verwaiste Schnittstellenblöcke, die durch Hardwareänderungen zurückgelassen wurden, mit vollständiger Vorschau und Rollback."
  },
  "header": {
    "title": "Konfigurationsanalyse und geführte Bereinigung",
    "description": "Untersucht jeden iface-Block in /etc/network/interfaces und prüft, ob die zugehörige physische Netzwerkkarte noch vorhanden ist. Meldet nach Hardwareänderungen verbliebene verwaiste Blöcke und bietet eine geführte Entfernung mit Backup, Vorschau und Bestätigung für jeden Block.",
    "section": "Netzwerk"
  },
  "intro": {
    "title": "Was das macht",
    "body": "Identifiziert <code>iface</code>-Deklarationen, deren unterstützende NIC nicht mehr auf dem Host vorhanden ist (typisch nach dem Ersetzen oder Entfernen einer Netzwerkkarte). Anschließend wird eine geführte Bereinigung angeboten, bei der <em>nur</em> die verwaisten Blöcke entfernt werden, mit einer Sicherung, einer Vorschau pro Abschnitt und einer expliziten endgültigen Bestätigung."
  },
  "differs": {
    "heading": "Wie es sich von der Brückenanalyse unterscheidet",
    "headerAspect": "Aspekt",
    "headerBridge": "Brückenanalyse",
    "headerConfig": "Konfigurationsanalyse",
    "rows": [
      {
        "aspect": "Untersucht",
        "bridge": "Brücken (<code>vmbrX</code>) und ihre <code>bridge-ports</code>-Linie",
        "config": "Jeder <code>iface</code>-Block (ausgenommen Loopback, Bridges, Bonds)"
      },
      {
        "aspect": "Erkennt",
        "bridge": "Brücken, die auf einen nicht vorhandenen Port verweisen",
        "config": "Standalone-Schnittstellenblöcke für NICs, die nicht existieren"
      },
      {
        "aspect": "Reparaturmaßnahmen",
        "bridge": "Ersetzt den Portnamen in <code>bridge-ports</code>",
        "config": "Entfernen Sie den gesamten <code>iface</code>-Block"
      },
      {
        "aspect": "Ausgenommen sind",
        "bridge": "Nichts – jede Brücke wird analysiert",
        "config": "Bridges (<code>vmbrX</code>) und Bonds (<code>bondX</code>) bleiben immer erhalten, da sie virtuell sind und beim Start vorübergehend fehlen können"
      }
    ],
    "outro": "In der Praxis führen Sie oft beide Werkzeuge in dieser Reihenfolge aus: zuerst <strong>Konfigurationsanalyse</strong>, um verwaiste Blöcke zu entfernen, dann <link>Brückenanalyse</link>, um Bridges, die auf die entfernte Schnittstelle verwiesen, neu zuzuordnen."
  },
  "step1": {
    "heading": "Schritt 1: Analyse (schreibgeschützt)",
    "intro": "Bricht sofort ab, wenn der Host nicht den klassischen Netzwerkstack nutzt. Andernfalls werden alle konfigurierten Schnittstellen außer Loopback mit ihrem Status aufgelistet:",
    "virtTitle": "Virtuelle Schnittstellen sind geschützt",
    "virtBody": "Bridges (<code>vmbrX</code>) und Bonds (<code>bondX</code>) sind virtuelle Konstrukte. Sie können zum Zeitpunkt der Prüfung durchaus fehlen, etwa eine Bridge ohne Ports. Daher schlägt die Analyse nur die Entfernung physischer Netzwerkkarten vor, niemals die dieser virtuellen Schnittstellen."
  },
  "step2": {
    "heading": "Schritt 2: geführte Bereinigung (5 Schritte)",
    "intro": "Wird nur gestartet, wenn Sie der Aufforderung am Ende der Analyse zustimmen. Jeder Schritt muss bestätigt werden; bei Abbruch wird ohne Schreiben beendet.",
    "steps": [
      {
        "title": "1. Sicherheitssicherung",
        "body": "Kopiert <code>/etc/network/interfaces</code> nach <code>/var/backups/proxmenux/interfaces_backup_&lt;TIMESTAMP&gt;</code>. Der Pfad wird vorher und nachher angezeigt.",
        "tone": "blue"
      },
      {
        "title": "2. Bestätigen Sie die Entfernungsliste",
        "body": "Listet genau die zu entfernenden physischen Schnittstellenblöcke auf. Sind die Netzwerkkarten zwischen Analyse und Bereinigung wieder aufgetaucht, etwa nach erneutem Einsetzen einer Karte, endet der Ablauf mit <em>„Keine Bereinigung erforderlich.“</em>",
        "tone": "blue"
      },
      {
        "title": "3. Vorschau der genauen Block(s)",
        "body": "Öffnet eine scrollbare Ansicht jedes <code>iface</code>-Blocks, der gelöscht werden würde, exakt wie in der Datei. Hier können Sie etwa einen wichtigen <code>up</code>-Hook erkennen, den Sie behalten möchten.",
        "tone": "blue"
      },
      {
        "title": "4. Entfernung anwenden",
        "body": "Für jede verwaiste Schnittstelle läuft <code>sed -i \"/^iface $iface/,/^$/d\" /etc/network/interfaces</code>. Das löscht von der passenden <code>iface</code>-Zeile bis zur nächsten leeren Zeile.",
        "tone": "amber"
      },
      {
        "title": "5. Überprüfung",
        "body": "Liest die Datei erneut, listet auf, was entfernt wurde, und überprüft die verbleibenden Schnittstellen erneut. Gibt den Rollback-Befehl aus. Führt <strong>nicht</strong> einen automatischen Neustart des Netzwerks durch. Das Entfernen eines nicht verwendeten Blocks kann sicher beim nächsten Neustart angewendet werden und vermeidet eine Beeinträchtigung des Live-Status.",
        "tone": "emerald"
      }
    ],
    "noRestartTitle": "Startet das Netzwerk nicht automatisch neu",
    "noRestartBody": "Im Gegensatz zur Brückenreparatur bietet der Bereinigungsfluss keinen Neustart des Dienstes. Das Entfernen eines unbenutzten Schnittstellenblocks hat keine unmittelbaren Auswirkungen auf die laufende Konfiguration, so dass ein Neustart unnötig ist und ein unnötiges Verbindungsrisiko darstellt. Die Änderung wird beim nächsten manuellen <code>systemctl restart networking</code> oder beim nächsten Neustart wirksam."
  },
  "caveats": {
    "heading": "Wichtige Vorbehalte",
    "boundaryTitle": "Die Blockgrenze ist die erste leere Linie",
    "boundaryBody": "Das <code>sed</code>-Muster löscht von <code>iface &lt;name&gt;</code> bis zur nächsten leeren Zeile. Fehlt in <code>/etc/network/interfaces</code> eine Leerzeile zwischen Blöcken, was nach manueller Bearbeitung möglich ist, kann auch der nächste Block gelöscht werden. Deshalb ist <strong>Schritt 3 obligatorisch</strong>: Prüfen Sie die Vorschau vor der Bestätigung.",
    "tandemTitle": "Ein Waisen-Iface, das von einer Brücke verwendet wird, wird hier erkannt, nicht in der Brückenanalyse",
    "tandemBody": "Wenn <code>vmbr0</code> <code>bridge-ports enp3s0</code> deklariert und <code>enp3s0</code> einen eigenen Block <code>iface enp3s0 inet manual</code> hat, bleibt nach der Entfernung von <code>enp3s0</code> eine ungültige Referenz in <code>vmbr0</code>. Führen Sie danach die <link>Brückenanalyse</link> aus, um den Bridge-Port neu zuzuordnen oder zu entfernen. Beide Abläufe sind für die gemeinsame Verwendung ausgelegt."
  },
  "troubleshoot": {
    "heading": "Fehlerbehebung",
    "notFoundTitle": "Die Analyse zeigt mein neues NIC als \"NICHT GEFUNDEN\"",
    "notFoundBody": "Der Kernel sieht das Gerät unter einem anderen Namen als in der Datei. Führen Sie <code>ip link show</code> aus, um den tatsächlichen Namen zu erhalten. Dies ist genau der Fall, wenn <link>Persistente Schnittstellennamen</link> das Problem verhindern würden.",
    "tooMuchTitle": "Die Bereinigung hat zu viel entfernt (einen Block, den ich behalten wollte)",
    "tooMuchBody": "Wiederherstellen aus dem in Schritt 5 gedruckten Backup:",
    "tooMuchOutro": "Bearbeiten Sie die Datei von Hand, um eine klare leere Linie zwischen den Blöcken hinzuzufügen, bevor Sie die Bereinigung erneut ausführen, oder entfernen Sie den problematischen Block manuell.",
    "bridgeBreakTitle": "Eine Brücke funktioniert nach dem Aufräumen nicht mehr",
    "bridgeBreakBody": "Die Bridge war auf einen Port angewiesen, dessen <code>iface</code>-Block gerade entfernt wurde. Führen Sie die <link>Brückenanalyse</link> aus; der Vorschlag ordnet der Bridge eine vorhandene physische Schnittstelle zu."
  },
  "related": {
    "heading": "Verwandte Themen",
    "items": [
      {
        "label": "Brückenanalyse und geführte Reparatur",
        "href": "/docs/network/bridge-analysis",
        "tail": " — der natürliche nächste Schritt nach einer Bereinigung."
      },
      {
        "label": "Persistente Schnittstellennamen",
        "href": "/docs/network/persistent-names",
        "tail": " — verhindert, dass sich nach jeder Hardwareänderung verwaiste Blöcke ansammeln."
      },
      {
        "label": "Schnittstellen sichern und neu starten",
        "href": "/docs/network/backup-restore",
        "tail": "- manuelle Snapshots und der Wiederherstellungsbrowser."
      }
    ]
  }
}