Updating the content of the Enea NFV Access Release Info

USERDOCAP-229

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

5 files changed, 45 insertions, 121 deletions

diff --git a/doc/book-enea-nfv-access-release-info/doc/about_release.xml b/doc/book-enea-nfv-access-release-info/doc/about_release.xml
index 9ee8d14..9aa4866 100644
--- a/doc/book-enea-nfv-access-release-info/doc/about_release.xml
+++ b/doc/book-enea-nfv-access-release-info/doc/about_release.xml
@@ -22,9 +22,8 @@
     <title>NFV Access Release content</title>
 
     <para>The current release contains along with other items, documentation,
-    pre-built kernels and images, a bootloader and a SDK.</para>
-
-    <para>The directories structure is detailed below:</para>
+    pre-built kernels and images, a bootloader and a SDK. The directories
+    structure is detailed below:</para>
 
     <programlisting>-- documentation/
    /* NFV Access documentation */
@@ -107,8 +106,11 @@
     <title>Supported Host Environment</title>
 
     <itemizedlist>
+      <para>The following environments have been validated as host
+      environments for Enea NFV Access 1.0:</para>
+
       <listitem>
-        <para>Ubuntu 14.04 LTS, 64-bit<remark>Hardcoded now in this XML file.
+        <para>Ubuntu 16.04 LTS, 64bit<remark>Hardcoded now in this XML file.
         Might be moved to the parameter file later.</remark><remark>INFO Below
         is a complete section with ID "eltf-target-tables-section" included
         from elft_params_updated.xml. It contains a variable number of target
@@ -118,6 +120,10 @@
         in the manifest.</remark></para>
       </listitem>
     </itemizedlist>
+
+    <para>For more details on system requirements and how to configure the
+    host environment, please see <xref
+    linkend="sys-req-prerequisites" />.</para>
   </section>
 
   <xi:include href="eltf_params_updated.xml"
@@ -128,9 +134,10 @@
     <title>Provided Toolchain(s) (SDK)</title>
 
     <para>The SDK contains toolchains supporting cross-compilation of
-    applications for the targets on an x86_64 host. See the <trademark
-    class="registered">Enea</trademark> NFV Access Application Development
-    Guide for information on how to build and install a toolchain.</para>
+    applications for the targets on an x86_64b host. <remark>(Possibly add
+    this in later) See the <trademark class="registered">Enea</trademark> NFV
+    Access Application Development Guide for information on how to build and
+    install a toolchain.</remark></para>
   </section>
 
   <section id="relinfo-documentation">
diff --git a/doc/book-enea-nfv-access-release-info/doc/eltf_params_updated.xml b/doc/book-enea-nfv-access-release-info/doc/eltf_params_updated.xml
index 503eb7c..7be944e 100644
--- a/doc/book-enea-nfv-access-release-info/doc/eltf_params_updated.xml
+++ b/doc/book-enea-nfv-access-release-info/doc/eltf_params_updated.xml
@@ -22,7 +22,7 @@
     <bridgehead>A programlisting, ID
     "eltf-prereq-apt-get-commands-host"</bridgehead>
 
-    <para id="eltf-prereq-apt-get-commands-host"><programlisting># Host Ubuntu 14.04.5 LTS 64bit
+    <para id="eltf-prereq-apt-get-commands-host"><programlisting># Host Ubuntu 16.04 LTS 64bit
 sudo apt-get -y update
 sudo apt-get -y install sed wget subversion git-core coreutils unzip texi2html \
    texinfo libsdl1.2-dev docbook-utils fop gawk python-pysqlite2 diffstat \
diff --git a/doc/book-enea-nfv-access-release-info/doc/getting_enea_nfv_access.xml b/doc/book-enea-nfv-access-release-info/doc/getting_enea_nfv_access.xml
index aedfd1b..ccbf8d3 100644
--- a/doc/book-enea-nfv-access-release-info/doc/getting_enea_nfv_access.xml
+++ b/doc/book-enea-nfv-access-release-info/doc/getting_enea_nfv_access.xml
@@ -10,6 +10,8 @@
   faster. Please refer to the sections below for details on how to get Enea
   NFV Access as pre-built binary images or source code.</para>
 
+  <remark>fix this para above to not sound so EL influenced</remark>
+
   <section id="relinfo-getting-pre-built-images">
     <title>Getting Pre-built Binaries</title>
 
@@ -22,6 +24,8 @@
     and the <emphasis role="bold">Online Documentation</emphasis>
     section.</para>
 
