Bug 1310009

Summary:	Clarify meaning of --forwarder options in IPA DNS installation (section 3)
Product:	Red Hat Enterprise Linux 7	Reporter:	Petr Spacek <pspacek>
Component:	doc-Linux_Domain_Identity_Management_Guide	Assignee:	Aneta Šteflová Petrová <apetrova>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Namita Soman <nsoman>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	7.2	CC:	rhel-docs
Target Milestone:	rc	Keywords:	Documentation
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2016-04-18 13:46:09 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:

Description Petr Spacek 2016-02-19 09:10:05 UTC

Description of problem:
Section
⁠3.2.4.1. Installing with an Integrated DNS Service Interactively
step 4. The script then prompts for DNS forwarders. 

and

⁠3.2.4.2. Installing with an Integrated DNS Service Non-Interactively
subsection DNS forwarders

should link to  ⁠17.7. Managing DNS Forwarding for further information what forwarding is and when it is necessary.


Actual results:
User needs to know what forwarding is and when to use it, so find out that he needs to jump from section 3 to section 17.7.


Expected results:
We advise user what to read.

Comment 2 Aneta Šteflová Petrová 2016-02-22 09:47:05 UTC

It might be good to put the information to the introductory "3.2.4. Configuring DNS Services within the IdM Domain" section. The installation procedures could then only include information relevant to the task itself.

Comment 3 Aneta Šteflová Petrová 2016-02-24 07:02:18 UTC

The following parts of the guide now point to 17.7. Managing DNS Forwarding for information on what forwarding is and whether to use it or not:
* 3.2.4. Configuring DNS Services
* step 4 "Installing with Integrated DNS Interactively" (part of 3.2.4.)
* step 1 in "Installing with Integrated DNS Non-Interactively" (part of 3.2.4.)

The SME acked the changes, so I'm moving this BZ directly to VERIFIED.

Comment 5 Aneta Šteflová Petrová 2016-04-18 13:46:09 UTC

The update is available on the Customer Portal.