diff options
author | Miruna Paun <Miruna.Paun@enea.com> | 2017-10-03 17:24:47 +0200 |
---|---|---|
committer | Miruna Paun <Miruna.Paun@enea.com> | 2017-10-03 17:24:47 +0200 |
commit | 1b00fad3ab0670c1b64e20ba51f7d7bc1b7ef623 (patch) | |
tree | b99edc4f8d2d2afbf35994303ce3a227a226a547 /book-enea-nfv-core-release-info | |
parent | 3c4b994ef83666190c17f554050646da241462ab (diff) | |
download | doc-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')
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 > 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 | ||