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

Update

Browse Source
This commit is contained in:
MacRimi 2025-03-04 19:35:06 +01:00
parent d30d497ca0
commit dca2796d92
4 changed files with 76 additions and 127 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -1,9 +1,9 @@
import type { Metadata } from "next"
import { Steps } from "@/components/ui/steps" import { Steps } from "@/components/ui/steps"
import CopyableCode from "@/components/CopyableCode"
export const metadata: Metadata = { export const metadata = {
title: "Repair Network | ProxMenux Documentation", title: "Repair Network | ProxMenux Documentation",
description: "Learn how to repair network configurations in Proxmox VE using ProxMenux.", description: "Step-by-step guide to repair network configurations in Proxmox VE using ProxMenux.",
} }
export default function RepairNetwork() { export default function RepairNetwork() {
@ -12,67 +12,59 @@ 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 Repair Network function is part of the network management script in ProxMenux. It automatically detects and The <strong>Repair Network</strong> function in <strong>ProxMenux</strong> automates the process of detecting and fixing network issues in
fixes common network issues in Proxmox VE systems, ensuring stable connectivity and proper configuration. <strong>Proxmox VE</strong>. It ensures stable connectivity by verifying network configurations, cleaning unused interfaces,
and correcting bridge settings.
</p> </p>
<h2 className="text-2xl font-semibold mt-8 mb-4">What Does Repair Network Do?</h2> <h2 className="text-2xl font-semibold mt-8 mb-4">Overview</h2>
<p className="mb-4">When you select the Repair Network option, the script performs the following actions:</p> <p className="mb-4">The script executes the following steps:</p>
<ol className="list-decimal pl-6 space-y-2 mb-6"> <ol className="list-decimal pl-6 space-y-2 mb-6">
<li>Detects physical network interfaces</li> <li>Detects physical network interfaces.</li>
<li>Cleans up non-existent interfaces from the configuration</li> <li>Cleans up non-existent or unused network interfaces.</li>
<li>Checks and fixes bridge configurations</li> <li>Checks and repairs bridge configurations.</li>
<li>Configures physical interfaces</li> <li>Configures detected physical interfaces.</li>
<li>Offers to restart the networking service</li> <li>Provides an option to restart the network service.</li>
<li>Verifies network connectivity</li> <li>Verifies network connectivity and displays updated IP information.</li>
<li>Displays updated IP information</li>
</ol> </ol>
<h2 className="text-2xl font-semibold mt-8 mb-4">How to Use Repair Network</h2> <h2 className="text-2xl font-semibold mt-8 mb-4">Implementation Steps</h2>
<Steps> <Steps>
<Steps.Step title="Access the Network Repair Menu"> <Steps.Step title="Detect Network Interfaces">
<p>Run the network management script and select the "Network Repair Menu" option.</p> <p>The script scans the system for available network interfaces and identifies the primary physical adapters.</p>
</Steps.Step> </Steps.Step>
<Steps.Step title="Choose Repair Network"> <Steps.Step title="Clean Up Non-Existent Interfaces">
<p>From the menu, select the "Repair Network" option.</p> <p>Removes outdated or missing interfaces from the configuration files to prevent conflicts.</p>
</Steps.Step> </Steps.Step>
<Steps.Step title="Follow the Prompts"> <Steps.Step title="Check and Fix Bridges">
<p>The script will guide you through the repair process with clear prompts and information dialogs.</p> <p>Verifies the bridge network settings and updates them if necessary to ensure correct operation.</p>
</Steps.Step> </Steps.Step>
<Steps.Step title="Review Results"> <Steps.Step title="Configure Physical Interfaces">
<p>After the repair process, review the results displayed in the dialog boxes.</p> <p>Ensures that all detected physical interfaces are properly configured in the network settings.</p>
</Steps.Step> </Steps.Step>
<Steps.Step title="Restart Networking (if prompted)"> <Steps.Step title="Restart Networking">
<p>If prompted, decide whether to restart the networking service to apply changes.</p> <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.Step>
</Steps> </Steps>
<h2 className="text-2xl font-semibold mt-8 mb-4">Key Features of Repair Network</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>Automatic detection and repair of common network issues</li> <li>Network interfaces are correctly detected and configured.</li>
<li>Bridge configuration verification and fixing</li> <li>Unused or missing network configurations are removed.</li>
<li>Cleanup of non-existent interfaces</li> <li>Bridge settings are corrected if necessary.</li>
<li>Automatic configuration of physical interfaces</li> <li>The system maintains a stable and functional network configuration.</li>
<li>Network connectivity check after repairs</li>
<li>Option to restart networking services</li>
<li>Display of updated IP information post-repair</li>
</ul> </ul>
<h2 className="text-2xl font-semibold mt-8 mb-4">Important Notes</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>This function requires root or sudo privileges to execute.</li> <li>Restarting the network service may cause temporary disconnection.</li>
<li>Restarting the network service may cause a brief disconnection.</li> <li>Ensure an alternative access method (such as IPMI or console) in case of network misconfiguration.</li>
<li>Always ensure you have an alternative way to access your Proxmox VE system in case of network issues.</li> <li>It is recommended to back up network configurations before running the script.</li>
<li>It's recommended to create a backup of your network configuration before making changes.</li>
<li>If you're unsure about any step, use the "Verify Network" option first to check the current status.</li>
</ul> </ul>
<p className="mt-6 italic">
The Repair Network function simplifies the process of troubleshooting and fixing network issues in Proxmox VE.
It provides an automated approach to common network maintenance tasks, helping to ensure your Proxmox system
maintains stable connectivity.
</p>
</div> </div>
) )
} }

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

