summaryrefslogtreecommitdiffstats
path: root/doc/system_requirements.xml
blob: fb55c8e1d3ba7616c0249432a77d67efbf0cb980 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
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>