Hide Forgot
Description of problem: This is raised as part of IPA DNS Test Day general feed back. There seems to be confusion in how one should use the ipa dnsrecord-add options with respect to the resource records. For e.g., It is assumed by the user that --srv-rec should/can be used with --srv-priority --srv-weight --srv-port --srv-target, which is actually not the case. Version-Release number of selected component (if applicable): ipa-server-2.2.0-101.20120127T0607zgit6863b8f.el6.x86_64 How reproducible: Steps to Reproduce: 1. See description 2. 3. Actual results: Expected results: Expanding the "ipa dnsrecord-add" with some more info on its description and usage would certainly help here. Additional info:
Upstream ticket: https://fedorahosted.org/freeipa/ticket/2382
I was thinking about this issue. It is true, that user may be get confused with all these new options until he gets a bit more familiar with it and understands the concepts behind the scenes. Would it be OK with you if we enhance ipa DNS help (`ipa help dns') and explain the concept of structured DNS options and how they operate in ADD, MOD and DEL commands, with few examples? Any other ideas how to make the new DNS operations more clear are welcome.
Yes, I think that would be OK as this is more related to usability and with enhanced ipa DNS help (`ipa help dns`) operations would be more clear.
fixed upstream. master: 640dee7caad4a1bf7c05bb539f0e6655fe758a54 ipa-2-2: b6ef6af22c931c92a53be74b406918d9bc748e8e
`ipa help dns` is very comprehensive indeed. Thanks Martin. <snip> USING STRUCTURED PER-TYPE OPTIONS There are many structured DNS RR types where DNS data stored in LDAP server is not just a scalar value, for example an IP address or a domain name, but a data structure which may be often complex. A good example is a LOC record [RFC1876] which consists of many mandatory and optional parts (degrees, minutes, seconds of latitude and longitude, altitude or precision). It may be difficult to manipulate such DNS records without making a mistake and entering an invalid value. DNS module provides an abstraction over these raw records and allows to manipulate each RR type with specific options. For each supported RR type, DNS module provides a standard option to manipulate a raw records with format --<rrtype>-rec, e.g. --mx-rec, and special options for every part of the RR structure with format --<rrtype>-<partname>, e.g. --mx-preference and --mx-exchanger. When adding a record, either RR specific options or standard option for a raw value can be used, they just should not be combined in one add operation. When modifying an existing entry, new RR specific options can be used to change one part of a DNS record, where the standard option for raw value is used to specify the modified value. The following example demonstrates a modification of MX record preference form 0 to 1 in a record without modifying the exchanger: ipa dnsrecord-mod --mx-rec="0 mx.example.com." --mx-preference=1 </snip> Verified: ipa-server-2.2.0-3.el6.x86_64
Technical note added. If any revisions are required, please edit the "Technical Notes" field accordingly. All revisions will be proofread by the Engineering Content Services team. New Contents: No documentation needed.
Since the problem described in this bug report should be resolved in a recent advisory, it has been closed with a resolution of ERRATA. For information on the advisory, and where to find the updated files, follow the link below. If the solution does not work for you, open a new bug report. http://rhn.redhat.com/errata/RHBA-2012-0819.html