@ -49,28 +49,6 @@ export default function ShowIPInformation() {
<li>Quick and easy access to network configuration information</li> <li>Quick and easy access to network configuration information</li>
<li>Non-intrusive operation (does not make any changes to the system)</li> <li>Non-intrusive operation (does not make any changes to the system)</li>
</ul> </ul>
<h2 className="text-2xl font-semibold mt-8 mb-4">Important Notes</h2>
<ul className="list-disc pl-6 space-y-2 mb-6">
<li>
This function requires root or sudo privileges to execute, as it needs to access system network information.
</li>
<li>
The Show IP Information function only displays current IP configurations; it does not modify any settings.
</li>
<li>This tool is useful for quick network diagnostics and configuration verification.</li>
<li>
If you notice unexpected IP assignments or missing addresses, consider using the "Verify Network" or "Repair
Network" functions.
</li>
</ul>
<p className="mt-6 italic">
The Show IP Information function provides a straightforward way to view your Proxmox VE system's IP
configurations. Use it whenever you need a quick overview of your network interfaces and their associated IP
addresses.
</p>
</div> </div>
) )
} }

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

@ -1,9 +1,9 @@
import type { Metadata } from "next"
import { Steps } from "@/components/ui/steps" import { Steps } from "@/components/ui/steps"
import CopyableCode from "@/components/CopyableCode"
export const metadata: Metadata = { export const metadata = {
title: "Verify Network | ProxMenux Documentation", title: "Verify Network | ProxMenux Documentation",
description: "Learn how to verify network configuration and connectivity in Proxmox VE using ProxMenux.", description: "Step-by-step guide to verify network configuration and connectivity in Proxmox VE using ProxMenux.",
} }
export default function VerifyNetwork() { export default function VerifyNetwork() {
@ -12,64 +12,43 @@ export default function VerifyNetwork() {
<h1 className="text-3xl font-bold mb-6">Verify Network</h1> <h1 className="text-3xl font-bold mb-6">Verify Network</h1>
<p className="mb-4"> <p className="mb-4">
The Verify Network function is part of the network management script in ProxMenux. It checks the current network The <strong>Verify Network</strong> function in ProxMenux allows users to check the current network
configuration and connectivity in Proxmox VE systems, providing a comprehensive overview of the network status. configuration and connectivity in <strong>Proxmox VE</strong>. It provides a quick way to identify potential
network issues and verify that all network interfaces are correctly configured.
</p> </p>
<h2 className="text-2xl font-semibold mt-8 mb-4">What Does Verify Network Do?</h2> <h2 className="text-2xl font-semibold mt-8 mb-4">Overview</h2>
<p className="mb-4">When you select the Verify Network option, the script performs the following actions:</p> <p className="mb-4">When executed, the script performs the following actions:</p>
<ol className="list-decimal pl-6 space-y-2 mb-6"> <ol className="list-decimal pl-6 space-y-2 mb-6">
<li>Detects and lists physical network interfaces</li> <li>Detects and lists all physical network interfaces.</li>
<li>Checks the current IP configuration for all relevant interfaces</li> <li>Retrieves the current IP configuration for each detected interface.</li>
<li>Verifies network connectivity by pinging an external server</li> <li>Verifies network connectivity by testing external server reachability.</li>
<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">How to Use Verify Network</h2> <h2 className="text-2xl font-semibold mt-8 mb-4">Implementation Steps</h2>
<Steps> <Steps>
<Steps.Step title="Access the Network Repair Menu"> <Steps.Step title="Access the Network Repair Menu">
<p>Run the network management script and select the "Network Repair Menu" option.</p> <p>Launch the network management script and navigate to the "Network Repair Menu" option.</p>
</Steps.Step> </Steps.Step>
<Steps.Step title="Choose Verify Network"> <Steps.Step title="Select Verify Network">
<p>From the menu, select the "Verify Network" option.</p> <p>Choose the "Verify Network" option from the menu.</p>
</Steps.Step> </Steps.Step>
<Steps.Step title="Review the Results"> <Steps.Step title="Review Network Details">
<p> <p>The script will display detected interfaces, their IP configurations, and connectivity status.</p>
The script will display information about detected interfaces, IP configurations, and connectivity status.
</p>
</Steps.Step> </Steps.Step>
<Steps.Step title="Interpret the Findings"> <Steps.Step title="Analyze the Findings">
<p> <p>Based on the output, determine if any corrective action is needed, such as using the "Repair Network" function.</p>
Based on the results, determine if any further action is needed (e.g., running the Repair Network function).
</p>
</Steps.Step> </Steps.Step>
</Steps> </Steps>
<h2 className="text-2xl font-semibold mt-8 mb-4">Key Features of Verify Network</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>Detection and listing of physical network interfaces</li> <li>All active network interfaces are detected and displayed.</li>
<li>Display of current IP configurations for all relevant interfaces</li> <li>Current IP configurations are listed for reference.</li>
<li>Network connectivity check to an external server</li> <li>Connectivity to an external server is confirmed or flagged if there is an issue.</li>
<li>Comprehensive summary of the network status</li>
<li>Non-intrusive operation (does not make any changes to the system)</li>
</ul> </ul>
<h2 className="text-2xl font-semibold mt-8 mb-4">Important Notes</h2>
<ul className="list-disc pl-6 space-y-2 mb-6">
<li>
This function requires root or sudo privileges to execute, as it needs to access system network information.
</li>
<li>Verify Network does not make any changes to your system; it only reports the current status.</li>
<li>If issues are detected, consider using the "Repair Network" function to address them.</li>
<li>Regular network verification can help prevent connectivity issues before they become critical.</li>
</ul>
<p className="mt-6 italic">
The Verify Network function provides a quick and easy way to check the status of your Proxmox VE system's
network configuration and connectivity. Use it regularly as part of your system maintenance routine or whenever
you suspect network issues.
</p>
</div> </div>
) )
} }

