ADC CLI Commands

dns-soaRec

The following operations can be performed on “dns-soaRec”:

rm set unset add show

rm dns soaRec

Removes the Start of Authority (SOA) record for the specified domain name. For EDNS Client Subnet (ECS) records, a subnet needs to be specified to remove the SOA record which is cached for that particular subnet

Synopsis

rm dns soaRec [-ecsSubnet <ip_addr[/prefix]|ipv6_addr[/prefix]>]

Arguments

domain Domain name of the SOA record.

ecsSubnet Subnet for which the cached SOA record need to be removed.

set dns soaRec

Modifies the parameters of the specified Start Of Authority (SOA) record.

Synopsis

set dns soaRec [-originServer ] [-contact ] [-serial ] [-refresh ] [-retry ] [-expire ] [-minimum ] [-TTL ]

Arguments

domain Domain of the SOA record to be modified.

originServer Domain name of the name server that responds authoritatively for the domain.

contact Email address of the contact to whom domain issues can be addressed. In the email address, replace the @ sign with a period (.). For example, enter domainadmin.example.com instead of domainadmin@example.com.

serial The secondary server uses this parameter to determine whether it requires a zone transfer from the primary server. Default value: 100 Minimum value: 1 Maximum value: 4294967294

refresh Time, in seconds, for which a secondary server must wait between successive checks on the value of the serial number. Default value: 3600 Maximum value: 4294967294

retry Time, in seconds, between retries if a secondary server’s attempt to contact the primary server for a zone refresh fails. Default value: 3 Maximum value: 4294967294

expire Time, in seconds, after which the zone data on a secondary name server can no longer be considered authoritative because all refresh and retry attempts made during the period have failed. After the expiry period, the secondary server stops serving the zone. Typically one week. Not used by the primary server. Default value: 3600 Maximum value: 4294967294

minimum Default time to live (TTL) for all records in the zone. Can be overridden for individual records. Default value: 5 Maximum value: 2147483647

TTL Time to Live (TTL), in seconds, for the record. TTL is the time for which the record must be cached by DNS proxies. The specified TTL is applied to all the resource records that are of the same record type and belong to the specified domain name. For example, if you add an address record, with a TTL of 36000, to the domain name example.com, the TTLs of all the address records of example.com are changed to 36000. If the TTL is not specified, the Citrix ADC uses either the DNS zone’s minimum TTL or, if the SOA record is not available on the appliance, the default value of 3600. Default value: 3600 Maximum value: 2147483647

unset dns soaRec

Use this command to remove dns soaRec settings.Refer to the set dns soaRec command for meanings of the arguments.

Synopsis

unset dns soaRec [-serial] [-refresh] [-retry] [-expire] [-minimum] [-TTL]

add dns soaRec

Creates a Start of Authority (SOA) record. Note: You can set the SOA parameters that are associated with zone transfers. However, the Citrix ADC currently does not support zone transfers.

Synopsis

add dns soaRec -originServer -contact [-serial ] [-refresh ] [-retry ] [-expire ] [-minimum ] [-TTL ]

Arguments

domain Domain name for which to add the SOA record.

originServer Domain name of the name server that responds authoritatively for the domain.

contact Email address of the contact to whom domain issues can be addressed. In the email address, replace the @ sign with a period (.). For example, enter domainadmin.example.com instead of domainadmin@example.com.

serial The secondary server uses this parameter to determine whether it requires a zone transfer from the primary server. Default value: 100 Minimum value: 0 Maximum value: 4294967294

refresh Time, in seconds, for which a secondary server must wait between successive checks on the value of the serial number. Default value: 3600 Maximum value: 4294967294

retry Time, in seconds, between retries if a secondary server’s attempt to contact the primary server for a zone refresh fails. Default value: 3 Maximum value: 4294967294

expire Time, in seconds, after which the zone data on a secondary name server can no longer be considered authoritative because all refresh and retry attempts made during the period have failed. After the expiry period, the secondary server stops serving the zone. Typically one week. Not used by the primary server. Default value: 3600 Maximum value: 4294967294

minimum Default time to live (TTL) for all records in the zone. Can be overridden for individual records. Default value: 5 Maximum value: 2147483647

TTL Time to Live (TTL), in seconds, for the record. TTL is the time for which the record must be cached by DNS proxies. The specified TTL is applied to all the resource records that are of the same record type and belong to the specified domain name. For example, if you add an address record, with a TTL of 36000, to the domain name example.com, the TTLs of all the address records of example.com are changed to 36000. If the TTL is not specified, the Citrix ADC uses either the DNS zone’s minimum TTL or, if the SOA record is not available on the appliance, the default value of 3600. Default value: 3600 Maximum value: 2147483647

show dns soaRec

Displays the parameters of the specified Start of Authority (SOA) record. If no domain name is specified, all SOA records are displayed.

Synopsis

show dns soaRec [ | -type ]

Arguments

domain The domain name.

type Type of records to display. Available settings function as follows:

  • ADNS - Display all authoritative address records.
  • PROXY - Display all proxy address records.
  • ALL - Display all address records.

Possible values: ALL, ADNS, PROXY

Output

originServer Domain name of the name server that responds authoritatively for the domain.

contact Email address of the contact to whom domain issues can be addressed. In the email address, replace the @ sign with a period (.). For example, enter domainadmin.example.com instead of domainadmin@example.com.

serial The secondary server uses this parameter to determine whether it requires a zone transfer from the primary server.

refresh Time, in seconds, for which a secondary server must wait between successive checks on the value of the serial number.

retry Time, in seconds, between retries if a secondary server’s attempt to contact the primary server for a zone refresh fails.

expire Time, in seconds, after which the zone data on a secondary name server can no longer be considered authoritative because all refresh and retry attempts made during the period have failed. After the expiry period, the secondary server stops serving the zone. Typically one week. Not used by the primary server.

minimum Default time to live (TTL) for all records in the zone. Can be overridden for individual records.

TTL Time to Live (TTL), in seconds, for the record. TTL is the time for which the record must be cached by DNS proxies. The specified TTL is applied to all the resource records that are of the same record type and belong to the specified domain name. For example, if you add an address record, with a TTL of 36000, to the domain name example.com, the TTLs of all the address records of example.com are changed to 36000. If the TTL is not specified, the Citrix ADC uses either the DNS zone’s minimum TTL or, if the SOA record is not available on the appliance, the default value of 3600.

authType Record type.

ecsSubnet Subnet for which this particular record is cached. Subnet caching will occur for responses with EDNS Client Subnet (ECS) option. Applies to resource records obtained through proxy configurations only.

devno count stateflag

dns-soaRec