summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMiruna Paun <Miruna.Paun@enea.com>2017-03-29 10:49:46 +0200
committerMiruna Paun <Miruna.Paun@enea.com>2017-03-29 10:49:46 +0200
commit6c566e97a4a2b182ee2796660b489b9e3c1b8d23 (patch)
tree14d70e452c5bf9b467c5e1866e972cc92781367b
parent2fe27d1b6e900c22c36d251e2e61fb1ceb6a5616 (diff)
downloadel_releases-standard-6c566e97a4a2b182ee2796660b489b9e3c1b8d23.tar.gz
Small corrections made to formatting
2 files affected sys req and prereq Signed-off-by: Miruna Paun <Miruna.Paun@enea.com>
-rw-r--r--doc/book-enea-linux-release-info/doc/prerequisites.xml10
-rw-r--r--doc/book-enea-linux-release-info/doc/system_requirements.xml110
2 files changed, 73 insertions, 47 deletions
diff --git a/doc/book-enea-linux-release-info/doc/prerequisites.xml b/doc/book-enea-linux-release-info/doc/prerequisites.xml
index bd37e85..93330d6 100644
--- a/doc/book-enea-linux-release-info/doc/prerequisites.xml
+++ b/doc/book-enea-linux-release-info/doc/prerequisites.xml
@@ -5,8 +5,8 @@
5 <title>Prerequisites</title> 5 <title>Prerequisites</title>
6 6
7 <para>Building Enea Linux or compiling applications requires that your git 7 <para>Building Enea Linux or compiling applications requires that your git
8 environment be setup properly, and for certain packages to be installed on 8 environment be setup properly and for certain packages to be installed on
9 your Linux development host. </para> 9 your Linux development host.</para>
10 10
11 <para>Please refer to <ulink 11 <para>Please refer to <ulink
12 url="https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup">Getting 12 url="https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup">Getting
@@ -28,5 +28,7 @@ $ git config --global user.email johndoe@example.com</programlisting>
28 <xi:include href="eltf_params_updated.xml" 28 <xi:include href="eltf_params_updated.xml"
29 xmlns:xi="http://www.w3.org/2001/XInclude" 29 xmlns:xi="http://www.w3.org/2001/XInclude"
30 xpointer="element(eltf-prereq-apt-get-commands-host/1)" /> 30 xpointer="element(eltf-prereq-apt-get-commands-host/1)" />
31 <xi:include href="system_requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> 31
32</chapter> 32 <xi:include href="system_requirements.xml"
33 xmlns:xi="http://www.w3.org/2001/XInclude" />
34</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
index d0a8633..fb55c8e 100644
--- a/doc/book-enea-linux-release-info/doc/system_requirements.xml
+++ b/doc/book-enea-linux-release-info/doc/system_requirements.xml
@@ -3,27 +3,33 @@
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> 3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<section id="enea-linux-sysreq"> 4<section id="enea-linux-sysreq">
5 <title>System Requirements</title> 5 <title>System Requirements</title>
6 <para>The host requirements listed below are extensive to allow for the building of
7Linux images via the Yocto system, and not just applications.</para>
8 6
9 <para>Please also see the system requirements in the Yocto 2.1 documents: Yocto Project Start <ulink 7 <para>The host requirements listed below are extensive to allow for the
8 building of Linux images via the Yocto system, and not just
9 applications.</para>
10
11 <para>Please also see the system requirements in the Yocto 2.1 documents:
12 Yocto Project Start <ulink
10 url="http://www.yoctoproject.org/docs/2.1/yocto-project-qs/yocto-project-qs.html#yp-resources"> 13 url="http://www.yoctoproject.org/docs/2.1/yocto-project-qs/yocto-project-qs.html#yp-resources">
11 http://www.yoctoproject.org/docs/2.1/yocto-project-qs/yocto-project-qs.html#yp-resources</ulink> 14 http://www.yoctoproject.org/docs/2.1/yocto-project-qs/yocto-project-qs.html#yp-resources</ulink>
12 and the Yocto Project Reference Manual <ulink 15 and the Yocto Project Reference Manual <ulink
13 url="http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#intro-requirements"> 16 url="http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#intro-requirements">
14 http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#intro-requirements</ulink>. 17 http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#intro-requirements</ulink>.
15 If needed, replace the Yocto version in the links provided with a more recent version.</para> 18 If needed, replace the Yocto version in the links provided with a more
19 recent version.</para>
16 20
17 <informaltable> 21 <informaltable>
18 <tgroup cols="2"> 22 <tgroup cols="2">
19 <colspec align="left" colname="1" colwidth="1*" /> 23 <colspec align="left" colname="1" colwidth="1*" />
24
20 <colspec align="left" colname="2" colwidth="3*" /> 25 <colspec align="left" colname="2" colwidth="3*" />
26
21 <spanspec nameend="2" namest="1" spanname="onetwo" /> 27 <spanspec nameend="2" namest="1" spanname="onetwo" />
22 28
23 <tbody> 29 <tbody>
24 <row> 30 <row>
25 <entry spanname="onetwo"><emphasis role="bold"> 31 <entry spanname="onetwo"><emphasis role="bold"> Build host
26 Build host requirements<indexterm> 32 requirements<indexterm>
27 <primary>system requirements</primary> 33 <primary>system requirements</primary>
28 </indexterm></emphasis></entry> 34 </indexterm></emphasis></entry>
29 </row> 35 </row>
@@ -31,47 +37,54 @@ Linux images via the Yocto system, and not just applications.</para>
31 <row> 37 <row>
32 <entry>Linux distribution</entry> 38 <entry>Linux distribution</entry>
33 39
34 <entry>The downloaded code shall be built on a Linux host to generate images for your 40 <entry>The downloaded code shall be built on a Linux host to
35 target or for emulation in QEMU. For information about the supported hosts and targets, see the 41 generate images for your target or for emulation in QEMU. For
36 <emphasis role="bold">Enea Linux Release Information</emphasis> in your Enea Linux distribution.</entry> 42 information about the supported hosts and targets, see the <emphasis
43 role="bold">Enea Linux Release Information</emphasis> in your Enea
44 Linux distribution.</entry>
37 </row> 45 </row>
38 46
39 <row> 47 <row>
40 <entry>Internet access</entry> 48 <entry>Internet access</entry>
41 49
42 <entry>Internet access must be available when building an image, since bitbake downloads 50 <entry>Internet access must be available when building an image,
43 source files from various servers during the build.</entry> 51 since bitbake downloads source files from various servers during the
52 build.</entry>
44 </row> 53 </row>
45 54
46 <row> 55 <row>
47 <entry>Packages</entry> 56 <entry>Packages</entry>
48 57
49 <entry>Depending on the Linux distribution and version on host, some packages may be required, 58 <entry>Depending on the Linux distribution and version on host, some
50 by bitbake for example. You will install any required packages while following the installation 59 packages may be required, by bitbake for example. You will install
51 instructions.</entry> 60 any required packages while following the installation
61 instructions.</entry>
52 </row> 62 </row>
53 63
54 <row> 64 <row>
55 <entry>Targets</entry> 65 <entry>Targets</entry>
56 66
57 <entry>Images can be built or downloaded for any of the targets supported in this release, 67 <entry>Images can be built or downloaded for any of the targets
58 as specified in the <emphasis role="bold">Enea Linux Release Information</emphasis>.</entry> 68 supported in this release, as specified in the <emphasis
69 role="bold">Enea Linux Release Information</emphasis>.</entry>
59 </row> 70 </row>
60 71
61 <row> 72 <row>
62 <entry>Disk space</entry> 73 <entry>Disk space</entry>
63 74
64 <entry><para>Your system should have at least 50 GB of free disk space when bitbaking the 75 <entry><para>Your system should have at least 50 GB of free disk
65 basic enea-image-name kernel image.</para> 76 space when bitbaking the basic enea-image-name kernel image.</para>
66 <para>For larger images and to allow for future package extensions and variations 77 <para>For larger images and to allow for future package extensions
67 in the build process, a minimum of 100 GB free disk space is recommended.</para></entry> 78 and variations in the build process, a minimum of 100 GB free disk
79 space is recommended.</para></entry>
68 </row> 80 </row>
69 81
70 <row> 82 <row>
71 <entry>Recommended RAM</entry> 83 <entry>Recommended RAM</entry>
72 84
73 <entry><para>Your system must have at least 4 GB available RAM.</para> 85 <entry><para>Your system must have at least 4 GB available
74 <para>It is recommended to have 8 GB RAM available for parallel build jobs.</para></entry> 86 RAM.</para> <para>It is recommended to have 8 GB RAM available for
87 parallel build jobs.</para></entry>
75 </row> 88 </row>
76 89
77 <row> 90 <row>
@@ -79,30 +92,36 @@ Linux images via the Yocto system, and not just applications.</para>
79 92
80 <entry>Java <indexterm> 93 <entry>Java <indexterm>
81 <primary>java</primary> 94 <primary>java</primary>
82 </indexterm>is required to run Eclipse. Currenly, Eclipse generally recommends at least 95 </indexterm>is required to run Eclipse. Currenly, Eclipse
83 Java 6 JRE/JDK. More information regarding operating environments for Eclipse, is provided in the 96 generally recommends at least Java 6 JRE/JDK. More information
84 <emphasis>Eclipse Project Release Notes</emphasis> for the version 97 regarding operating environments for Eclipse, is provided in the
85 used. This can usually be found via http://www.eclipse.org/eclipse/development/readme_eclipse_version. 98 <emphasis>Eclipse Project Release Notes</emphasis> for the version
86 See the <emphasis role="bold">Enea Linux Release Information 99 used. This can usually be found via
87 </emphasis>for the Eclipse Version.</entry> 100 http://www.eclipse.org/eclipse/development/readme_eclipse_version.
101 See the <emphasis role="bold">Enea Linux Release Information
102 </emphasis>for the Eclipse Version.</entry>
88 </row> 103 </row>
89 </tbody> 104 </tbody>
90 </tgroup> 105 </tgroup>
91 </informaltable> 106 </informaltable>
92 107
93 <para>The build time depends on the capacity of the processor and other hardware, available resources, 108 <para>The build time depends on the capacity of the processor and other
94 speed of internet connection, load situation, etc. E.g: on a fast 16 core machine with 16 GB RAM and 109 hardware, available resources, speed of internet connection, load situation,
95 SSD disks, a complete build from source could take about two hours.</para> 110 etc. E.g: on a fast 16 core machine with 16 GB RAM and SSD disks, a complete
111 build from source could take about two hours.</para>
96 112
97 <informaltable> 113 <informaltable>
98 <tgroup cols="2"> 114 <tgroup cols="2">
99 <colspec align="left" colname="1" colwidth="1*" /> 115 <colspec align="left" colname="1" colwidth="1*" />
116
100 <colspec align="left" colname="2" colwidth="3*" /> 117 <colspec align="left" colname="2" colwidth="3*" />
118
101 <spanspec nameend="2" namest="1" spanname="onetwo" /> 119 <spanspec nameend="2" namest="1" spanname="onetwo" />
102 120
103 <tbody> 121 <tbody>
104 <row> 122 <row>
105 <entry spanname="onetwo"><emphasis role="bold">Target Requirements</emphasis></entry> 123 <entry spanname="onetwo"><emphasis role="bold">Target
124 Requirements</emphasis></entry>
106 </row> 125 </row>
107 126
108 <row> 127 <row>
@@ -110,12 +129,15 @@ Linux images via the Yocto system, and not just applications.</para>
110 129
111 <entry>To boot a CGL<indexterm> 130 <entry>To boot a CGL<indexterm>
112 <primary>CGL</primary> 131 <primary>CGL</primary>
113 </indexterm> image, you need at least 16 GB on a hard-disk drive<indexterm> 132 </indexterm> image, you need at least 16 GB on a hard-disk
133 drive<indexterm>
114 <primary>HDD</primary> 134 <primary>HDD</primary>
115 </indexterm> on eSATA, USB drive, or SD card.<remark>INFO: (packed rootfs 4.5 GB + unpacked 135 </indexterm> on eSATA, USB drive, or SD card.<remark>INFO: (packed
116 rootfs 1.5 GB + good margins)</remark><remark>INFO: NFS does not support SELinux. In 136 rootfs 4.5 GB + unpacked rootfs 1.5 GB + good
117 order to have a security-enhanced Linux, one must take off from an NFS-booted system and 137 margins)</remark><remark>INFO: NFS does not support SELinux. In
118 proceed with boot from external memory.</remark></entry> 138 order to have a security-enhanced Linux, one must take off from an
139 NFS-booted system and proceed with boot from external
140 memory.</remark></entry>
119 </row> 141 </row>
120 </tbody> 142 </tbody>
121 </tgroup> 143 </tgroup>
@@ -124,13 +146,15 @@ Linux images via the Yocto system, and not just applications.</para>
124 <section id="ensure-bash"> 146 <section id="ensure-bash">
125 <title>System Shell Configuration</title> 147 <title>System Shell Configuration</title>
126 148
127 <para>Before installing Enea Linux, ensure that bash is the default shell.</para> 149 <para>Before installing Enea Linux, ensure that bash is the default
150 shell.</para>
128 151
129 <para>If your system runs Ubuntu, you can use ls -l to ensure <filename>/usr/bin</filename> is a 152 <para>If your system runs Ubuntu, you can use ls -l to ensure
130 symbolic link to bash. In case the link points to dash, which is default in some Ubuntu versions, 153 <filename>/usr/bin</filename> is a symbolic link to bash. In case the link
131 change it to bash by running <emphasis role="bold">sudo dpkg-reconfigure dash</emphasis> and answer 154 points to dash, which is default in some Ubuntu versions, change it to
132 <emphasis role="bold">No</emphasis> to the question "Use dash as the default system shell (/bin/sh)?": 155 bash by running <emphasis role="bold">sudo dpkg-reconfigure
133 </para> 156 dash</emphasis> and answer <emphasis role="bold">No</emphasis> to the
157 question "Use dash as the default system shell (/bin/sh)?":</para>
134 158
135 <programlisting># ls -l /bin/sh 159 <programlisting># ls -l /bin/sh
136 lrwxrwxrwx 1 root root 4 2012-03-02 11:53 /bin/sh -&gt; bash</programlisting> 160 lrwxrwxrwx 1 root root 4 2012-03-02 11:53 /bin/sh -&gt; bash</programlisting>