From 77ef11ea97a11c70c09ca9b82b1c4cefdc5585e2 Mon Sep 17 00:00:00 2001
From: MacRimi <ricoextincion@gmail.com>
Date: Tue, 4 Mar 2025 19:53:06 +0100
Subject: [PATCH] Update

---
 web/app/docs/network/repair-network/page.tsx  | 69 ++++++++-----------
 .../docs/network/show-ip-information/page.tsx | 18 +----
 web/app/docs/network/verify-network/page.tsx  | 15 ----
 3 files changed, 30 insertions(+), 72 deletions(-)

diff --git a/web/app/docs/network/repair-network/page.tsx b/web/app/docs/network/repair-network/page.tsx
index 146db52..f3dc146 100644
--- a/web/app/docs/network/repair-network/page.tsx
+++ b/web/app/docs/network/repair-network/page.tsx
@@ -12,57 +12,44 @@ export default function RepairNetwork() {
       <h1 className="text-3xl font-bold mb-6">Repair Network</h1>
       
       <p className="mb-4">
-        The <strong>Repair Network</strong> function in <strong>ProxMenux</strong> automates the process of detecting and fixing network issues in
-        <strong>Proxmox VE</strong>. It ensures stable connectivity by verifying network configurations, cleaning unused interfaces,
-        and correcting bridge settings.
+        The <strong>Repair Network</strong> function in <strong>ProxMenux</strong> addresses issues caused by changes in network interface identifiers
+        that occur when modifying hardware components such as network adapters or GPUs. This can lead to a loss of
+        network connectivity because the system retains old configurations that no longer match the new interface IDs.
       </p>
       
-      <h2 className="text-2xl font-semibold mt-8 mb-4">Overview</h2>
-      <p className="mb-4">The script executes the following steps:</p>
-      <ol className="list-decimal pl-6 space-y-2 mb-6">
-        <li>Detects physical network interfaces.</li>
-        <li>Cleans up non-existent or unused network interfaces.</li>
-        <li>Checks and repairs bridge configurations.</li>
-        <li>Configures detected physical interfaces.</li>
-        <li>Provides an option to restart the network service.</li>
-        <li>Verifies network connectivity and displays updated IP information.</li>
-      </ol>
+      <h2 className="text-2xl font-semibold mt-8 mb-4">Purpose</h2>
+      <p className="mb-4">
+        In many cases, when adding or removing hardware (e.g., network cards, GPUs), network interfaces may be renamed
+        due to changes in the system's PCI device enumeration. As a result, Proxmox VE may fail to establish a network
+        connection because the <code>/etc/network/interfaces</code> file references outdated interface names.
+      </p>
+      <p className="mb-4">
+        Restoring a backup of <code>/etc/network/interfaces</code> is not a viable solution, as the IDs of the interfaces have changed. Instead,
+        the system needs to detect the new identifiers and update the configuration accordingly. <strong>Repair Network</strong>
+        automates this process by identifying the correct interface names and applying the necessary corrections.
+      </p>
       
-      <h2 className="text-2xl font-semibold mt-8 mb-4">Implementation Steps</h2>
-      <Steps>
-        <Steps.Step title="Detect Network Interfaces">
-          <p>The script scans the system for available network interfaces and identifies the primary physical adapters.</p>
-        </Steps.Step>
-        <Steps.Step title="Clean Up Non-Existent Interfaces">
-          <p>Removes outdated or missing interfaces from the configuration files to prevent conflicts.</p>
-        </Steps.Step>
-        <Steps.Step title="Check and Fix Bridges">
-          <p>Verifies the bridge network settings and updates them if necessary to ensure correct operation.</p>
-        </Steps.Step>
-        <Steps.Step title="Configure Physical Interfaces">
-          <p>Ensures that all detected physical interfaces are properly configured in the network settings.</p>
-        </Steps.Step>
-        <Steps.Step title="Restart Networking">
-          <p>If necessary, the script prompts the user to restart the network service to apply changes.</p>
-        </Steps.Step>
-        <Steps.Step title="Verify Network Connectivity">
-          <p>Performs a final connectivity check and displays updated network information.</p>
-        </Steps.Step>
-      </Steps>
+      <h2 className="text-2xl font-semibold mt-8 mb-4">How It Works</h2>
+      <ul className="list-disc pl-6 space-y-2 mb-6">
+        <li>Detects the current physical network interfaces and their updated identifiers.</li>
+        <li>Checks the <code>/etc/network/interfaces</code> file for outdated interface names.</li>
+        <li>Replaces incorrect or missing network interface names with the correct ones.</li>
+        <li>Verifies the integrity of bridge configurations and updates them if necessary.</li>
+        <li>Provides an option to restart the network service to apply changes.</li>
+      </ul>
       
       <h2 className="text-2xl font-semibold mt-8 mb-4">Expected Results</h2>
       <ul className="list-disc pl-6 space-y-2 mb-6">
-        <li>Network interfaces are correctly detected and configured.</li>
-        <li>Unused or missing network configurations are removed.</li>
-        <li>Bridge settings are corrected if necessary.</li>
-        <li>The system maintains a stable and functional network configuration.</li>
+        <li>Network connectivity is restored automatically without manual intervention.</li>
+        <li>Updated interface names are correctly assigned in <code>/etc/network/interfaces</code>.</li>
+        <li>Bridges and other network settings remain functional after hardware changes.</li>
       </ul>
       
       <h2 className="text-2xl font-semibold mt-8 mb-4">Important Considerations</h2>
       <ul className="list-disc pl-6 space-y-2 mb-6">
-        <li>Restarting the network service may cause temporary disconnection.</li>
-        <li>Ensure an alternative access method (such as IPMI or console) in case of network misconfiguration.</li>
-        <li>It is recommended to back up network configurations before running the script.</li>
+        <li>Restarting the network service is recommended to apply the changes.</li>
+        <li>This script is useful when network connectivity is lost due to hardware modifications.</li>
+        <li>Having an alternative access method (such as IPMI or console) is advisable in case of unforeseen issues.</li>
       </ul>
       
     </div>
diff --git a/web/app/docs/network/show-ip-information/page.tsx b/web/app/docs/network/show-ip-information/page.tsx
index e6ecb03..86aa7b3 100644
--- a/web/app/docs/network/show-ip-information/page.tsx
+++ b/web/app/docs/network/show-ip-information/page.tsx
@@ -12,7 +12,7 @@ export default function ShowIPInformation() {
       <h1 className="text-3xl font-bold mb-6">Show IP Information</h1>
 
       <p className="mb-4">
-        The Show IP Information function is part of the network management script in ProxMenux. It provides a quick and
+        The Show IP Information function it provides a quick and
         easy way to view the IP configurations of all relevant network interfaces in your Proxmox VE system.
       </p>
 
@@ -25,21 +25,7 @@ export default function ShowIPInformation() {
         <li>Indicates if an interface has no IP assigned</li>
       </ol>
 
-      <h2 className="text-2xl font-semibold mt-8 mb-4">How to Use Show IP Information</h2>
-      <Steps>
-        <Steps.Step title="Access the Network Repair Menu">
-          <p>Run the network management script and select the "Network Repair Menu" option.</p>
-        </Steps.Step>
-        <Steps.Step title="Choose Show IP Information">
-          <p>From the menu, select the "Show IP Information" option.</p>
-        </Steps.Step>
-        <Steps.Step title="Review the IP Information">
-          <p>The script will display a list of all detected interfaces and their IP addresses.</p>
-        </Steps.Step>
-        <Steps.Step title="Interpret the Results">
-          <p>Use this information to verify IP assignments or troubleshoot network issues.</p>
-        </Steps.Step>
-      </Steps>
+
 
       <h2 className="text-2xl font-semibold mt-8 mb-4">Key Features of Show IP Information</h2>
       <ul className="list-disc pl-6 space-y-2 mb-6">
diff --git a/web/app/docs/network/verify-network/page.tsx b/web/app/docs/network/verify-network/page.tsx
index 942b6ab..91624d9 100644
--- a/web/app/docs/network/verify-network/page.tsx
+++ b/web/app/docs/network/verify-network/page.tsx
@@ -26,21 +26,6 @@ export default function VerifyNetwork() {
         <li>Displays a summary of the network status.</li>
       </ol>
       
-      <h2 className="text-2xl font-semibold mt-8 mb-4">Implementation Steps</h2>
-      <Steps>
-        <Steps.Step title="Access the Network Repair Menu">
-          <p>Launch the network management script and navigate to the "Network Repair Menu" option.</p>
-        </Steps.Step>
-        <Steps.Step title="Select Verify Network">
-          <p>Choose the "Verify Network" option from the menu.</p>
-        </Steps.Step>
-        <Steps.Step title="Review Network Details">
-          <p>The script will display detected interfaces, their IP configurations, and connectivity status.</p>
-        </Steps.Step>
-        <Steps.Step title="Analyze the Findings">
-          <p>Based on the output, determine if any corrective action is needed, such as using the "Repair Network" function.</p>
-        </Steps.Step>
-      </Steps>
       
       <h2 className="text-2xl font-semibold mt-8 mb-4">Expected Results</h2>
       <ul className="list-disc pl-6 space-y-2 mb-6">