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 410B21FF15C
for <inbox@lore.proxmox.com>; Wed, 5 Mar 2025 09:53:46 +0100 (CET)
Received: from firstgate.proxmox.com (localhost [127.0.0.1])
by firstgate.proxmox.com (Proxmox) with ESMTP id A1F1DFD82;
Wed, 5 Mar 2025 09:53:40 +0100 (CET)
Mime-Version: 1.0
Date: Wed, 05 Mar 2025 09:53:06 +0100
Message-Id: <D887EKKZ9CV6.3A7YTAY0BPZ2P@proxmox.com>
Cc: "pve-devel" <pve-devel-bounces@lists.proxmox.com>
From: "Shannon Sterz" <s.sterz@proxmox.com>
To: "Proxmox VE development discussion" <pve-devel@lists.proxmox.com>
X-Mailer: aerc 0.20.1-0-g2ecb8770224a-dirty
References: <20250304154101.3-1-a.zeidler@proxmox.com>
<20250304154101.3-5-a.zeidler@proxmox.com>
In-Reply-To: <20250304154101.3-5-a.zeidler@proxmox.com>
X-SPAM-LEVEL: Spam detection results: 0
AWL -0.014 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
RCVD_IN_VALIDITY_CERTIFIED_BLOCKED 0.001 ADMINISTRATOR NOTICE: The query to
Validity was blocked. See
https://knowledge.validity.com/hc/en-us/articles/20961730681243 for more
information.
RCVD_IN_VALIDITY_RPBL_BLOCKED 0.001 ADMINISTRATOR NOTICE: The query to
Validity was blocked. See
https://knowledge.validity.com/hc/en-us/articles/20961730681243 for more
information.
RCVD_IN_VALIDITY_SAFE_BLOCKED 0.001 ADMINISTRATOR NOTICE: The query to
Validity was blocked. See
https://knowledge.validity.com/hc/en-us/articles/20961730681243 for more
information.
SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record
SPF_PASS -0.001 SPF: sender matches SPF record
Subject: Re: [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>
On Tue Mar 4, 2025 at 4:40 PM CET, Alexander Zeidler wrote:
> * 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
you can lose the "to" here, "It will help you partition your disks" is
more concise
> +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
this should probably be split into two sentences "...for the OS
installation. Then make sure to select them in..."
> +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.
the installer's GRUB boot menu will be displayed.
or something like that would be more descriptive to me than "the Proxmox
VE menu". not sure what that would be if there wasn't a screenshot here
(which may be relevant to users that can't look at it, such as blind
people).
>
> -* 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)::
>
_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel