path: root/doc/book-enea-edge-example-usecases/doc/appendix_2.xml

<?xml version="1.0" encoding="UTF-8"?>
<appendix id="appendix_two_cust">
  <title>How to create the 128T image for NFV Access</title>

  <para>The following steps were used by Enea to generate the 128T qcow2 image
  used as the VNF image on NFV Access.</para>

  <note>
    <para>Keep in mind a Virtual Machine was used instead of a physical
    host.</para>
  </note>

  <para><emphasis role="bold">Prerequisites:</emphasis><itemizedlist>
      <listitem>
        <para><filename>128T-3.2.7-1.el7.centos.x86_64.iso</filename> provided
        by 128 Technologies.</para>
      </listitem>

      <listitem>
        <para>A Linux development host with internet access.</para>
      </listitem>

      <listitem>
        <para>A least one of the TAP interfaces connected to a bridge with
        Internet access.</para>
      </listitem>
    </itemizedlist><emphasis role="bold">How to create the 128T image for NFV
  Access:</emphasis><orderedlist>
      <listitem>
        <programlisting>&gt;qemu-img create -f qcow2 128t.qcow2  128G
&gt;qemu-system-x86_64 -enable-kvm -m 8G -cpu host -smp cores=3,sockets=1 \
-M q35 -nographic bios /usr/share/qemu/bios.bin -boot order=d,menu=on \
cdrom 128T-3.2.7-1.el7.centos.x86_64.iso \
hdb 128t.qcow2 \
device e1000,netdev=net1,mac=52:52:01:02:03:01 \
netdev tap,id=net1,ifname=tap1,script=no,downscript=no</programlisting>
      </listitem>

      <listitem>
        <para>Press the &lt;ENTER&gt; key to begin the installation
        process.</para>
      </listitem>

      <listitem>
        <para>Wait for the distribution and the 128T to install:</para>

        <programlisting>------------------------------
128T Packages Installed       
                              
Please Remove Install Media,  
                              
then enter &lt;Yes&gt; to reboot and
continue install process      
                              
      &lt;Yes&gt;          &lt;No&gt;     
------------------------------</programlisting>

        <para>Press Yes.</para>
      </listitem>

      <listitem>
        <para>Wait to reboot and press <literal>CTR+ a+c</literal> to enter
        the qemu monitor:</para>

        <programlisting>(qemu) quit</programlisting>
      </listitem>

      <listitem>
        <para>Start qemu only with the qcow2 image attached, no installer
        image required:</para>

        <programlisting>&gt;qemu-system-x86_64 -enable-kvm -m 8G -cpu host -smp cores=3,sockets=1 \ 
-M q35 -nographic bios /usr/share/qemu/bios.bin \
-boot order=c,menu=on \
-hda 128t.qcow2 \
-device e1000,netdev=net1,mac=52:52:01:02:03:01 \
-netdev tap,id=net1,ifname=tap1,script=no,downscript=no

------------------------------------------------------------------------------
Booting from Hard Disk...
.

      * CentOS Linux (3.10.0-514.2.2.el7.x86_64) 7 (Core)
      CentOS Linux (0-rescue-4e73a369e89e466a888c9c77655a1d65) 7 (Core)


      Use the ^ and v keys to change the selection.
      Press 'e' to edit the selected item, or 'c' for a command prompt.
------------------------------------------------------------------------------</programlisting>

        <para>Select the first option.</para>
      </listitem>

      <listitem>
        <programlisting>|-------------------128T Installer-------------------|
|                                                    |
|             Configure Linux Networking             |
|                                                    |
|                 Before 128T SetUp?                 |
|                                                    |
|                                                    |
|                  &lt; Yes &gt;  &lt; No &gt;                   |
|----------------------------------------------------|</programlisting>

        <para>Select NO.</para>
      </listitem>

      <listitem>
        <para><programlisting>|----------------------------------------------------|
|       Please select a role for this node:          |
|  |----------------------------------------------|  |
|  |               (*) Router                     |  |
|  |               ( ) Conductor                  |  |
|  |----------------------------------------------|  |
|                                                    |
|----------------------------------------------------|
|                  &lt; OK &gt; &lt; Back &gt;                   |
|----------------------------------------------------|</programlisting>Select
        Router and OK.</para>
      </listitem>

      <listitem>
        <programlisting>|-------------------Conductor Info-------------------|
|                                                    |
|  |----------------------------------------------|  |
|  |1st Conductor Address                         |  |
|  |Conductor Address                             |  |
|  |----------------------------------------------|  |
|                                                    |
|----------------------------------------------------|
|       &lt; OK &gt;   &lt; Skip &gt;   &lt; Back &gt;   &lt; Help &gt;      |
|----------------------------------------------------|</programlisting>

        <para>Select SKIP.</para>
      </listitem>

      <listitem>
        <para><programlisting>|----------------------HA Setup----------------------|
|         What kind of Router node is this?          |
|  |----------------------------------------------|  |
|  |(*) Standalone   No HA peer                   |  |
|  |( ) 1st HA Node  HA peer is not set up        |  |
|  |( ) 2nd HA Node  HA peer is already set up    |  |
|  |----------------------------------------------|  |
|                                                    |
|                                                    |
|----------------------------------------------------|
|               &lt; OK &gt;        &lt; Back &gt;               |
|----------------------------------------------------|</programlisting>Select
        Standalone and OK.</para>
      </listitem>

      <listitem>
        <programlisting>|---------------------Node Info----------------------|
