Bug 1069244 - Chapter 4.2 errors
Summary: Chapter 4.2 errors
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Satellite 5
Classification: Red Hat
Component: Docs Proxy Installation Guide
Version: 570
Hardware: All
OS: Linux
unspecified
medium
Target Milestone: ---
Assignee: Dan Macpherson
QA Contact: Dan Macpherson
URL:
Whiteboard:
Depends On:
Blocks: sat-docs
TreeView+ depends on / blocked
 
Reported: 2014-02-24 14:43 UTC by Gunther Schlegel
Modified: 2015-09-16 07:56 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2015-09-16 07:56:46 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

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.


Note You need to log in before you can comment on or make changes to this bug.