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

View File

@ -1,78 +1,70 @@
import type { Metadata } from "next"
import { Steps } from "@/components/ui/steps"
import CopyableCode from "@/components/CopyableCode"
export const metadata: Metadata = {
export const metadata = {
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() {
return (
<div className="max-w-3xl mx-auto">
<h1 className="text-3xl font-bold mb-6">Repair Network</h1>
<p className="mb-4">
The Repair Network function is part of the network management script in ProxMenux. It automatically detects and
fixes common network issues in Proxmox VE systems, ensuring stable connectivity and proper configuration.
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.
</p>
<h2 className="text-2xl font-semibold mt-8 mb-4">What Does Repair Network Do?</h2>
<p className="mb-4">When you select the Repair Network option, the script performs the following actions:</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 interfaces from the configuration</li>
<li>Checks and fixes bridge configurations</li>
<li>Configures physical interfaces</li>
<li>Offers to restart the networking service</li>
<li>Verifies network connectivity</li>
<li>Displays updated IP information</li>
<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">How to Use Repair Network</h2>
<h2 className="text-2xl font-semibold mt-8 mb-4">Implementation Steps</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 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="Choose Repair Network">
<p>From the menu, select the "Repair Network" option.</p>
<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="Follow the Prompts">
<p>The script will guide you through the repair process with clear prompts and information dialogs.</p>
<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="Review Results">
<p>After the repair process, review the results displayed in the dialog boxes.</p>
<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 (if prompted)">
<p>If prompted, decide whether to restart the networking service to apply changes.</p>
<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">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">
<li>Automatic detection and repair of common network issues</li>
<li>Bridge configuration verification and fixing</li>
<li>Cleanup of non-existent interfaces</li>
<li>Automatic configuration of physical interfaces</li>
<li>Network connectivity check after repairs</li>
<li>Option to restart networking services</li>
<li>Display of updated IP information post-repair</li>
<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>
</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">
<li>This function requires root or sudo privileges to execute.</li>
<li>Restarting the network service may cause a brief disconnection.</li>
<li>Always ensure you have an alternative way to access your Proxmox VE system in case of network issues.</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>
<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>
</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>
)
}

View File

@ -49,28 +49,6 @@ export default function ShowIPInformation() {
<li>Quick and easy access to network configuration information</li>
<li>Non-intrusive operation (does not make any changes to the system)</li>
</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>
)
}

View File

@ -1,75 +1,54 @@
import type { Metadata } from "next"
import { Steps } from "@/components/ui/steps"
import CopyableCode from "@/components/CopyableCode"
export const metadata: Metadata = {
export const metadata = {
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() {
return (
<div className="max-w-3xl mx-auto">
<h1 className="text-3xl font-bold mb-6">Verify Network</h1>
<p className="mb-4">
The Verify Network function is part of the network management script in ProxMenux. It checks the current network
configuration and connectivity in Proxmox VE systems, providing a comprehensive overview of the network status.
The <strong>Verify Network</strong> function in ProxMenux allows users to check the current network
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>
<h2 className="text-2xl font-semibold mt-8 mb-4">What Does Verify Network Do?</h2>
<p className="mb-4">When you select the Verify Network option, the script performs the following actions:</p>
<h2 className="text-2xl font-semibold mt-8 mb-4">Overview</h2>
<p className="mb-4">When executed, the script performs the following actions:</p>
<ol className="list-decimal pl-6 space-y-2 mb-6">
<li>Detects and lists physical network interfaces</li>
<li>Checks the current IP configuration for all relevant interfaces</li>
<li>Verifies network connectivity by pinging an external server</li>
<li>Displays a summary of the network status</li>
<li>Detects and lists all physical network interfaces.</li>
<li>Retrieves the current IP configuration for each detected interface.</li>
<li>Verifies network connectivity by testing external server reachability.</li>
<li>Displays a summary of the network status.</li>
</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.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 title="Choose Verify Network">
<p>From the menu, select the "Verify Network" option.</p>
<Steps.Step title="Select Verify Network">
<p>Choose the "Verify Network" option from the menu.</p>
</Steps.Step>
<Steps.Step title="Review the Results">
<p>
The script will display information about detected interfaces, IP configurations, and connectivity status.
</p>
<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="Interpret the Findings">
<p>
Based on the results, determine if any further action is needed (e.g., running the Repair Network function).
</p>
<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">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">
<li>Detection and listing of physical network interfaces</li>
<li>Display of current IP configurations for all relevant interfaces</li>
<li>Network connectivity check to an external server</li>
<li>Comprehensive summary of the network status</li>
<li>Non-intrusive operation (does not make any changes to the system)</li>
<li>All active network interfaces are detected and displayed.</li>
<li>Current IP configurations are listed for reference.</li>
<li>Connectivity to an external server is confirmed or flagged if there is an issue.</li>
</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>
)
}

View File

@ -117,7 +117,7 @@ export default function BasicSettingsPage() {
<li>
<strong>iftop</strong>: A tool to display bandwidth usage on an interface
<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
src="https://macrimi.github.io/ProxMenux/basic/iftop.png"
alt="iftop Example"
@ -127,7 +127,7 @@ export default function BasicSettingsPage() {
<li>
<strong>iotop</strong>: A tool to display I/O usage by processes
<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
src="https://macrimi.github.io/ProxMenux/basic/iotop.png"
alt="iotop Example"
@ -149,7 +149,7 @@ export default function BasicSettingsPage() {
<li>
<strong>iptraf-ng</strong>: An interactive colorful IP LAN monitor
<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
src="https://macrimi.github.io/ProxMenux/basic/iptraf-ng.png"
alt="iptraf-ng Example"
@ -164,7 +164,7 @@ export default function BasicSettingsPage() {
<li>
<strong>msr-tools</strong>: Tools for accessing CPU model-specific registers
<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>
<strong>net-tools</strong>: A collection of programs that form the base set of the NET-3 networking distribution for the Linux operating system