summaryrefslogtreecommitdiffstats
path: root/doc/book-enea-edge-release-info/doc/known_bugs_and_limitations.xml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/book-enea-edge-release-info/doc/known_bugs_and_limitations.xml')
-rw-r--r--doc/book-enea-edge-release-info/doc/known_bugs_and_limitations.xml215
1 files changed, 127 insertions, 88 deletions
diff --git a/doc/book-enea-edge-release-info/doc/known_bugs_and_limitations.xml b/doc/book-enea-edge-release-info/doc/known_bugs_and_limitations.xml
index 81816a5..13a8c23 100644
--- a/doc/book-enea-edge-release-info/doc/known_bugs_and_limitations.xml
+++ b/doc/book-enea-edge-release-info/doc/known_bugs_and_limitations.xml
@@ -4,38 +4,59 @@
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 general issues and limitations that 7 <note>
8 affect the current release.</para> 8 <para>All issues may also affect previous releases.</para>
9 </note>
9 10
10 <itemizedlist> 11 <itemizedlist>
11 <listitem> 12 <listitem>
12 <para><remark>LXCR-9904</remark>Enea Edge Runtime cannot be installed on 13 <para><remark>ELCCR-1688, ELCCR-1809</remark>It is possible to end up
13 USB storage devices.</para> 14 with a corrupted VM image from the download operation. If that happens,
15 the VNF instantiation will fail. The corrupted image has to be manually
16 removed from <literal>/var/odm/vm_images/startup/</literal>.</para>
14 </listitem> 17 </listitem>
15 18
16 <listitem> 19 <listitem>
17 <para><remark>LXCR-9799</remark>Proper boot order is not ensured if a 20 <para><remark>ELCCR-1733</remark>Logging into the Enea Edge Management
18 uCPE device has more than one HDD attached.</para> 21 application over HTTP can fail, producing the error <literal>You have
22 been automatically logged out</literal>. If this happens, the user
23 should clear the <literal>JSESSIONID</literal> browser's cookie or close
24 and restart the browser.</para>
19 </listitem> 25 </listitem>
20 26
21 <listitem> 27 <listitem>
22 <para><remark>ELCCR-527</remark>Cancelling a file upload in the Enea 28 <para><remark>ELCCR-1753</remark>When using tap interfaces for
23 Edge Management will require the user to close and reopen the upload 29 communicating over the bridge, port numbers assigned to VM interfaces
24 window for the next upload to work.</para> 30 can change when the VMs are restarted. The only currently known
31 workaround is rebooting the uCPE device.</para>
25 </listitem> 32 </listitem>
26 33
27 <listitem> 34 <listitem>
28 <para><remark>ELCCR-577</remark>If the Enea Edge Management application 35 <para><remark>ELCCR-1999</remark>Attempting to upload multiple files
29 is restored from a backup made on a release version older than Enea NFV 36 simultaneously (e.g. a VNF image and custom scripts) in the Enea Edge
30 Access 2.2.3, VNFs cannot be instantiated from the GUI.</para> 37 Management application will cause all upload operations to be canceled.
38 In order to avoid this limitation, please wait until any previous
39 upload finishes before initiating a new one.</para>
31 </listitem> 40 </listitem>
32 41
33 <listitem> 42 <listitem>
34 <para><remark>ELCCR-1134</remark>In order to avoid an incorrect boot 43 <para><remark>LXCR-10922</remark>A very rare error on some Atom C3000
35 order after a failed upgrade, the user should remove the upgrade 44 boards makes X553 SFP+ Ethernet ports unusable until a target cold reset
36 image before attempting again.</para> 45 is performed. When the error occurs in Enea Edge Runtime 2.5.0, there
46 will be a warning printed into the console by the
47 <literal>ixgbe</literal> driver:</para>
48
49 <programlisting>[11.361580] ixgbe 0000:0a:00.0: Warning firmware error detected FWSM: 0x8010801A</programlisting>
50
51 <para>The only currently known workaround for this issue is a cold
52 reset.</para>
37 </listitem> 53 </listitem>
54 </itemizedlist>
38 55
56 <para><emphasis role="bold">Limitations detected in previous releases,
57 that still affect this release:</emphasis></para>
58
59 <itemizedlist>
39 <listitem> 60 <listitem>
40 <para><remark>ELCCR-474</remark>Deleting VNF instances with flows 61 <para><remark>ELCCR-474</remark>Deleting VNF instances with flows
41 configured on the OVS bridges can be done only after removing the 62 configured on the OVS bridges can be done only after removing the
@@ -43,12 +64,24 @@
43 </listitem> 64 </listitem>
44 65
45 <listitem> 66 <listitem>
67 <para><remark>ELCCR-527</remark>Canceling a file upload in the Enea Edge
68 Management application will require the user to close and reopen the
69 upload window for the next upload to work.</para>
70 </listitem>
71
72 <listitem>
46 <para><remark>ELCCR-572</remark>Sometimes when selecting and deleting 73 <para><remark>ELCCR-572</remark>Sometimes when selecting and deleting
47 more than one VNF instance simultaneously, an error message might be 74 more than one VNF instance simultaneously, an error message might be
48 triggered, even if the delete operation succeeds.</para> 75 triggered, even if the delete operation succeeds.</para>
49 </listitem> 76 </listitem>
50 77
51 <listitem> 78 <listitem>
79 <para><remark>ELCCR-577</remark>If the Enea Edge Management application
80 is restored from a backup made on a release version older than Enea NFV
81 Access 2.2.3, VNFs cannot be instantiated from the GUI.</para>
82 </listitem>
83
84 <listitem>
52 <para><remark>ELCCR-847</remark>The Juniper vSRX VNF cannot be 85 <para><remark>ELCCR-847</remark>The Juniper vSRX VNF cannot be
53 instantiated on the Xeon-D architectures due to missing CPU features in 86 instantiated on the Xeon-D architectures due to missing CPU features in
54 the VNF's domain XML. This impacts all example use cases where the 87 the VNF's domain XML. This impacts all example use cases where the
@@ -56,10 +89,53 @@
56 </listitem> 89 </listitem>
57 90
58 <listitem> 91 <listitem>
59 <para><remark>USERDOCAP-648</remark>The <literal>storage size</literal> 92 <para><remark>ELCCR-912</remark>When the Enea Edge Management
60 parameter on the VNF onboarding page is ignored. The default storage 93 application is installed on CentOS 7, prior to C7.1804 (kernel version
61 size specified when creating the VM image is used when instantiating the 94 3.10.0-862), adding an upgrade image fails. As a workaround, please
62 VM and when presenting VM information.</para> 95 update <literal>glib2</literal> to version 2.54.2 or later, using
96 <literal>#yum update glib2</literal>.</para>
97 </listitem>
98
99 <listitem>
100 <para><remark>ELCCR-1468</remark>When using the Enea Edge Management
101 application in HTTPS mode, upgrading a device from NFV Access 2.3.0 is
102 not possible. Either switch to HTTP mode (for more details see <olink
103 targetdoc="book_enea_edge_getting_started"
104 targetptr="device_up_process">The uCPE device Upgrade Process in the
105 <xi:include href="../../s_docbuild/olinkdb/pardoc-names.xml"
106 xmlns:xi="http://www.w3.org/2001/XInclude"
107 xpointer="element(book_enea_edge_getting_started/1)" /></olink> Manual)
108 or install it manually.</para>
109 </listitem>
110
111 <listitem>
112 <para><remark>ELCCR-1497</remark>If the Enea Edge Management application
113 has an incorrect database configuration, when performing an
114 uninstallation, the Tomcat instance and Watchdog service will not be
115 stopped automatically. Instead, they must be killed explicitly.</para>
116 </listitem>
117
118 <listitem>
119 <para><remark>ELCCR-1565</remark>Before starting an Enea Edge Management
120 upgrade, any owned Tomcat certificates should be manually copied into
121 the
122 <literal>/opt/ems/ucpemanager/application/config/certificates</literal>
123 folder.</para>
124 </listitem>
125
126 <listitem condition="hidden">
127 <para><remark>LXCR-3283</remark><emphasis role="bold">PDF
128 navigation</emphasis>: When using links to open other PDFs, or jump to
129 another place in the same PDF, jumping back sometimes fails. This has
130 been observed when opening a PDF in Adobe Reader, inside a browser with
131 PDF add-on, as well as when the browser is configured to open PDF files
132 in an external PDF reader. As a workaround, open the HTML version of the
133 document.</para>
134 </listitem>
135
136 <listitem>
137 <para><remark>LXCR-9799</remark>Proper boot order is not ensured if a
138 uCPE device has more than one HDD attached.</para>
63 </listitem> 139 </listitem>
64 140
65 <listitem> 141 <listitem>
@@ -67,11 +143,10 @@
67 to be connected to a network with at least a router/gateway installed 143 to be connected to a network with at least a router/gateway installed
68 for next-hop communication.</para> 144 for next-hop communication.</para>
69 </listitem> 145 </listitem>
70 146
71 <listitem> 147 <listitem>
72 <para><remark>ELCCR-1504</remark>To change the type of an interface 148 <para><remark>LXCR-9904</remark>Enea Edge Runtime cannot be installed on
73 from DPDK to SR-IOV, first delete the existing interface, then 149 USB storage devices.</para>
74 recreate it with the desired type.</para>
75 </listitem> 150 </listitem>
76 151
77 <listitem> 152 <listitem>
@@ -85,29 +160,9 @@
85 </listitem> 160 </listitem>
86 161
87 <listitem> 162 <listitem>
88 <para><remark>STCR-6224</remark>The Enea Edge Automation and the Enea 163 <para><remark>LXCR-10750</remark>In order to avoid an incorrect boot
89 Edge Automation Framework and Test Harness do not support multiple 164 order after a failed upgrade, the user should remove the upgrade image
90 custom scripts uploaded to a uCPE device at the same time.</para> 165 before attempting again.</para>
91 </listitem>
92
93 <listitem>
94 <para><remark>STCR-6292</remark>Management of WAN Interfaces is not
95 implemented in the Enea Edge Automation Framework and Test
96 Harness.</para>
97 </listitem>
98
99 <listitem>
100 <para><remark>USERDOCAP-628</remark>Enea Edge Automation Framework and
101 Test Harness does not have support for product features implemented in
102 Enea Edge 2.4.0 or newer.</para>
103 </listitem>
104
105 <listitem>
106 <para><remark>ELCCR-912</remark>When the Enea Edge Management
107 application is installed on CentOS 7, prior to C7.1804 (kernel version
108 3.10.0-862), adding an upgrade image fails. As a workaround, please
109 update <literal>glib2</literal> to version 2.54.2 or later, using
110 <literal>#yum update glib2</literal>.</para>
111 </listitem> 166 </listitem>
112 167
113 <listitem> 168 <listitem>
@@ -117,58 +172,42 @@
117 </listitem> 172 </listitem>
118 173
119 <listitem> 174 <listitem>
175 <para><remark>USERDOCAP-648</remark>The <literal>storage size</literal>
176 parameter on the VNF onboarding page is ignored. The default storage
177 size specified when creating the VM image is used when instantiating the
178 VM and when presenting VM information.</para>
179 </listitem>
180
181 <listitem>
120 <para><remark>USERDOCAP-651</remark>Wireless AP configuration is 182 <para><remark>USERDOCAP-651</remark>Wireless AP configuration is
121 optimized for wireless modules that use the <literal>ath10k</literal> 183 optimized for wireless modules that use the <literal>ath10k</literal>
122 driver. Using other wireless modules may result in undefined 184 driver. Using other wireless modules may result in undefined
123 behavior.</para> 185 behavior.</para>
124 </listitem> 186 </listitem>
187 </itemizedlist>
125 188
126 <listitem> 189 <para><emphasis role="bold">The following limitations affect deprecated
127 <para><remark>ELCCR-1518</remark>The Wireless AP's wpa2psk password 190 components and their documentation:</emphasis></para>
128 should not contain white space characters.</para>
129 </listitem>
130 191
192 <itemizedlist>
131 <listitem> 193 <listitem>
132 <para><remark>ELCCR-1561</remark>Before starting an Enea Edge Management 194 <para><remark>STCR-6224</remark>The Enea Edge Automation Framework and
133 upgrade, any owned Tomcat certificates should be manually copied into the 195 Test Harness do not support multiple custom scripts uploaded to a uCPE
134 <literal>/opt/ems/ucpemanager/application/3rdParty/apache-tomcat/conf/config/certificates</literal> 196 device at the same time. This limitation does not apply to Enea Edge
135 folder.</para> 197 Automation.</para>
136 </listitem> 198 </listitem>
137 199
138 <listitem> 200 <listitem>
139 <para><remark>ELCCR-1378</remark>Modifying the type of the external 201 <para><remark>STCR-6292</remark>Management of WAN Interfaces is not
140 interfaces can lead to errors. Instead of modifying, it is recommended 202 implemented in the Enea Edge Automation Framework and Test
141 to delete the old interfaces and recreate them with the desired 203 Harness. This limitation does not apply to the Enea Edge Automation.</para>
142 type.</para>
143 </listitem>
144
145 <listitem>
146 <para><remark>ELCCR-1497</remark>If the Enea Edge Management application
147 has an incorrect database configuration, when performing an uninstallation,
148 the Tomcat instance and Watchdog service will not be stopped automatically.
149 Instead, they must be killed explicitly.</para>
150 </listitem>
151
152 <listitem>
153 <para><remark>ELCCR-1468</remark>When using the Enea Edge Management
154 application in HTTPS mode, upgrading a device from NFV Access 2.3.0 is
155 not possible. Either switch to HTTP mode (for more details see <olink
156 targetdoc="book_enea_edge_getting_started"
157 targetptr="device_up_process">The uCPE device Upgrade Process in the
158 <xi:include href="../../s_docbuild/olinkdb/pardoc-names.xml"
159 xmlns:xi="http://www.w3.org/2001/XInclude"
160 xpointer="element(book_enea_edge_getting_started/1)" /></olink> Manual)
161 or install it manually.</para>
162 </listitem> 204 </listitem>
163 205
164 <listitem condition="hidden"> 206 <listitem>
165 <para><remark>LXCR-3283</remark><emphasis role="bold">PDF 207 <para><remark>USERDOCAP-628</remark>The Enea Edge Automation Framework
166 navigation</emphasis>: When using links to open other PDFs, or jump to 208 and Test Harness do not have support for product features implemented in
167 another place in the same PDF, jumping back sometimes fails. This has 209 Enea Edge 2.4.0 or newer. Please use the new Enea Edge Automation
168 been observed when opening a PDF in Adobe Reader, inside a browser with 210 component if you want support for newer features.</para>
169 PDF add-on, as well as when the browser is configured to open PDF files
170 in an external PDF reader. As a workaround, open the HTML version of the
171 document.</para>
172 </listitem> 211 </listitem>
173 </itemizedlist> 212 </itemizedlist>
174 213
@@ -176,4 +215,4 @@
176 215
177 <!-- <xi:include href="jiraissues_generated.xml" 216 <!-- <xi:include href="jiraissues_generated.xml"
178 xmlns:xi="http://www.w3.org/2001/XInclude" /> --> 217 xmlns:xi="http://www.w3.org/2001/XInclude" /> -->
179</chapter> 218</chapter> \ No newline at end of file