Project

Profile

Help

Issue #1396

closed

RHEL 7 install doc misses RPM, error throws link to wrong doc afterward

Added by kfiresmith over 8 years ago. Updated almost 4 years ago.

Status:
CLOSED - CURRENTRELEASE
Priority:
Normal
Assignee:
-
Category:
-
Sprint/Milestone:
-
Start date:
Due date:
Estimated time:
Severity:
2. Medium
Version:
2.7.0
Platform Release:
2.7.1
OS:
Triaged:
Yes
Groomed:
No
Sprint Candidate:
No
Tags:
Documentation, Easy Fix, Pulp 2
Sprint:
Quarter:

Description

Folks,
The Server installation doc here: https://pulp.readthedocs.org/en/latest/user-guide/installation.html#server misses the required package "qpid-tools". This becomes apparent when one attempts to initialize the Pulp Mongo database:

Halting migrations due to a migration failure.
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/2.4-release/troubleshooting.html#qpidtoollibs-is-not-installed for more information.
Traceback (most recent call last):

Unfortunately the link provided in the error (a practice new users like myself greatly appreciate, btw!) is stale and points to 2.4 troubleshooting docs that I have observed won't fix RHEL 7. The "/latest/" docs do however provide the correct guidance on fixing the issue (install qpid-tools).

So I guess my request is kind of twofold:
1. Update the docs to have the user install qpid-tools if using RHEL
2. Update the Pulp source code to use the "/latest/" doc link that provides the fix for this issue: https://pulp.readthedocs.org/en/latest/user-guide/troubleshooting.html#qpidtoollibs-is-not-installed

Thanks a bunch!
- Kodiak Firesmith

Actions #1

Updated by bmbouter over 8 years ago

  • Status changed from NEW to CLOSED - DUPLICATE

Thank you for the bug report. This bug is actually a problem with our comps.xml definition which is tracked as issue #1061. Since the root cause is tracked there I'm going to close this as a duplicate. Even still, I appreciate the detailed report.

That change is expected to be included with 2.7.1. From there the statement below already in the docs will ensure they have qpid-tools installed.

sudo yum groupinstall pulp-server-qpid
Actions #2

Updated by bmbouter over 8 years ago

  • Is duplicate of Issue #1061: qpidtoollibs has moved from python-qpid-qmf to qpid-tools added
Actions #3

Updated by kfiresmith over 8 years ago

bmbouter wrote:

Thank you for the bug report. This bug is actually a problem with our comps.xml definition which is tracked as issue #1061. Since the root cause is tracked there I'm going to close this as a duplicate. Even still, I appreciate the detailed report.

That change is expected to be included with 2.7.1. From there the statement below already in the docs will ensure they have qpid-tools installed.

[...]

My only remaining qualm is that the pulp-server(?) code still throws an error message pointing to an older version (2.4) of the docs rather than the one in the "/latest/" version of the docs which doesn't resolve the problem. I didn't see updating the pulp-server code as a deliverable in the issue# this one is a duplicate of.

Thanks very much!
- Kodiak

Actions #4

Updated by dkliban@redhat.com over 8 years ago

  • Status changed from CLOSED - DUPLICATE to POST

Good point. I submitted a PR to remove the links from the error messages.

https://github.com/pulp/pulp/pull/2224

Actions #5

Updated by bmbouter over 8 years ago

  • Is duplicate of deleted (Issue #1061: qpidtoollibs has moved from python-qpid-qmf to qpid-tools)

Added by dkliban@redhat.com over 8 years ago

Revision c84c9e99 | View on GitHub

Removes URLs from migration 0009 error messages

https://pulp.plan.io/issues/1396 closes #1396

Added by dkliban@redhat.com over 8 years ago

Revision c84c9e99 | View on GitHub

Removes URLs from migration 0009 error messages

https://pulp.plan.io/issues/1396 closes #1396

Actions #6

Updated by dkliban@redhat.com over 8 years ago

  • Status changed from POST to MODIFIED
  • % Done changed from 0 to 100
Actions #7

Updated by dkliban@redhat.com over 8 years ago

  • Platform Release set to 2.7.1
Actions #8

Updated by mhrivnak over 8 years ago

  • Status changed from MODIFIED to CLOSED - CURRENTRELEASE
  • Triaged changed from No to Yes
Actions #9

Updated by bmbouter about 5 years ago

  • Tags Pulp 2 added
Actions #10

Updated by bmbouter almost 4 years ago

  • Category deleted (23)

Also available in: Atom PDF