ADC CLI Commands

dns-srvRec

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

add rm set unset show

add dns srvRec

Creates a service (SRV) record for the service offered by the specified target host, in the specified domain.

Synopsis

add dns srvRec -priority -weight -port [-TTL ]

Arguments

domain Domain name, which, by convention, is prefixed by the symbolic name of the desired service and the symbolic name of the desired protocol, each with an underscore (_) prepended. For example, if an SRV-aware client wants to discover a SIP service that is provided over UDP, in the domain example.com, the client performs a lookup for _sip._udp.example.com.

target Target host for the specified service.

priority Integer specifying the priority of the target host. The lower the number, the higher the priority. If multiple target hosts have the same priority, selection is based on the Weight parameter. Minimum value: 0 Maximum value: 65535

weight Weight for the target host. Aids host selection when two or more hosts have the same priority. A larger number indicates greater weight. Minimum value: 0 Maximum value: 65535

port Port on which the target host listens for client requests. Minimum value: 0 Maximum value: 65535

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

rm dns srvRec

Removes, from the specified domain, the SRV record created for the service provided by the specified target host. For EDNS Client Subnet (ECS) records, a subnet needsto be specified to remove the SRV record created for the service provided by the specified target host which is cached for that particular subnet

Synopsis

rm dns srvRec ... \[-ecsSubnet <ip\_addr\[/prefix]|ipv6\_addr\[/prefix]>]

Arguments

domain Domain name of the SRV record.

target Target host for the specified service.

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

set dns srvRec

Modifies the parameters of the specified service (SRV) record.

Synopsis

set dns srvRec [-priority ] [-weight ] [-port ] [-TTL ]

Arguments

domain Name of the SRV record to be modified.

target Target of the SRV record to be modified.

priority Integer specifying the priority of the target host. The lower the number, the higher the priority. If multiple target hosts have the same priority, selection is based on the Weight parameter. Minimum value: 0 Maximum value: 65535

weight Weight for the target host. Aids host selection when two or more hosts have the same priority. A larger number indicates greater weight. Minimum value: 0 Maximum value: 65535

port Port on which the target host listens for client requests. Minimum value: 0 Maximum value: 65535

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 srvRec

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

Synopsis

unset dns srvRec -TTL

show dns srvRec

Displays the service (SRV) record configured for the specified target host and domain. If the domain name is not specified, all of the SRV records are shown.

Synopsis

show dns srvRec [( \[]) | -type ]

Arguments

domain Domain name for which to display the SRV record.

target Target host for the specified service.

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

priority Priority of the target host. This helps in server selection by the client.

weight Weight for the target host. Aids host selection when two or more hosts have the same priority. A larger number indicates greater weight.

port Port on which the target host listens for client requests.

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-srvRec