diff --git a/CHANGELOG.md b/CHANGELOG.md index 73dd806..54953e3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,30 @@ +## 2025-05-04 + +### Added +- **Interactive Help & Info Menu** + Added a new script called `Help and Info`, which provides an interactive command reference menu for Proxmox VE through a dialog-based interface. + This tool offers users a quick way to browse and copy useful commands for managing and maintaining their Proxmox server, all in one centralized location. + +  + + *Figure 1: Help and Info interactive command reference menu.* + +- **Uninstaller for Post-Install Utilities** + A new script has been added to the **Post-Installation** menu, allowing users to uninstall utilities or packages that were previously installed through the post-install script. + +### Improved +- **Utility Selection Menu in Post-Installation Script** + The `Install Common System Utilities` section now includes a menu where users can choose which utilities to install, instead of installing all by default. This gives more control over what gets added to the system. + +- **Old PV Header Detection and Auto-Fix** + After updating the system, the post-update script now includes a security check for physical disks with outdated LVM PV (Physical Volume) headers. + This issue can occur when virtual machines have passthrough access to disks and unintentionally modify volume metadata. The script now detects and automatically updates these headers. + If any error occurs during the process, a warning is shown to the user. + +- **Faster Translations in Menus** + Several post-installation menus with auto-translations have been optimized to reduce loading times and improve user experience. + + ## 2025-04-14 ### Added diff --git a/web/app/docs/help-info/page.tsx b/web/app/docs/help-info/page.tsx index 918eb13..3b3472c 100644 --- a/web/app/docs/help-info/page.tsx +++ b/web/app/docs/help-info/page.tsx @@ -16,6 +16,36 @@ import { Book, } from "lucide-react" + +export const metadata: Metadata = { + title: "ProxMenux Documentation: Help and Info", + description: + "Comprehensive collection of useful commands and references for Proxmox VE, organized by category for easy access and quick reference.", + openGraph: { + title: "ProxMenux Documentation: Help and Info", + description: + "Comprehensive collection of useful commands and references for Proxmox VE, organized by category for easy access and quick reference.", + type: "article", + url: "https://macrimi.github.io/ProxMenux/docs/help-info", + images: [ + { + url: "https://macrimi.github.io/ProxMenux/help/help-info-menu.png", + width: 1200, + height: 630, + alt: "ProxMenux Help and Info Menu", + }, + ], + }, + twitter: { + card: "summary_large_image", + title: "ProxMenux Documentation: Help and Info", + description: + "Comprehensive collection of useful commands and references for Proxmox VE, organized by category for easy access and quick reference.", + images: ["https://macrimi.github.io/ProxMenux/help/help-info-menu.png"], + }, +} + + interface ImageWithCaptionProps { src: string alt: string diff --git a/web/app/docs/post-install/basic-settings/page.tsx b/web/app/docs/post-install/basic-settings/page.tsx index 865cd17..346c02f 100644 --- a/web/app/docs/post-install/basic-settings/page.tsx +++ b/web/app/docs/post-install/basic-settings/page.tsx @@ -54,19 +54,23 @@ export default function BasicSettingsPage() {
- This optimization installs a set of common system utilities that are useful for system administration and - troubleshooting. + This option presents a menu where you can select which system utilities to install based on your needs.
-- Why it's beneficial: - Having these utilities pre-installed saves time when managing your Proxmox - VE system. They provide essential tools for monitoring system performance, managing files, and troubleshooting - issues, enhancing your ability to maintain and optimize your virtualization environment. -
-The utilities selection menu allows you to choose which tools to install
+This optimization updates the system's package lists, upgrades installed packages, and configures Proxmox - repositories. It also includes additional steps to properly set up Debian repositories and disable certain - warnings. + repositories. It also includes additional steps to properly set up Debian repositories, disable certain + warnings, and perform safety checks after the update process.
Why it's beneficial: Keeping your system up-to-date is essential for security, stability, and performance. This optimization ensures you have the latest patches and features, while also configuring the - correct repositories for Proxmox VE, enabling access to necessary updates and tools. + correct repositories for Proxmox VE, enabling access to necessary updates and tools. The disk metadata check helps prevent potential issues with storage devices that may have been modified by virtual machines.
- All of these optimizations are automatically applied when selected in the Basic Settings section. This - automation ensures that these beneficial settings are applied consistently and correctly, saving time and - reducing the potential for human error during manual configuration. + `} +/> +
+ After updating the system, the script performs an important safety check to detect disks with old PV (Physical Volume) headers that might have been modified by virtual machines.
- ++ Why this matters: When VMs have direct access to disks through passthrough, they can sometimes modify the disk metadata. This can cause issues with storage management on the host system, potentially leading to data access problems or errors when using LVM (Logical Volume Manager). +
+
+ If any issues are detected, the script will display a warning message and suggest running the pvs
command to identify the affected disks. This early detection helps prevent potential storage problems before they impact your system.
+
- The Customizable Post-Install Script is a utility designed to optimize - the installation of Proxmox VE by adjusting system configurations. One of the advantages of - its modular and selectable structure is that it allows users to choose specific settings based on - their requirements, needs, and preferences. + The Customizable Post-Install Script is a utility designed to optimize the installation of + Proxmox VE by adjusting system configurations. One of the advantages of its modular and selectable structure is + that it allows users to choose specific settings based on their requirements, needs, and preferences.
- This script is primarily based on the work of{" "} - - extremeshok – Scripts for working with and optimizing Proxmox - {" "} - and the{" "} - - Proxmox VE Post Install script from Proxmox VE Helper-Scripts - . + This script is primarily based on the work of{" "} + + extremeshok – Scripts for working with and optimizing Proxmox + {" "} + and the{" "} + + Proxmox VE Post Install script from Proxmox VE Helper-Scripts + + . +
++ This script includes {categories.length} main categories, each targeting a key aspect of Proxmox VE performance, + security, and usability:
-This script includes {categories.length} main categories, each targeting a key aspect of Proxmox VE - performance, security, and usability:
+
Each category includes selectable options, ensuring that users can tailor the system adjustments to their specific needs without applying unnecessary modifications. Click on a category to explore available settings.
-Uninstall Option
++ The Post-Install Menu Script now includes an option to uninstall packages and utilities that were previously + installed by the script. This feature allows you to: +
+Important: Avoid Running Multiple Post-Install Scripts
- It is not recommended to use different post-installation scripts, as this can cause conflicts by overwriting or duplicating files and settings. + It is not recommended to use different post-installation scripts, as this can cause conflicts by overwriting + or duplicating files and settings.