diff options
Diffstat (limited to 'doc/book-enea-linux-release-info/doc/system_requirements.xml')
-rw-r--r-- | doc/book-enea-linux-release-info/doc/system_requirements.xml | 159 |
1 files changed, 159 insertions, 0 deletions
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..cc1248e --- /dev/null +++ b/doc/book-enea-linux-release-info/doc/system_requirements.xml | |||
@@ -0,0 +1,159 @@ | |||
1 | <?xml version="1.0" encoding="ISO-8859-1"?> | ||
2 | <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | ||
3 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | ||
4 | <section id="enea-linux-sysreq"> | ||
5 | <title>System Requirements</title> | ||
6 | |||
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.3 documents: | ||
12 | <ulink | ||
13 | url="http://www.yoctoproject.org/docs/2.3/yocto-project-qs/yocto-project-qs.html#yp-resources">Yocto | ||
14 | Project Start</ulink> and the <ulink | ||
15 | url="http://www.yoctoproject.org/docs/2.3/ref-manual/ref-manual.html#intro-requirements">Yocto | ||
16 | Project Reference Manual</ulink>. If needed, replace the Yocto version in | ||
17 | the links provided with a more recent version.</para> | ||
18 | |||
19 | <informaltable> | ||
20 | <tgroup cols="2"> | ||
21 | <colspec align="left" colname="1" colwidth="1*" /> | ||
22 | |||
23 | <colspec align="left" colname="2" colwidth="3*" /> | ||
24 | |||
25 | <spanspec nameend="2" namest="1" spanname="onetwo" /> | ||
26 | |||
27 | <tbody> | ||
28 | <row> | ||
29 | <entry spanname="onetwo"><emphasis role="bold"> Build host | ||
30 | requirements<indexterm> | ||
31 | <primary>system requirements</primary> | ||
32 | </indexterm></emphasis></entry> | ||
33 | </row> | ||
34 | |||
35 | <row> | ||
36 | <entry>Linux distribution</entry> | ||
37 | |||
38 | <entry>The downloaded code shall be built on a Linux host to | ||
39 | generate images for your target or for emulation in QEMU. For | ||
40 | information about the supported hosts and targets, see the <emphasis | ||
41 | role="bold">Enea Linux Release Information</emphasis> in your Enea | ||
42 | Linux distribution.</entry> | ||
43 | </row> | ||
44 | |||
45 | <row> | ||
46 | <entry>Internet access</entry> | ||
47 | |||
48 | <entry>Internet access must be available when building an image, | ||
49 | since bitbake downloads source files from various servers during the | ||
50 | build.</entry> | ||
51 | </row> | ||
52 | |||
53 | <row> | ||
54 | <entry>Packages</entry> | ||
55 | |||
56 | <entry>Depending on the Linux distribution and version on host, some | ||
57 | packages may be required, by bitbake for example. You will install | ||
58 | any required packages while following the installation | ||
59 | instructions.</entry> | ||
60 | </row> | ||
61 | |||
62 | <row> | ||
63 | <entry>Targets</entry> | ||
64 | |||
65 | <entry>Images can be built or downloaded for any of the targets | ||
66 | supported in this release.</entry> | ||
67 | </row> | ||
68 | |||
69 | <row> | ||
70 | <entry>Disk space</entry> | ||
71 | |||
72 | <entry><para>Your system should have at least 50 GB of free disk | ||
73 | space when bitbaking the basic enea-image-name kernel image.</para> | ||
74 | <para>For larger images and to allow for future package extensions | ||
75 | and variations in the build process, a minimum of 100 GB free disk | ||
76 | space is recommended.</para></entry> | ||
77 | </row> | ||
78 | |||
79 | <row> | ||
80 | <entry>Recommended RAM</entry> | ||
81 | |||
82 | <entry><para>Your system must have at least 4 GB available | ||
83 | RAM.</para> <para>It is recommended to have 8 GB RAM available for | ||
84 | parallel build jobs.</para></entry> | ||
85 | </row> | ||
86 | |||
87 | <row> | ||
88 | <entry>Java</entry> | ||
89 | |||
90 | <entry>Java <indexterm> | ||
91 | <primary>java</primary> | ||
92 | </indexterm>is required to run Eclipse. Currently, Eclipse | ||
93 | generally recommends at least Java 6 JRE/JDK. More information | ||
94 | regarding operating environments for Eclipse is provided in the | ||
95 | <ulink | ||
96 | url="http://www.eclipse.org/eclipse/development/readme_eclipse_version">Eclipse | ||
97 | Project Release Notes</ulink> for the Eclipse version used in this | ||
98 | release. See the <emphasis role="bold">Enea Linux Release | ||
99 | Information </emphasis>for the Eclipse Version.</entry> | ||
100 | </row> | ||
101 | </tbody> | ||
102 | </tgroup> | ||
103 | </informaltable> | ||
104 | |||
105 | <para>The build time depends on the capacity of the processor and other | ||
106 | hardware, available resources, speed of internet connection, load situation, | ||
107 | etc. E.g: on a fast 16 core machine with 16 GB RAM and SSD disks, a complete | ||
108 | build from source could take about two hours.</para> | ||
109 | |||
110 | <informaltable> | ||
111 | <tgroup cols="2"> | ||
112 | <colspec align="left" colname="1" colwidth="1*" /> | ||
113 | |||
114 | <colspec align="left" colname="2" colwidth="3*" /> | ||
115 | |||
116 | <spanspec nameend="2" namest="1" spanname="onetwo" /> | ||
117 | |||
118 | <tbody> | ||
119 | <row> | ||
120 | <entry spanname="onetwo"><emphasis role="bold">Target | ||
121 | Requirements</emphasis></entry> | ||
122 | </row> | ||
123 | |||
124 | <row> | ||
125 | <entry>External memory</entry> | ||
126 | |||
127 | <entry>To boot a CGL<indexterm> | ||
128 | <primary>CGL</primary> | ||
129 | </indexterm> image, you need at least 16 GB on a hard-disk | ||
130 | drive<indexterm> | ||
131 | <primary>HDD</primary> | ||
132 | </indexterm> on an eSATA, USB drive, or SD card.<remark>INFO: | ||
133 | (packed rootfs 4.5 GB + unpacked rootfs 1.5 GB + good | ||
134 | margins)</remark><remark>INFO: NFS does not support SELinux. In | ||
135 | order to have a security-enhanced Linux, one must take off from an | ||
136 | NFS-booted system and proceed with boot from external | ||
137 | memory.</remark></entry> | ||
138 | </row> | ||
139 | </tbody> | ||
140 | </tgroup> | ||
141 | </informaltable> | ||
142 | |||
143 | <section id="ensure-bash"> | ||
144 | <title>System Shell Configuration</title> | ||
145 | |||
146 | <para>Before installing Enea Linux, ensure that bash is the default | ||
147 | shell.</para> | ||
148 | |||
149 | <para>If your system runs Ubuntu, you can use ls -l to ensure | ||
150 | <filename>/usr/bin</filename> is a symbolic link to bash. In case the link | ||
151 | points to dash, which is default in some Ubuntu versions, change it to | ||
152 | bash by running <emphasis role="bold">sudo dpkg-reconfigure | ||
153 | dash</emphasis> and answer <emphasis role="bold">No</emphasis> to the | ||
154 | question "Use dash as the default system shell (/bin/sh)?":</para> | ||
155 | |||
156 | <programlisting># ls -l /bin/sh | ||
157 | lrwxrwxrwx 1 root root 4 2012-03-02 11:53 /bin/sh -> bash</programlisting> | ||
158 | </section> | ||
159 | </section> \ No newline at end of file | ||