Bug 636703

Summary:	Additional Documentation for Client Configuration Guide for registering with satellite server (
Product:	Red Hat Satellite 5	Reporter:	Xixi <xdmoon>
Component:	Docs Client Config Guide	Assignee:	Lana Brindley <lbrindle>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Pavel Novotny <pnovotny>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	530	CC:	cperry, lbrindle, mhideo, pnovotny
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:	2011-06-16 22:11:45 UTC	Type:	---
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:	644720
Bug Blocks:	677505

Description Xixi 2010-09-23 00:19:52 UTC

Description of problem:
Proposing to augment the documentation http://www.redhat.com/docs/en-US/Red_Hat_Network_Satellite/5.3.0/Client_Configuration_Guide/html/index.html
specifically either 
http://www.redhat.com/docs/en-US/Red_Hat_Network_Satellite/5.3.0/Client_Configuration_Guide/html/s2-client-config-file.html
or
http://www.redhat.com/docs/en-US/Red_Hat_Network_Satellite/5.3.0/Client_Configuration_Guide/html/s1-certificate-rpms.html

with additional info contained in KBase article https://access.redhat.com/kb/docs/DOC-11017

For example, after installing rhn-org-trusted-ssl-cert-VER-REL.noarch.rpm, SSL cert path needs to be updated in up2date configuration on client system. So it would be better to add a note to for editing /etc/sysconfig/rhn/up2date file to have
sslCACert=/usr/share/rhn/RHN-ORG-TRUSTED-SSL-CERT

Version-Release number of selected component (if applicable):
Red Hat Network (RHN) Satellite 5.3.0

How reproducible:
Always.

Steps to Reproduce:
See above.

Actual results:
See above.

Expected results:
See above.

Additional info:

Comment 1 Lana Brindley 2010-10-08 04:12:16 UTC

This is slated for inclusion in the Satellite 5.5 documentation. If there is
any other source content that is not listed (or linked to) in this bug, please
link to it.

LKB

Comment 2 Lana Brindley 2010-11-16 21:14:12 UTC

Added to content specification for 5.4.1.

LKB

Comment 3 Lana Brindley 2011-02-01 00:00:49 UTC

<section id="register-clients">
      <title>Registering Clients to &RHN; &SAT;</title>
      <indexterm>
        <primary><application>registering</application>
        </primary>
      </indexterm>
      <para>
		To register a system with a &SAT;, you will need the fully qualified domain name (FQDN) and the SSL cert of the &SAT;.
       </para>
      <orderedlist>
        <listitem>
          <para>
           Download the SSL certificate to the client:
          </para>
<screen>
cd /usr/share/rhn/
wget http://satellite.example.com/pub/RHN-ORG-TRUSTED-SSL-CERT
<screen>
        </listitem>
        <listitem>
          <para>
		  Edit the <filename>/etc/sysconfig/rhn/up2date</filename> file: 
          </para>
<screen>
serverURL=https://satellite.example.com/XMLRPC
noSSLServerURL=http://satellite.example.com/XMLRPC
sslCACert=/usr/share/rhn/RHN-ORG-TRUSTED-SSL-CERT
</screen>
        </listitem>
        <listitem>
          <para>
           Register the machine:
          </para>
<screen>
rhn_register
</screen>
        </listitem>
      </orderedlist>
    </section>

Updated in revision 1-7.

LKB

Comment 4 Pavel Novotny 2011-04-21 12:22:39 UTC

Taking this bug for verification.

Comment 5 Pavel Novotny 2011-04-21 17:03:59 UTC

(In reply to comment #3)
> <section id="register-clients">
>       <title>Registering Clients to &RHN; &SAT;</title>
>       <indexterm>
>         <primary><application>registering</application>
>         </primary>
>       </indexterm>
>       <para>
>   To register a system with a &SAT;, you will need the fully qualified domain
> name (FQDN) and the SSL cert of the &SAT;.
>        </para>
>       <orderedlist>
>         <listitem>
>           <para>
>            Download the SSL certificate to the client:
>           </para>
> <screen>
> cd /usr/share/rhn/
> wget http://satellite.example.com/pub/RHN-ORG-TRUSTED-SSL-CERT
> <screen>
>         </listitem>
>         <listitem>
>           <para>
>     Edit the <filename>/etc/sysconfig/rhn/up2date</filename> file: 
>           </para>
> <screen>
> serverURL=https://satellite.example.com/XMLRPC
> noSSLServerURL=http://satellite.example.com/XMLRPC
> sslCACert=/usr/share/rhn/RHN-ORG-TRUSTED-SSL-CERT
> </screen>
>         </listitem>
>         <listitem>
>           <para>
>            Register the machine:
>           </para>
> <screen>
> rhn_register
> </screen>
>         </listitem>
>       </orderedlist>
>     </section>
> 
> Updated in revision 1-7.
> 
> LKB

Verified
in Satellite 5.4.1 "Client Configuration Guide", section "2.2. Configuring the Client Applications".

Comment 6 Lana Brindley 2011-05-06 00:12:00 UTC

This book has now been dropped to translation (RT#75265).
No further updates can be accepted. Please raise a new bug for any changes.
LKB

Comment 7 Lana Brindley 2011-06-16 22:11:45 UTC

5.4.1 Satellite books are now available on docs.redhat.com. Please raise a new bug for any issues.

LKB