|  |----------------------------------------------|  |
|  |           Node Role      Router              |  |
|  |           Node Name      128tNode            |  |
|  |           Router Name    128tRouter          |  |
|  |----------------------------------------------|  |
|                                                    |
|----------------------------------------------------|
|     &lt; OK &gt;   &lt; Advanced &gt;   &lt; Back &gt;  &lt; Help &gt;     |
|----------------------------------------------------|</programlisting>

        <para>Enter a name for the router and node, press OK.</para>
      </listitem>

      <listitem>
        <programlisting>|-------------------Password Setup-------------------|
|   Enter the new password for the 128T 'admin'      |
|   user:                                            |
|  |----------------------------------------------|  |
|  |     128Tadmin                                |  |
|  |----------------------------------------------|  |
|                                                 |  |
|----------------------------------------------------|
|              &lt; OK &gt;      &lt; Back &gt;                  |
|----------------------------------------------------|</programlisting>

        <para>Enter the password for web access: <literal>128Tadmin</literal>
        and confirm the password.</para>
      </listitem>

      <listitem>
        <programlisting>|--------------------------Anonymous Data Collection--------------------------|
| The 128T Networking Platform comes packaged with a software process         |
|("Roadrunner") that is used to proactively monitor the health and liveliness |
|of the 128T Router and associated components. This watchdog process collects |
|anonymous information from the router and sends it to 128 Technology for     |
|storage and analysis. This information helps inform 128 Technology about     |
|software usage, to aid in the support and improvement of the 128 Technology  |
|Networking Platform.                                                         |
|                                                                             |
|Disabling this feature will prevent the sending of anonymous usage data to   |
|128 Technology.                                                              |
|                                                                             |
|                                                                             |
|                 &lt; Accept &gt;       &lt; Back &gt;       &lt; Disable &gt;                 |
|-----------------------------------------------------------------------------|</programlisting>

        <para>Select Accept.</para>
      </listitem>

      <listitem>
        <programlisting>|-----128T Statistics Table Creator-----|
|  Created table for metric 760/827     |
|  Created table for metric 770/827     |
|  Created table for metric 780/827     |
|  Created table for metric 790/827     |
|  Created table for metric 800/827     |
|  Created table for metric 810/827     |
|  Created table for metric 820/827     |
|  Finished pre-creating stats tables   |
|  Creating tables for audit events     |
|  Finished creating audit event tables |
|  Completed in 27.001386642456055 s    |
|  Shutting down local Cassandra node   |
|---------------------------------------|
|                 &lt; OK &gt;                |
|---------------------------------------|</programlisting>

        <para>Select OK.</para>
      </listitem>

      <listitem>
        <programlisting>|--------128T Installer Status----------|
|                                       |
|           Install SUCCESS             |
|                                       |
|           Start 128T Router           |
|           before proceeding to        |
|           login prompt?               |
|---------------------------------------|
|           &lt; Yes &gt;   &lt; No  &gt;           |
|---------------------------------------|</programlisting>

        <para>Select: Yes</para>
      </listitem>

      <listitem>
        <programlisting>localhost login: root
Password:</programlisting>

        <para>The following user accounts and passwords are created during the
        ISO installation process:</para>

        <table>
          <title>Accounts Created</title>

          <tgroup cols="2">
            <colspec align="left" />

            <thead>
              <row>
                <entry align="center">User</entry>

                <entry align="center">Password</entry>
              </row>
            </thead>

            <tbody>
              <row>
                <entry>root</entry>

                <entry>128tRoutes</entry>
              </row>

              <row>
                <entry>t128</entry>

                <entry>128tRoutes</entry>
              </row>
            </tbody>
          </tgroup>
        </table>
      </listitem>

      <listitem>
        <para>GUI login via HTTPS is enabled by default on port 443</para>

        <programlisting>[root@localhost ~]# dhclient enp0s2
[root@localhost ~]# echo "nameserver 8.8.8.8" &gt;&gt;/etc/resolv.conf
[root@localhost ~]# yum -y install cloud-init
[root@localhost ~]# reboot</programlisting>
      </listitem>

      <listitem>
        <para>Wait to reboot and press CTR+ a+c to enter in qemu
        monitor.</para>

        <programlisting>(qemu) quit
&gt; qemu-img info 128t.qcow2
image: 128t.qcow2
file format: qcow2
virtual size: 128G (137438953472 bytes)
disk size: 5.4G
cluster_size: 65536
Format specific information:
    compat: 1.1
    lazy refcounts: false
    refcount bits: 16
    corrupt: false</programlisting>
      </listitem>

      <listitem>
        <para>Compress the generated <filename>128t.qcow2</filename> image to
        decrease the size of VNF image:</para>

        <programlisting>qemu-img convert -O qcow2 -c 128t.qcow2 centos_128t_compressed.qcow2

&gt; qemu-img info centos_128t_compressed.qcow2
image: centos_128t_compressed.qcow2
file format: qcow2
virtual size: 128G (137438953472 bytes)
disk size: 1.2G
cluster_size: 65536
Format specific information:
    compat: 1.1
    lazy refcounts: false
    refcount bits: 16
    corrupt: false

centos_128t_compressed.qcow2 - Resulted image can be used in NFV Access.</programlisting>
      </listitem>
    </orderedlist></para>
</appendix>