diff options
Diffstat (limited to 'doc/book-enea-linux-release-info/doc/getting_enea_linux.xml')
-rw-r--r-- | doc/book-enea-linux-release-info/doc/getting_enea_linux.xml | 103 |
1 files changed, 103 insertions, 0 deletions
diff --git a/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml b/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml new file mode 100644 index 0000000..f25c1a5 --- /dev/null +++ b/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml | |||
@@ -0,0 +1,103 @@ | |||
1 | <?xml version="1.0" encoding="ISO-8859-1"?> | ||
2 | <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | ||
3 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | ||
4 | <chapter id="relinfo-getting-enea-linux"> | ||
5 | <title>Getting Enea Linux</title> | ||
6 | |||
7 | <section id="relinfo-getting-pre-built-images"> | ||
8 | <title>Getting Pre-built Binaries</title> | ||
9 | |||
10 | <para>Application developers will download pre-complied images from the | ||
11 | Enea Portal or will receive prebuilt images from the platform developers. | ||
12 | For further information on this see <olink | ||
13 | targetdoc="book_enea_linux_app_dev_guide" | ||
14 | targetptr="book_enea_linux_app_dev_guide">Enea Linux Application | ||
15 | Development Guide</olink>.</para> | ||
16 | </section> | ||
17 | |||
18 | <section id="relinfo-getting-source"> | ||
19 | <title>Getting the Source</title> | ||
20 | |||
21 | <para>The source for this Enea Linux release is available for cloning from | ||
22 | a set of Git repositories. To manage the different repositories, Google's | ||
23 | repo tool is used. The basic idea is to store a list with (repo-URL, | ||
24 | version) tuples in a separate file, known as the manifest. The repo tool | ||
25 | is then used to traverse the list and clone the specified versions of the | ||
26 | repositories. See <ulink | ||
27 | url="https://code.google.com/p/git-repo/">https://code.google.com/p/git-repo/</ulink> | ||
28 | for more info.</para> | ||
29 | |||
30 | <para>To use repo tool to download the source for Enea Linux, follow the | ||
31 | steps below:</para> | ||
32 | |||
33 | <orderedlist> | ||
34 | <listitem> | ||
35 | <para>Make sure that the repo tool is installed. If not, follow the | ||
36 | instructions below:</para> | ||
37 | |||
38 | <para><programlisting>$ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo | ||
39 | $ chmod a+x ~/bin/repo</programlisting>The instruction assumes that ~/bin | ||
40 | exists and is included in the PATH variable.</para> | ||
41 | </listitem> | ||
42 | |||
43 | <listitem> | ||
44 | <para>Use the repo tool to download the source:<remark>FIXME: Before | ||
45 | final release the tag for the manifest must be set in Makefile as | ||
46 | MANIFESTHASH, typically something like refs/tags/EL6. Before that, a | ||
47 | generic branch name is used instead, e.g. krogoth in | ||
48 | Makefile</remark></para> | ||
49 | |||
50 | <para><programlisting>$ mkdir enea-linux | ||
51 | $ cd enea-linux | ||
52 | $ repo init -u <xi:include href="../../s_docsrc_common/pardoc-distro.xml" | ||
53 | xmlns:xi="http://www.w3.org/2001/XInclude" | ||
54 | xpointer="element(EneaLinux_MANIFESTURL/1)" /> \ | ||
55 | -b <xi:include href="../../s_docsrc_common/pardoc-distro.xml" | ||
56 | xmlns:xi="http://www.w3.org/2001/XInclude" | ||
57 | xpointer="element(EneaLinux_MANIFESTHASH/1)" /> \ | ||
58 | -m <manifest file> | ||
59 | $ repo sync</programlisting></para> | ||
60 | |||
61 | <para>The parameter <manifest file> depends on the target. See | ||
62 | the following table:</para> | ||
63 | |||
64 | <informaltable> | ||
65 | <tgroup cols="2"> | ||
66 | <thead> | ||
67 | <row> | ||
68 | <entry align="center">Target</entry> | ||
69 | |||
70 | <entry align="center">Manifest file</entry> | ||
71 | </row> | ||
72 | </thead> | ||
73 | |||
74 | <tbody> | ||
75 | <row> | ||
76 | <entry>P2041RDB</entry> | ||
77 | |||
78 | <entry><para>p2041rdb/default.xml</para></entry> | ||
79 | </row> | ||
80 | </tbody> | ||
81 | </tgroup> | ||
82 | </informaltable> | ||
83 | </listitem> | ||
84 | </orderedlist> | ||
85 | |||
86 | <para>The source code is now downloaded. Current directory will contain a | ||
87 | README file with instructions on how to build the distro and boot the | ||
88 | target. For convenience, these instructions are also copied into this | ||
89 | document. See <xref linkend="relinfo-build-boot" />.</para> | ||
90 | |||
91 | <para>It is not necessary to explicitly clone the manifest repository | ||
92 | since that is done automatically by the repo tool. To see the current | ||
93 | manifest, e.g. to get a list of the repositories, use the following | ||
94 | command:</para> | ||
95 | |||
96 | <programlisting>$ repo manifest</programlisting> | ||
97 | |||
98 | <remark>The UG should be updated with instructions on how to add | ||
99 | customisations. That section should also contain some more info about the | ||
100 | manifest: The manifest templates, using a branch instead of the tag EL6, | ||
101 | ... When this is done a reference from here should be added.</remark> | ||
102 | </section> | ||
103 | </chapter> \ No newline at end of file | ||