It's too late to get this into 5.4.1 docs, but should we add it to the relnotes? If so, please clone this bug and apply the clone against the release_notes component.

LKB

I think, this is not so important, to be included in the release_notes.
Moreover, this bug also applies to Satellite 5.4.0 documentation, which does
not mention it as well. From my view, this is only nice_to_have in future.

Slated for 5.4.2.

LKB

(In reply to comment #0)
> Description of problem:
> At the very beginning of Chapter 10 in the reference guide there is
> a list of required channels:
> 
>     Red Hat Network Tools for RHEL Server (v. 5 for 32-bit x86)
>      — rhn-tools-rhel-i386-server-5
>     RHN Tools
>      — rhn-tools-rhel-5-i386
>     Red Hat Enterprise Linux Server (v. 5 for 32-bit x86)
>      — rhel-i386-server-5 (and all child channels)
>     Red Hat Enterprise Linux Server Virtualization (v. 5 for 32-bit x86)
>      — rhel-i386-server-vt-5 (and all child channels) 
> 
> You can see rhel version hard-coded to the documentation, which does
> not seem ideal to me. Anyway, for rhel6 there is no such channel 
> 'Virtualization'. Rhel6 costumer needs to sync at least:
> 
>     rhel-i386-server-6
>     rhn-tools-rhel-i386-server-6
> 
> instead. Please consider, whether we really want to list required
> channels. And also consider, whether we should better list x86_64
> architecture instead of i386 in the year 2011.
> 
> 
> Additional info:
> See also bug 707568

Hi Šimon,

This is actually not hard-coded into the documentation, it uses entities as follows:

<para>
	Red Hat Network Tools for RHEL Server (v. &RHELVER; for 32-bit x86) &mdash; rhn-tools-rhel-i386-server-&RHELVER;
</para>

Currently, <!ENTITY RHELVER "5"> but I can update this to 6, if you think it is appropriate?

LKB

Well, I am not a documentation person. I am not sure, what is the best
approach here. For example, if we really want to list required channels.

Nevertheless, you should not simply flip &RHELVER to 6, because one
of the rhel-i386-server-vt-5 channel does not exists on RHEL6.

I can see several problems with a current listings:
  (1) It's rhel5 specific, it does not compound any info for rhel6.
  (2) It lists i386 architecture, while it's 21 century.
  (3) It contains vague: '(and all child channels)', which is not true.
  (4) It lists base channels after child channels

The text could read:

-----
The set of recommended channels depends on the platform and architecture
of the host system:

 * for RHEL5, RHN recommends at least the following channels:
    Red Hat Enterprise Linux Server (v. 5 for 32-bit x86) -- rhel-i386-server-5
    Red Hat Network Tools for RHEL Server (v. 5 for 32-bit x86) -- rhn-tools-rhel-i386-server-5
    Red Hat Enterprise Linux Server Virtualization (v. 5 for 32-bit x86) -- rhel-i386-server-vt-5

 * for RHEL6, RHN recommends at least the following channels:
    Red Hat Enterprise Linux Server (v. 6 for 64-bit x86_64) -- rhel-x86_64-server-6
    RHN Tools for RHEL (v.6 for 64-bit x86_64) -- rhn-tools-rhel-x86_64-server-6
-----

Updated. Please check on the stage: http://documentation-stage.bne.redhat.com/docs/en-US/Red_Hat_Network_Satellite/5.4/html-single/Reference_Guide/index.html#chap-Reference_Guide-Virtualization

Revision 2-5

LKB