Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1069244

Summary:	Chapter 4.2 errors
Product:	Red Hat Satellite 5	Reporter:	Gunther Schlegel <schlegel>
Component:	Docs Proxy Installation Guide	Assignee:	Dan Macpherson <dmacpher>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Dan Macpherson <dmacpher>
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	570	CC:	ggainey, schlegel
Target Milestone:	---
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2015-09-16 07:56:46 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:	1018166

Description Gunther Schlegel 2014-02-24 14:43:30 UTC

Description of problem:
Chapter 4.2. Adding CNAME Records to the Satellite Proxy Server Configuration has 2 issues:

#1: valid_cnames_<systemID of Proxy server> = cname1,cname2,cname3
-> it would be helpful to describe how to retrieve the proxy server's system ID and to provide a valid example of that line.

I suppose it is the content of /etc/sysconfig/rhn/systemid, but maybe one has to remove the "ID-" prefix?

#2: Documentation says: "service tomcat6 restart".

Well, tomcat6 is not installed by Satellite Proxy 5.6. Probably "rhn-proxy restart" ?


Version-Release number of selected component (if applicable):


How reproducible:


Steps to Reproduce:
1.
2.
3.

Actual results:


Expected results:


Additional info:

Comment 1 David O'Brien 2014-10-13 04:22:35 UTC

(In reply to Gunther Schlegel from comment #0)

Grant,
Can you confirm/comment on these or pass to a suitable SME?

> Description of problem:
> Chapter 4.2. Adding CNAME Records to the Satellite Proxy Server
> Configuration has 2 issues:
> 
> #1: valid_cnames_<systemID of Proxy server> = cname1,cname2,cname3
> -> it would be helpful to describe how to retrieve the proxy server's system
> ID and to provide a valid example of that line.
> 
> I suppose it is the content of /etc/sysconfig/rhn/systemid, but maybe one
> has to remove the "ID-" prefix?
> 

And also this:


> #2: Documentation says: "service tomcat6 restart".
> 
> Well, tomcat6 is not installed by Satellite Proxy 5.6. Probably "rhn-proxy
> restart" ?
> 
> 

I'm pretty sure I've seen that same statement elsewhere - KCS maybe? - so it'd be good to get confirmation of what it should be before I change anything.

thanks

Comment 2 Grant Gainey 2014-10-13 12:48:44 UTC

(In reply to David O'Brien from comment #1)
> (In reply to Gunther Schlegel from comment #0)
> 
> Grant,
> Can you confirm/comment on these or pass to a suitable SME?
> 
> > Description of problem:
> > Chapter 4.2. Adding CNAME Records to the Satellite Proxy Server
> > Configuration has 2 issues:
> > 
> > #1: valid_cnames_<systemID of Proxy server> = cname1,cname2,cname3
> > -> it would be helpful to describe how to retrieve the proxy server's system
> > ID and to provide a valid example of that line.
> > 
> > I suppose it is the content of /etc/sysconfig/rhn/systemid, but maybe one
> > has to remove the "ID-" prefix?

That is correct - for a system with the following in its systemid file:

===
<member>
<name>system_id</name>
<value><string>ID-1037137892</string></value>
</member>
===

the ID recognized by Satellite is 1037137892


> > #2: Documentation says: "service tomcat6 restart".
> > 
> > Well, tomcat6 is not installed by Satellite Proxy 5.6. Probably "rhn-proxy
> > restart" ?
> > 
> > 
> 
> I'm pretty sure I've seen that same statement elsewhere - KCS maybe? - so
> it'd be good to get confirmation of what it should be before I change
> anything.

Yes, rhn-proxy exists and is what you would use to restart.

(If it helps - it handles start/stop/status/restart/condrestart , for services (squid httpd jabberd MonitoringScout) )

Comment 3 David O'Brien 2014-10-15 04:05:55 UTC

To git.lab.tlv.redhat.com:satellite5-docs/proxy-installation-guide.git
   56f087b..343c150  master -> master

Updated:
Procedure 5.1. To Configure Your Satellite Proxy Server to Use CNAME Records:

Comment 4 Dan Macpherson 2015-09-16 02:32:19 UTC

This appears to be correct and implemented live:

https://access.redhat.com/documentation/en-US/Red_Hat_Satellite/5.7/html/Proxy_Installation_Guide/sect-cname-Adding_CNAME_Records_to_the_Satellite_Proxy_Server_Configuration.html

Gunther, are there any further documentation corrections required for this section? If not, I'll close this bug.

Comment 5 Gunther Schlegel 2015-09-16 07:33:43 UTC

Looks good to me.

Comment 6 Dan Macpherson 2015-09-16 07:56:46 UTC

No worries. Thanks for reporting it.