+    <remark>fix this para above to not sound so EL influenced</remark>
+
     <para>The Files section lists each Enea NFV Access distribution, one for
     each version and profile, as a separate download package. Clicking on the
     name of the distribution will open a new page, which presents further
@@ -56,14 +60,14 @@
     release:</para>
 
     <itemizedlist>
-      <listitem>
+      <listitem condition="hidden">
         <para><emphasis role="bold">Enea NFV Access Developer&rsquo;s
         Guide</emphasis> -intended for Enea NFV Access developers, who want to
         configure and build customized NFV Access kernel images for embedded
         system targets, using the Yocto configuration and build system.</para>
       </listitem>
 
-      <listitem>
+      <listitem condition="hidden">
         <para><emphasis role="bold">Enea NFV Access Application Developer's
         Guide</emphasis> - dedicated to Enea NFV Access application
         developers, who want to build and run applications.</para>
diff --git a/doc/book-enea-nfv-access-release-info/doc/main_changes.xml b/doc/book-enea-nfv-access-release-info/doc/main_changes.xml
index 3dd3e80..e3dff3b 100644
--- a/doc/book-enea-nfv-access-release-info/doc/main_changes.xml
+++ b/doc/book-enea-nfv-access-release-info/doc/main_changes.xml
@@ -4,10 +4,7 @@
 <chapter id="relinfo-changes">
   <title>Main Changes</title>
 
-  <para>N/A.</para>
-
-  <para>This is the first release of Enea NFV Access, Networking
-  profile.</para>
+  <para>N/A. This is the first release of Enea NFV Access.</para>
 
   <section id="relinfo-changes-other">
     <title>New Features</title>
@@ -17,15 +14,11 @@
 
     <itemizedlist spacing="compact">
       <listitem>
-        <para>New Yocto version (<xi:include href="eltf_params_updated.xml"
-        xmlns:xi="http://www.w3.org/2001/XInclude"
-        xpointer="element(Yocto_VER/1)" />). See <ulink
-        url="https://www.yoctoproject.org/downloads/core/krogoth21">https://www.yoctoproject.org/downloads/core/krogoth21</ulink>.</para>
+        <para></para>
       </listitem>
 
       <listitem>
-        <para>Introduction of the repo tool to manage the Git
-        repositories.</para>
+        <para></para>
       </listitem>
     </itemizedlist>
 
diff --git a/doc/book-enea-nfv-access-release-info/doc/system_requirements_prerequisites.xml b/doc/book-enea-nfv-access-release-info/doc/system_requirements_prerequisites.xml
index f4a815f..3217339 100644
--- a/doc/book-enea-nfv-access-release-info/doc/system_requirements_prerequisites.xml
+++ b/doc/book-enea-nfv-access-release-info/doc/system_requirements_prerequisites.xml
@@ -10,20 +10,10 @@
   <section id="enea-nfv-access-sysreq">
     <title>System Requirements</title>
 
-    <para>The host requirements listed below are extensive to allow for the
-    building of Linux images via the Yocto system, and not just
+    <para>The host requirements listed below are extensive to allow getting
+    Enea NFV Access to be booted on target machines and for building
     applications.</para>
 
-    <para>Please also see the system requirements in the Yocto 2.1 documents:
-    Yocto Project Start <ulink
-    url="http://www.yoctoproject.org/docs/2.1/yocto-project-qs/yocto-project-qs.html#yp-resources">
-    http://www.yoctoproject.org/docs/2.1/yocto-project-qs/yocto-project-qs.html#yp-resources</ulink>
-    and the Yocto Project Reference Manual <ulink
-    url="http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#intro-requirements">
-    http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#intro-requirements</ulink>.
-    If needed, replace the Yocto version in the link(s) provided with a more
-    recent version.</para>
-
     <informaltable>
       <tgroup cols="2">
         <colspec align="left" colname="1" colwidth="1*" />
@@ -34,8 +24,8 @@
 
         <tbody>
           <row>
-            <entry spanname="onetwo"><emphasis role="bold"> Build host
-            requirements<indexterm>
+            <entry spanname="onetwo"><emphasis role="bold"> Build Host
+            Requirements<indexterm>
                 <primary>system requirements</primary>
               </indexterm></emphasis></entry>
           </row>
@@ -43,107 +33,31 @@
           <row>
             <entry>Linux distribution</entry>
 
