From 6392fc70c0e3b55c0e0a0087b29258ae41767749 Mon Sep 17 00:00:00 2001 From: Abraham Arce Date: Tue, 15 Jan 2019 09:23:53 -0600 Subject: [PATCH] [Installation] NVMe Drive as Boot Drive A node can have Non-Volatile Memory Express (NVMe) drive as its boot drive by: - Enabling UEFI mode. - Modifying Kernel boot parameters. Story: 2004780 Task: 28922 Change-Id: I1e0a2e841b94226bc9ea578765b968986d25bb8d Co-authored-by: Don Penney Signed-off-by: Abraham Arce --- doc/source/installation_guide/index.rst | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/doc/source/installation_guide/index.rst b/doc/source/installation_guide/index.rst index a07db3c9d..5e19d0454 100644 --- a/doc/source/installation_guide/index.rst +++ b/doc/source/installation_guide/index.rst @@ -113,6 +113,30 @@ be deployed, include: The recommended minimum requirements for the physical servers are described later in each StarlingX Deployment Options guide. +^^^^^^^^^^^^^^^^^^^^^^^^ +NVMe Drive as Boot Drive +^^^^^^^^^^^^^^^^^^^^^^^^ + +To use a Non-Volatile Memory Express (NVMe) drive as the boot drive for any of +your nodes, you must configure your host and adjust kernel parameters during +installation: + +- Configure the host to be in UEFI mode. +- Edit the kernel boot parameter. After you are presented with the StarlingX + ISO boot options and after you have selected the preferred installation option + (e.g. Standard Configuration / All-in-One Controller Configuration), press the + TAB key to edit the Kernel boot parameters. Modify the **boot_device** and + **rootfs_device** from the default **sda** so that it is the correct device + name for the NVMe drive (e.g. "nvme0n1"). + + :: + + vmlinuz rootwait console=tty0 inst.text inst.stage2=hd:LABEL=oe_iso_boot + inst.ks=hd:LABEL=oe_iso_boot:/smallsystem_ks.cfg boot_device=nvme0n1 + rootfs_device=nvme0n1 biosdevname=0 usbcore.autosuspend=-1 inst.gpt + security_profile=standard user_namespace.enable=1 initrd=initrd.img + + ******************* Virtual Environment *******************