From 27c3059578ec3372d69e7c2207ef8041309acd30 Mon Sep 17 00:00:00 2001 From: Toma Bilius Date: Thu, 4 Mar 2021 14:38:53 +0200 Subject: ELCCR-1468 HA: Cannot upgrade NFV Access installation Change-Id: I8a399d43dcfd6e5b845f90bf2e8e2e2c9bac6afc Signed-off-by: Toma Bilius --- .../doc/upgrade_ena.xml | 51 ++++--- .../doc/known_bugs_and_limitations.xml | 167 ++++++++++++--------- 2 files changed, 128 insertions(+), 90 deletions(-) diff --git a/doc/book-enea-nfv-access-getting-started/doc/upgrade_ena.xml b/doc/book-enea-nfv-access-getting-started/doc/upgrade_ena.xml index 69e3b5d..9f9a50d 100644 --- a/doc/book-enea-nfv-access-getting-started/doc/upgrade_ena.xml +++ b/doc/book-enea-nfv-access-getting-started/doc/upgrade_ena.xml @@ -71,22 +71,24 @@ Enea_NFV_Access_uCPEManager_<version>-build<build_number>.tar.gzStart the ucpemanager service. - - Fresh Installation of the Enea uCPE Manager in the - Manual contains information - about the input required to be entered during the execution of the upgrade script. - For an example on how to upgrade an Enea uCPE Manager installation in a - High Availability setup, consult Fresh Installation of the Enea uCPE + Manager in the + Manual contains information about the input required to be entered during + the execution of the upgrade script. + + For an example on how to upgrade an Enea uCPE Manager installation + in a High Availability setup, consult Upgrading a High Availability Deployment in the Manual. + xmlns:ns="http://www.w3.org/2001/XInclude" + xpointer="element(book_enea_nfv_access_getting_started/1)" /> + Manual.
Restoring a previous Enea uCPE Manager Installation @@ -235,6 +237,15 @@ Enea_NFV_Access_uCPEManager_<version>-build<build_number>.tar.gz + + + Upgrading from Enea NFV Access 2.3.0 is not possible when using + the Enea uCPE Manager in HTTPS mode. Either switch to HTTP by accessing + System, Configuration, Web + Access and checking the Enable + HTTP box, or installing it manually. +
@@ -390,10 +401,10 @@ Enea_NFV_Access_uCPEManager_<version>-build<build_number>.tar.gz - Mark the uCPE devices that you wish to upgrade and - press the > button to - move the uCPE devices to the right side of the selector. Those - chosen form the list of uCPE devices that will be upgraded. + Mark the uCPE devices that you wish to upgrade and press the + > button to move the uCPE + devices to the right side of the selector. Those chosen form the + list of uCPE devices that will be upgraded. @@ -420,9 +431,11 @@ Enea_NFV_Access_uCPEManager_<version>-build<build_number>.tar.gz - - To start the upgrade, click - ok. + + + To start the upgrade, click ok. + 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 31d3a03..a1a5db3 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 @@ -84,80 +84,94 @@ - ELCCR-912When the Enea uCPE Manager is installed - on CentOS 7, prior to C7.1804 (kernel version 3.10.0-862), adding an - upgrade image fails. As a workaround, please update glib2 - to version 2.54.2 or later, using #yum update glib2. + ELCCR-912When the Enea uCPE Manager is installed + on CentOS 7, prior to C7.1804 (kernel version 3.10.0-862), adding an + upgrade image fails. As a workaround, please update + glib2 to version 2.54.2 or later, using #yum + update glib2. + + + + ELCCR-854Changing the management interface IP + address will result in a temporary loss of connection with the uCPE + device. If the device is behind a NAT, while using the Call Home + connection, reestablishing the connection automatically could take up to + 20 minutes. Restarting the vCPE Overlay will immediately reestablish the + connection, but that implies the existence of an alternate way to + trigger the vCPE restart operation on the device. + + + + USERDOCAP-641Enea NFV Access does not have + support for IPv6 addresses on both uCPE devices and the Enea uCPE + Manager installation. + + + + ELCCR-1428Wireless AP creation through the REST + API does not validate that the wireless interface and LAN bridge are + configured. Using these parameters may result in undefined + behavior. + + + + ELCCR-1351The updated + .Keystore and server.xml files + from the + /opt/ems/ucpemanager/application/3rdParty/apache-tomcat/conf/ + folder are overwritten during a product upgrade. As a workaround for + this issue, after an upgrade, copy the updated + .Keystore and server.xml files + into the + /opt/ems/ucpemanager/application/3rdParty/apache-tomcat/conf/ + folder and restart the ucpemanager service. + + + + ELCCR-1371The current self-signed certificate for + the Enea uCPE Manager is generated at build time, with a hard-coded + common-name causing the uCPE device upgrade to fail in HTTPS mode. As a + workaround, another certificate (containing an IP based common-name) + must be generated. + + Perform the following the steps to generate the + certificate: + + + + Stop the uCPE Manager service. + + + + Create the certificate using the + createCertificate.sh script from distribution + folder. This will create a new .Keystore file + and copy it into the + /opt/ems/ucpemanager/application/3rdParty/apache-tomcat/conf/config/certificates + folder. + + + + Start the Enea uCPE Manager, the new certificate should now + take effect. + + + + + ELCCR-1378Modifying the type of the external + interfaces can lead to errors. Instead of modifying, it is recommended + to delete the old interfaces and recreate them with the desired + type. + - ELCCR-854Changing the management interface IP address - will result in a temporary loss of connection with the uCPE device. If the - device is behind a NAT, while using the Call Home connection, - reestablishing the connection automatically could take up to 20 minutes. - Restarting the vCPE Overlay will immediately reestablish the connection, - but that implies the existence of an alternate way to trigger the vCPE - restart operation on the device. - - - - USERDOCAP-641Enea NFV Access does not have support - for IPv6 addresses on both uCPE devices and the Enea uCPE Manager - installation. - - - - ELCCR-1428Wireless AP creation through the REST - API does not validate that the wireless interface and LAN bridge are - configured. Using these parameters may result in undefined behavior. - - - - ELCCR-1351The updated .Keystore - and server.xml files from the - /opt/ems/ucpemanager/application/3rdParty/apache-tomcat/conf/ - folder are overwritten during a product upgrade. As a workaround for - this issue, after an upgrade, copy the updated .Keystore - and server.xml files into the - /opt/ems/ucpemanager/application/3rdParty/apache-tomcat/conf/ - folder and restart the ucpemanager service. - - - - ELCCR-1371The current self-signed certificate for - the Enea uCPE Manager is generated at build time, with a hard-coded common-name - causing the uCPE device upgrade to fail in HTTPS mode. As a workaround, - another certificate (containing an IP based common-name) must be generated. - - Perform the following the steps to generate the certificate: - - - Stop the uCPE Manager service. - - Create the certificate using the - createCertificate.sh script from distribution - folder. This will create a new .Keystore file - and copy it into the - /opt/ems/ucpemanager/application/3rdParty/apache-tomcat/conf/config/certificates - folder. - - Start the Enea uCPE Manager, the new certificate - should now take effect. - - - - - ELCCR-1378Modifying the type of the external interfaces can lead - to errors. Instead of modifying, it is recommended to delete the old - interfaces and recreate them with the desired type. - - - - ELCCR-907At times the VIP address is not acquired - by any of the backup nodes if a power failure happens on primary node - in a High Availability setup. To recover, follow the official documentation - available at Galera Cluster Recovery. + ELCCR-907At times the VIP address is not acquired + by any of the backup nodes if a power failure happens on primary node in + a High Availability setup. To recover, follow the official documentation + available at Galera Cluster + Recovery. @@ -168,6 +182,17 @@ configured to open PDF files in an external PDF reader. As a workaround, open the HTML version of the document.LXCR-3283 + + + ELCCR-1468When using the Enea uCPE Manager in HTTPS + mode, upgrading a device from NFV Access 2.3.0 is not possible. Either + switch to HTTP mode (for more details see The uCPE device Upgrade Process in the +Manual) or install it manually. + -- cgit v1.2.3-54-g00ecf