Bug 1040519

Summary:	yum-config-manager and subscription-manager are not used consistently.
Product:	Red Hat OpenStack	Reporter:	Summer Long <slong>
Component:	doc-Getting_Started_Guide	Assignee:	RHOS Documentation Team <rhos-docs>
Status:	CLOSED CURRENTRELEASE	QA Contact:
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	5.0 (RHEL 7)	CC:	adahms, ddomingo, yeylon
Target Milestone:	---	Keywords:	Documentation
Target Release:	5.0 (RHEL 7)
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2015-02-04 12:25:10 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Bug Depends On:	1108768
Bug Blocks:

Description Summer Long 2013-12-11 14:53:31 UTC

If there's no reason to use both for disabling or enabling channels, pick one and make it consistent throughout the doc. Note: Subscription-manager allows wild cards.
Ensure that whatever is used, matches the text in the Release Notes.

Once settled, please raise an Install Guide to fix the same issue.

Comment 3 Bruce Reeler 2014-06-17 06:05:44 UTC

Emailed Deon Ballard and received a reply pointing out that, for a long time, there was no way to enable/disable repos using subscription-manager, which is why the docs referenced yum-config-manager for enabling. But since RHEL 6.4, subscription-manager can also enable/disable.

However, yum-plugin-priorities still needs to be installed to allow setting the  
priority of the Red Hat Enterprise Linux OpenStack Platform software repository, and this needs to be run with the yum-config-manager command. So that part left in,  and moved command 'yum install -y yum-utils' to install yum-config-manager int the appropriate procedure step where it is required.

Comment 4 Bruce Reeler 2014-06-17 06:27:23 UTC

Changed most sections in "2.1.1. Configure Software Repositories"
Setting Don Domingo as QA review: you know where to look Don as we discussed this extensively.

Comment 6 Bruce Reeler 2014-07-01 06:54:52 UTC

Hi Don, changes are as follows:

In http://docbuilder.usersys.redhat.com/22636/#Register_to_Red_Hat_Network
changed heading "2.1.2.2. Register to Red Hat Network" to "2.2.2.2. Customer Portal Subscription Management" as per Deon Lackey's explanation.

In http://docbuilder.usersys.redhat.com/22636/#Red_Hat_Enterprise_Linux_Repository_Configuration

renamed procedure to "Procedure 2.2. Attaching Pool IDs to your subscription" as it is more descriptive than "registering to RHN network" (especially as RHN network is being phased out in pref to "subscription management")

In  http://docbuilder.usersys.redhat.com/22636/#Red_Hat_OpenStack_Repository_Configuration

in "Procedure 2.3. Attaching Pool IDs to your subscription" (also renamed),

in step3, changed from yum-config-manager to subscription-manager command.

ditto in step 5, also removed RHEL6 example, the step on its own with "replace REPO-NAME" is adequate.

because the --setopt parameter is still part of the yum-config-manager, I left yum-config-manager in step 8, 

and explained how to install yum-plugin-priorities and yum-utils prior to step 8

thats all I think!

Comment 8 Andrew Dahms 2015-02-04 12:25:10 UTC

I can confirm that the requested changes have been implemented.

Moreover, these sections of the guide are under full review and are being further worked upon.

Closing.