Bug 636703 - Additional Documentation for Client Configuration Guide for registering with satellite server (
Summary: Additional Documentation for Client Configuration Guide for registering with ...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Satellite 5
Classification: Red Hat
Component: Docs Client Config Guide
Version: 530
Hardware: All
OS: Linux
medium
medium
Target Milestone: ---
Assignee: Lana Brindley
QA Contact: Pavel Novotny
URL:
Whiteboard:
Depends On: 644720
Blocks: sat541-docs
TreeView+ depends on / blocked
 
Reported: 2010-09-23 00:19 UTC by Xixi
Modified: 2018-11-14 18:55 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2011-06-16 22:11:45 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

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


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