Skip to content

Commit

Permalink
Add some notes in the blocker FAQ about unsupported repos
Browse files Browse the repository at this point in the history
case RE-158: Hopefully this reduces the amount of issue filings on that.
Phrasing reviewed by Katherine Frain in DOCS-261.
  • Loading branch information
Thomas "Andy" Baugh authored and Andy Baugh committed Nov 14, 2024
1 parent 5ebe3da commit 3ea496a
Show file tree
Hide file tree
Showing 3 changed files with 21 additions and 2 deletions.
19 changes: 19 additions & 0 deletions docs-website-src/content/blockers.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
2 changes: 1 addition & 1 deletion elevate-cpanel
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion lib/Elevate/Components/Repositories.pm
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down

0 comments on commit 3ea496a

Please sign in to comment.