summaryrefslogtreecommitdiffstats
path: root/doc/book-enea-nfv-access-release-info/doc/about_release.xml
blob: a3b6779456a569bfded5aff9831c5739f857b233 (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
163
164
165
166
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<chapter id="relinfo-about-release">
  <title>About This Release</title>

  <para>This release of Enea NFV Access <xi:include
  href="eltf_params_updated.xml" xmlns:xi="http://www.w3.org/2001/XInclude"
  xpointer="element(EneaLinux_REL_VER/1)" /> provides a publicly available
  Enea NFV Access distribution for a selected set of targets.<remark>INFO
  <emphasis role="bold">eltf_params_updated.xml</emphasis> contains many
  parameters in the book, also in the open source books, and MUST be created
  FROM <emphasis role="bold">eltf_params_template.xml</emphasis>. The
  parameters are automatically used in the books, via xi:include statements,
  similar to how parameters from pardoc-distro.xml are included in the book.
  Read the file <emphasis
  role="bold">eltf_params_updated_template_how_to_use.txt</emphasis> for
  important details about formats and how to do! The idea is that ELTF will
  auto-create/update it.</remark></para>

  <section id="release-content">
    <title>NFV Access Release content</title>

    <para>The current release contains along with other items, documentation,
    pre-built kernels and images, a bootloader and a SDK.</para>

    <para>The directories structure is detailed below:</para>

    <programlisting>-- documentation/
   /* NFV Access documentation */
-- inteld1521/
   /* artifacts for the host side */
        -- deb/
           /* deb packages */
        -- images/
            -- enea-image-virtualization-host
               /* precompiled artifacts for the Host release image */
                -- various artifacts
            -- enea-image-virtualization-host-sdk
               /* precompiled artifacts for the Host SDK image.
               The SDK image contains userspace tools and kernel
               configurations necessary for developing, debugging
               and profiling applications and kernel modules */
                -- various artifacts
        -- sdk
           /* NFV Access SDK for the host */
                -- enea-glibc-x86_64-enea-image-virtualization-host-sdk /
                   -corei7-64-toolchain-7.0.sh
                   /* self-extracting archive installing
                   cross-compilation toolchain for the host */
-- qemux86-64
   /* artifacts for the guest side */
        -- deb/
           /* deb packages */
        -- images/
            -- enea-image-virtualization-guest
               /* precompiled artifacts for the Guest image */
                -- various artifacts
        -- sdk
           /* NFV Access SDK for the guest */
                -- enea-glibc-x86_64-enea-image-virtualization-guest-sdk /
                   -core2-64-toolchain-7.0.sh
                   /* self-extracting archive installing cross-compilation
                   toolchain for the guest (QEMU x86-64) */
</programlisting>

    <para>For each combination of image and target, the following set of
    artifacts is available:</para>

    <programlisting>-- bzImage
   /* kernel image */
-- bzImage-&lt;target&gt;.bin
   /* kernel image, same as above */
-- config-&lt;target&gt;.config
   /* kernel configuration file */
-- core-image-minimal-initramfs-&lt;target&gt;.cpio.gz
   /* cpio archive of the initramfs */
-- core-image-minimal-initramfs-&lt;target&gt;.qemuboot.conf
   /* qemu config file for the initramfs image */
-- &lt;image-name&gt;-&lt;target&gt;.ext4
   /* EXT4 image of the rootfs */
-- &lt;image-name&gt;-&lt;target&gt;.hddimg
   /* msdos filesystem containing syslinux, kernel, initrd and rootfs image */
-- &lt;image-name&gt;-&lt;target&gt;.iso
   /* CD .iso image */
-- &lt;image-name&gt;-&lt;target&gt;.qemuboot.conf
   /* qemu config file for the image */
-- &lt;image-name&gt;-&lt;target&gt;.tar.gz
   /* tar archive of the image */
-- &lt;image-name&gt;-&lt;target&gt;.wic
   /* Wic image */
-- microcode.cpio
   /* kernel microcode data */
-- modules-&lt;target&gt;.tgz
   /* external kernel modules */
-- ovmf.*.qcow2
   /* ovmf firmware for uefi support in qemu */
-- rmc.db
   /* Central RMC Database */
-- systemd-bootx64.efi
   /* systemd-boot EFI file */
-- grub-efi-bootx64.efi
   /* GRUB EFI file */</programlisting>
  </section>

  <xi:include href="../../s_doceneacommon/doc/supported_host_environment.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="eltf_params_updated.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude"
              xpointer="element(eltf-target-tables-section)" />

  <section condition="hidden" id="relinfo-provided-sdk">
    <title>Provided Toolchain(s) (SDK)</title>

    <para>The SDK contains toolchains supporting cross-compilation of
    applications for the targets on an x86_64 host. See the <olink
    targetdoc="book_enea_linux_app_dev_guide"
    targetptr="book_enea_linux_app_dev_guide"><trademark
    class="registered">Enea</trademark> NFV Access Application Development
    Guide</olink> for information on how to build and install a
    toolchain.</para>
  </section>

  <section id="relinfo-documentation">
    <title>Provided Documentation</title>

    <para>Enea NFV Access is provided with the following set of
    documents:</para>

    <itemizedlist spacing="compact">
      <listitem>
        <para><olink targetdoc="book_enea_nfv_access_guide"
        targetptr="book_enea_nfv_access_guide">Enea NFV Access Guide</olink>
        &ndash; A document describing how to use ENFV Access, as well as use
        cases and benchmark results.</para>
      </listitem>

      <listitem>
        <para>Enea NFV Access Release Information &ndash; This document,
        describing the Enea NFV Access release content</para>
      </listitem>

      <listitem>
        <para><olink targetdoc="book_enea_nfv_access_open_source"
        targetptr="book_enea_nfv_access_open_source">Enea NFV Access Open
        Source Report</olink> &ndash; A document containing the open source
        and license information pertaining to packages provided with Enea NFV
        Access.</para>
      </listitem>

      <listitem>
        <para>Enea NFV Access Test Report &ndash; The document that summarizes
        the test results for the Enea NFV Access release.</para>
      </listitem>

      <listitem>
        <para>Enea NFV Access Security Report &ndash; The document that lists
        all security fixes included in the Enea NFV Access release.</para>
      </listitem>
    </itemizedlist>
  </section>

  <xi:include href="../../s_doceneacommon/doc/security_fixes.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />
</chapter>