| Summary: | Documentation is incorrect for ipa-dns-install. | ||
|---|---|---|---|
| Product: | Red Hat Enterprise Linux 6 | Reporter: | Brian Harrington <bharrington> |
| Component: | doc-Identity_Management_Guide | Assignee: | Deon Ballard <dlackey> |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | ecs-bugs |
| Severity: | medium | Docs Contact: | |
| Priority: | medium | ||
| Version: | 6.4 | CC: | bharrington, dpal, jskeoch, mkosek |
| Target Milestone: | rc | Keywords: | Documentation |
| Target Release: | 6.3 | ||
| Hardware: | Unspecified | ||
| OS: | Linux | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | Bug Fix | |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2012-06-21 23:14:17 UTC | Type: | --- |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
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? I think he means the part where forwarders can be provided as a comma-separated list vs using multiple invocations of --forwarder. 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. Setting all priority and severity to medium. Updated the description here: http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6-Beta/html/Identity_Management_Guide/enabling-dns.html Closing. |
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%