* [pve-devel] [PATCH docs] installation: reword `nomodeset` section a bit, add link to it
@ 2024-02-26 11:20 Christoph Heiss
2024-02-26 11:27 ` Stefan Sterz
0 siblings, 1 reply; 3+ messages in thread
From: Christoph Heiss @ 2024-02-26 11:20 UTC (permalink / raw)
To: pve-devel
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 <a.zeidler@proxmox.com>
Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
---
pve-installation.adoc | 11 ++++++-----
1 file changed, 6 insertions(+), 5 deletions(-)
diff --git a/pve-installation.adoc b/pve-installation.adoc
index 6b44fc0..c799570 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
+<<nomodeset_kernel_param,adding the `nomodeset` kernel parameter>>.
Advanced Options: Install {pve} (Graphical, Debug Mode)::
@@ -300,14 +301,14 @@ following command:
# zpool add <pool-name> log </dev/path_to_fast_ssd>
----
+[[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 the 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
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [pve-devel] [PATCH docs] installation: reword `nomodeset` section a bit, add link to it
2024-02-26 11:20 [pve-devel] [PATCH docs] installation: reword `nomodeset` section a bit, add link to it Christoph Heiss
@ 2024-02-26 11:27 ` Stefan Sterz
2024-02-26 11:42 ` Christoph Heiss
0 siblings, 1 reply; 3+ messages in thread
From: Stefan Sterz @ 2024-02-26 11:27 UTC (permalink / raw)
To: Proxmox VE development discussion
On Mon Feb 26, 2024 at 12:20 PM CET, Christoph Heiss wrote:
> 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 <a.zeidler@proxmox.com>
> Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
> ---
> pve-installation.adoc | 11 ++++++-----
> 1 file changed, 6 insertions(+), 5 deletions(-)
>
> diff --git a/pve-installation.adoc b/pve-installation.adoc
> index 6b44fc0..c799570 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
> +<<nomodeset_kernel_param,adding the `nomodeset` kernel parameter>>.
>
> Advanced Options: Install {pve} (Graphical, Debug Mode)::
>
> @@ -300,14 +301,14 @@ following command:
> # zpool add <pool-name> log </dev/path_to_fast_ssd>
> ----
>
> +[[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 the 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.
>
nit: "the installation hangs during the boot" doesn't require that
"the". imo "If the installation hangs during boot, you can..."
otherwise sounds good to me
> 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
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [pve-devel] [PATCH docs] installation: reword `nomodeset` section a bit, add link to it
2024-02-26 11:27 ` Stefan Sterz
@ 2024-02-26 11:42 ` Christoph Heiss
0 siblings, 0 replies; 3+ messages in thread
From: Christoph Heiss @ 2024-02-26 11:42 UTC (permalink / raw)
To: Stefan Sterz; +Cc: Proxmox VE development discussion
Thanks for the review!
On Mon, Feb 26, 2024 at 12:27:13PM +0100, Stefan Sterz wrote:
> On Mon Feb 26, 2024 at 12:20 PM CET, Christoph Heiss wrote:
[..]
> > +[[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 the 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.
> >
>
> nit: "the installation hangs during the boot" doesn't require that
> "the". imo "If the installation hangs during boot, you can..."
Yep, sounds indeed better. I'll send a v2.
>
> otherwise sounds good to me
>
> > 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
>
>
>
> _______________________________________________
> pve-devel mailing list
> pve-devel@lists.proxmox.com
> https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel
>
>
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2024-02-26 11:42 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2024-02-26 11:20 [pve-devel] [PATCH docs] installation: reword `nomodeset` section a bit, add link to it Christoph Heiss
2024-02-26 11:27 ` Stefan Sterz
2024-02-26 11:42 ` Christoph Heiss
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox