Satellite 6 upgrade fails with error 'pulpcore-manager migrate --noinput' returned 1 instead of one of [0]'

Environment

• Red Hat Satellite 6

Issue

• Upgrade to Red Hat Satellite 6.10 fails with the following error.

2023-08-21 19:52:21 [DEBUG ] [configure] /Stage[main]/Pulpcore::Database/Pulpcore::Admin[migrate --noinput]/Exec[pulpcore-manager migrate --noinput]/unless: pkg_resources.ContextualVersionConflict: (PyYAML 5.3.1 (/usr/local/lib64/python3.6/site-packages), Requirement.parse('pyyaml<6,>=5.4.1'), {'galaxy-importer'})

2023-08-21 19:52:22 [INFO  ] [configure] /Stage[main]/Pulpcore::Database/Pulpcore::Admin[migrate --noinput]/Exec[pulpcore-manager migrate --noinput]/returns: pkg_resources.ContextualVersionConflict: (PyYAML 5.3.1 (/usr/local/lib64/python3.6/site-packages), Requirement.parse('pyyaml<6,>=5.4.1'), {'galaxy-importer'})
2023-08-21 19:52:22 [ERROR ] [configure] 'pulpcore-manager migrate --noinput' returned 1 instead of one of [0]
2023-08-21 19:52:22 [ERROR ] [configure] /Stage[main]/Pulpcore::Database/Pulpcore::Admin[migrate --noinput]/Exec[pulpcore-manager migrate --noinput]/returns: change from 'notrun' to ['0'] failed: 'pulpcore-manager migrate --noinput' returned 1 instead of one of [0]

Resolution

• If there are any contents found inside /usr/local/lib64 , they should be moved to a different place or probably renamed temporarily before the upgrade of the satellite can be re-attempted.
• Then re-install the following packages.

  # yum reinstall python3-pyyaml PyYAML python3-galaxy-importer

• Upgrade the satellite.

 # satellite-maintain upgrade check --target-version 6.10

 # satellite-maintain upgrade run --target-version 6.10

• If the issue still persists, refer this article as well.

For more KB articles/solutions related to Red Hat Satellite 6.x Installation/Upgrade/Update Issues, please refer to the Red Hat Satellite Consolidated Troubleshooting Article for Red Hat Satellite 6.x Installation/Upgrade/Update Issues.

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.