From 3ea496ae1ce97a1a82f3b75f22def21a34123729 Mon Sep 17 00:00:00 2001 From: "Thomas \"Andy\" Baugh" Date: Wed, 13 Nov 2024 17:09:51 +0000 Subject: [PATCH] Add some notes in the blocker FAQ about unsupported repos case RE-158: Hopefully this reduces the amount of issue filings on that. Phrasing reviewed by Katherine Frain in DOCS-261. --- docs-website-src/content/blockers.md | 19 +++++++++++++++++++ elevate-cpanel | 2 +- lib/Elevate/Components/Repositories.pm | 2 +- 3 files changed, 21 insertions(+), 2 deletions(-) diff --git a/docs-website-src/content/blockers.md b/docs-website-src/content/blockers.md index 3205cf86..0e34d4b3 100644 --- a/docs-website-src/content/blockers.md +++ b/docs-website-src/content/blockers.md @@ -149,3 +149,22 @@ These issues with the YUM repositories can cause ELevate to block your upgrade: * 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. + +#### Unsupported Repository + +If you receive the following error message when you use this script, +you have installed packages from an unsupported repository: + +One or more enabled YUM repo[sitories] are currently unsupported and have installed packages. +You should disable these repositories and remove packages installed from them before continuing the update. + +We will not allow upgrades while you are using packages from unsupported repositories for the following reasons: + +* We cannot be sure that unsupported repositories provides packages for your upgraded distribution version. +* Even if an unsupported repository provides packages for your upgraded distribution version, we cannot +be sure installing them will not interfere with your upgrade process. + +To upgrade your distribution version, you must first disable these repositories and remove their packages. +Then, when the upgrade completes, you can reenable and reinstall, or install equivalent packages +from other repositories. If no equivalent packages exist, you may have to find a different solution +to provide the package's functionality. diff --git a/elevate-cpanel b/elevate-cpanel index aa8a3e23..99441dbe 100755 --- a/elevate-cpanel +++ b/elevate-cpanel @@ -5433,7 +5433,7 @@ EOS } if ( $status_hr->{'USE_RPMS_FROM_UNVETTED_REPO'} ) { $msg .= <<~'EOS'; - One or more enabled YUM repo are currently unsupported and have installed packages. + One or more enabled YUM repositories are currently unsupported and have installed packages. You should disable these repositories and remove packages installed from them before continuing the update. EOS diff --git a/lib/Elevate/Components/Repositories.pm b/lib/Elevate/Components/Repositories.pm index 1690f588..71d856bd 100644 --- a/lib/Elevate/Components/Repositories.pm +++ b/lib/Elevate/Components/Repositories.pm @@ -164,7 +164,7 @@ sub _blocker_invalid_yum_repos ($self) { } if ( $status_hr->{'USE_RPMS_FROM_UNVETTED_REPO'} ) { $msg .= <<~'EOS'; - One or more enabled YUM repo are currently unsupported and have installed packages. + One or more enabled YUM repositories are currently unsupported and have installed packages. You should disable these repositories and remove packages installed from them before continuing the update. EOS