From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by lists.proxmox.com (Postfix) with ESMTPS id 87D22954FF for ; Mon, 26 Feb 2024 19:01:36 +0100 (CET) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id 5F483139AD for ; Mon, 26 Feb 2024 19:01:06 +0100 (CET) Received: from proxmox-new.maurer-it.com (proxmox-new.maurer-it.com [94.136.29.106]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by firstgate.proxmox.com (Proxmox) with ESMTPS for ; Mon, 26 Feb 2024 19:01:02 +0100 (CET) Received: from proxmox-new.maurer-it.com (localhost.localdomain [127.0.0.1]) by proxmox-new.maurer-it.com (Proxmox) with ESMTP id ED614473CB for ; Mon, 26 Feb 2024 19:01:01 +0100 (CET) From: Christoph Heiss To: pve-devel@lists.proxmox.com Date: Mon, 26 Feb 2024 18:59:55 +0100 Message-ID: <20240226180044.1406827-1-c.heiss@proxmox.com> X-Mailer: git-send-email 2.43.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-SPAM-LEVEL: Spam detection results: 0 AWL 0.005 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 T_SCC_BODY_TEXT_LINE -0.01 - Subject: [pve-devel] [PATCH docs v2] installation: reword `nomodeset` section a bit, add link to it X-BeenThere: pve-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox VE development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 26 Feb 2024 18:01:36 -0000 The `nomodeset` section needs some massaging due to the text flow being broken a bit. While at it, link to it above at the 'Terminal UI' bootloader tip such that readers can find it more easily. Suggested-by: Alexander Zeidler Signed-off-by: Christoph Heiss --- Changes v1 -> v2: * dropped superflous `the` * use `xref` instead of `<< >>` for linking paragraph pve-installation.adoc | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/pve-installation.adoc b/pve-installation.adoc index 6b44fc0..016aa91 100644 --- a/pve-installation.adoc +++ b/pve-installation.adoc @@ -88,7 +88,8 @@ Both modes use the same code base for the actual installation process to benefit from more than a decade of bug fixes and ensure feature parity. TIP: The 'Terminal UI' option can be used in case the graphical installer does -not work correctly, due to e.g. driver issues. +not work correctly, due to e.g. driver issues. See also +xref:nomodeset_kernel_param[adding the `nomodeset` kernel parameter]. Advanced Options: Install {pve} (Graphical, Debug Mode):: @@ -300,14 +301,14 @@ following command: # zpool add log ---- +[[nomodeset_kernel_param]] Adding the `nomodeset` Kernel Parameter ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Problems may arise on very old or very new hardware due to graphics drivers. If -the installation hangs during the boot. In that case, you can try adding the -`nomodeset` parameter. This prevents the Linux kernel from loading any -graphics drivers and forces it to continue using the BIOS/UEFI-provided -framebuffer. +the installation hangs during boot, you can try adding the `nomodeset` +parameter. This prevents the Linux kernel from loading any graphics drivers and +forces it to continue using the BIOS/UEFI-provided framebuffer. On the {pve} bootloader menu, navigate to 'Install {pve} (Terminal UI)' and press `e` to edit the entry. Using the arrow keys, navigate to the line starting -- 2.43.0