Updated sys req and prereq xml files

LXCR-7634 prelimiary steps made, full
update to el_releases-common.git still in
progress

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

2 files changed, 175 insertions, 13 deletions

diff --git a/doc/book-enea-linux-release-info/doc/prerequisites.xml b/doc/book-enea-linux-release-info/doc/prerequisites.xml
index 1d883b1..197a48a 100644
--- a/doc/book-enea-linux-release-info/doc/prerequisites.xml
+++ b/doc/book-enea-linux-release-info/doc/prerequisites.xml
@@ -4,9 +4,12 @@
 <chapter id="prerequisites">
   <title>Prerequisites</title>
 
+  <xi:include href="system_requirements.xml"
+              xmlns:xi="http://www.w3.org/2001/XInclude" />
+
   <para>Building Enea Linux or compiling applications requires that your git
   environment be setup properly, and for certain packages to be installed on
-  your Linux development host. </para>
+  your Linux development host.</para>
 
   <para>Please refer to <ulink
   url="https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup">Getting
@@ -20,18 +23,15 @@ $ git config --global user.email johndoe@example.com</programlisting>
   <section id="inst-host-packages-ubuntu-debian">
     <title>Ubuntu 14.04 LTS, 64-bit</title>
 
-    <para>Ensure the system is up-to-date:</para>
-
-    <programlisting>$ sudo apt-get update</programlisting>
-
-    <para>For a supported <emphasis role="bold">Ubuntu</emphasis><indexterm>
-        <primary>Ubuntu</primary>
-      </indexterm> distribution you need the following packages:</para>
+    <para>For the supported distribution(s) you need the following packages:
+    <remark>INFO: The programlisting below is a parameter in
+    eltf_params_updated.xml with ID: "eltf-prereq-apt-get-command-host". If
+    multiple hosts are supported, store the commands for each host in the same
+    programlisting with empty lines between each - the comment with the FULL
+    HOST name and version is essential.</remark></para>
 
-    <programlisting>$ sudo apt-get install sed wget subversion git-core
-    coreutils unzip texi2html texinfo libsdl1.2-dev docbook-utils fop gawk
-    python-pysqlite2 diffstat make gcc build-essential xsltproc g++
-    desktop-file-utils chrpath libgl1-mesa-dev libglu1-mesa-dev autoconf automake
-    groff libtool xterm libxml-parser-perl</programlisting>
+    <!--    <xi:include href="eltf_params_updated.xml"
+                xmlns:xi="http://www.w3.org/2001/XInclude"
+                xpointer="element(eltf-prereq-apt-get-commands-host/1)" /> -->
   </section>
 </chapter>
\ No newline at end of file
diff --git a/doc/book-enea-linux-release-info/doc/system_requirements.xml b/doc/book-enea-linux-release-info/doc/system_requirements.xml
new file mode 100644
index 0000000..2c14761
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/system_requirements.xml
@@ -0,0 +1,162 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
+<section id="enea-linux-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
+  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 links provided with a more
+  recent version.</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"> Build host
+          requirements<indexterm>
+              <primary>system requirements</primary>
+            </indexterm></emphasis></entry>
+        </row>
+
+        <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>
+        </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>
+        </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>
+        </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>
+        </row>
+      </tbody>
+    </tgroup>
+  </informaltable>
+
+  <section id="ensure-bash">
+    <title>System Shell Configuration</title>
+
+    <para>Before installing Enea Linux, ensure that bash is the default
+    shell.</para>
+
+    <para>If your system runs Ubuntu, you can use ls -l to ensure
+    <filename>/usr/bin</filename> is a symbolic link to bash. In case the link
+    points to dash, which is default in some Ubuntu versions, change it to
+    bash by running <emphasis role="bold">sudo dpkg-reconfigure
+    dash</emphasis> and answer <emphasis role="bold">No</emphasis> to the
+    question "Use dash as the default system shell (/bin/sh)?":</para>
+
+    <programlisting># ls -l /bin/sh
+        lrwxrwxrwx 1 root root 4 2012-03-02 11:53 /bin/sh -&gt; bash</programlisting>
+  </section>
+</section>
\ No newline at end of file