Bug 896283

Summary:	freeipa zone specific forwards doc semicolon in example
Product:	Red Hat Enterprise Linux 6	Reporter:	Michael Gregg <mgregg>
Component:	doc-Identity_Management_Guide	Assignee:	Deon Ballard <dlackey>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Jenny Severance <jgalipea>
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	6.0	CC:	abokovoy, dpal, mkosek, pspacek, rcritten, ssorce
Target Milestone:	rc	Keywords:	Documentation
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2014-05-10 03:43:27 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:
Embargoed:

Description Michael Gregg 2013-01-16 23:17:25 UTC

Description of problem:
Going from the document here:
https://docs.fedoraproject.org/en-US/Fedora/17/html/FreeIPA_Guide/config-forwarders.html#zone-forwarder

The example given for configuring a zone specific forwarder is:
"[jsmith@server ~]$ ipa dnszone-mod --forwarder=1.2.3.4;255.255.255.255
example.com"

This should not work as there is a semicolon in the doc.

It appears as though this should be a comma, and not a semicolon. 

Also, could the example be broken out a bit more please? Something like:

The format will be similar to: 
$ ipa dnszone-mod --forwarder=<server 1>,<server 2> example.com

Example:
$ ipa dnszone-mod --forwarder=1.2.3.4,10.34.22.80 example.com

I think the 255.255.255.255 is just a second server, I am not sure why you would have a IP mask in the forwarder list.

Comment 2 Petr Spacek 2013-01-17 14:59:09 UTC

Proper syntax is:
"ipa dnszone-mod --forwarder=203.0.113.8 --forwarder=192.0.2.33 example.com"

"255.255.255.255" is very misleading example. This item should be normal IP address.


These blocks of IPv4 and IPv6 address are reserved purely for use in documentation:

For IPv4 - according to http://tools.ietf.org/html/rfc5737:
192.0.2.0/24 (TEST-NET-1)
198.51.100.0/24 (TEST-NET-2)
203.0.113.0/24 (TEST-NET-3)

For IPv6 - according to http://tools.ietf.org/html/rfc3849:
2001:DB8::/32

Please try to use those blocks for new texts and when correcting older texts. Please don't forget to redact IP addresses shown in output of the "ipa dnszone-mod" command after "Zone forwarders:" prefix.

Comment 5 Deon Ballard 2014-05-10 03:43:27 UTC

Mass closure of bugs modified in 2013. All of these are in the currently-published docs.