From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <pve-devel-bounces@lists.proxmox.com>
Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68])
	by lore.proxmox.com (Postfix) with ESMTPS id D73D41FF168
	for <inbox@lore.proxmox.com>; Tue,  4 Mar 2025 16:41:29 +0100 (CET)
Received: from firstgate.proxmox.com (localhost [127.0.0.1])
	by firstgate.proxmox.com (Proxmox) with ESMTP id 62933474A;
	Tue,  4 Mar 2025 16:41:20 +0100 (CET)
From: Alexander Zeidler <a.zeidler@proxmox.com>
To: pve-devel@lists.proxmox.com
Date: Tue,  4 Mar 2025 16:40:58 +0100
Message-Id: <20250304154101.3-5-a.zeidler@proxmox.com>
X-Mailer: git-send-email 2.39.5
In-Reply-To: <20250304154101.3-1-a.zeidler@proxmox.com>
References: <20250304154101.3-1-a.zeidler@proxmox.com>
MIME-Version: 1.0
X-SPAM-LEVEL: Spam detection results:  0
 AWL 0.086 Adjusted score from AWL reputation of From: address
 BAYES_00                 -1.9 Bayes spam probability is 0 to 1%
 DMARC_MISSING             0.1 Missing DMARC policy
 KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment
 SPF_HELO_NONE           0.001 SPF: HELO does not publish an SPF Record
 SPF_PASS               -0.001 SPF: sender matches SPF record
Subject: [pve-devel] [PATCH docs 4/7] installer: revise introduction
X-BeenThere: pve-devel@lists.proxmox.com
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Proxmox VE development discussion <pve-devel.lists.proxmox.com>
List-Unsubscribe: <https://lists.proxmox.com/cgi-bin/mailman/options/pve-devel>, 
 <mailto:pve-devel-request@lists.proxmox.com?subject=unsubscribe>
List-Archive: <http://lists.proxmox.com/pipermail/pve-devel/>
List-Post: <mailto:pve-devel@lists.proxmox.com>
List-Help: <mailto:pve-devel-request@lists.proxmox.com?subject=help>
List-Subscribe: <https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel>, 
 <mailto:pve-devel-request@lists.proxmox.com?subject=subscribe>
Reply-To: Proxmox VE development discussion <pve-devel@lists.proxmox.com>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Errors-To: pve-devel-bounces@lists.proxmox.com
Sender: "pve-devel" <pve-devel-bounces@lists.proxmox.com>

* Describe what the installer does, this was earlier included in the
  installation introduction
* Mention the importance of a redundant disk setup
* s/CD-ROM/DVD/
* Rephrase and expand the boot tip

Signed-off-by: Alexander Zeidler <a.zeidler@proxmox.com>
---
 pve-installation.adoc | 55 ++++++++++++++++++++++++++-----------------
 1 file changed, 34 insertions(+), 21 deletions(-)

diff --git a/pve-installation.adoc b/pve-installation.adoc
index 0065bca..404d66c 100644
--- a/pve-installation.adoc
+++ b/pve-installation.adoc
@@ -40,35 +40,48 @@ endif::wiki[]
 Using the {pve} Installer
 -------------------------
 
-The installer ISO image includes the following:
+The interactive installer guides you through the initial setup
+process. It will help you to partition your disks, apply basic
+settings such as the language, time zone and network configuration,
+and finally install all required packages within minutes.
+
+[IMPORTANT]
+====
+If your server does not yet meet the
+xref:system_requirements[recommended system requirements] in the best
+possible way, most points can also be improved at a later date.
+
+One exception is the installation of the hypervisor, which may not be
+easy to change to a redundant disk setup afterwards. To avoid
+reinstallation or data loss if a disk fails in the future, we
+recommend having two disks available for the OS installation and
+selecting them in the installer for a mirrored RAID level, for
+example, xref:chapter_zfs[ZFS RAID1].
+====
+
+CAUTION: Any existing data on the selected drives will be overwritten
+during the installation process. The installer does not add boot menu
+entries for other operating systems.
+
+Please insert the
+xref:installation_prepare_media[prepared installation medium] (for
+example, USB flash drive or DVD) and boot from it.
+
+TIP: You may need to go into your server's firmware settings, to
+enable booting from your installation medium (for example, USB) and
+set the desired boot order. When booting an installer prior to {pve}
+8.1, 'Secure Boot' needs to be disabled.
 
-* Complete operating system (Debian Linux, 64-bit)
-
-* The {pve} installer, which partitions the local disk(s) with ext4, XFS,
-  BTRFS (technology preview), or ZFS and installs the operating system
-
-* {pve} Linux kernel with KVM and LXC support
+[thumbnail="screenshot/pve-grub-menu.png"]
 
-* Complete toolset for administering virtual machines, containers, the host
-  system, clusters and all necessary resources
+After choosing the correct entry (for example, 'Boot from USB') the {pve} menu
+will be displayed.
 
-* Web-based management interface
 
-NOTE: All existing data on the selected drives will be removed during the
-installation process. The installer does not add boot menu entries for other
-operating systems.
 
-Please insert the xref:installation_prepare_media[prepared installation media]
-(for example, USB flash drive or CD-ROM) and boot from it.
 
-TIP: Make sure that booting from the installation medium (for example, USB) is
-enabled in your server's firmware settings. Secure boot needs to be disabled
-when booting an installer prior to {pve} version 8.1.
 
-[thumbnail="screenshot/pve-grub-menu.png"]
 
-After choosing the correct entry (for example, 'Boot from USB') the {pve} menu
-will be displayed, and one of the following options can be selected:
 
 Install {pve} (Graphical)::
 
-- 
2.39.5



_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel