Updated the ENFV Release notes and debugged building the OSRs

LXCR-8001

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

2 files changed, 94 insertions, 101 deletions

diff --git a/doc/book-enea-nfv-access-dev-hardening-guide/doc/hardening_checklist.xml b/doc/book-enea-nfv-access-dev-hardening-guide/doc/hardening_checklist.xml
index 2e008e3..f444cd5 100644
--- a/doc/book-enea-nfv-access-dev-hardening-guide/doc/hardening_checklist.xml
+++ b/doc/book-enea-nfv-access-dev-hardening-guide/doc/hardening_checklist.xml
@@ -7,8 +7,8 @@
   <section id="broken_algorithms">
     <title>Broken Algorithms</title>
 
-    <para>Make sure that algorithms that are broken in regards to security are
-    not used.</para>
+    <para>Algorithms that are broken in regards to security must not be used.
+    The following should be verified to prevent this issue:</para>
 
     <remark>Ask Sona/Casc if the algorithms listed below are the broken ones
     to check for or if they're the ones that are broken to begin with and if
@@ -57,7 +57,7 @@
     <title>System Installation</title>
 
     <para>Enea NFV Access Images should be check summed with SHA512 and/or a
-    signed GPG key. See <ulink
+    signed GPG key. Please see <ulink
     url="https://www.openssl.org/source/">https://www.openssl.org/source/</ulink>
     for more details on how to proceed.</para>
   </section>
@@ -67,8 +67,8 @@
 
     <para>Applying security patches is an important part of security hardening
     and maintenance. Enea backports all known critical vulnerabilities within
-    a reasonable time frame if not immeditately, and makes them available to
-    users for updates/upgrades.</para>
+    a reasonable time frame and makes them available to users for
+    updates/upgrades.</para>
 
     <para>Prepare the system for regular updates in the following
     manner:</para>
@@ -89,9 +89,9 @@
   <section id="openembedded_security_layer">
     <title>OpenEmbedded meta-security layer</title>
 
-    <para>An OpenEmbedded meta-security layer provides many hardening tools.
-    These tools are open source packages suited for embedded devices. Below is
-    a list of several packages included in meta-security layer:</para>
+    <para>An OpenEmbedded meta-security layer provides many hardening open
+    source packages suited for embedded devices. Below is a list of several
+    packages included in meta-security layer:</para>
 
     <itemizedlist>
       <listitem>
@@ -139,11 +139,11 @@
     </itemizedlist>
 
     <para>For more information about tools supported in the meta-security
-    layer please refer to <emphasis role="bold">Introduction to the Tools in
-    meta-security layer</emphasis>.</para>
+    layer please refer to the chapter: <emphasis role="bold">Introduction to
+    the Tools in meta-security layer</emphasis>.</para>
 
     <remark>change the bold text to point to the section/chapter in question
-    through an xref</remark>
+    through an xref refering to chapter 3 of the same title.</remark>
   </section>
 
   <section id="ker-hardening">
diff --git a/doc/book-enea-nfv-access-dev-hardening-guide/doc/introduction.xml b/doc/book-enea-nfv-access-dev-hardening-guide/doc/introduction.xml
index bbf203f..aaeb6d6 100644
--- a/doc/book-enea-nfv-access-dev-hardening-guide/doc/introduction.xml
+++ b/doc/book-enea-nfv-access-dev-hardening-guide/doc/introduction.xml
@@ -4,124 +4,117 @@
 <chapter id="overview">
   <title>Overview</title>
 
-  <para>This document describes the activities needed for securing/hardening
-  Enea NFV Access platform by ESRT/ developers in order to fulfill the
-  security requirements specified in <ulink
+  <para>This document describes the activities needed for securing Enea NFV
+  Access platform by ESRT/ developers in order to fulfill the security
+  requirements specified in <ulink
   url="https://eneaissues.enea.com/browse/CPDX-2632">CPDX-2632</ulink> (see
-  the Security section under Pre-Study).</para>
+  the Security section under Pre-Study). For further information about the
+  hardening features available, please read <ulink
+  url="https://eneadoc.enea.com/idc/idcplg?IdcService=GET_FILE&amp;dDocName=055550&amp;Rendition=Primary&amp;RevisionSelectionMethod=Latest"><trademark
+  class="registered">Enea</trademark> NFV Access User's Hardening
+  Guide</ulink>.</para>
 
-  <section id="intro">
-    <title>Introduction</title>
+  <section id="rev_hist">
+    <title>Revision History</title>
 
-    <para>This document contains a checklist to use when hardening Enea NFV
-    Access. Please read <ulink
-    url="https://eneadoc.enea.com/idc/idcplg?IdcService=GET_FILE&amp;dDocName=055550&amp;Rendition=Primary&amp;RevisionSelectionMethod=Latest"><trademark
-    class="registered">Enea</trademark> NFV Access User's Hardening
-    Guide</ulink> for further information about the hardening features
-    available.</para>
+    <table>
+      <tgroup cols="4">
+        <colspec align="center" />
 
-    <section id="rev-hist">
-      <title>Revision History</title>
+        <thead>
+          <row>
+            <entry align="center">Revision</entry>
 
