Bug 1378357

Summary: Unable to find Satellite License (or system already consuming that sub) while Installing connected Satellite Server
Product: Red Hat Satellite Reporter: anerurka
Component: Docs Install GuideAssignee: Brandi Munilla <bmcelvee>
Status: CLOSED CURRENTRELEASE QA Contact: Stephen Wadeley <swadeley>
Severity: medium Docs Contact:
Priority: medium    
Version: 6.2.0CC: adahms, bkearney, mmccune, rjerrido, sbream, xdmoon
Target Milestone: UnspecifiedKeywords: UserExperience
Target Release: Unused   
Hardware: x86_64   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-10-31 10:04:26 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:
Embargoed:
Bug Depends On:    
Bug Blocks: 1115190, 1385841    

Description anerurka 2016-09-22 09:03:38 UTC
Document URL: 

https://access.redhat.com/documentation/en/red-hat-satellite/6.2/paged/installation-guide/chapter-3-installing-satellite-server

Section Number and Name: 

3.1.2. Identifying and Attaching the Satellite Subscription to the Host

Describe the issue: 

Unable to find Satellite License while Installing connected Satellite Server

Suggestions for improvement: 

Multiple times Customers are unable to find Satellite Subscriptions while satellite server installation.

- We have a script "https://access.redhat.com/solutions/2058823" which can be executed to list out what subscriptions has been consumed by clients registered under subscriptions manager (Customer Portal).

- We can add this script or article in installation doc, in installation steps so if customer unable to find the Satellite Subscription then ,this script will be helpful.

Additional information:

Comment 1 Rich Jerrido 2016-09-28 19:20:00 UTC
Just an FYI, the upstream repo for this script is here - https://github.com/RedHatSatellite/rhsmTools

Comment 2 Mike McCune 2016-09-29 19:25:43 UTC
The install docs state to use Subscription Manger's built in searching option:

https://access.redhat.com/documentation/en/red-hat-satellite/6.2/paged/installation-guide/chapter-3-installing-satellite-server

this quickly lets you find the right pool to attach:

# subscription-manager list --available --matches 'Red Hat Satellite'
+-------------------------------------------+
    Available Subscriptions
+-------------------------------------------+
Subscription Name:   Red Hat Satellite Subscription
Provides:            Red Hat Beta
                     Red Hat Satellite Capsule Beta
                     Red Hat Software Collections (for RHEL Server)
                     Red Hat Satellite Capsule
                     Red Hat Satellite with Embedded Oracle
                     Red Hat Satellite Beta
                     Red Hat Satellite 6 Beta
                     Red Hat Enterprise Linux Server
                     Red Hat Enterprise Linux High Availability (for RHEL Server)
                     Red Hat Satellite
                     Red Hat Software Collections Beta (for RHEL Server)
                     Red Hat Enterprise Linux Load Balancer (for RHEL Server)
SKU:                 SER0232US
Contract:            **************
Pool ID:             **************
Provides Management: Yes
Available:           5741
Suggested:           1
Service Level:       Self-Support
Service Type:        L1-L3
Subscription Type:   Standard
Ends:                12/31/2021
System Type:         Physical


why would we need additional tooling beyond this that would just add complexity?

Comment 5 Rich Jerrido 2016-09-29 21:26:00 UTC
(In reply to Mike McCune from comment #2)

> why would we need additional tooling beyond this that would just add
> complexity?


Two separate problems:

- The subscription is in use by another system and I need to find it. 
- The subscription is NOT in use by another system and I need to find it. 

rhsmShowConsumerSubs.py handles the former. 
the --matches switch to subscription-manager does the latter. 

Note: The Customer Portal allows you to see which system is consuming a subscription. It is just burdensome to perform this task across large numbers of systems.

Comment 7 Andrew Dahms 2016-09-30 01:10:30 UTC
Hi everyone,

Thank you for the needinfo request, and understood.

Assigning to Brandi for review.

Brandi - as per comment #3, we need to add some guidance to the step on enabling repositories to point to the KBase article mentioned.

Kind regards,

Andrew