Mirrors/ProxMenux
1
0
Fork 0
mirror of https://github.com/MacRimi/ProxMenux.git synced 2025-06-28 04:06:54 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update

Browse Source
This commit is contained in:
MacRimi 2025-03-04 19:53:06 +01:00
parent dca2796d92
commit 77ef11ea97
3 changed files with 30 additions and 72 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

69
web/app/docs/network/repair-network/page.tsx
View File

@ -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>

18
web/app/docs/network/show-ip-information/page.tsx
View File

@ -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">

15
web/app/docs/network/verify-network/page.tsx
View File

@ -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">