-            <entry>The downloaded code shall be built on a Linux host to
-            generate images for your target or for emulation in QEMU. For
-            information about the supported hosts and targets, see the
-            <emphasis role="bold">Enea Linux Release Information</emphasis> in
-            your Enea Linux distribution.</entry>
-          </row>
-
-          <row>
-            <entry>Internet access</entry>
-
-            <entry>Internet access must be available when building an image,
-            since bitbake downloads source files from various servers during
-            the build.</entry>
+            <entry>The downloaded product can installed on the target machine
+            using a Linux host. For information about the supported hosts and
+            targets, see <xref
+            linkend="relinfo-supported-host-environment" />.</entry>
           </row>
 
           <row>
             <entry>Packages</entry>
 
-            <entry>Depending on the Linux distribution and version on host,
-            some packages may be required, by bitbake for example. You will
-            install any required packages while following the installation
-            instructions.</entry>
-          </row>
-
-          <row>
-            <entry>Targets</entry>
-
-            <entry>Images can be built or downloaded for any of the targets
-            supported in this release, as specified in the <emphasis
-            role="bold">Enea Linux Release Information</emphasis>.</entry>
+            <entry>Depending on the Linux distribution and version of the
+            host, some packages may be required. See details on what packages
+            are needed and how to install, in the following sections.</entry>
           </row>
 
           <row>
             <entry>Disk space</entry>
 
-            <entry><para>Your system should have at least 50 GB of free disk
-            space when bitbaking the basic enea-image-name kernel
-            image.</para> <para>For larger images and to allow for future
-            package extensions and variations in the build process, a minimum
-            of 100 GB free disk space is recommended.</para></entry>
+            <entry>Your system should have at least 50 GB of free disk space
+            for installing the SDK or cross-compiling applications.</entry>
           </row>
 
           <row>
             <entry>Recommended RAM</entry>
 
-            <entry><para>Your system must have at least 4 GB available
-            RAM.</para> <para>It is recommended to have 8 GB RAM available for
-            parallel build jobs.</para></entry>
-          </row>
-
-          <row>
-            <entry>Java</entry>
-
-            <entry>Java <indexterm>
-                <primary>java</primary>
-              </indexterm>is required to run Eclipse. Currenly, Eclipse
-            generally recommends at least Java 6 JRE/JDK. More information
-            regarding operating environments for Eclipse, is provided in the
-            <emphasis>Eclipse Project Release Notes</emphasis> for the version
-            used. This can usually be found via
-            http://www.eclipse.org/eclipse/development/readme_eclipse_version.
-            See the <emphasis role="bold">Enea Linux Release Information
-            </emphasis>for the Eclipse Version.</entry>
-          </row>
-        </tbody>
-      </tgroup>
-    </informaltable>
-
-    <para>The build time depends on the capacity of the processor and other
-    hardware, available resources, speed of internet connection, load
-    situation, etc. E.g: on a fast 16 core machine with 16 GB RAM and SSD
-    disks, a complete build from source could take about two hours.</para>
-
-    <informaltable>
-      <tgroup cols="2">
-        <colspec align="left" colname="1" colwidth="1*" />
-
-        <colspec align="left" colname="2" colwidth="3*" />
-
-        <spanspec nameend="2" namest="1" spanname="onetwo" />
-
-        <tbody>
-          <row>
-            <entry spanname="onetwo"><emphasis role="bold">Target
-            Requirements</emphasis></entry>
-          </row>
-
-          <row>
-            <entry>External memory</entry>
-
-            <entry>To boot a CGL<indexterm>
-                <primary>CGL</primary>
-              </indexterm> image, you need at least 16 GB on a hard-disk
-            drive<indexterm>
-                <primary>HDD</primary>
-              </indexterm> on eSATA, USB drive, or SD card.<remark>INFO:
-            (packed rootfs 4.5 GB + unpacked rootfs 1.5 GB + good
-            margins)</remark><remark>INFO: NFS does not support SELinux. In
-            order to have a security-enhanced Linux, one must take off from an
-            NFS-booted system and proceed with boot from external
-            memory.</remark></entry>
+            <entry>Your system must have at least 4 GB available RAM.</entry>
           </row>
         </tbody>
       </tgroup>
@@ -153,7 +67,7 @@
   <section id="ensure-bash">
     <title>System Shell Configuration</title>
 
-    <para>Before installing Enea Linux, ensure that bash is the default
+    <para>Before installing Enea NFV Access, ensure that bash is the default
     shell.</para>
 
     <para>If your system runs Ubuntu, you can use ls -l to ensure
@@ -182,4 +96,10 @@
                 xmlns:xi="http://www.w3.org/2001/XInclude"
                 xpointer="element(eltf-prereq-apt-get-commands-host/1)" />
   </section>
+
+  <section id="dns-server">
+    <title>Installing and Configuring the DNS server</title>
+
+    <para>CONTENT NEEDED</para>
+  </section>
 </chapter>
\ No newline at end of file