feat: add "How to Reinstall" section in Proxmox help view, providing detailed guidance on the reinstallation process and important data loss warnings
This commit is contained in:
@@ -35,7 +35,7 @@
|
||||
this.expandedCategories[key] = true;
|
||||
});
|
||||
// Auto-switch to first matching section
|
||||
const sections = ['overview', 'quick-start', 'boot-settings', 'network', 'subdomain', 'cloud-init', 'display', 'statistics', 'system', 'backups', 'console', 'bgp', 'glossary', 'rfc-standards', 'troubleshooting'];
|
||||
const sections = ['overview', 'quick-start', 'reinstall', 'boot-settings', 'network', 'subdomain', 'cloud-init', 'display', 'statistics', 'system', 'backups', 'console', 'bgp', 'glossary', 'rfc-standards', 'troubleshooting'];
|
||||
for (const section of sections) {
|
||||
const sectionElement = document.querySelector(`[data-section-id='${section}']`);
|
||||
if (sectionElement) {
|
||||
@@ -99,6 +99,13 @@
|
||||
<x-ri-rocket-line class="size-4" />
|
||||
<span>Quick Start Guide</span>
|
||||
</button>
|
||||
<button @click="activeSection = 'reinstall'"
|
||||
x-show="shouldShowSection('reinstall', 'reinstall operating system os template fresh install', 'reinstall operating system os template fresh install')"
|
||||
:class="activeSection === 'reinstall' ? 'bg-background text-base font-semibold' : 'text-base/70 hover:text-base'"
|
||||
class="w-full text-left px-3 py-2 rounded-md transition-colors flex items-center gap-2">
|
||||
<x-ri-refresh-line class="size-4" />
|
||||
<span>How to Reinstall</span>
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -316,6 +323,163 @@
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- How to Reinstall Section -->
|
||||
<div x-show="activeSection === 'reinstall'" x-transition style="display: none;" data-section-id="reinstall">
|
||||
<div class="flex items-center gap-3 mb-4">
|
||||
<div class="flex items-center justify-center w-10 h-10 rounded-lg bg-primary/10">
|
||||
<x-ri-refresh-line class="size-5 text-primary" />
|
||||
</div>
|
||||
<h2 class="text-2xl font-bold">How to Reinstall</h2>
|
||||
</div>
|
||||
|
||||
<p class="text-base/80 mb-6">
|
||||
Learn how to reinstall your virtual machine with a fresh operating system. Reinstalling will completely wipe your current installation and install a new OS from scratch.
|
||||
</p>
|
||||
|
||||
<div class="bg-warning/10 border border-warning/30 rounded-lg p-4 mb-6">
|
||||
<div class="flex items-start gap-3">
|
||||
<x-ri-error-warning-line class="size-5 text-warning flex-shrink-0 mt-0.5" />
|
||||
<div>
|
||||
<p class="text-sm font-semibold mb-2 text-warning">Important: Data Loss Warning</p>
|
||||
<ul class="list-disc list-inside text-sm text-base/70 space-y-1">
|
||||
<li><strong>All data will be permanently deleted</strong> - This includes files, applications, configurations, and user data</li>
|
||||
<li><strong>Backups are not automatically restored</strong> - Make sure to restore any needed data from backups after reinstallation</li>
|
||||
<li><strong>IP addresses are preserved</strong> - Your assigned IP addresses will remain the same</li>
|
||||
<li><strong>Network configuration is reset</strong> - You may need to reconfigure network settings after reinstall</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="space-y-6">
|
||||
<div class="bg-background border border-neutral rounded-lg p-5">
|
||||
<h3 class="text-xl font-semibold mb-3 flex items-center gap-2">
|
||||
<span class="flex items-center justify-center w-8 h-8 rounded-full bg-primary/10 text-primary font-bold">1</span>
|
||||
Before You Begin
|
||||
</h3>
|
||||
<ol class="list-decimal list-inside space-y-2 text-sm text-base/70 ml-10">
|
||||
<li><strong>Backup important data</strong> - Download or backup any files, databases, or configurations you need to keep</li>
|
||||
<li><strong>Document your current configuration</strong> - Note down network settings, installed packages, and custom configurations</li>
|
||||
<li><strong>Verify server protection status</strong> - Some servers may have reinstall protection enabled (contact support if needed)</li>
|
||||
<li><strong>Ensure you have console access</strong> - You'll need NoVNC or Xterm.js access to complete the installation</li>
|
||||
</ol>
|
||||
</div>
|
||||
|
||||
<div class="bg-background border border-neutral rounded-lg p-5">
|
||||
<h3 class="text-xl font-semibold mb-3 flex items-center gap-2">
|
||||
<span class="flex items-center justify-center w-8 h-8 rounded-full bg-primary/10 text-primary font-bold">2</span>
|
||||
Accessing the Reinstall Feature
|
||||
</h3>
|
||||
<ol class="list-decimal list-inside space-y-2 text-sm text-base/70 ml-10">
|
||||
<li>Navigate to the <strong>Overview</strong> tab of your server</li>
|
||||
<li>Scroll down to find the <strong>"Reinstall Server"</strong> button (usually in the server management section)</li>
|
||||
<li>Click the button to open the reinstall dialog</li>
|
||||
<li>If the button is disabled or shows a warning, your server may be protected - contact support</li>
|
||||
</ol>
|
||||
</div>
|
||||
|
||||
<div class="bg-background border border-neutral rounded-lg p-5">
|
||||
<h3 class="text-xl font-semibold mb-3 flex items-center gap-2">
|
||||
<span class="flex items-center justify-center w-8 h-8 rounded-full bg-primary/10 text-primary font-bold">3</span>
|
||||
Selecting an Operating System
|
||||
</h3>
|
||||
<p class="text-sm text-base/70 mb-3 ml-10">
|
||||
The reinstall dialog displays available operating system templates organized by category:
|
||||
</p>
|
||||
<ul class="list-disc list-inside space-y-2 text-sm text-base/70 ml-10">
|
||||
<li><strong>Ubuntu</strong> - Popular Linux distribution with LTS (Long Term Support) versions</li>
|
||||
<li><strong>Debian</strong> - Stable, community-driven Linux distribution</li>
|
||||
<li><strong>CentOS / Enterprise / RHEL Family</strong> - Enterprise Linux distributions (AlmaLinux, Rocky Linux, Oracle Linux)</li>
|
||||
<li><strong>Community & Rolling</strong> - Fedora, Arch Linux, openSUSE, Gentoo</li>
|
||||
<li><strong>Lightweight</strong> - Alpine Linux for minimal resource usage</li>
|
||||
<li><strong>BSD Family</strong> - FreeBSD, NetBSD, OpenBSD</li>
|
||||
<li><strong>Windows Server</strong> - Microsoft Windows Server editions</li>
|
||||
<li><strong>Proxmox Hypervisor</strong> - Proxmox VE for virtualization hosts</li>
|
||||
</ul>
|
||||
<p class="text-sm text-base/70 mt-3 ml-10">
|
||||
<strong>Tip:</strong> Look for "Recommended" badges on certain OS versions for best compatibility and support.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div class="bg-background border border-neutral rounded-lg p-5">
|
||||
<h3 class="text-xl font-semibold mb-3 flex items-center gap-2">
|
||||
<span class="flex items-center justify-center w-8 h-8 rounded-full bg-primary/10 text-primary font-bold">4</span>
|
||||
Confirming the Reinstall
|
||||
</h3>
|
||||
<ol class="list-decimal list-inside space-y-2 text-sm text-base/70 ml-10">
|
||||
<li>Select your desired operating system from the list</li>
|
||||
<li>Review the warning message about data loss</li>
|
||||
<li>Check the confirmation checkbox to acknowledge data will be deleted</li>
|
||||
<li>Click <strong>"Reinstall"</strong> to begin the process</li>
|
||||
<li>You will be redirected to the servers list - the reinstall happens in the background</li>
|
||||
</ol>
|
||||
</div>
|
||||
|
||||
<div class="bg-background border border-neutral rounded-lg p-5">
|
||||
<h3 class="text-xl font-semibold mb-3 flex items-center gap-2">
|
||||
<span class="flex items-center justify-center w-8 h-8 rounded-full bg-primary/10 text-primary font-bold">5</span>
|
||||
During Reinstallation
|
||||
</h3>
|
||||
<p class="text-sm text-base/70 mb-3 ml-10">
|
||||
The reinstall process typically takes 5-15 minutes and involves:
|
||||
</p>
|
||||
<ul class="list-disc list-inside space-y-2 text-sm text-base/70 ml-10">
|
||||
<li>Stopping the current virtual machine</li>
|
||||
<li>Deleting the existing VM configuration and disk</li>
|
||||
<li>Creating a new VM with the selected OS template</li>
|
||||
<li>Installing the operating system from scratch</li>
|
||||
<li>Configuring network settings with your assigned IP addresses</li>
|
||||
<li>Setting up initial user credentials (password will be generated and sent via notification)</li>
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
<div class="bg-background border border-neutral rounded-lg p-5">
|
||||
<h3 class="text-xl font-semibold mb-3 flex items-center gap-2">
|
||||
<span class="flex items-center justify-center w-8 h-8 rounded-full bg-primary/10 text-primary font-bold">6</span>
|
||||
After Reinstallation
|
||||
</h3>
|
||||
<ol class="list-decimal list-inside space-y-2 text-sm text-base/70 ml-10">
|
||||
<li><strong>Check your notifications</strong> - You'll receive a notification with the new root/admin password</li>
|
||||
<li><strong>Access the console</strong> - Use NoVNC or Xterm.js to access the new installation</li>
|
||||
<li><strong>Verify network connectivity</strong> - Check that IP addresses are configured correctly</li>
|
||||
<li><strong>Update the system</strong> - Run system updates: <code class="bg-background-secondary px-2 py-1 rounded">apt update && apt upgrade</code> (Debian/Ubuntu) or equivalent</li>
|
||||
<li><strong>Restore your data</strong> - Restore files and configurations from your backups</li>
|
||||
<li><strong>Reconfigure services</strong> - Set up applications, web servers, databases, etc.</li>
|
||||
<li><strong>Update Cloud-init settings</strong> - Configure hostname, SSH keys, and other settings in the Cloud-init tab</li>
|
||||
</ol>
|
||||
</div>
|
||||
|
||||
<div class="bg-background border border-neutral rounded-lg p-5">
|
||||
<h3 class="text-xl font-semibold mb-3 flex items-center gap-2">
|
||||
<x-ri-question-line class="size-5 text-info" />
|
||||
Frequently Asked Questions
|
||||
</h3>
|
||||
<div class="space-y-4 ml-10">
|
||||
<div>
|
||||
<p class="text-sm font-semibold mb-1 text-base/90">Will my IP addresses change?</p>
|
||||
<p class="text-sm text-base/70">No, your assigned IP addresses (both IPv4 and IPv6) will remain the same after reinstallation.</p>
|
||||
</div>
|
||||
<div>
|
||||
<p class="text-sm font-semibold mb-1 text-base/90">Can I cancel a reinstall once it starts?</p>
|
||||
<p class="text-sm text-base/70">No, once the reinstall process begins, it cannot be cancelled. The old VM is deleted immediately.</p>
|
||||
</div>
|
||||
<div>
|
||||
<p class="text-sm font-semibold mb-1 text-base/90">What if my server shows "Protected" status?</p>
|
||||
<p class="text-sm text-base/70">Protected servers have reinstall disabled for safety. Contact support to enable reinstall if needed.</p>
|
||||
</div>
|
||||
<div>
|
||||
<p class="text-sm font-semibold mb-1 text-base/90">Will my backups be deleted?</p>
|
||||
<p class="text-sm text-base/70">No, existing backups are preserved. However, you'll need to manually restore data from backups after reinstall.</p>
|
||||
</div>
|
||||
<div>
|
||||
<p class="text-sm font-semibold mb-1 text-base/90">How long does reinstallation take?</p>
|
||||
<p class="text-sm text-base/70">Typically 5-15 minutes depending on the OS template size and server resources. You'll receive a notification when complete.</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Overview Section -->
|
||||
<div x-show="activeSection === 'overview'" x-transition data-section-id="overview">
|
||||
<div class="flex items-center gap-3 mb-4">
|
||||
|
||||
Reference in New Issue
Block a user