summaryrefslogtreecommitdiffstats
path: root/doc/book-enea-linux-user-guide/doc/prerequisites_and_requirements.xml
blob: 688145f8c34c5ba1f43c732e40b2fb5a524fea17 (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
<?xml version="1.0" encoding="ISO-8859-1"?>
<chapter id="prereq_reqs">
  <title>Prerequisites and Requirements</title>

  <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. The following chapter details the
  configurations needed on the build environment in order to properly use Enea
  Linux.</para>

  <section id="gitconfig">
    <title>Git Configuration</title>

    <para>If you intend to get Enea Linux sources and build Enea Linux
    yourself, you will need Git installed in your build environemtn. Please
    refer to <ulink
    url="https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup">Getting
    Started - First-Time Git Setup</ulink>, for more details on how to set up
    your git environment correctly, including how to set your identity using
    the following commands:</para>

    <programlisting>$ git config --global user.name "John Doe"
$ git config --global user.email johndoe@example.com</programlisting>
  </section>

  <section id="hostpackages">
    <title>Host Packages</title>

    <para>In order to work with Enea Linux, you need a set of tools installed
    on the build machine, depending on the scenario you use. The following
    chapters will describe what tools to install on the build machine.</para>

    <section id="prebuiltprereq">
      <title>Using Pre-Build Binaries</title>

      <para>Using the pre-built binaries, you can get up and running more
      quickly. Since building is not required, there are not a lot of packaes
      and tools that need to be installed but a few are still required:</para>

      <itemizedlist>
        <listitem>
          <para>wget - for downloading the Enea Linux binaries</para>
        </listitem>

        <listitem>
          <para>tar - for decompressing the Enea Linux release</para>
        </listitem>

        <listitem>
          <para>tftpboot server - for deploying Enea Linux on target</para>
        </listitem>

        <listitem>
          <para>NFS server - in case you want to mount the root file system
          over NFS</para>
        </listitem>
      </itemizedlist>
    </section>

    <section id="hostprereqpackages">
      <title>Required Packages for the Host Development System</title>

      <para>Building Enea Linux requires a set of packages to be installed on
      your Linux development host. The list of required packages is described
      in the <ulink
      url="https://www.yoctoproject.org/docs/2.7/ref-manual/ref-manual.html#required-packages-for-the-host-development-system">Yocto
      Project reference manual</ulink>.</para>
    </section>
  </section>

  <section id="sysshell_config">
    <title>Default Shell Configuration</title>

    <para>Before installing Enea Linux, make sure that
    <filename>bash</filename> is the default shell.</para>

    <para><emphasis role="bold">To verify the default system
    shell</emphasis></para>

    <itemizedlist>
      <listitem>
        <para>If your system runs Ubuntu, use list to verify if
        <filename>/usr/bin</filename> is a symbolic link to <emphasis
        role="bold">bash</emphasis>:</para>

        <programlisting># ls -l /bin/sh
lrwxrwxrwx 1 root root 4 2012-03-02 11:53 /bin/sh -&gt; bash</programlisting>
      </listitem>

      <listitem>
        <para>Optionally, in case the link points to <literal>dash</literal>,
        change it through the following steps:</para>

        <programlisting># ls -l /bin/sh
lrwxrwxrwx 1 root root 4 2012-03-02 11:53 /bin/sh -&gt; dash
# sudo dpkg-reconfigure dash
Use dash as the default system shell (/bin/sh)? No</programlisting>
      </listitem>
    </itemizedlist>
  </section>
</chapter>