Mirrors/ProxMenux
1
0
Fork 0
mirror of https://github.com/MacRimi/ProxMenux.git synced 2025-06-28 12:16:53 +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> <h1 className="text-3xl font-bold mb-6">Repair Network</h1>
<p className="mb-4"> <p className="mb-4">
The <strong>Repair Network</strong> function in <strong>ProxMenux</strong> automates the process of detecting and fixing network issues in The <strong>Repair Network</strong> function in <strong>ProxMenux</strong> addresses issues caused by changes in network interface identifiers
<strong>Proxmox VE</strong>. It ensures stable connectivity by verifying network configurations, cleaning unused interfaces, that occur when modifying hardware components such as network adapters or GPUs. This can lead to a loss of
and correcting bridge settings. network connectivity because the system retains old configurations that no longer match the new interface IDs.
</p> </p>
<h2 className="text-2xl font-semibold mt-8 mb-4">Overview</h2> <h2 className="text-2xl font-semibold mt-8 mb-4">Purpose</h2>
<p className="mb-4">The script executes the following steps:</p> <p className="mb-4">
<ol className="list-decimal pl-6 space-y-2 mb-6"> In many cases, when adding or removing hardware (e.g., network cards, GPUs), network interfaces may be renamed
<li>Detects physical network interfaces.</li> due to changes in the system's PCI device enumeration. As a result, Proxmox VE may fail to establish a network
<li>Cleans up non-existent or unused network interfaces.</li> connection because the <code>/etc/network/interfaces</code> file references outdated interface names.
<li>Checks and repairs bridge configurations.</li> </p>
<li>Configures detected physical interfaces.</li> <p className="mb-4">
<li>Provides an option to restart the network service.</li> Restoring a backup of <code>/etc/network/interfaces</code> is not a viable solution, as the IDs of the interfaces have changed. Instead,
<li>Verifies network connectivity and displays updated IP information.</li> the system needs to detect the new identifiers and update the configuration accordingly. <strong>Repair Network</strong>
</ol> 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> <h2 className="text-2xl font-semibold mt-8 mb-4">How It Works</h2>
<Steps> <ul className="list-disc pl-6 space-y-2 mb-6">
<Steps.Step title="Detect Network Interfaces"> <li>Detects the current physical network interfaces and their updated identifiers.</li>
<p>The script scans the system for available network interfaces and identifies the primary physical adapters.</p> <li>Checks the <code>/etc/network/interfaces</code> file for outdated interface names.</li>
</Steps.Step> <li>Replaces incorrect or missing network interface names with the correct ones.</li>
<Steps.Step title="Clean Up Non-Existent Interfaces"> <li>Verifies the integrity of bridge configurations and updates them if necessary.</li>
<p>Removes outdated or missing interfaces from the configuration files to prevent conflicts.</p> <li>Provides an option to restart the network service to apply changes.</li>
</Steps.Step> </ul>
<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">Expected Results</h2> <h2 className="text-2xl font-semibold mt-8 mb-4">Expected Results</h2>
<ul className="list-disc pl-6 space-y-2 mb-6"> <ul className="list-disc pl-6 space-y-2 mb-6">
<li>Network interfaces are correctly detected and configured.</li> <li>Network connectivity is restored automatically without manual intervention.</li>
<li>Unused or missing network configurations are removed.</li> <li>Updated interface names are correctly assigned in <code>/etc/network/interfaces</code>.</li>
<li>Bridge settings are corrected if necessary.</li> <li>Bridges and other network settings remain functional after hardware changes.</li>
<li>The system maintains a stable and functional network configuration.</li>
</ul> </ul>
<h2 className="text-2xl font-semibold mt-8 mb-4">Important Considerations</h2> <h2 className="text-2xl font-semibold mt-8 mb-4">Important Considerations</h2>
<ul className="list-disc pl-6 space-y-2 mb-6"> <ul className="list-disc pl-6 space-y-2 mb-6">
<li>Restarting the network service may cause temporary disconnection.</li> <li>Restarting the network service is recommended to apply the changes.</li>
<li>Ensure an alternative access method (such as IPMI or console) in case of network misconfiguration.</li> <li>This script is useful when network connectivity is lost due to hardware modifications.</li>
<li>It is recommended to back up network configurations before running the script.</li> <li>Having an alternative access method (such as IPMI or console) is advisable in case of unforeseen issues.</li>
</ul> </ul>
</div> </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> <h1 className="text-3xl font-bold mb-6">Show IP Information</h1>
<p className="mb-4"> <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. easy way to view the IP configurations of all relevant network interfaces in your Proxmox VE system.
</p> </p>
@ -25,21 +25,7 @@ export default function ShowIPInformation() {
<li>Indicates if an interface has no IP assigned</li> <li>Indicates if an interface has no IP assigned</li>
</ol> </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> <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"> <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> <li>Displays a summary of the network status.</li>
</ol> </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> <h2 className="text-2xl font-semibold mt-8 mb-4">Expected Results</h2>
<ul className="list-disc pl-6 space-y-2 mb-6"> <ul className="list-disc pl-6 space-y-2 mb-6">