Red Hat Bugzilla – Bug 143797
documentation bugs in RHN Satellite Server 3.6 Installation Guide
Last modified: 2009-08-19 23:10:04 EDT
From Bugzilla Helper:
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.4.3)
Description of problem:
- chapter 2.1:
...an Everything install, RedHat this installs packages that if not
properly managed could pose ...
...an Everything install, this installs packages that, if not
properly managed, could pose...
- chapter 2.1:
At least for me it was unclear whether the mentioned perl packages
needed to be manually installed only with the CD/ISO installation
or also with the kickstart installation (not needed with kickstart,
as I found out)
- chapter 4.2, point 12 / figure 4-6:
the text says:
...Note that references to protocol such as http:// or https://
should not be included in the HTTP proxy server field...
the figure says:
...The http proxy should be of the form: http://hostname:port,...
The text is correct, the picture is actually what is being
displayed during the installation. To avoid confusion, the text
displayed during installation should be changed, but meanwhile
it might be easier to add an additional note in the installation
docs that the text displayed during installation is wrong and the
installation docs are correct.
- chapter 8.10, last sentence:
Version-Release number of selected component (if applicable):
Steps to Reproduce:
I can reproduce the same errors every time I print the guide, as I
don't have a printer with built-in auto-correction module...<g>
These are nice catches, Kurt. Regarding those perl packages mentioned
in section 2.1, those need to be specified individually only when
installing via kickstart. When installing via CD/ISO, selecting the
listed package groups will ensure those packages are included. I'll
attempt to clarify that text.
It seems, however, that you found those packages *did not* need to be
specified during kickstart. If that's the case, please provide
additional details (your steps, the KS config file, etc.) and I'll
ensure engineering is aware of the issue.
The rest of your comments will be addressed in the next release of the
guide. Thanks for your thorough review and detailed feedback.
Robin, I'm bumping this over to you because the item begining '-
chapter 4.2, point 12 / figure 4-6:' actually points to a flaw in the
installer text. It seems all we need to do is remove 'http://' from
the line 'The http proxy should be of the form:
http://hostname:port...' in the RHN Configuration page.
This format will match the documentation and previous sat install
practices. If I need to open a separate bug for this, please let me
know. Otherwise, bounce this back to me when you're done and I'll
finish the remaining documentation changes. Thanks.
Clay, concerning section 2.1, I _think_ that the additional perl
modules (perl-CGI, perl-libwww-perl, ...) must be installed manually
on a CD/ISO installation but not on a kickstart installation. I
fed my machine with a CD and a kickstart file on floppy which
included the following section:
# packages to install
# package clusters as per RHN Satellite Server v3.6 Installation Guide
@ Development Tools
@ Legacy Software Development
# additional packages as per RHN Satellite Server v3.6 Installation Guide
# packages we want
Checking after the installation, the mentioned perl modules were
I was referring to the list
perl-CGI perl-libwww-perl ... perl-XML-Encoding.
Maybe you are talking about the perl-CGI and perl-TimeHiRes packages
or groups which go in the kickstart file?
Ahh, my apologies for the confusion, Kurt. You are correct in that
those perl packages must be manually installed (via up2date, for
instance) only when installing from CD/ISO. As you found, specifying
the recommended packages (perl-CGI, perl-Time-HiRes) at kickstart
eliminates that manual step.
Although this is what I intended to convey when I drafted the section
immediately following the CD/ISO package group list - "Then after
operating system installation, register the system..." - it is clear
to me now I did not tie this step to CD/ISO installs.
So the resolution to that particular item is for me to make that
correlation, perhaps by beginning that sentence with, "If you
installed the operating system by CD or ISO (rather than kickstart),
you will need to register the system..."
Again, many thanks for your input.
The description text on the installer page has been fixed in CVS, and
should be available in the next version of the satellite.
1) perform a satellite install, up until the 'configure.pxt' page.
- Verify that the text description at the top of the page is accurate and makes
software reqs part of the docs complete
screenshot of sat-installer in docs FAILS
the actual satellite installer bug was addressed here: bug #144404
As vlady points out, by mixing my fixes in with this docs bug, I've created a
confusing mess. I've created bug #150062 to describe my fix. Ignore all my
comments on this bug and go there instead.
Re-assigning to cmurphy, because vlady indicates that his work for this bug is
not yet complete.
The screenshot of the new sat install page is a separate documentation
change, so it will need a separate bug. If someone can launch a sat
install and grab it for me, great. Otherwise, file a new bug against
Setting this back to ON_DEV.
Shifting my ON_DEV bugs to ON_QA to reflect today's push.
shughes will get you a screenshot tomorrow morning
The new screenshot has been added to the docs and will be in Monday's
QA push - thanks Vlad!
man, my screenshot looks good!!
mass move: PROD_READY --> CLOSED:CURRENTRELEASE