public inbox for pve-devel@lists.proxmox.com
 help / color / mirror / Atom feed
From: Alexander Zeidler <a.zeidler@proxmox.com>
To: pve-devel@lists.proxmox.com
Subject: [pve-devel] [PATCH docs 4/7] installer: revise introduction
Date: Tue,  4 Mar 2025 16:40:58 +0100	[thread overview]
Message-ID: <20250304154101.3-5-a.zeidler@proxmox.com> (raw)
In-Reply-To: <20250304154101.3-1-a.zeidler@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


  parent reply	other threads:[~2025-03-04 15:41 UTC|newest]

Thread overview: 14+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-03-04 15:40 [pve-devel] [PATCH v1 docs 0/7] Revise installation chapter Alexander Zeidler
2025-03-04 15:40 ` [pve-devel] [PATCH docs 1/7] system-requirements: revise subchapter and provide more details Alexander Zeidler
2025-03-04 16:21   ` Shannon Sterz
2025-03-04 15:40 ` [pve-devel] [PATCH docs 2/7] installation: prepare medium: revise subchapter Alexander Zeidler
2025-03-04 16:34   ` Shannon Sterz
2025-03-04 15:40 ` [pve-devel] [PATCH docs 3/7] installation: revise introduction Alexander Zeidler
2025-03-05  8:35   ` Shannon Sterz
2025-03-04 15:40 ` Alexander Zeidler [this message]
2025-03-05  8:53   ` [pve-devel] [PATCH docs 4/7] installer: " Shannon Sterz
2025-03-04 15:40 ` [pve-devel] [PATCH docs 5/7] installer: revise boot menu description and introduce sections Alexander Zeidler
2025-03-04 15:41 ` [pve-devel] [PATCH docs 6/7] installer: revise installation steps " Alexander Zeidler
2025-03-05  9:25   ` Shannon Sterz
2025-03-04 15:41 ` [pve-devel] [PATCH docs 7/7] installer: revise intro of advanced ZFS/BTRFS configuration options Alexander Zeidler
2025-03-05  9:27   ` Shannon Sterz

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20250304154101.3-5-a.zeidler@proxmox.com \
    --to=a.zeidler@proxmox.com \
    --cc=pve-devel@lists.proxmox.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
Service provided by Proxmox Server Solutions GmbH | Privacy | Legal