Product Documentation

dns soaRec

Sep 12, 2016

The following operations can be performed on "dns soaRec":

add | rm | set | unset | show

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 NetScaler appliance currently does not support zone transfers.

Synopsys

add dns soaRec <domain> -originServer <string> -contact <string> [-serial <positive_integer>] [-refresh <secs>] [-retry <secs>] [-expire <secs>] [-minimum <secs>] [-TTL <secs>]

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 NetScaler appliance 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

rm dns soaRec

Removes the Start of Authority (SOA) record for the specified domain name.

Synopsys

rm dns soaRec <domain>

Arguments

domain

Domain name of the SOA record.

set dns soaRec

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

Synopsys

set dns soaRec <domain> [-originServer <string>] [-contact <string>] [-serial <positive_integer>] [-refresh <secs>] [-retry <secs>] [-expire <secs>] [-minimum <secs>] [-TTL <secs>]

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 NetScaler appliance 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.

Synopsys

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

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.

Synopsys

show dns soaRec [<domain> | -type <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

Outputs

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 NetScaler appliance 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.

devno

count

stateflag