summaryrefslogtreecommitdiffstats
path: root/book-enea-nfv-core-release-info
diff options
context:
space:
mode:
authorMiruna Paun <Miruna.Paun@enea.com>2017-07-14 14:52:08 +0200
committerMiruna Paun <Miruna.Paun@enea.com>2017-07-14 14:52:08 +0200
commit2df2d1adbab4c4fbfda61700945d85ca3ce53d74 (patch)
tree5c42a474a7294947d79fd72edbbfdef3501d0c4b /book-enea-nfv-core-release-info
parenta35c2a961de2619baa94a47ddd5448cd6eeda798 (diff)
downloaddoc-enea-nfv-2df2d1adbab4c4fbfda61700945d85ca3ce53d74.tar.gz
Renamed all relevant instances of the product
USERDOCAP-207 from ENFV to ENFV Core. Signed-off-by: Miruna Paun <Miruna.Paun@enea.com>
Diffstat (limited to 'book-enea-nfv-core-release-info')
-rw-r--r--book-enea-nfv-core-release-info/doc/about_release.xml24
-rw-r--r--book-enea-nfv-core-release-info/doc/book.xml19
-rw-r--r--book-enea-nfv-core-release-info/doc/jiraissues_override.xml72
-rw-r--r--book-enea-nfv-core-release-info/doc/known_bugs_and_limitations.xml-FIX59
-rw-r--r--book-enea-nfv-core-release-info/doc/reference_index.xml-NOTES120
-rw-r--r--book-enea-nfv-core-release-info/doc/summary.xml112
-rw-r--r--book-enea-nfv-core-release-info/swcomp.mk10
7 files changed, 416 insertions, 0 deletions
diff --git a/book-enea-nfv-core-release-info/doc/about_release.xml b/book-enea-nfv-core-release-info/doc/about_release.xml
new file mode 100644
index 0000000..0acde2e
--- /dev/null
+++ b/book-enea-nfv-core-release-info/doc/about_release.xml
@@ -0,0 +1,24 @@
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-about-release">
5 <title>About This Release</title>
6
7 <section id="relinfo-abstract">
8 <title>Abstract</title>
9
10 <para>This document compiles the release notes for the 1.0 release of Enea
11 NFV Core when using Fuel as a deployment tool.</para>
12 </section>
13
14 <section id="relinfo-importantnotes">
15 <title>Important Notes</title>
16
17 <para>These notes provides release information for the use of Fuel as
18 deployment tool for the 1.0 release of ENFV Core. This Fuel-based
19 deployment process is to establish a lab ready platform accelerating
20 further development of the ENFV infrastructure. Carefully follow the
21 installation instructions detailed in Installation Guide provided with
22 this release.</para>
23 </section>
24</chapter> \ No newline at end of file
diff --git a/book-enea-nfv-core-release-info/doc/book.xml b/book-enea-nfv-core-release-info/doc/book.xml
new file mode 100644
index 0000000..d8ad5de
--- /dev/null
+++ b/book-enea-nfv-core-release-info/doc/book.xml
@@ -0,0 +1,19 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<book id="book_enea_nfv_core_release_info">
5 <title><trademark class="registered">Enea</trademark> NFV Core Release Information</title>
6
7 <subtitle>Release Version <xi:include href="../../s_docsrc_common/pardoc-distro.xml" xmlns:xi="http://www.w3.org/2001/XInclude" xpointer="element(EneaNFV_REL_VER/1)" /></subtitle>
8
9 <xi:include href="../../s_docbuild/template/docsrc_common/bookinfo_userdoc.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
10 <xi:include href="about_release.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
11 <xi:include href="summary.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
12<!-- <xi:include href="prerequisites_and_included_packages.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
13 <ns:include href="added_features.xml" xmlns:xi="http://www.w3.org/2001/XInclude "/>
14 <xi:include href="getting_enea_nfv.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
15 <xi:include href="build_boot_generated.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
16 <xi:include href="main_changes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
17 <xi:include href="known_bugs_and_limitations.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -->
18 <xi:include href="../../s_docbuild/template/docsrc_common/contacting_enea_enea_linux.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
19</book> \ No newline at end of file
diff --git a/book-enea-nfv-core-release-info/doc/jiraissues_override.xml b/book-enea-nfv-core-release-info/doc/jiraissues_override.xml
new file mode 100644
index 0000000..ee3e55d
--- /dev/null
+++ b/book-enea-nfv-core-release-info/doc/jiraissues_override.xml
@@ -0,0 +1,72 @@
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="relinfo-extracted-from-jira">
5 <title>Release-Specific Problems</title>
6
7 <informaltable>
8 <tgroup cols="2">
9 <colspec colwidth="6*" colname="c1"/>
10
11 <colspec align="center" colwidth="1*" colname="c2"/>
12
13 <thead>
14 <row>
15 <entry align="center">Summary</entry>
16
17 <entry>Enea Ref</entry>
18 </row>
19 </thead>
20
21 <tbody>
22 <row>
23 <entry>Eclipse Plug-Ins for Perf and Latencytop are not functioning properly on P2041RDB target.</entry>
24
25 <entry>LXCR-6936</entry>
26 </row>
27
28 <row>
29 <entry>QEMU cannot be launched from Eclipse environment.</entry>
30
31 <entry>LXCR-6997</entry>
32 </row>
33
34 <row>
35 <entry>Crosstap is not supported on LS1021a-IoT and QEMU targets.</entry>
36
37 <entry>LXCR-7110</entry>
38 </row>
39
40 <row>
41 <entry><para>LTTng kernel tracing from Eclipse does not work due to RSE connectivity problems.</para><para>As a workaround, traces can be collected on target and visualized on Eclipse, after copying the files on the host system.</para></entry>
42
43 <entry>LXCR-7166</entry>
44 </row>
45
46 <row>
47 <entry>Latencytop is not supported on LS1021a-IoT target.</entry>
48
49 <entry>LXCR-7168</entry>
50 </row>
51
52 <row>
53 <entry>A limitation currently makes Powertop calibration not function properly on LS1021a-IoT target.</entry>
54
55 <entry>LXCR-7170</entry>
56 </row>
57
58 <row>
59 <entry>Due to optimization done by GCC when compiling the LS1021a-IoT kernel, some context variables may not have accurate debugging data and may not be accessible to Systemtap probes.</entry>
60
61 <entry>LXCR-7184</entry>
62 </row>
63
64 <row>
65 <entry><para>KGDB is not functioning properly on LS1021a-IoT target.</para><para>The kernel sources are not present in the eSDK sysroot path and gdb will not be able to find the sources when debugging the kernel.</para></entry>
66
67 <entry>LXCR-7185</entry>
68 </row>
69 </tbody>
70 </tgroup>
71 </informaltable>
72</section>
diff --git a/book-enea-nfv-core-release-info/doc/known_bugs_and_limitations.xml-FIX b/book-enea-nfv-core-release-info/doc/known_bugs_and_limitations.xml-FIX
new file mode 100644
index 0000000..fad85a5
--- /dev/null
+++ b/book-enea-nfv-core-release-info/doc/known_bugs_and_limitations.xml-FIX
@@ -0,0 +1,59 @@
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="bugs-limitations">
5 <title>Known Problems in This Release</title>
6
7 <para>Problems and limitations relevant to the current release are detailed
8 in this chapter. Corrections to bugs detected by Enea are submitted
9 upstream, and remaining issues are listed below.<remark>INFO: The <emphasis
10 role="bold">Release-Specific Problems</emphasis> section further down is
11 generated from JIRA with gen_known_issues.py, but that script is HARDCODED
12 with affectedversion "Enea NFV 1.0" and needs to be adapted when a release
13 info for another ENFV version changes.</remark></para>
14
15 <section condition="hidden" id="bugs-limitations-gen">
16 <title>Release Specific Issues</title>
17
18 <itemizedlist spacing="compact">
19 <listitem>
20 <para><emphasis role="bold">Issue</emphasis>: <remark>Insert all
21 issues specific to this release, along with their relevant
22 CRs</remark></para>
23 </listitem>
24 </itemizedlist>
25 </section>
26
27 <section condition="hidden" id="bugs-limitations-doc">
28 <title>Documentation</title>
29
30 <itemizedlist spacing="compact">
31 <listitem>
32 <para><emphasis role="bold">PDF navigation</emphasis>: When using
33 links to open other PDFs, or jump to another place in the same PDF,
34 jumping back sometimes fails. This has been observed when opening a
35 PDF in Adobe Reader, inside a browser with PDF add-on, as well as when
36 the browser is configured to open PDF files in an external PDF reader.
37 As a workaround, open the HTML version of the
38 document.<remark>LXCR-3283</remark></para>
39 </listitem>
40 </itemizedlist>
41 </section>
42
43 <section condition="hidden" id="bugs-limitations-other">
44 <title>Miscellaneous</title>
45
46 <itemizedlist spacing="compact">
47 <listitem>
48 <para />
49
50 <remark>list all misc problems here.</remark>
51 </listitem>
52 </itemizedlist>
53 </section>
54
55 <!-- The file with a section below is autocreated by make init -->
56
57 <xi:include href="jiraissues_generated.xml"
58 xmlns:xi="http://www.w3.org/2001/XInclude" />
59</chapter> \ No newline at end of file
diff --git a/book-enea-nfv-core-release-info/doc/reference_index.xml-NOTES b/book-enea-nfv-core-release-info/doc/reference_index.xml-NOTES
new file mode 100644
index 0000000..079a566
--- /dev/null
+++ b/book-enea-nfv-core-release-info/doc/reference_index.xml-NOTES
@@ -0,0 +1,120 @@
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="ref-index">
5 <title>Reference Index</title>
6
7 <para>For more information on the ENFV 1.0 release, please see:</para>
8
9 <section id="opnfv">
10 <title>OPNFV</title>
11
12 <remark>Should these external remain as they are now, leading to opnfv, or
13 be changed to something referencing our own products if possible, or
14 omitted partially/entirely?</remark>
15
16 <orderedlist>
17 <listitem id="reference-one">
18 <para>OPNFV Home Page: <ulink
19 url="http://www.opnfv.org">http://www.opnfv.org</ulink></para>
20 </listitem>
21
22 <listitem id="reference-two">
23 <para>OPNFV documentation and software downloads: <ulink
24 url="https://www.opnfv.org/software/download">https://www.opnfv.org/software/download</ulink></para>
25 </listitem>
26 </orderedlist>
27 </section>
28
29 <section id="openstack">
30 <title>OpenStack</title>
31
32 <orderedlist>
33 <listitem id="reference-three">
34 <para>OpenStack Mitaka Release artifacts: <ulink
35 url="http://www.openstack.org/software/mitaka">http://www.openstack.org/software/mitaka</ulink></para>
36 </listitem>
37
38 <listitem id="reference-four">
39 <para>OpenStack documentation: <ulink
40 url="http://docs.openstack.org">http://docs.openstack.org</ulink></para>
41 </listitem>
42 </orderedlist>
43 </section>
44
45 <section id="opendaylight">
46 <title>OpenDaylight</title>
47
48 <orderedlist>
49 <listitem id="reference-five">
50 <para>OpenDaylight artifacts: <ulink
51 url="http://www.opendaylight.org/software/downloads">http://www.opendaylight.org/software/downloads</ulink></para>
52 </listitem>
53 </orderedlist>
54 </section>
55
56 <section id="fuel">
57 <title>Fuel</title>
58
59 <orderedlist>
60 <listitem id="reference-six">
61 <para>The Fuel OpenStack project: <ulink
62 url="https://wiki.openstack.org/wiki/Fuel">https://wiki.openstack.org/wiki/Fuel</ulink></para>
63 </listitem>
64
65 <listitem id="reference-seven">
66 <para>Fuel documentation overview: <ulink
67 url="http://docs.openstack.org/developer/fuel-docs">http://docs.openstack.org/developer/fuel-docs</ulink></para>
68 </listitem>
69
70 <listitem id="reference-eight">
71 <para>Fuel Installation Guide: <ulink
72 url="http://docs.openstack.org/developer/fueldocs/userdocs/fuel-install-guide.html">http://docs.openstack.org/developer/fueldocs/userdocs/fuel-install-guide.html</ulink></para>
73 </listitem>
74
75 <listitem id="reference-nine">
76 <para>Fuel User Guide: <ulink
77 url="http://docs.openstack.org/developer/fuel-docs/userdocs/fueluser-guide.html">http://docs.openstack.org/developer/fuel-docs/userdocs/fueluser-guide.html</ulink></para>
78 </listitem>
79
80 <listitem id="reference-ten">
81 <para>Fuel Developer Guide: <ulink
82 url="http://docs.openstack.org/developer/fueldocs/devdocs/develop.html">http://docs.openstack.org/developer/fueldocs/devdocs/develop.html</ulink></para>
83 </listitem>
84
85 <listitem id="reference-eleven">
86 <para>Fuel Plugin Developers Guide: <ulink
87 url="http://docs.openstack.org/developer/fueldocs/plugindocs/fuel-plugin-sdk-guide.html">http://docs.openstack.org/developer/fueldocs/plugindocs/fuel-plugin-sdk-guide.html</ulink></para>
88 </listitem>
89
90 <listitem id="reference-twelve">
91 <para>Fuel OpenStack Hardware Compatibility List: <ulink
92 url="https://www.mirantis.com/products/openstack-drivers-and-plugins/hardwarecompatibility-list">https://www.mirantis.com/products/openstack-drivers-and-plugins/hardwarecompatibility-list</ulink></para>
93 </listitem>
94 </orderedlist>
95 </section>
96
97 <section id="fuel-enfv">
98 <title>Fuel in ENFV</title>
99
100 <orderedlist>
101 <listitem id="reference-thirteen">
102 <para>ENFV Installation instruction for the 1.0 release of ENFV when
103 using Fuel as a deployment tool: <ulink
104 url="http://artifacts.opnfv.org/fuel/colorado/3.0/docs/installationprocedure/index.html {change}">http://artifacts.opnfv.org/fuel/colorado/3.0/docs/installationprocedure/index.html</ulink></para>
105 </listitem>
106
107 <listitem id="reference-fourteen">
108 <para>ENFV Build instruction for the 1.0 release of ENFV when using
109 Fuel as a deployment tool: <ulink
110 url="http://artifacts.opnfv.org/fuel/colorado/3.0/docs/buildprocedure/index.html {change}">http://artifacts.opnfv.org/fuel/colorado/3.0/docs/buildprocedure/index.html</ulink></para>
111 </listitem>
112
113 <listitem id="reference-fifteen">
114 <para>ENFV Release Notes for the 1.0 release of ENFV when using Fuel
115 as a deployment tool: <ulink
116 url="http://artifacts.opnfv.org/fuel/colorado/3.0/docs/releasenotes/index.html {change}">http://artifacts.opnfv.org/fuel/colorado/3.0/docs/releasenotes/index.html</ulink></para>
117 </listitem>
118 </orderedlist>
119 </section>
120</chapter> \ No newline at end of file
diff --git a/book-enea-nfv-core-release-info/doc/summary.xml b/book-enea-nfv-core-release-info/doc/summary.xml
new file mode 100644
index 0000000..3059386
--- /dev/null
+++ b/book-enea-nfv-core-release-info/doc/summary.xml
@@ -0,0 +1,112 @@
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-summary">
5 <title>Summary</title>
6
7 <section id="relinfo-overview">
8 <title>Brief Overview</title>
9
10 <para>For the 1.0 release, the typical use of Fuel as an OpenStack
11 installer is supplemented with ENFV Core unique components, such
12 as:</para>
13
14 <para><itemizedlist>
15 <listitem>
16 <para><ulink url="http://www.opendaylight.org/software">OpenDaylight
17 version: Boron</ulink></para>
18 </listitem>
19
20 <listitem>
21 <para><ulink url="http://onosproject.org/">ONOS version:
22 Drake</ulink></para>
23 </listitem>
24
25 <listitem>
26 <para><ulink
27 url="https://wiki.opnfv.org/service_function_chaining">Service
28 function chaining</ulink></para>
29 </listitem>
30
31 <listitem>
32 <para><ulink url="https://wiki.opnfv.org/sdnvpn">SDN distributed
33 routing and VPN</ulink></para>
34 </listitem>
35
36 <listitem>
37 <para><ulink url="https://wiki.opnfv.org/nfv-kvm">NFV
38 Hypervisors-KVM</ulink></para>
39 </listitem>
40
41 <listitem>
42 <para><ulink url="https://wiki.opnfv.org/ovsnfv">Open vSwitch for
43 NFV</ulink></para>
44 </listitem>
45
46 <listitem>
47 <para><ulink
48 url="https://wiki.opnfv.org/characterize_vswitch_performance_for_telco_nfv_use_cases">VSPERF</ulink></para>
49 </listitem>
50
51 <listitem>
52 <para><ulink
53 url="https://wiki.opnfv.org/display/promise">Promise</ulink></para>
54 </listitem>
55
56 <listitem>
57 <para><ulink
58 url="https://wiki.opnfv.org/display/parser">Parser</ulink></para>
59 </listitem>
60
61 <listitem>
62 <para><ulink
63 url="https://wiki.opnfv.org/display/doctor">Doctor</ulink></para>
64
65 <remark>Change these links and titles accordingly to the appropriate
66 ones for our product.</remark>
67 </listitem>
68 </itemizedlist>This release also includes ENFV-unique configurations of
69 the Hardware and Software stack, provides Fuel as the deployment stage
70 tool in the ENFV CI pipeline, and includes the following:</para>
71
72 <itemizedlist>
73 <listitem>
74 <para>Documentation built by Jenkins</para>
75
76 <itemizedlist>
77 <listitem>
78 <para>Overall ENFV Core documentation</para>
79 </listitem>
80
81 <listitem>
82 <para>This document (release notes)</para>
83 </listitem>
84
85 <listitem>
86 <para>Installation instructions</para>
87 </listitem>
88
89 <listitem>
90 <para>Build-instructions</para>
91 </listitem>
92 </itemizedlist>
93 </listitem>
94
95 <listitem>
96 <para>The Fuel installer image (.iso) built by Jenkins</para>
97 </listitem>
98
99 <listitem>
100 <para>Automated deployment of Fuel with running on bare metal or a
101 nested hypervisor environment (KVM)</para>
102
103 <remark>Is this applicable to us? If not remove this bullet point or
104 change the text to a relevant option</remark>
105 </listitem>
106
107 <listitem>
108 <para>Automated validation of current release deployment</para>
109 </listitem>
110 </itemizedlist>
111 </section>
112</chapter> \ No newline at end of file
diff --git a/book-enea-nfv-core-release-info/swcomp.mk b/book-enea-nfv-core-release-info/swcomp.mk
new file mode 100644
index 0000000..8a5adb4
--- /dev/null
+++ b/book-enea-nfv-core-release-info/swcomp.mk
@@ -0,0 +1,10 @@
1# Component build specification
2
3# Version of THIS book
4BOOK_VER ?= $(REL_VER)-dev
5
6DOCBOOK_SRC := $(COMP)/swcomp.mk $(COMP)/doc/book.xml $(shell find $(COMP)/doc -type f \( -name "*.xml" -o -name "*.svg" -o -name "*.png" \) ! -name "book.xml" -print)
7
8BOOKPACKAGES := book-enea-nfv-core-release-info
9BOOKDESC_$(BOOKPACKAGES) := "Enea NFV Core $(PROD_VER) Release Information"
10BOOKDEFAULTCONDITION := $(DEFAULTCONDITIONS)