Bug 1413161

Summary: Explain importance of prefix in man pages, add satellite 6 example
Product: Red Hat Enterprise Linux 7 Reporter: Barnaby Court <bcourt>
Component: subscription-managerAssignee: Kevin Howell <khowell>
Status: CLOSED ERRATA QA Contact: John Sefler <jsefler>
Severity: low Docs Contact:
Priority: medium    
Version: 7.4CC: bbuckingham, bcourt, bkearney, katello-qa-list, khowell, redakkan, shetze, skallesh, vrjain
Target Milestone: rcKeywords: EasyFix, Triaged
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: subscription-manager-1.20.2-1 Doc Type: No Doc Update
Doc Text:
Story Points: ---
Clone Of: 1335382
: 1413162 (view as bug list) Environment:
Last Closed: 2018-04-10 09:47:31 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:    
Bug Blocks: 1335382, 1413162    

Comment 3 Rehana 2017-11-10 12:49:32 UTC
on latest RHEL75 machine  having follows subscription-manager version

subscription-manager-rhsm-certificates-1.20.5-1.el7.x86_64
subscription-manager-gui-1.20.5-1.el7.x86_64
subscription-manager-rhsm-1.20.5-1.el7.x86_64
subscription-manager-1.20.5-1.el7.x86_64
subscription-manager-initial-setup-addon-1.20.5-1.el7.x86_64
subscription-manager-plugin-container-1.20.5-1.el7.x86_64

1) man rhsm.conf provides baseurl examples 


# man rhsm.conf | grep baseurl -A1
       baseurl
           This setting is the prefix for all content which is managed by the subscription service. This should be the hostname for the Red Hat CDN, the local Satellite or Capsule depending on your deployment.  Prefix depends on the service type.  For the Red Hat CDN, the full baseurl is https://cdn.redhat.com .  For Satellite 6, the baseurl is https://HOSTNAME/pulp/repos , so for a hostname of sat6.example.com the full baseurl would be for example: https://sat6.example.com/pulp/repos .


The subscription-manager man page is also updated with examples for the baseurl based on the deployment type

#man subscription-manager , grep for baseurl

       --baseurl=https://CONTENT_SERVICE:PORT/PREFIX
              Passes the name of the content delivery service to configure the yum service to use to pull down packages. If there is an on-premise subscription service such as Subscription Asset Manager or CloudForms  System  Engine,  this  parameter can be used to submit the URL of the content repository, in the form https://server_name:port/prefix.  PREFIX in particular depends on the service
type.  For example, https://sam.example.com:8088/sam is the baseurl for a SAM service.  https://sat6.example.com/pulp/repos is the  baseurl  for  a  Satellite  6  service  with  the  hostname sat6.example.com .  https://cdn.redhat.com is the baseurl for the Red Hat CDN.

As requested in the bug , its observed that now baseurl samples are given in the man pages of rhsm.conf and subscription-manager. 

based on the above observations , marking the bug as "Verified"

Comment 6 errata-xmlrpc 2018-04-10 09:47:31 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2018:0681