summaryrefslogtreecommitdiffstats
path: root/book-enea-nfv-core-release-info
diff options
context:
space:
mode:
authorMiruna Paun <Miruna.Paun@enea.com>2017-10-03 17:24:47 +0200
committerMiruna Paun <Miruna.Paun@enea.com>2017-10-03 17:24:47 +0200
commit1b00fad3ab0670c1b64e20ba51f7d7bc1b7ef623 (patch)
treeb99edc4f8d2d2afbf35994303ce3a227a226a547 /book-enea-nfv-core-release-info
parent3c4b994ef83666190c17f554050646da241462ab (diff)
downloaddoc-enea-nfv-1b00fad3ab0670c1b64e20ba51f7d7bc1b7ef623.tar.gz
USERDOCAP-240 updating the release info and other minor edits to the IG
Diffstat (limited to 'book-enea-nfv-core-release-info')
-rw-r--r--book-enea-nfv-core-release-info/doc/about_release.xml249
-rw-r--r--book-enea-nfv-core-release-info/doc/book.xml5
-rw-r--r--book-enea-nfv-core-release-info/doc/build_boot_generated.xml55
-rw-r--r--book-enea-nfv-core-release-info/doc/build_boot_template.xml34
-rw-r--r--book-enea-nfv-core-release-info/doc/known_bugs_and_limitations.xml356
-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/machine_list_generated.xml8
-rw-r--r--book-enea-nfv-core-release-info/doc/summary.xml112
8 files changed, 593 insertions, 285 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
index 0acde2e..e0c6e2f 100644
--- a/book-enea-nfv-core-release-info/doc/about_release.xml
+++ b/book-enea-nfv-core-release-info/doc/about_release.xml
@@ -4,21 +4,244 @@
4<chapter id="relinfo-about-release"> 4<chapter id="relinfo-about-release">
5 <title>About This Release</title> 5 <title>About This Release</title>
6 6
7 <section id="relinfo-abstract"> 7 <section id="intro">
8 <title>Abstract</title> 8 <title>Introduction</title>
9 9
10 <para>This document compiles the release notes for the 1.0 release of Enea 10 <para>Enea NFV Core is based on the OPNFV <emphasis
11 NFV Core when using Fuel as a deployment tool.</para> 11 role="bold">Danube</emphasis> release, and is compatible with the <ulink
12 </section> 12 url="http://www.etsi.org/deliver/etsi_gs/NFV/001_099/002/01.02.01_60/gs_NFV002v010201p.pdf">ETSI
13 NFV reference architecture</ulink>. It leverages several OPNFV community
14 projects, including Functest, Yardstick, Doctor, Fuel, and Armband.</para>
15
16 <para>This release consists of the following components:</para>
17
18 <informaltable>
19 <tgroup cols="2">
20 <tbody>
21 <row>
22 <entry align="center"><emphasis
23 role="bold">Component</emphasis></entry>
24
25 <entry align="center"><emphasis role="bold">Version /
26 Details</emphasis></entry>
27 </row>
28
29 <row>
30 <entry>Installer</entry>
31
32 <entry>Fuel v.10</entry>
33 </row>
34
35 <row>
36 <entry>OPNFV version</entry>
37
38 <entry>Danube</entry>
39 </row>
40
41 <row>
42 <entry>OpenStack Version</entry>
43
44 <entry>OpenStack Newton</entry>
45 </row>
46
47 <row>
48 <entry>OS for Controller / Compute Nodes</entry>
49
50 <entry>Debian 9</entry>
51 </row>
52
53 <row>
54 <entry>Pacemaker</entry>
55
56 <entry>2:9.1.3-1~u16.04+mos4</entry>
57 </row>
58
59 <row>
60 <entry>HA Proxy</entry>
61
62 <entry>1.6.3-1~u16.04+mos3</entry>
63 </row>
64
65 <row>
66 <entry>Open vSwitch</entry>
67
68 <entry>2.7.0-0ubuntu3 plus other patches</entry>
69 </row>
70
71 <row>
72 <entry>DPDK</entry>
73
74 <entry>16.11.2-3 upgraded to 17.02.1 plus other patches</entry>
75 </row>
76
77 <row>
78 <entry>Qemu-KVM</entry>
79
80 <entry align="left">1:2.8+dfsg-3ubuntu1 upgraded to
81 1:2.9~rc1+dfsg-0+amos1~u16.04 plus other patches</entry>
82 </row>
83
84 <row>
85 <entry>EDK2</entry>
86
87 <entry align="left">0~20160813.de74668f-1ubuntu0.1 plus other
88 patches</entry>
89 </row>
90
91 <row>
92 <entry>Libvirt</entry>
93
94 <entry>3.5.0-1ubuntu3 plus other patches</entry>
95 </row>
96
97 <row>
98 <entry>Linux Kernel</entry>
99
100 <entry>4.10 plus other patches</entry>
101 </row>
102
103 <row>
104 <entry>Aodh</entry>
105
106 <entry>3.0.2-1~u16.04+mos0</entry>
107 </row>
108
109 <row>
110 <entry>Ceilometer</entry>
111
112 <entry>1:7.0.3-1~u16.04+mos2</entry>
113 </row>
114
115 <row>
116 <entry>Tacker</entry>
117
118 <entry>0.7.0 plus other patches</entry>
119 </row>
120
121 <row>
122 <entry>Heat</entry>
123
124 <entry>1:7.0.2-1~u16.04+mos4</entry>
125 </row>
126
127 <row>
128 <entry>TOSCA-Parser</entry>
129
130 <entry>0.8.1 plus other patches</entry>
131 </row>
132
133 <row>
134 <entry>cloud-init</entry>
135
136 <entry>0.7.9-90-g61eb03fe-0+amos1~u16.04</entry>
137 </row>
138
139 <row>
140 <entry>Ceph Object Storage</entry>
141
142 <entry>10.2.6-0ubuntu0.16.04.1</entry>
143 </row>
144
145 <row>
146 <entry>RabbitMQ Messaging</entry>
147
148 <entry>3.6.6-1+amos1~u16.04+mos1</entry>
149 </row>
150
151 <row>
152 <entry>Zabbix</entry>
153
154 <entry>1:2.4.8-1+trusty plus other patches</entry>
155 </row>
156
157 <row>
158 <entry>Vitrage</entry>
159
160 <entry>1.0.2.dev5</entry>
161 </row>
162
163 <row>
164 <entry>Erlang</entry>
165
166 <entry>1:18.3.4+dfsg-1~u16.04+mos1</entry>
167 </row>
168
169 <row>
170 <entry>Percona XtraBackup</entry>
171
172 <entry>2.4.5-1+amos1~u16.04 plus other patches</entry>
173 </row>
174
175 <row>
176 <entry>MongoDB</entry>
177
178 <entry>1:2.6.10-0+amos1~u16.04</entry>
179 </row>
180 </tbody>
181 </tgroup>
182 </informaltable>
183
184 <para>Galera cluster for MySQL consists of:</para>
185
186 <informaltable>
187 <tgroup cols="2">
188 <tbody>
189 <row>
190 <entry align="center"><emphasis
191 role="bold">Component</emphasis></entry>
192
193 <entry align="center"><emphasis role="bold">Version /
194 Details</emphasis></entry>
195 </row>
196
197 <row>
198 <entry>MySQL-wsrep</entry>
199
200 <entry>5.6.36</entry>
201 </row>
202
203 <row>
204 <entry>Galera</entry>
205
206 <entry>3.21</entry>
207 </row>
208
209 <row>
210 <entry>wsrep API</entry>
211
212 <entry>25</entry>
213 </row>
214 </tbody>
215 </tgroup>
216 </informaltable>
217
218 <para>Components that are included but not pre-integrated or verified in
219 the release testing scenarios, (not formally supported):</para>
220
221 <informaltable>
222 <tgroup cols="2">
223 <tbody>
224 <row>
225 <entry align="center"><emphasis
226 role="bold">Component</emphasis></entry>
227
228 <entry align="center"><emphasis role="bold">Version /
229 Details</emphasis></entry>
230 </row>
231
232 <row>
233 <entry>OpenDaylight</entry>
234
235 <entry>Boron</entry>
236 </row>
13 237
14 <section id="relinfo-importantnotes"> 238 <row>
15 <title>Important Notes</title> 239 <entry>Congress</entry>
16 240
17 <para>These notes provides release information for the use of Fuel as 241 <entry>4.0.0 with Doctor datasource</entry>
18 deployment tool for the 1.0 release of ENFV Core. This Fuel-based 242 </row>
19 deployment process is to establish a lab ready platform accelerating 243 </tbody>
20 further development of the ENFV infrastructure. Carefully follow the 244 </tgroup>
21 installation instructions detailed in Installation Guide provided with 245 </informaltable>
22 this release.</para>
23 </section> 246 </section>
24</chapter> \ No newline at end of file 247</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
index 1f865b8..3a6b27d 100644
--- a/book-enea-nfv-core-release-info/doc/book.xml
+++ b/book-enea-nfv-core-release-info/doc/book.xml
@@ -8,9 +8,6 @@
8 8
9 <xi:include href="../../s_docbuild/template/docsrc_common/bookinfo_userdoc.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> 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" /> 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" /> 11 <xi:include href="known_bugs_and_limitations.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
12 <xi:include href="build_boot_generated.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
13<!-- <xi:include href="main_changes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
14 <xi:include href="known_bugs_and_limitations.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -->
15 <xi:include href="../../s_docbuild/template/docsrc_common/contacting_enea_enea_linux.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> 12 <xi:include href="../../s_docbuild/template/docsrc_common/contacting_enea_enea_linux.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
16</book> \ No newline at end of file 13</book> \ No newline at end of file
diff --git a/book-enea-nfv-core-release-info/doc/build_boot_generated.xml b/book-enea-nfv-core-release-info/doc/build_boot_generated.xml
deleted file mode 100644
index 7affc4e..0000000
--- a/book-enea-nfv-core-release-info/doc/build_boot_generated.xml
+++ /dev/null
@@ -1,55 +0,0 @@
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-build-boot">
5 <title>Target Specific Instructions</title>
6
7 <para>If the source has been fetched there will be a target specific README
8 file containing the build and boot instructions. To make it easier for the
9 reader, the contents of this file(s) have been extracted into the following
10 sections.</para>
11
12 <note>
13 <para>The build process duration may vary and be longer than expected in
14 some cases, depending on the individual build resources and parameters of
15 each target/machine supported in this release.</para>
16 </note>
17
18 <para><remark>NOTE: Only EDIT THE TEMPLATE build_boot_template.xml file here
19 and also only edit the manifest template ".README" (name starting by a dot)!
20 A new build_boot_generated.xml file is created from the template and
21 sections are added below automatically from the README files for each target
22 when building the book! Only in the template file you see a line below with
23 SCRIPT_...._HERE and the text telling that this is a template
24 file.</remark></para>
25
26 <section id="target_inteld1521">
27 <title>Target inteld1521</title>
28
29 <remark>NOTE: DO NOT EDIT THIS GENERATED FILE! Only edit the template
30 file.</remark>
31
32 <section>
33 <title>Build Instructions for inteld1521</title>
34 </section>
35
36 <section>
37 <title>Boot Instructions for inteld1521</title>
38 </section>
39 </section>
40
41 <section id="target_qemux86-64">
42 <title>Target qemux86-64</title>
43
44 <remark>NOTE: DO NOT EDIT THIS GENERATED FILE! Only edit the template
45 file.</remark>
46
47 <section>
48 <title>Build Instructions for qemux86-64</title>
49 </section>
50
51 <section>
52 <title>Boot Instructions for qemux86-64</title>
53 </section>
54 </section>
55</chapter> \ No newline at end of file
diff --git a/book-enea-nfv-core-release-info/doc/build_boot_template.xml b/book-enea-nfv-core-release-info/doc/build_boot_template.xml
deleted file mode 100644
index e39dd81..0000000
--- a/book-enea-nfv-core-release-info/doc/build_boot_template.xml
+++ /dev/null
@@ -1,34 +0,0 @@
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-build-boot">
5 <title>Target Specific Instructions</title>
6
7 <para>If the source has been fetched (<xref
8 linkend="relinfo-getting-source" />), there will be a target specific README
9 file containing the build and boot instructions. To make it easier for the
10 reader, the contents of this file(s) have been extracted into the following
11 sections.</para>
12
13 <note>
14 <para>The build process duration may vary and be longer than expected in
15 some cases, depending on the individual build resources and parameters of
16 each target/machine supported in this release.</para>
17 </note>
18
19 <para><remark>NOTE: Only EDIT THE TEMPLATE build_boot_template.xml file here
20 and also only edit the manifest template ".README" (name starting by a dot)!
21 A new build_boot_generated.xml file is created from the template and
22 sections are added below automatically from the README files for each target
23 when building the book! Only in the template file you see a line below with
24 SCRIPT_...._HERE and the text telling that this is a template
25 file.</remark></para>
26
27 <para>SCRIPT_INCLUDES_BUILD_BOOT_SECTIONS_HERE</para>
28
29 <para><emphasis role="bold">This is a template file which you can edit. When
30 the book is built, a new XML chapter file is created where the above part of
31 this file is copied to the new XML file and all from the line above is
32 replaced automatically by build and boot sections from the README
33 files!</emphasis></para>
34</chapter> \ No newline at end of file
diff --git a/book-enea-nfv-core-release-info/doc/known_bugs_and_limitations.xml b/book-enea-nfv-core-release-info/doc/known_bugs_and_limitations.xml
new file mode 100644
index 0000000..039fae9
--- /dev/null
+++ b/book-enea-nfv-core-release-info/doc/known_bugs_and_limitations.xml
@@ -0,0 +1,356 @@
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 Issues and Limitations</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 id="bugs-limitations-gen">
16 <title>Release Specific Issues</title>
17
18 <orderedlist>
19 <listitem>
20 <para>Security groups are not working correctly for ICMP traffic in
21 deployments with OpenDaylight.</para>
22
23 <itemizedlist>
24 <listitem>
25 <para>Description and Impact:</para>
26
27 <orderedlist>
28 <listitem>
29 <para>When OPNFV is deployed with OpenDaylight as an SDN
30 controller, the Security Groups rules pertaining to ICMP do
31 not work as expected. The OpenFlow rules describing the ICMP
32 rules are inconsistent, so VMs can be pinged even when this is
33 not desired.</para>
34 </listitem>
35
36 <listitem>
37 <para>This reproduces on aarch64. On x86 the security groups
38 work correctly.</para>
39 </listitem>
40 </orderedlist>
41 </listitem>
42
43 <listitem>
44 <para>Workaround: N/A.</para>
45 </listitem>
46 </itemizedlist>
47 </listitem>
48
49 <listitem>
50 <para>Virtual instances do not get IP from DHCP in SFC scenarios with
51 ODL</para>
52
53 <itemizedlist>
54 <listitem>
55 <para>Description and Impact:</para>
56
57 <orderedlist>
58 <listitem>
59 <para>After a fresh deploy of OPNFV with OpenDaylight and the
60 Service Function Chaining scenario configurations, instances
61 fail to get IP from DHCP, due to OpenDaylight
62 malfunctioning.</para>
63 </listitem>
64
65 <listitem>
66 <para>The SFC VNFs are not reachable via SSH for management
67 and configuration.</para>
68 </listitem>
69 </orderedlist>
70 </listitem>
71
72 <listitem>
73 <para>Workaround: Restarting OpenDaylight via
74 <literal>systemctl</literal> fixes the problem.</para>
75 </listitem>
76 </itemizedlist>
77 </listitem>
78
79 <listitem>
80 <para>Scale-in and Scale-out operations are not supported</para>
81
82 <itemizedlist>
83 <listitem>
84 <para>Description and Impact:</para>
85
86 <orderedlist>
87 <listitem>
88 <para>When adding or removing nodes via Fuel installer on an
89 OPNFV deployment that uses OpenDaylight, flows in
90 <filename>ovs</filename> tables on the existing and new nodes
91 are not updated properly. Similarly, OpenvSwitch ports
92 interfaces are not removed when deleting nodes.</para>
93 </listitem>
94
95 <listitem>
96 <para>As a consequence, when adding a compute node to an
97 existing OPNFV deployment, the instances running on the new
98 compute node cannot be reached by floating IP. Scale-out and
99 scale-in operations are flawed.</para>
100 </listitem>
101 </orderedlist>
102 </listitem>
103
104 <listitem>
105 <para>Workaround: The rules can be manually configured, but this
106 is not scalable.</para>
107 </listitem>
108 </itemizedlist>
109 </listitem>
110
111 <listitem>
112 <para>Hot-plugging network interfaces does not work in aarch64
113 guests</para>
114
115 <itemizedlist>
116 <listitem>
117 <para>Description and Impact:</para>
118
119 <orderedlist>
120 <listitem>
121 <para>When the user tries to hot-plug a network port to a
122 running instance, this fails due to virtio negotiation failure
123 between the host and guest. This happens when the VM is using
124 a Linux Kernel version prior to 4.10. Port addition or
125 deletion is not possible.</para>
126 </listitem>
127
128 <listitem>
129 <para>This reproduces on aarch64.</para>
130 </listitem>
131 </orderedlist>
132 </listitem>
133
134 <listitem>
135 <para>Workaround: The user needs to upgrade the guest Linux Kernel
136 to 4.10 or later. In case of port addition, the user also needs to
137 manually set the link up and trigger the
138 <literal>dhclient</literal> request.</para>
139 </listitem>
140 </itemizedlist>
141 </listitem>
142
143 <listitem>
144 <para>Fuel Healthcheck Configuration tests fail when default
145 credentials are used</para>
146
147 <itemizedlist>
148 <listitem>
149 <para>Description and Impact:</para>
150
151 <orderedlist>
152 <listitem>
153 <para>The Configuration tests from the Fuel Healthcheck fail
154 when the OPNFV cluster operates with the default credentials.
155 This has no impact on the overall cluster
156 functionality.</para>
157 </listitem>
158
159 <listitem>
160 <para>This is architecture independent.</para>
161 </listitem>
162 </orderedlist>
163 </listitem>
164
165 <listitem>
166 <para>Workaround: In order to make these 3 test cases pass, the
167 user needs to:</para>
168
169 <orderedlist>
170 <listitem>
171 <para>Change the credentials for the root user on the Fuel
172 Master node: after logging on as root on the master node,
173 issue command <command>passwd</command> and provide the new
174 password.</para>
175 </listitem>
176
177 <listitem>
178 <para>Change the default credentials for the OpenStack
179 cluster: in Fuel Dashboard, for an Environment, change
180 Settings|General|OpenStack Access &gt; Password to something
181 other than the default.</para>
182 </listitem>
183
184 <listitem>
185 <para>Change the default credentials for Keystone on the
186 master node: in Fuel Dashboard, click on the user avatar and
187 select <literal>Change Password</literal>. This should be done
188 before deploy or you will need to redeploy to have the changes
189 applied.</para>
190 </listitem>
191 </orderedlist>
192 </listitem>
193 </itemizedlist>
194 </listitem>
195
196 <listitem>
197 <para>Fuel Healthcheck Stack update test fails</para>
198
199 <itemizedlist>
200 <listitem>
201 <para>Description and Impact:</para>
202
203 <para>The Platform test case number 5 (Update stack) from the Fuel
204 Healthcheck fails. This has no impact on the overal cluster
205 functionality.</para>
206 </listitem>
207
208 <listitem>
209 <para>Workaround: N/A.</para>
210 </listitem>
211 </itemizedlist>
212 </listitem>
213
214 <listitem>
215 <para>Issue #1 with Openstack Resource Agents and Compute Fencing
216 functionality</para>
217
218 <itemizedlist>
219 <listitem>
220 <para>Description and Impact:</para>
221
222 <para>In an OPNFV deployment that uses Openstack Resource Agents,
223 the neutron-openvswitch-agent is killed by Pacemaker when booting,
224 due to Pacemaker misconfiguration.</para>
225 </listitem>
226
227 <listitem>
228 <para>Workaround:</para>
229
230 <para>Starting the <literal>systemd</literal> service manually
231 makes it run successfully. Enea NFV Core 1.0 will be shipped
232 without Openstack Resource Agents, therefore this issue should not
233 affect the user.</para>
234 </listitem>
235 </itemizedlist>
236 </listitem>
237
238 <listitem>
239 <para>Virtual instances are not affected by removing a node from Ceph
240 Storage Cluster</para>
241
242 <itemizedlist>
243 <listitem>
244 <para>Description and Impact:</para>
245
246 <para>Engineering wanted to validate the survival of the storage
247 systems when a single disk is removed without causing data loss.
248 Without physical access to the test setup, this test is not
249 feasible.</para>
250 </listitem>
251
252 <listitem>
253 <para>Workaround:</para>
254
255 <itemizedlist>
256 <listitem>
257 <para>The chosen approach was to validate what happens to the
258 Ceph cluster when network connectivity is lost for the Storage
259 interface of one of the nodes. The observed behavior: no
260 impact on a running instance using Ceph for volume
261 storage.</para>
262 </listitem>
263
264 <listitem>
265 <para><ulink
266 url="http://ceph.com/geen-categorie/admin-guide-replacing-a-failed-disk-in-a-ceph-cluster/">Reference
267 information</ulink></para>
268 </listitem>
269 </itemizedlist>
270 </listitem>
271 </itemizedlist>
272 </listitem>
273
274 <listitem>
275 <para>Issue #2 with Openstack Resource Agents and Compute Fencing
276 functionality</para>
277
278 <itemizedlist>
279 <listitem>
280 <para>Description and Impact:</para>
281
282 <para>In an OPNFV deployment that uses Openstack Resource Agents,
283 when we configure the <literal>fence_compute</literal> as a
284 Pacemaker resource, the Controller nodes start to reboot each
285 other endlessly.</para>
286 </listitem>
287
288 <listitem>
289 <para>Workaround:</para>
290
291 <para>Enea NFV Core 1.0 will be shipped without Openstack Resource
292 Agents, therefore this issue should not affect the user.</para>
293 </listitem>
294 </itemizedlist>
295 </listitem>
296
297 <listitem>
298 <para>Offline Deploy with Fuel fails at times</para>
299
300 <itemizedlist>
301 <listitem>
302 <para>Description and Impact:</para>
303
304 <para>The Postfix installation and post-install configuration
305 sometimes take longer when the Fuel deployment is performed
306 without Internet connectivity. The <emphasis
307 role="bold">tools</emphasis> Puppet task has a 5 minute completion
308 timeout, causing there to not be enough time left for the other
309 components of the tools task to be executed.</para>
310 </listitem>
311
312 <listitem>
313 <para>Workaround:</para>
314
315 <para>Simply press <literal>Deploy changes</literal> again. Since
316 by now Postfix is installed, it will skip the installation and
317 finish in time.</para>
318 </listitem>
319 </itemizedlist>
320 </listitem>
321 </orderedlist>
322 </section>
323
324 <section condition="hidden" id="bugs-limitations-doc">
325 <title>Documentation</title>
326
327 <itemizedlist spacing="compact">
328 <listitem>
329 <para><emphasis role="bold">PDF navigation</emphasis>: When using
330 links to open other PDFs, or jump to another place in the same PDF,
331 jumping back sometimes fails. This has been observed when opening a
332 PDF in Adobe Reader, inside a browser with PDF add-on, as well as when
333 the browser is configured to open PDF files in an external PDF reader.
334 As a workaround, open the HTML version of the
335 document.<remark>LXCR-3283</remark></para>
336 </listitem>
337 </itemizedlist>
338 </section>
339
340 <section condition="hidden" id="bugs-limitations-other">
341 <title>Miscellaneous</title>
342
343 <itemizedlist spacing="compact">
344 <listitem>
345 <para></para>
346
347 <remark>list all misc problems here.</remark>
348 </listitem>
349 </itemizedlist>
350 </section>
351
352 <!-- The file with a section below is autocreated by make init
353
354 <xi:include href="jiraissues_generated.xml"
355 xmlns:xi="http://www.w3.org/2001/XInclude" /> -->
356</chapter> \ No newline at end of file
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
deleted file mode 100644
index fad85a5..0000000
--- a/book-enea-nfv-core-release-info/doc/known_bugs_and_limitations.xml-FIX
+++ /dev/null
@@ -1,59 +0,0 @@
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/machine_list_generated.xml b/book-enea-nfv-core-release-info/doc/machine_list_generated.xml
deleted file mode 100644
index 2b9d17f..0000000
--- a/book-enea-nfv-core-release-info/doc/machine_list_generated.xml
+++ /dev/null
@@ -1,8 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<para id="machine-list">
5<programlisting># Set MACHINE to ONE of the targets in this release!
6# export MACHINE=inteld1521
7# export MACHINE=qemux86-64</programlisting>
8</para>
diff --git a/book-enea-nfv-core-release-info/doc/summary.xml b/book-enea-nfv-core-release-info/doc/summary.xml
deleted file mode 100644
index 3059386..0000000
--- a/book-enea-nfv-core-release-info/doc/summary.xml
+++ /dev/null
@@ -1,112 +0,0 @@
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