Bug 790094 - Documentation is incorrect for ipa-dns-install.
Summary: Documentation is incorrect for ipa-dns-install.
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: doc-Identity_Management_Guide
Version: 6.4
Hardware: Unspecified
OS: Linux
medium
medium
Target Milestone: rc
: 6.3
Assignee: Deon Ballard
QA Contact: ecs-bugs
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2012-02-13 16:27 UTC by Brian Harrington
Modified: 2012-06-21 23:14 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2012-06-21 23:14:17 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description Brian Harrington 2012-02-13 16:27:43 UTC
Description of problem:

In section 8.2 of the "Identity management guide" it states the following:

"--no-forwarders means that there are no forwarders used with the DNS service, only root servers. Alternatively, a comma-separated list of forwarders can be given, using the --forwarder option. "

While in the man page for ipa-dns-install it states:


"       --forwarder=FORWARDER
              A forwarder is a DNS server where queries for a specific non-resolvable address can be directed. To define multiple forwarders use mul-
              tiple instances of --forwarder"

The correct behaviour is that of the man page.


Version-Release number of selected component (if applicable):
IPA v.2 in RHEL 6


How reproducible:
100%

Comment 2 Dmitri Pal 2012-02-13 16:36:29 UTC
I think that the --no-forwarders option will suppress prompting for forwarders and getting into the interactive installation mode. If you just omit all the parameters the installation will start asking questions. Would you mind doublecheking this and closing this bug?

Comment 3 Rob Crittenden 2012-02-13 16:56:04 UTC
I think he means the part where forwarders can be provided as a comma-separated list vs using multiple invocations of --forwarder.

Comment 4 Brian Harrington 2012-02-14 18:02:32 UTC
That would be correct.  The documentation between the man page and what we have on docs.redhat.com is conflicting (also, comma separating hosts for the forwarders simply doesn't work).  My request would either be to make that work, or fix the docs.  Fixing the docs is probably the easier of the two.

Comment 6 Deon Ballard 2012-05-03 16:34:17 UTC
Setting all priority and severity to medium.

Comment 9 Deon Ballard 2012-06-21 23:14:17 UTC
Closing.


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