Product Documentation

Creating TXT Records for Holding Descriptive Text

Aug 31, 2016

Domain hosts store TXT records for informative purposes. A TXT record’s RDATA component, which consists of one or more character strings of variable length, can store practically any information that a recipient might need to know about the domain, including information about the service provider, contact person, email addresses, and associated details. SPF (Sender Policy Framework) protection has been the most prominent use case for the TXT record.

All configuration types (authoritative DNS, DNS proxy, end resolver, and forwarder configurations) on the NetScaler appliance support TXT records. You can add a maximum of 20 TXT resource records to a domain. Each resource record is stored with a unique, internally generated record ID. You can view the ID of a record and use it to delete the record. However, you cannot modify a TXT resource record.

To create a TXT resource record by using the command line interface

At the command prompt, type the following commands to create a TXT resource record and verify the configuration:

  • add dns txtRec <domain> <string> ... [-TTL <secs>]
  • show dns txtRec [<domain> | -type <type>]

Example

> add dns txtRec www.example.com "Contact: Mark" "Email: mark@example.com" -TTL 36000 
 Done 
> show dns txtRec www.example.com 
1)	Domain : www.example.com	Record id: 13783	   TTL : 36000 secs	Record Type : ADNS         
		"Contact: Mark" 
		"Email: mark@example.com" 
 Done 

To remove a TXT resource record by using the command line interface

At the command prompt, type the following commands to remove a TXT resource record and verify the configuration:

  • rm dns txtRec <domain> (<string> ... | -recordId <positive_integer>)
  • show dns txtRec [<domain> | -type <type>]

Example

You can use the show dns txtRec command first to view the record ID of the TXT resource record that you want to remove, as shown:

> show dns txtRec www.example.com 
1)	Domain : www.example.com	Record id: 36865	   TTL : 36000 secs	Record Type : ADNS         
		"Contact: Evan" 
		"Email: evan@example.com" 
2)	Domain : www.example.com	Record id: 14373	   TTL : 36000 secs	Record Type : ADNS         
		"Contact: Mark" 
		"Email: mark1@example.com" 
 Done 

The simpler method of deleting a TXT record is to use the record ID. If you want to provide the strings, enter them in the order in which they are stored in the record. In the following example, the TXT record is deleted by using its record ID.

>rm dns txtRec www.example.com -recordID 36865 
 Done 
> show dns txtRec www.example.com 
1)	Domain : www.example.com	Record id: 14373	   TTL : 36000 secs	Record Type : ADNS         
		"Contact: Mark" 
		"Email: mark1@example.com" 
 Done 

To configure a TXT record by using the configuration utility

Navigate to Traffic Management > DNS > Records > TXT Records and create a TXT record.