diff options
author | Miruna Paun <Miruna.Paun@enea.com> | 2017-03-29 10:49:46 +0200 |
---|---|---|
committer | Miruna Paun <Miruna.Paun@enea.com> | 2017-03-29 10:49:46 +0200 |
commit | 6c566e97a4a2b182ee2796660b489b9e3c1b8d23 (patch) | |
tree | 14d70e452c5bf9b467c5e1866e972cc92781367b | |
parent | 2fe27d1b6e900c22c36d251e2e61fb1ceb6a5616 (diff) | |
download | el_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.xml | 10 | ||||
-rw-r--r-- | doc/book-enea-linux-release-info/doc/system_requirements.xml | 110 |
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 | ||
7 | Linux 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 -> bash</programlisting> | 160 | lrwxrwxrwx 1 root root 4 2012-03-02 11:53 /bin/sh -> bash</programlisting> |