8
web/app/docs/post-install/basic-settings/page.tsx
View File

@ -117,7 +117,7 @@ export default function BasicSettingsPage() {
<li> <li>
<strong>iftop</strong>: A tool to display bandwidth usage on an interface <strong>iftop</strong>: A tool to display bandwidth usage on an interface
<p className="mt-2">To start iftop (requires root):</p> <p className="mt-2">To start iftop (requires root):</p>
<code className="block bg-gray-100 p-2 rounded">sudo iftop</code> <code className="block bg-gray-100 p-2 rounded">iftop</code>
<img <img
src="https://macrimi.github.io/ProxMenux/basic/iftop.png" src="https://macrimi.github.io/ProxMenux/basic/iftop.png"
alt="iftop Example" alt="iftop Example"
@ -127,7 +127,7 @@ export default function BasicSettingsPage() {
<li> <li>
<strong>iotop</strong>: A tool to display I/O usage by processes <strong>iotop</strong>: A tool to display I/O usage by processes
<p className="mt-2">To start iotop (requires root):</p> <p className="mt-2">To start iotop (requires root):</p>
<code className="block bg-gray-100 p-2 rounded">sudo iotop</code> <code className="block bg-gray-100 p-2 rounded">siotop</code>
<img <img
src="https://macrimi.github.io/ProxMenux/basic/iotop.png" src="https://macrimi.github.io/ProxMenux/basic/iotop.png"
alt="iotop Example" alt="iotop Example"
@ -149,7 +149,7 @@ export default function BasicSettingsPage() {
<li> <li>
<strong>iptraf-ng</strong>: An interactive colorful IP LAN monitor <strong>iptraf-ng</strong>: An interactive colorful IP LAN monitor
<p className="mt-2">To start iptraf-ng:</p> <p className="mt-2">To start iptraf-ng:</p>
<code className="block bg-gray-100 p-2 rounded">sudo iptraf-ng</code> <code className="block bg-gray-100 p-2 rounded">iptraf-ng</code>
<img <img
src="https://macrimi.github.io/ProxMenux/basic/iptraf-ng.png" src="https://macrimi.github.io/ProxMenux/basic/iptraf-ng.png"
alt="iptraf-ng Example" alt="iptraf-ng Example"
@ -164,7 +164,7 @@ export default function BasicSettingsPage() {
<li> <li>
<strong>msr-tools</strong>: Tools for accessing CPU model-specific registers <strong>msr-tools</strong>: Tools for accessing CPU model-specific registers
<p className="mt-2">Example usage (read MSR):</p> <p className="mt-2">Example usage (read MSR):</p>
<code className="block bg-gray-100 p-2 rounded">sudo rdmsr 0x1a0</code> <code className="block bg-gray-100 p-2 rounded">rdmsr 0x1a0</code>
</li> </li>
<li> <li>
<strong>net-tools</strong>: A collection of programs that form the base set of the NET-3 networking distribution for the Linux operating system <strong>net-tools</strong>: A collection of programs that form the base set of the NET-3 networking distribution for the Linux operating system