Mirrors/ProxMenux
1
0
Fork 0
mirror of https://github.com/MacRimi/ProxMenux.git synced 2025-08-25 13:51:15 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update

Browse Source
This commit is contained in:
MacRimi
2025-03-02 00:44:16 +01:00
parent ce460e6b45
commit b3b3df01ea
4 changed files with 256 additions and 160 deletions
Download Patch File Download Diff File Expand all files Collapse all files

201
web/app/docs/post-install/virtualization/page.tsx
View File

@@ -1,5 +1,5 @@
import type { Metadata } from "next"
import { Box } from 'lucide-react'
import { Box } from "lucide-react"
import CopyableCode from "@/components/CopyableCode"
export const metadata: Metadata = {
@@ -30,6 +30,14 @@ export const metadata: Metadata = {
},
}
function StepNumber({ number }: { number: number }) {
return (
<div className="inline-flex items-center justify-center w-8 h-8 mr-3 text-white bg-blue-500 rounded-full">
<span className="text-sm font-bold">{number}</span>
</div>
)
}
export default function VirtualizationSettingsPage() {
return (
<div className="container mx-auto px-4 py-8">
@@ -38,22 +46,30 @@ export default function VirtualizationSettingsPage() {
<h1 className="text-3xl font-bold">Virtualization Settings</h1>
</div>
<p className="mb-4">
The <strong>Virtualization Settings</strong> category focuses on optimizing your
Proxmox VE installation for enhanced virtualization performance, compatibility, and functionality. These settings
are crucial for creating a robust and efficient virtualization environment.
The <strong>Virtualization Settings</strong> category focuses on optimizing your Proxmox VE installation for
enhanced virtualization performance, compatibility, and functionality. These settings are crucial for creating a
robust and efficient virtualization environment.
</p>
<h2 className="text-2xl font-semibold mt-8 mb-4">Available Optimizations</h2>
<section className="mb-8">
<h3 className="text-xl font-semibold mb-2">Enable VFIO IOMMU Support</h3>
<p className="mb-4">
This optimization enables IOMMU (Input-Output Memory Management Unit) and configures VFIO (Virtual Function I/O) for PCI passthrough, allowing direct assignment of PCI devices to virtual machines.
</p>
<p className="mb-4">
<strong>Why it's important:</strong> IOMMU and VFIO support enables near-native performance for PCI devices (like GPUs or network cards) in virtual machines. This is crucial for high-performance virtualization scenarios, such as GPU-accelerated workloads or network-intensive applications. It allows VMs to directly access hardware, bypassing the hypervisor, which significantly improves performance and reduces latency.
</p>
<h4 className="text-lg font-semibold mb-2">To apply this setting manually, run:</h4>
<CopyableCode code={`# For Intel CPUs
<h3 className="text-xl font-semibold mt-16 mb-4 flex items-center">
<StepNumber number={1} />
Enable VFIO IOMMU Support
</h3>
<p className="mb-4">
This optimization enables IOMMU (Input-Output Memory Management Unit) and configures VFIO (Virtual Function I/O)
for PCI passthrough, allowing direct assignment of PCI devices to virtual machines.
</p>
<p className="mb-4">
<strong>Why it's beneficial:</strong> IOMMU and VFIO support enables near-native performance for PCI devices
(like GPUs or network cards) in virtual machines. This is crucial for high-performance virtualization scenarios,
such as GPU-accelerated workloads or network-intensive applications. It allows VMs to directly access hardware,
bypassing the hypervisor, which significantly improves performance and reduces latency.
</p>
<p className="text-lg font-semibold mb-2">This adjustment automates the following commands:</p>
<CopyableCode
code={`
# For Intel CPUs
echo "intel_iommu=on" | sudo tee -a /etc/default/grub
# For AMD CPUs
echo "amd_iommu=on" | sudo tee -a /etc/default/grub
@@ -61,84 +77,121 @@ echo "amd_iommu=on" | sudo tee -a /etc/default/grub
echo "vfio vfio_iommu_type1 vfio_pci vfio_virqfd" | sudo tee -a /etc/modules
sudo update-grub
sudo update-initramfs -u -k all`} />
</section>
sudo update-initramfs -u -k all
`}
/>
<section className="mb-8">
<h3 className="text-xl font-semibold mb-2">Install Relevant Guest Agent</h3>
<p className="mb-4">
This optimization detects the virtualization environment and installs the appropriate guest agent for improved integration between the host and guest systems.
</p>
<p className="mb-4">
<strong>Why it's important:</strong> Guest agents improve communication and integration between the host and guest systems. They enable features like graceful shutdown of virtual machines, file sharing between host and guest, better performance monitoring, and enhanced resource allocation. This leads to more efficient management of VMs and improved overall system performance.
</p>
<h4 className="text-lg font-semibold mb-2">To apply this setting manually, run:</h4>
<CopyableCode code={`# For QEMU/KVM VMs
<h3 className="text-xl font-semibold mt-16 mb-4 flex items-center">
<StepNumber number={2} />
Install Relevant Guest Agent
</h3>
<p className="mb-4">
This optimization detects the virtualization environment and installs the appropriate guest agent for improved
integration between the host and guest systems.
</p>
<p className="mb-4">
<strong>Why it's beneficial:</strong> Guest agents improve communication and integration between the host and
guest systems. They enable features like graceful shutdown of virtual machines, file sharing between host and
guest, better performance monitoring, and enhanced resource allocation. This leads to more efficient management
of VMs and improved overall system performance.
</p>
<p className="text-lg mb-2">This adjustment automates the following commands:</p>
<CopyableCode
code={`
# For QEMU/KVM VMs
sudo apt-get install -y qemu-guest-agent
# For VMware VMs
sudo apt-get install -y open-vm-tools
# For VirtualBox VMs
sudo apt-get install -y virtualbox-guest-utils`} />
</section>
<section className="mb-8">
<h3 className="text-xl font-semibold mb-2">Configure KSM (Kernel Samepage Merging)</h3>
<p className="mb-4">
This optimization installs and configures the KSM control daemon, which helps optimize memory usage in virtualized environments by sharing identical memory pages between multiple virtual machines.
</p>
<p className="mb-4">
<strong>Why it's important:</strong> KSM can significantly reduce memory usage in environments with many similar VMs, allowing for higher VM density on a single host. This is particularly beneficial for scenarios where many VMs run similar operating systems or applications. By reducing overall memory usage, KSM can improve system performance and allow for more efficient resource utilization.
</p>
<h4 className="text-lg font-semibold mb-2">To apply this setting manually, run:</h4>
<CopyableCode code={`sudo apt-get install -y ksm-control-daemon
sudo apt-get install -y virtualbox-guest-utils
`}
/>
<h3 className="text-xl font-semibold mt-20 mb-4 flex items-center">
<StepNumber number={3} />
Configure KSM (Kernel Samepage Merging)
</h3>
<p className="mb-4">
This optimization installs and configures the KSM control daemon, which helps optimize memory usage in
virtualized environments by sharing identical memory pages between multiple virtual machines.
</p>
<p className="mb-4">
<strong>Why it's beneficial:</strong> KSM can significantly reduce memory usage in environments with many
similar VMs, allowing for higher VM density on a single host. This is particularly beneficial for scenarios
where many VMs run similar operating systems or applications. By reducing overall memory usage, KSM can improve
system performance and allow for more efficient resource utilization.
</p>
<p className="text-lg font-semibold mb-2">This adjustment automates the following commands:</p>
<CopyableCode
code={`
sudo apt-get install -y ksm-control-daemon
echo "KSM_ENABLED=1" | sudo tee -a /etc/default/ksm
echo "KSM_SLEEP_MSEC=100" | sudo tee -a /etc/default/ksm
sudo systemctl enable ksm
sudo systemctl start ksm`} />
</section>
<section className="mb-8">
<h3 className="text-xl font-semibold mb-2">Optimize CPU Governor</h3>
<p className="mb-4">
This setting configures the CPU governor to optimize performance for virtualization workloads.
</p>
<p className="mb-4">
<strong>Why it's important:</strong> The CPU governor controls how the processor scales its frequency based on system load. For virtualization environments, setting the governor to 'performance' ensures that the CPU always runs at its maximum frequency, providing consistent performance for VMs. This is crucial for workloads that require predictable and high CPU performance.
</p>
<h4 className="text-lg font-semibold mb-2">To apply this setting manually, run:</h4>
<CopyableCode code={`sudo apt-get install -y cpufrequtils
sudo systemctl start ksm
`}
/>
<h3 className="text-xl font-semibold mt-20 mb-4 flex items-center">
<StepNumber number={4} />
Optimize CPU Governor
</h3>
<p className="mb-4">
This setting configures the CPU governor to optimize performance for virtualization workloads.
</p>
<p className="mb-4">
<strong>Why it's beneficial:</strong> The CPU governor controls how the processor scales its frequency based on
system load. For virtualization environments, setting the governor to 'performance' ensures that the CPU always
runs at its maximum frequency, providing consistent performance for VMs. This is crucial for workloads that
require predictable and high CPU performance.
</p>
<p className="text-lg mb-2">This adjustment automates the following commands:</p>
<CopyableCode
code={`
sudo apt-get install -y cpufrequtils
echo 'GOVERNOR="performance"' | sudo tee /etc/default/cpufrequtils
sudo systemctl restart cpufrequtils`} />
</section>
<section className="mb-8">
<h3 className="text-xl font-semibold mb-2">Enable Huge Pages Support</h3>
<p className="mb-4">
This optimization enables and configures huge pages support, which can improve memory management efficiency for large-memory VMs.
</p>
<p className="mb-4">
<strong>Why it's important:</strong> Huge pages reduce the overhead of Translation Lookaside Buffer (TLB) lookups, which can significantly improve performance for memory-intensive applications running in VMs. This is particularly beneficial for databases, in-memory caches, and other applications that manage large amounts of memory.
</p>
<h4 className="text-lg font-semibold mb-2">To apply this setting manually, run:</h4>
<CopyableCode code={`echo "vm.nr_hugepages = 1024" | sudo tee -a /etc/sysctl.conf
sudo systemctl restart cpufrequtils
`}
/>
<h3 className="text-xl font-semibold mt-20 mb-4 flex items-center">
<StepNumber number={5} />
Enable Huge Pages Support
</h3>
<p className="mb-4">
This optimization enables and configures huge pages support, which can improve memory management efficiency for
large-memory VMs.
</p>
<p className="mb-4">
<strong>Why it's beneficial:</strong> Huge pages reduce the overhead of Translation Lookaside Buffer (TLB)
lookups, which can significantly improve performance for memory-intensive applications running in VMs. This is
particularly beneficial for databases, in-memory caches, and other applications that manage large amounts of
memory.
</p>
<p className="text-lg font-semibold mb-2">This adjustment automates the following commands:</p>
<CopyableCode
code={`
echo "vm.nr_hugepages = 1024" | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
echo "hugetlbfs /dev/hugepages hugetlbfs defaults 0 0" | sudo tee -a /etc/fstab
sudo mount -a`} />
</section>
sudo mount -a
`}
/>
<section className="mt-12 p-4 bg-blue-100 rounded-md">
<h2 className="text-xl font-semibold mb-2">Automatic Application</h2>
<p>
All of these optimizations are automatically applied when selected in the Virtualization 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.
All of these optimizations are automatically applied when selected in the Virtualization 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.
</p>
</section>
</div>
);
}
)
}