summaryrefslogtreecommitdiffstats
path: root/doc/book-enea-nfv-access-release-info/doc/known_bugs_and_limitations.xml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/book-enea-nfv-access-release-info/doc/known_bugs_and_limitations.xml')
-rw-r--r--doc/book-enea-nfv-access-release-info/doc/known_bugs_and_limitations.xml225
1 files changed, 52 insertions, 173 deletions
diff --git a/doc/book-enea-nfv-access-release-info/doc/known_bugs_and_limitations.xml b/doc/book-enea-nfv-access-release-info/doc/known_bugs_and_limitations.xml
index 961a281..ce9e9e0 100644
--- a/doc/book-enea-nfv-access-release-info/doc/known_bugs_and_limitations.xml
+++ b/doc/book-enea-nfv-access-release-info/doc/known_bugs_and_limitations.xml
@@ -4,100 +4,94 @@
4<chapter id="bugs-limitations"> 4<chapter id="bugs-limitations">
5 <title>Known Issues and Limitations in this Release</title> 5 <title>Known Issues and Limitations in this Release</title>
6 6
7 <para>This chapter lists the known issues that affect the current 7 <para>This chapter lists the known general issues and limitations that
8 release.</para> 8 affect the current release.</para>
9 9
10 <para><remark>The section further down is generated from JIRA with 10 <para><remark>The section further down is generated from JIRA with
11 gen_known_issues.py, but that script is HARDCODED with affectedversion 11 gen_known_issues.py, but that script is HARDCODED with affectedversion
12 "EL7_3-virtualization" and needs to be adapted when a release info for 12 "EL7_3-virtualization" and needs to be adapted when a release info for
13 another ENFV Access version changes.</remark><emphasis 13 another ENFV Access version changes.</remark></para>
14 role="bold">Product-specific Issues and Limitations</emphasis></para>
15 14
16 <itemizedlist> 15 <itemizedlist>
17 <para><emphasis role="bold">Enea uCPE Manager</emphasis></para>
18
19 <listitem> 16 <listitem>
20 <para><remark>ELCCR-99</remark>The uCPE Manager fails to onboard renamed 17 <para><remark>ELCCR-119</remark>Multiple uCPE devices behind a firewall
21 VNF bundles downloaded to the same repo.</para> 18 or a gateway connecting with Call-Home are not supported.</para>
22 </listitem> 19 </listitem>
23 20
24 <listitem> 21 <listitem>
25 <para><remark>ELCCR-119</remark>No support is provided for multiple uCPE 22 <para><remark>ELCCR-319</remark>After a successful installation or
26 devices behind a firewall or gateway connecting Call Home to the uCPE 23 upgrade, it takes about 2 minutes until the device is accessible from
27 Manager (running outside the local network).</para> 24 the uCPE Manager.</para>
28 </listitem> 25 </listitem>
29 26
30 <listitem> 27 <listitem>
31 <para><remark>ELCCR-319</remark>After a successful installation or 28 <para><remark>ELCCR-349</remark>If the uCPE Manager has not been
32 upgrade, it takes about 2 minutes until the device is accessible from 29 successfully installed originally or if the installed resources (files,
33 the browser.</para> 30 users, services, databases, environment variables, etc.) have been
31 manually changed/removed, the uninstallation may fail and some resources will
32 have to be removed manually.</para>
33 </listitem>
34
35 <listitem>
36 <para><remark>ELCCR-349</remark>Recovery in case of a failed uCPE Manager
37 uninstallation is not implemented. In case of a failure the resources have to
38 be removed manually.</para>
34 </listitem> 39 </listitem>
35 40
36 <listitem> 41 <listitem>
37 <para><remark>ELCCR-349</remark>After uninstalling the uCPE manager 42 <para><remark>ELCCR-454</remark>Only the default database is supported,
38 using the <filename>uninstall.sh</filename> script, the 43 any requests for alternative databases are custom adaptations not tested
39 <literal>ec_postgres</literal> service remains in an abnormal state. If 44 by Enea.</para>
40 a product has not been successfully installed originally or if the
41 installed resources (files, users, services, databases, environment
42 variables, etc.) have been manually changed/removed, the uninstall may
43 fail and some resources will not be removed from the machine. Reverting
44 resources in the case of a failed uninstall is not implemented.</para>
45 </listitem> 45 </listitem>
46
47 <listitem><remark>ELCCR-454</remark>Only the default database is supported, any requests for alternative databases are custom adaptations.</listitem>
48 46
49 <listitem> 47 <listitem>
50 <para><remark>ELCCR-371</remark>A software image for NFV Access runs 48 <para><remark>ELCCR-474</remark>Deleting VNF instances with flows
51 only upon the hardware platform it is built for. Currently, NFV Access 49 configured on the OVS bridges can be done only after removing the
52 supports two separate platforms: Intel atom-c and Intel xeon-d. The user 50 flows.</para>
53 uploading a software image to the uCPE Manager can specify which
54 platform the image belongs to. When upgrading devices that have older
55 versions of NFV Access (2.2.1 and earlier), the device does not provide
56 information about its platform. In such cases, it is not possible to
57 validate if it is acceptable to use a given software image for an
58 upgrade. In more recent versions of NFV Access (2.2.2 onwards), the
59 device supplies its platform and while upgrading a device, the system
60 will validate that the software image being upgraded to is of the same
61 platform type as the device.</para>
62 </listitem> 51 </listitem>
63 52
64 <listitem> 53 <listitem>
65 <para><remark>ELCCR-474</remark>In case one VNF has configured flows in 54 <para><remark>ELCCR-527</remark>Cancelling a file upload in the uCPE
66 one of the OVS bridges it is connected to, the VNF instance cannot be 55 Manager will require the user to close and reopen the upload window for
67 deleted before removing the appropriate flows.</para> 56 the next upload to work.</para>
68 </listitem> 57 </listitem>
69
70 <listitem><remark>ELCCR-527</remark>When uploading a file, if the user cancels the upload, the upload window must be closed and reopened in order for the next upload to work.</listitem>
71 58
72 <listitem> 59 <listitem>
73 <para><remark>LXCR-9088</remark>Automation Framework and Test Harness 60 <para><remark>ELCCR-572</remark>Sometimes when selecting and deleting
74 tests require python version 2.7.X. Please make sure it is installed 61 more than one VNF instance simultaneously, an error message might be
75 before using the framework.</para> 62 triggered, even if the delete operation succeeds.</para>
76 </listitem> 63 </listitem>
77 64
78 <listitem> 65 <listitem>
79 <para><remark>LXCR-????</remark>The Call Home functionality does not 66 <para><remark>LXCR-????</remark>The Call Home functionality does not
80 support having multiple interfaces/routes that go from the device to the 67 support having multiple interfaces/routes that go from the device to the
81 uCPE Manager. The IP/DNS address might need to be changed to the 68 uCPE Manager.</para>
82 established socket IP.</para>
83 </listitem> 69 </listitem>
84 70
85 <listitem> 71 <listitem>
86 <para><remark>LXCR-9799</remark>In case two HDDs installed with NFV 72 <para><remark>LXCR-9799</remark>NFV Access can boot from the wrong
87 Access are attached to the same device, it is possible that NFV Access 73 partition if two HDDs are attached to the same device, this must be
88 will boot from the wrong partition. Please avoid having two NFV Access 74 avoided.</para>
89 images installed on two HDDs on the same device.</para>
90 </listitem> 75 </listitem>
91 </itemizedlist>
92 76
93 <para><remark>The section further down is generated from JIRA with 77 <listitem>
94 gen_known_issues.py, but that script is HARDCODED with affectedversion 78 <para><remark>LXCR-9853</remark>The WAN interface of uCPE device needs
95 "EL7_3-virtualization" and needs to be adapted when a release info for 79 to be connected to a network with at least a router/gateway installed
96 another ENFV Access version changes.</remark></para> 80 for next-hop communication.</para>
81 </listitem>
82
83 <listitem>
84 <para><remark>LXCR-9853</remark>When configuring a VNF with WAN and
85 Management access on different interfaces, the user has to ensure VNF's
86 virtual interfaces are configured so that proper routes are used for
87 traffic egress-ing the VNF.</para>
88 </listitem>
97 89
98 <para><emphasis role="bold">General Issues and Limitations</emphasis></para> 90 <listitem>
91 <para><remark>LXCR-9904</remark>NFV Access cannot be installed on USB
92 storage devices.</para>
93 </listitem>
99 94
100 <itemizedlist>
101 <listitem condition="hidden"> 95 <listitem condition="hidden">
102 <para><emphasis role="bold">PDF navigation</emphasis>: When using links 96 <para><emphasis role="bold">PDF navigation</emphasis>: When using links
103 to open other PDFs, or jump to another place in the same PDF, jumping 97 to open other PDFs, or jump to another place in the same PDF, jumping
@@ -106,121 +100,6 @@
106 configured to open PDF files in an external PDF reader. As a workaround, 100 configured to open PDF files in an external PDF reader. As a workaround,
107 open the HTML version of the document.<remark>LXCR-3283</remark></para> 101 open the HTML version of the document.<remark>LXCR-3283</remark></para>
108 </listitem> 102 </listitem>
109
110 <listitem>
111 <para><remark>LXCR-9773</remark>REST API changes for specified modules
112 that might cause backward compatibility issues, are listed below:</para>
113
114 <itemizedlist>
115 <listitem>
116 <para>CustomScripts:</para>
117
118 <para>The <literal>uploadCustomScript()</literal> method takes in an
119 additional argument (device module name). This should not affect
120 current REST clients, since CustomScript functionality is available
121 only for NFV Access 2.2.2.</para>
122 </listitem>
123
124 <listitem>
125 <para>Device Upgrade:</para>
126
127 <para>A new method <literal>-- upload() --</literal> has been added
128 to allow uploads of NFV Access software images to the uCPE Manager.
129 This should not affect current REST clients, since it is a new
130 method.</para>
131 </listitem>
132
133 <listitem>
134 <para>VnfManager:</para>
135
136 <para>A new method <literal>-- upload() --</literal> has been added
137 to allow uploads of VNF images to the uCPE Manager as part of the
138 onboarding process. This should not affect current REST clients,
139 since it is a new method.</para>
140 </listitem>
141
142 <listitem>
143 <para>VcpeAgent (i.e. NFV Access device module):<itemizedlist>
144 <listitem>
145 <para>The system-attributes config table was split into
146 system-attributes-state (operational data) and
147 system-attributes (configuration data).<itemizedlist>
148 <listitem>
149 <para>The configuration data still contains the
150 attributes: device-name, device-description and
151 initial-configuration-complete.</para>
152 </listitem>
153
154 <listitem>
155 <para>The fields device-type, device-version, device-id,
156 device-latitude, and device-longitude are now
157 operational data. device-ip-address has been added as
158 oper data.</para>
159 </listitem>
160
161 <listitem>
162 <para>customer-tag in release version 2.2.1 was a config
163 leaf-list, it is now a leaf called device-customer-tags
164 (comma-separated).</para>
165 </listitem>
166
167 <listitem>
168 <para>mgmt-ip-address has been added as oper data. This
169 attribute was configured within an ovs-bridge of type
170 inband-mgmt.</para>
171 </listitem>
172 </itemizedlist></para>
173 </listitem>
174
175 <listitem>
176 <para>The external-interface-capabilities operational table
177 now has "wan" and "mgmt" Booleans.</para>
178 </listitem>
179
180 <listitem>
181 <para>The external-interface configuration table now has a
182 choice of "wan".</para>
183
184 <para>New fields for this type are mgmt-interface,
185 address-assignment , ip-address, gateway, netmask (only
186 considered if static).</para>
187 </listitem>
188
189 <listitem>
190 <para>In ovs-bridge, for the choice of inband-mgmt, the
191 mgmt-address and mgmt-port fields have been removed (there are
192 no fields left in this choice).</para>
193 </listitem>
194
195 <listitem>
196 <para>In the Host operational table, there are a couple of
197 changes:<itemizedlist>
198 <listitem>
199 <para>The "name" field has been removed, there is still
200 a "host-name" field.</para>
201 </listitem>
202
203 <listitem>
204 <para>A "machine-type" field has been added.</para>
205 </listitem>
206 </itemizedlist></para>
207 </listitem>
208 </itemizedlist></para>
209 </listitem>
210 </itemizedlist>
211 </listitem>
212
213 <listitem>
214 <para>REST clients should see some minor changes depending upon whether
215 they are dealing with version 2.2.1 or 2.2.2 of the device. Code that
216 deals with the system-attributes table, in-band management OVS bridges,
217 or the host operational data might need to be modified.</para>
218
219 <para>The new wan interface type only matters in that you need a
220 wan-mgmt interface configured to create the in-band mgmt. bridge. This
221 should typically happen automatically as part of initial install or
222 upgrade and should not affect the REST clients</para>
223 </listitem>
224 </itemizedlist> 103 </itemizedlist>
225 104
226 <!-- The file with a section below is autocreated by make init --> 105 <!-- The file with a section below is autocreated by make init -->