From 000866115506797f7524e0e5398d5c5114c522d7 Mon Sep 17 00:00:00 2001 From: Stephen Bee Date: Wed, 12 Jun 2024 13:39:15 -0500 Subject: [PATCH 1/2] Updated blockers documentation for changes made in RE-34, RE-338, and RE-337. This change adds documentation for the removal of the blockers for systems with remote MySQL, NICs named by the kernel, and incomplete yum transactions. --- docs-website-src/content/blockers.md | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/docs-website-src/content/blockers.md b/docs-website-src/content/blockers.md index 1ec3436a..682bd5d0 100644 --- a/docs-website-src/content/blockers.md +++ b/docs-website-src/content/blockers.md @@ -101,20 +101,16 @@ If you are running JetBackup, it **must** be version 5 or greater. Earlier versi ### Multiple network interface cards using kernel names -We block if your machine has multiple network interface cards (NICs) using kernel names (`ethX`). - * Since `ethX` style names are automatically assigned by the kernel, there is no guarantee that this name will remain the same upon upgrade to a new kernel version tier. - * The "default" approach in `network-scripts` config files of specifying NICs by `DEVICE` can cause issues due to the above. - * To find a more in-depth explanation of *why* this is a problem (and what to do about it), read Freedesktop.org's Predictable Network Interface Names documentation. - -One way to prevent these issues is to assign a custom name in the configuration and re-initialize NICs ahead of time. +If your machine has multiple network interface cards (NICs) using kernel names (`ethX`), we offer to automatically update the name from `ethX` to `cpethX` during elevation. + * To find a more in-depth explanation of *why* this name change is necessary, read Freedesktop.org's Predictable Network Interface Names documentation. ### MySQL version A MySQL upgrade **cannot be** in progress. -If the version of MySQL/MariaDB installed on the system is not supported on RHEL 8-based distributions, you **must** upgrade to a supported version. If cPanel manages the MySQL installation, we will offer to upgrade MySQL automatically to MariaDB 10.6 during elevation. +If the local version of MySQL/MariaDB installed on the system is not supported on RHEL 8-based distributions, you **must** upgrade to a supported version. If cPanel manages the MySQL installation, we will offer to upgrade MySQL automatically to MariaDB 10.6 during elevation. -The system **must** not be set up to use a remote database server. +**NOTE:** In cases where an upgrade is necessary **and** the system is set up to use a remote server, a local server will be temporarily configured and enabled for the duration of the elevation, and the remote instance will be re-enabled once the elevation completes. ## OVH proactive intervention monitoring @@ -155,3 +151,5 @@ These issues with the YUM repositories can cause ELevate to block your upgrade: * Invalid syntax or use of `\$`. That character is interpolated on RHEL 7-based systems, but not on systems that are RHEL 8-based. * Any unsupported repositories that have packages installed. * If YUM is in an unstable state (running `yum makecache` fails). + +If any unfinished yum transactions are detected, ELevate will attempt to complete them by executing `/usr/sbin/yum-complete-transaction --cleanup-only`. If this fails, ELevate will block you from beginning the upgrade process until you manually resolve any outstanding issues or transactions. From abb58590743884951e6e047b719e614cb19ca602 Mon Sep 17 00:00:00 2001 From: Stephen Bee Date: Wed, 12 Jun 2024 13:42:32 -0500 Subject: [PATCH 2/2] Fix broken markdown link for httpupdate.cpanel.net --- docs-website-src/content/blockers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-website-src/content/blockers.md b/docs-website-src/content/blockers.md index 682bd5d0..b8082b0d 100644 --- a/docs-website-src/content/blockers.md +++ b/docs-website-src/content/blockers.md @@ -62,7 +62,7 @@ We do **not** support running the system in a container-like environment. To run the ELevate script successfully, you will need to be on a version mentioned in the _Latest cPanel & WHM Builds (All Architectures)_ section at http://httpupdate.cpanel.net/. -If you are not on a version mentioned in _Latest cPanel & WHM Builds (All Architectures)_ section, run the `/usr/local/cpanel/scripts/upcp` script to update. +If you are not on a version mentioned in [Latest cPanel & WHM Builds (All Architectures)](http://httpupdate.cpanel.net/) section, run the `/usr/local/cpanel/scripts/upcp` script to update. ### EA4 packages