summaryrefslogtreecommitdiff
path: root/doc/source/install/include
diff options
context:
space:
mode:
authorJulia Kreger <juliaashleykreger@gmail.com>2023-04-26 07:34:29 -0700
committerJulia Kreger <juliaashleykreger@gmail.com>2023-04-26 07:34:29 -0700
commitf2605e928136f88032ef9b4977a076d5c535987b (patch)
tree36024a640a37fd97ea7c1ab87d7a9035d0d602ef /doc/source/install/include
parent7083545731a8d5009f113f87b07710be833b627a (diff)
downloadironic-f2605e928136f88032ef9b4977a076d5c535987b.tar.gz
Remove use of nomodeset by default
The troubleshooting kernel command line option nomodeset unfortunately changes the way framebuffer interactions work with graphics devices which in some cases can result in kernel memory to be used for graphics updates. When this happens on some specific hardware common in rack mount servers with baseboard management controllers, this can cause the memory bus to become locked for a brief time while the graphics update is occuring. This locked memory bus means disk IO can become blocked, and network cards can overflow their buffers resulting in packet loss on top of the latency incurred by the graphics update executing. As such, we've removed the nomodeset option from default usage and added a note describing its removal to the documentation along with a release note. Change-Id: I9084d88c3ec6f13bd64b8707892758fa87dd7f86
Diffstat (limited to 'doc/source/install/include')
-rw-r--r--doc/source/install/include/kernel-boot-parameters.inc4
1 files changed, 2 insertions, 2 deletions
diff --git a/doc/source/install/include/kernel-boot-parameters.inc b/doc/source/install/include/kernel-boot-parameters.inc
index f0da59d60..82b4ecc91 100644
--- a/doc/source/install/include/kernel-boot-parameters.inc
+++ b/doc/source/install/include/kernel-boot-parameters.inc
@@ -91,7 +91,7 @@ respectively.
[pxe]
# Additional append parameters for baremetal PXE boot.
- kernel_append_params = nofb nomodeset vga=normal console=ttyS0,115200n8
+ kernel_append_params = nofb vga=normal console=ttyS0,115200n8
* For node web console configuration is similar with the addition of ``ttyX``
@@ -100,7 +100,7 @@ respectively.
[pxe]
# Additional append parameters for baremetal PXE boot.
- kernel_append_params = nofb nomodeset vga=normal console=tty0 console=ttyS0,115200n8
+ kernel_append_params = nofb vga=normal console=tty0 console=ttyS0,115200n8
For detailed information on how to add consoles see the reference documents
`kernel params`_ and `serial console`_.