Our error messages in migration 0009_qpid_queues[0] aren't quite in agreement with the packages that our release notes say to install[1]. According to Brian, the release notes are correct, so we should adjust the error messages in the migration in accordance. It could be nice if the error messages also linked to these release notes, or if we added a section to the troubleshooting section of the docs about this that they could link to. [0] https://github.com/pulp/pulp/blob/master/server/pulp/server/db/migrations/0009_qpid_queues.py#L46 [1] http://pulp-user-guide.readthedocs.org/en/latest/release-notes/2.4.x.html#upgrade-instructions-for-2-3-x-2-4-0
Technically, both are right, but the error message could be more useful. The documentation recommends installing the packages via RPM; the python-qpid-qmf python-qpid give you the python packages qpid.messaging and qpidtoollibs. The user could read the error message and decide to pip install those python packages. The migration cares that those packages exist, not how the user installs them. Mixing pip and rpm on an install is a bad idea, so, I think the best thing to do is to update the error message to recommend using yum to install the python-qpid-qmf and python-qpid packages. Perhaps we should link to the docs in the error message. If we do, maybe we should put all the hard-coded doc links as doc constants somewhere in a new or existing module so we don't repeat ourselves, and keep it all in one place.
https://github.com/pulp/pulp/pull/994
build: 2.4.0-0.20.beta
from /var/log/messages: Jun 11 11:15:31 ec2-54-74-117-222 pulp: pulp.server.db.manage:INFO: Applying pulp.server.db.migrations version 9 Jun 11 11:15:31 ec2-54-74-117-222 pulp: pulp.server.db.migrations.0009_qpid_queues:ERROR: Migration 0009 did not run because the python package qpidtoollibs is not installed. Please install qpidtoollibs and rerun the migrations. See http://pulp-user-guide.readthedocs.org/en/pulp-2.4/troubleshooting.html#qpidtoollibs-is-not-installed for more information. Jun 11 11:15:31 ec2-54-74-117-222 pulp: pulp.server.db.manage:CRITICAL: Applying migration pulp.server.db.migrations.0009_qpid_queues failed. Jun 11 11:15:31 ec2-54-74-117-222 pulp: pulp.server.db.manage:CRITICAL: Migration 0009 did not run because the python package qpidtoollibs is not installed. Please install qpidtoollibs and r erun the migrations. See http://pulp-user-guide.readthedocs.org/en/pulp-2.4/troubleshooting.html#qpidtoollibs-is-not-installed for more information. Jun 11 11:15:31 ec2-54-74-117-222 pulp: pulp.server.db.manage:CRITICAL: Traceback (most recent call last): Jun 11 11:15:31 ec2-54-74-117-222 pulp: pulp.server.db.manage:CRITICAL: File "/usr/lib/python2.7/site-packages/pulp/server/db/manage.py", line 86, in migrate_database Jun 11 11:15:31 ec2-54-74-117-222 pulp: pulp.server.db.manage:CRITICAL: update_current_version=not options.test) Jun 11 11:15:31 ec2-54-74-117-222 pulp: pulp.server.db.manage:CRITICAL: File "/usr/lib/python2.7/site-packages/pulp/server/db/migrate/models.py", line 161, in apply_migration Jun 11 11:15:31 ec2-54-74-117-222 pulp: pulp.server.db.manage:CRITICAL: migration.migrate() Jun 11 11:15:31 ec2-54-74-117-222 pulp: pulp.server.db.manage:CRITICAL: File "/usr/lib/python2.7/site-packages/pulp/server/db/migrations/0009_qpid_queues.py", line 56, in migrate Jun 11 11:15:31 ec2-54-74-117-222 pulp: pulp.server.db.manage:CRITICAL: raise Exception(msg) Jun 11 11:15:31 ec2-54-74-117-222 pulp: pulp.server.db.manage:CRITICAL: Exception: Migration 0009 did not run because the python package qpidtoollibs is not installed. Please install qpidtoo llibs and rerun the migrations. See http://pulp-user-guide.readthedocs.org/en/pulp-2.4/troubleshooting.html#qpidtoollibs-is-not-installed for more information. Moving to Verified.
This has been fixed in Pulp 2.4.0-1.