From 5266cfe727a079d0bfd29550a52af6b62a623446 Mon Sep 17 00:00:00 2001 From: Sona Sarmadi Date: Wed, 13 Feb 2019 14:47:37 +0100 Subject: GettingStarted: fix section 4 review comments Change-Id: Ie7fae7a8d4422d02bb7e68e12f1d70b1428513c1 Signed-off-by: Sona Sarmadi --- .../doc/getting_started_nfv_access.xml | 77 ++++++++++++++-------- 1 file changed, 51 insertions(+), 26 deletions(-) diff --git a/doc/book-enea-nfv-access-getting-started/doc/getting_started_nfv_access.xml b/doc/book-enea-nfv-access-getting-started/doc/getting_started_nfv_access.xml index 72c5570..77c3244 100644 --- a/doc/book-enea-nfv-access-getting-started/doc/getting_started_nfv_access.xml +++ b/doc/book-enea-nfv-access-getting-started/doc/getting_started_nfv_access.xml @@ -19,7 +19,7 @@ If your system runs Ubuntu, use list to verify if - /usr/bin is a symbolic link to + /bin/sh is a symbolic link to bash: # ls -l /bin/sh @@ -266,16 +266,33 @@ sdb 8:0 0 111.8G 0 disk Once the USB stick is properly booted, a GRUB menu appears on - the serial console. Two options are available: + the serial console. The following options are available: + Using the serial + console: + - live-boot. Boots NFV Access directly from the USB + live-boot serial. Boots NFV Access directly from the USB stick. - Installer. Launches the NFV Access installer. + installer serial. Launches NFV Access. + + + + + Using the graphics + console: + + + live-boot graphical. Boots NFV Access directly from the + USB stick. + + + + installer graphical. Launches NFV Access. @@ -287,7 +304,8 @@ sdb 8:0 0 111.8G 0 disk To launch the installer, select installer - from the GRUB menu. An installation menu will appear, containing the following options: + from the GRUB menu. An installation menu will appear, containing the + following options: @@ -371,13 +389,14 @@ sdb 8:0 0 111.8G 0 disk Device ID. An unique uuid format string. - - Modifying any of the Default parameters (e.g Core - isolation, 1G huge page count, etc.) will automatically update - the kernel parameters string. Updating the Custom - parameters within the kernel string directly will override any - values set previously for the Default parameters. - + + + Modifying any of the Default parameters (e.g Core + isolation, 1G huge page count, etc.) will automatically update + the kernel parameters string. Updating the Custom parameters + within the kernel string directly will override any values set + previously for the Default parameters. + @@ -388,9 +407,8 @@ sdb 8:0 0 111.8G 0 disk It is recommended to perform a dry run with the - Start install (dry run) option - before proceeding with actually modifying the - drive. + Start install (dry run) option before + proceeding with actually modifying the drive. @@ -478,7 +496,7 @@ run
- +
@@ -501,18 +519,23 @@ run - If a system has an amount of memory that's lower than 8GB, - the allocation algorithm will reserve 70% of the memory as hugepages, - leaving the rest to be used by the OS. + If a system has an amount of memory up to 8GB, the allocation + algorithm will reserve up to 30%, but no more than 2GB, for the OS and + the rest as huge pages. - If a system has an amount of memory that's higher than 8GB, the allocation - algorithm will reserve all but 2GB of memory as 1GB hugepages, leaving the rest (2GB) - to be used by the OS. + If a system has an amount of memory that's higher than 8GB, the + allocation algorithm will reserve all but 2GB of memory as 1GB + hugepages, leaving the rest (2GB) to be used by the OS. + + This is a best effort reservation, after the kernel boot, so the + results may not be as described. + +
Customizing Automatic Hugepage Reservation @@ -569,16 +592,18 @@ run - 2GB of memory: approximately 616MB allocated for OS and 1432MB allocated - as 2MB hugepages. + 2GB of memory: 1024MB allocated for OS and 1024MB allocated as + 2MB hugepages. - 4GB of memory: 1024MB allocated for OS and 7168MB as hugepages. + 4GB of memory: 1024MB allocated for OS and 3072MB allocated as + 2MB hugepages. - 16GB of memory: 2GB allocated for OS and 14GB as 1GB hugepages. + 16GB of memory: 1GB allocated for OS and 15GB as 1GB + hugepages.
-- cgit v1.2.3-54-g00ecf