-      <table>
-        <tgroup cols="4">
-          <colspec align="center" />
+            <entry align="center">Author</entry>
 
-          <thead>
-            <row>
-              <entry align="center">Revision</entry>
+            <entry align="center">Date</entry>
 
-              <entry align="center">Author</entry>
+            <entry align="center">Purpose for Revision</entry>
+          </row>
+        </thead>
 
-              <entry align="center">Date</entry>
+        <tbody>
+          <row>
+            <entry>4</entry>
 
-              <entry align="center">Purpose for Revision</entry>
-            </row>
-          </thead>
+            <entry>Sona Sarmadi</entry>
 
-          <tbody>
-            <row>
-              <entry>4</entry>
+            <entry>2017-09-07</entry>
 
-              <entry>Sona Sarmadi</entry>
+            <entry>Added Appendix, sec 4.</entry>
+          </row>
 
-              <entry>2017-09-07</entry>
+          <row>
+            <entry>3</entry>
 
-              <entry>Added Appendix, sec 4.</entry>
-            </row>
+            <entry>Sona Sarmadi</entry>
 
-            <row>
-              <entry>3</entry>
+            <entry>2017-09-05</entry>
 
-              <entry>Sona Sarmadi</entry>
+            <entry>Added introduction to the tools in the Open Embedded
+            meta-security layer Fixed 1.1 Revision History.</entry>
+          </row>
 
-              <entry>2017-09-05</entry>
+          <row>
+            <entry>2</entry>
 
-              <entry>Added introduction to the tools in the Open Embedded
-              meta-security layer Fixed 1.1 Revision History.</entry>
-            </row>
+            <entry>Sona Sarmadi</entry>
 
-            <row>
-              <entry>2</entry>
+            <entry>2017-08-30</entry>
 
-              <entry>Sona Sarmadi</entry>
+            <entry>Made this document as a guideline for Enea NFV Access
+            developers. Moved section 2 and 3 to a new document (a guideline
+            only for users).</entry>
+          </row>
 
-              <entry>2017-08-30</entry>
+          <row>
+            <entry>1</entry>
 
-              <entry>Made this document as a guideline for Enea NFV Access
-              developers. Moved section 2 and 3 to a new document (a guideline
-              only for users).</entry>
-            </row>
+            <entry>Sona Sarmadi</entry>
 
-            <row>
-              <entry>1</entry>
+            <entry>2017-08-20</entry>
 
-              <entry>Sona Sarmadi</entry>
-
-              <entry>2017-08-20</entry>
-
-              <entry>Initial Revision</entry>
-            </row>
-          </tbody>
-        </tgroup>
-      </table>
-    </section>
-
-    <section id="references">
-      <title>References</title>
-
-      <itemizedlist>
-        <listitem>
-          <para><ulink
-          url="https://www.sans.org/reading-room/whitepapers/linux/linux-kernel-hardening-1294">SANS
-          linux-kernel-hardening-1294</ulink></para>
-        </listitem>
-
-        <listitem>
-          <para><ulink
-          url="https://lwn.net/Articles/705262/">lwn.net/Articles/705262/</ulink></para>
-        </listitem>
+            <entry>Initial Revision</entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </table>
+  </section>
 
-        <listitem>
-          <para><ulink
-          url="https://eneadoc.enea.com/idc/idcplg?IdcService=GET_FILE&amp;dDocName=055550&amp;Rendition=Primary&amp;RevisionSelectionMethod=Latest">Hardening
-          Guide for Users of Enea NFV Access</ulink><remark>Not sure if this
-          should remain an ulink to eneadoc or be changed to an olink to the
-          guide in question.</remark></para>
-        </listitem>
-      </itemizedlist>
-    </section>
+  <section id="references">
+    <title>References</title>
+
+    <itemizedlist>
+      <listitem>
+        <para><ulink
+        url="https://www.sans.org/reading-room/whitepapers/linux/linux-kernel-hardening-1294">SANS
+        linux-kernel-hardening-1294</ulink></para>
+      </listitem>
+
+      <listitem>
+        <para><ulink
+        url="https://lwn.net/Articles/705262/">lwn.net/Articles/705262/</ulink></para>
+      </listitem>
+
+      <listitem>
+        <para><ulink
+        url="https://eneadoc.enea.com/idc/idcplg?IdcService=GET_FILE&amp;dDocName=055550&amp;Rendition=Primary&amp;RevisionSelectionMethod=Latest">Hardening
+        Guide for Users of Enea NFV Access</ulink><remark>Not sure if this
+        should remain an ulink to eneadoc or be changed to an olink to the
+        guide in question.</remark></para>
+      </listitem>
+    </itemizedlist>
+  </section>
 
-    <section id="def_acro">
-      <title>Definitions and Acronyms</title>
+  <section id="def_acro">
+    <title>Definitions and Acronyms</title>
 
-      <para>Definitions</para>
+    <para>Definitions:</para>
 
-      <para>[FIXME]</para>
+    <para>[FIXME]</para>
 
-      <para>Acronyms</para>
+    <para>Acronyms:</para>
 
-      <para>[FIXME]</para>
-    </section>
+    <para>[FIXME]</para>
   </section>
 </chapter>
\ No newline at end of file