diff options
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.xml | 225 |
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 --> |