Create TXT records for holding descriptive text
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. It can also include 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. A TXT resource record can contain up to six strings, each of which can contain up to 255 characters. You can view the ID of a record and use it to delete the record. However, you cannot modify a TXT resource record.
Related information
Create a TXT resource record by using the CLI
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
Split the string in a TXT resource record using CLI
If you have a string that is more than 255 characters, you can split the strings, considering the six string limit. Each string can be of length 254 bytes.
add dns txtrec domain.com "string1" "string2" string3" "string4"
Example:
add dns txtrec exampledomain.com "Contact: Evan" "Email: evan@example.com" "Contact: Mark" "Email: mark1@example.com"
Remove a TXT resource record by using the CLI
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
Configure a TXT record by using the GUI
Navigate to Traffic Management > DNS > Records > TXT Records and create a TXT record.