Updated remaing content save for benchmarks

LXCR-7844

Signed-off-by: Miruna Paun <Miruna.Paun@enea.com>

1 files changed, 212 insertions, 2 deletions

diff --git a/doc/book-enea-nfv-access-platform-guide/doc/getting_started.xml b/doc/book-enea-nfv-access-platform-guide/doc/getting_started.xml
index b534e20..aa0dcb5 100644
--- a/doc/book-enea-nfv-access-platform-guide/doc/getting_started.xml
+++ b/doc/book-enea-nfv-access-platform-guide/doc/getting_started.xml
@@ -120,8 +120,218 @@
   </section>
 
   <section id="prebuilt-artifacts">
-    <title>How to use Prebuilt Artifacts</title>
+    <title>How to use the Prebuilt Artifacts</title>
 
-    <para></para>
+    <section id="boot-ramdisk">
+      <title>Booting Enea NFV Access Platform using RAMDISK</title>
+
+      <para>There may be use cases, especially at first target ramp-up, where
+      the HDD/SDD has no partitions and you need to prepare the disks for
+      boot. Booting from ramdisk can help with this task.</para>
+
+      <para>The prerequisites needed to proceed:</para>
+
+      <itemizedlist>
+        <listitem>
+          <para>Enea Linux ext4 rootfs image -
+          enea-image-virtualization-host-inteld1521.ext4</para>
+        </listitem>
+
+        <listitem>
+          <para>Enea Linux kernel image - bzImage</para>
+        </listitem>
+
+        <listitem>
+          <para>BIOS has PXE boot enabled</para>
+        </listitem>
+
+        <listitem>
+          <para>PXE/tftp server configured and connected (ethernet) to
+          target.</para>
+        </listitem>
+      </itemizedlist>
+
+      <para>Copy bzImage and enea-image-virtualization-host-inteld1521.ext4.gz
+      images to the tftpserver configured for PXE boot.</para>
+
+      <para>Use the following as an example for the PXE configuration
+      file:</para>
+
+      <programlisting>default vesamenu.c32
+prompt 1
+timeout 0
+
+label el_ramfs
+    menu label ^EneaLinux_RAMfs
+    kernel bzImage
+    append root=/dev/ram0 initrd=enea-image-virtualization-host-inteld1521.ext4 /
+    ramdisk_size=1200000 console=ttyS0,115200 eralyprintk=ttyS0,115200</programlisting>
+
+      <para>Restart the target. Then enter (F11) in the Boot Menu and select
+      the Ethernet interface used for PXE boot. From the PXE Boot Menu select
+      <emphasis role="bold">Enea Linux_RAMfs</emphasis>. Once the Enea NFV
+      Access Platform is started you can partition the HDD/SDD and install
+      GRUB as described in in the following section.s</para>
+    </section>
+
+    <section id="install-grub">
+      <title>Partitioning a new harddisk and installing GRUB</title>
+
+      <para>The prerequisites needed:</para>
+
+      <itemizedlist>
+        <listitem>
+          <para>grub (<literal>grub-efi-bootx64.efi</literal>) - availalble as
+          a pre-built artifact under
+          <literal>inteld1521/images/enea-image-virtualization-host</literal>.</para>
+        </listitem>
+
+        <listitem>
+          <para><literal>e2fsprogs-mke2fs_1.43.4-r0.0_amd64.deb,
+          dosfstools_4.1-r0.0_amd64.deb</literal> - available under
+          <literal>inteld1521/deb</literal>.</para>
+        </listitem>
+      </itemizedlist>
+
+      <para>Proceed using the following steps:</para>
+
+      <orderedlist>
+        <listitem>
+          <para>Boot target with Enea NFV Access Platform from RAMDISK</para>
+        </listitem>
+
+        <listitem>
+          <para>Install prerequisite packages:</para>
+
+          <programlisting>&gt; dpkg -i e2fsprogs-mke2fs_1.43.4-r0.0_amd64.deb
+&gt; dpkg -i dosfstools_4.1-r0.0_amd64.deb</programlisting>
+        </listitem>
+
+        <listitem>
+          <para>Partition the disk:</para>
+
+          <programlisting>&gt; fdisk /dev/sda
+fdisk&gt; g   {GPT partition type}
+fdisk&gt; n
+fdisk&gt; 1
+fdisk&gt;     {default start part}
+fdisk&gt; +512M
+fdisk&gt; t
+fdisk&gt; 1 {ESP/EFI partition}
+fdisk&gt; n
+fdisk&gt; 2
+fdisk&gt;    {default start part}
+fdisk&gt; +18G
+fdisk&gt; 3
+fdisk&gt;    {default start part}
+fdisk&gt; +20G
+...
+fdisk&gt; 7
+fdisk&gt;  {default start part}
+fdisk&gt;  {default end end part}
+
+fdisk&gt; p  {print partion table}
+fdisk&gt; w   {write to disk}
+fdisk&gt; q</programlisting>
+        </listitem>
+
+        <listitem>
+          <para>Format the partitions:</para>
+
+          <programlisting>&gt; mkfs.fat -F32 -nEFI /dev/sda1
+&gt; mkfs.ext4 -LROOT /dev/sda2
+&gt; mkfs.ext4 -LROOT /dev/sda3
+&gt; mkfs.ext4 -LROOT /dev/sda4
+&gt; mkfs.ext4 -LROOT /dev/sda5
+&gt; mkfs.ext4 -LROOT /dev/sda6
+&gt; mkfs.ext4 -LROOT /dev/sda7</programlisting>
+        </listitem>
+
+        <listitem>
+          <para>Create a GRUB partition:</para>
+
+          <programlisting>&gt; mkdir /mnt/boot
+&gt; mount /dev/sda1 /mnt/boot
+&gt; mkdir -p /mnt/boot/EFI/boot
+
+&gt; cp grub-efi-bootx64.efi /mnt/boot/EFI/boot/bootx64.efi
+&gt; vi /mnt/boot/EFI/boot/grub.cfg
+default=1
+
+menuentry "Linux Reference Image" {
+  linux (hd0,gpt2)/boot/bzImage root=/dev/sda2 ip=dhcp
+}
+
+menuentry "Linux sda3" {
+  linux (hd0,gpt3)/boot/bzImage root=/dev/sda3 ip=dhcp
+}
+
+menuentry "Linux sda4" {
+  linux (hd0,gpt4)/boot/bzImage root=/dev/sda4 ip=dhcp
+}
+
+menuentry "Linux sda5" {
+  linux (hd0,gpt5)/boot/bzImage root=/dev/sda5 ip=dhcp
+}
+
+menuentry "Linux sda6" {
+  linux (hd0,gpt6)/boot/bzImage root=/dev/sda6 ip=dhcp
+}
+
+menuentry "Linux sda7" {
+  linux (hd0,gpt7)/boot/bzImage root=/dev/sda7 ip=dhcp
+}</programlisting>
+        </listitem>
+      </orderedlist>
+    </section>
+
+    <section id="boot-hdd">
+      <title>Installing and booting Enea NFV Access Platform on the
+      harddisk</title>
+
+      <para>After partitioning the harddisk, boot Enea NFV Access Platform
+      from RAMFS or from a reference image installed on one of the
+      partitions.</para>
+
+      <para>To install Enea Linux image on a partition follow these
+      steps:</para>
+
+      <orderedlist>
+        <listitem>
+          <para>Copy your platform image on target:</para>
+
+          <programlisting>server&gt; scp ./enea-image-virtualization-host-inteld1521.tar.gz /
+root@&lt;target_ip&gt;:/home/root/</programlisting>
+        </listitem>
+
+        <listitem>
+          <para>Extract image onto the desired partition:</para>
+
+          <programlisting>target&gt; mount /dev/sda3 /mnt/sda
+target&gt; tar -pzxf /home/root/enea-image-virtualization-host-inteld1521.tar.gz /
+-C /mnt/sda</programlisting>
+
+          <para>Alternately, you can do both steps in one command from the
+          server:</para>
+
+          <programlisting>server&gt; cat ./enea-image-virtualization-host-inteld1521.tar.gz | /
+ssh root@&lt;target_ip&gt; "cd /mnt/sda6; tar -zxf -"</programlisting>
+        </listitem>
+
+        <listitem>
+          <para>Reboot</para>
+        </listitem>
+
+        <listitem>
+          <para>From the GRUB menu select your partition</para>
+        </listitem>
+      </orderedlist>
+
+      <note>
+        <para>In order to change kernel boot parameters you need to mount the
+        GRUB partition (i.e. <literal>/dev/sda1</literal>) and change the
+        <literal>EFI/boot/grub.cfg</literal> file.</para>
+      </note>
+    </section>
   </section>
 </chapter>
\ No newline at end of file