GettingStarted: fix section 4 review comments

Change-Id: Ie7fae7a8d4422d02bb7e68e12f1d70b1428513c1
Signed-off-by: Sona Sarmadi <sona.sarmadi@enea.com>

1 files 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 @@
     <itemizedlist>
       <listitem>
         <para>If your system runs Ubuntu, use list to verify if
-        <filename>/usr/bin</filename> is a symbolic link to
+        <filename>/bin/sh</filename> is a symbolic link to
         <literal>bash</literal>:</para>
 
         <programlisting># ls -l /bin/sh
@@ -266,16 +266,33 @@ sdb            8:0            0     111.8G  0  disk
 
         <listitem>
           <para>Once the USB stick is properly booted, a GRUB menu appears on
-          the serial console. Two options are available:</para>
+          the serial console. The following options are available:</para>
 
           <itemizedlist>
+            <para><emphasis role="bold">Using the serial
+            console</emphasis>:</para>
+
             <listitem>
-              <para>live-boot. Boots NFV Access directly from the USB
+              <para>live-boot serial. Boots NFV Access directly from the USB
               stick.</para>
             </listitem>
 
             <listitem>
-              <para>Installer. Launches the NFV Access installer.</para>
+              <para>installer serial. Launches NFV Access.</para>
+            </listitem>
+          </itemizedlist>
+
+          <itemizedlist>
+            <para><emphasis role="bold">Using the graphics
+            console:</emphasis></para>
+
+            <listitem>
+              <para>live-boot graphical. Boots NFV Access directly from the
+              USB stick.</para>
+            </listitem>
+
+            <listitem>
+              <para>installer graphical. Launches NFV Access.</para>
             </listitem>
           </itemizedlist>
 
@@ -287,7 +304,8 @@ sdb            8:0            0     111.8G  0  disk
 
         <listitem>
           <para>To launch the installer, select <command>installer</command>
-          from the GRUB menu. An installation menu will appear, containing the following options:</para>
+          from the GRUB menu. An installation menu will appear, containing the
+          following options:</para>
 
           <itemizedlist>
             <listitem>
@@ -371,13 +389,14 @@ sdb            8:0            0     111.8G  0  disk
                   <para>Device ID. An unique uuid format string.</para>
                 </listitem>
               </itemizedlist>
-             <note>
-              <para>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.</para>
-             </note>
+
+              <note>
+                <para>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.</para>
+              </note>
             </listitem>
           </itemizedlist>
         </listitem>
@@ -388,9 +407,8 @@ sdb            8:0            0     111.8G  0  disk
 
           <note>
             <para>It is recommended to perform a dry run with the
-            <command>Start install (dry run)</command> option
-            before proceeding with actually modifying the
-            drive.</para>
+            <command>Start install (dry run)</command> option before
+            proceeding with actually modifying the drive.</para>
           </note>
         </listitem>
 
@@ -478,7 +496,7 @@ run</programlisting>
       <figure>
         <mediaobject>
           <imageobject>
-           <imagedata align="center" fileref="images/efi_menu.png" scale="60" />
+            <imagedata align="center" fileref="images/efi_menu.png" scale="60" />
           </imageobject>
         </mediaobject>
       </figure>
@@ -501,18 +519,23 @@ run</programlisting>
 
     <itemizedlist>
       <listitem>
-        <para>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.</para>
+        <para>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.</para>
       </listitem>
 
       <listitem>
-        <para>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.</para>
+        <para>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.</para>
       </listitem>
     </itemizedlist>
 
+    <note>
+      <para>This is a best effort reservation, after the kernel boot, so the
+      results may not be as described.</para>
+    </note>
+
     <section id="hugepage_customizing_auto">
       <title>Customizing Automatic Hugepage Reservation</title>
 
@@ -569,16 +592,18 @@ run</programlisting>
 
       <itemizedlist>
         <listitem>
-          <para>2GB of memory: approximately 616MB allocated for OS and 1432MB allocated
-          as 2MB hugepages.</para>
+          <para>2GB of memory: 1024MB allocated for OS and 1024MB allocated as
+          2MB hugepages.</para>
         </listitem>
 
         <listitem>
-          <para>4GB of memory: 1024MB allocated for OS and 7168MB as hugepages.</para>
+          <para>4GB of memory: 1024MB allocated for OS and 3072MB allocated as
+          2MB hugepages.</para>
         </listitem>
 
         <listitem>
-          <para>16GB of memory: 2GB allocated for OS and 14GB as 1GB hugepages.</para>
+          <para>16GB of memory: 1GB allocated for OS and 15GB as 1GB
+          hugepages.</para>
         </listitem>
       </itemizedlist>
     </section>