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