Previous page

Next page

Locate page

--add or -a

Adds a resource record to the Plesk server's domain DNS zone template.

If a record already exists, the command returns code 2.

To add new MX resource record mail.<domain> to the domain DNS zone template and specify mail exchanger mail.<domain> and set the mail exchanger priority to 35 for the record:

# ./server_dns --add -mx "" -mailexchanger "mail.<domain>" -priority 35

or

# ./server_dns -a -mx "" -mailexchanger "mail.<domain>" -priority 35

--set or -s

"<record_1>;<record_2>;...<record_N>"

where <record> =

MX,"<subdomain_name>",<mail_exchanger_name>."<domain>"|

NS,"<subdomain_name>",<server_name>."<domain>"|

A,<subdomain_name>,<IP_address>|"<ip>"|

PTR,<IP_address/subnet_mask>,<subdomain_name>|

CNAME,<subdomain_name>,<canonical_domain_name>|"<domain>"|

TXT,<subdomain_name>,<text>

Adds specified resource records to and removes all pre-existing resource records from the Plesk server's domain DNS zone template.

For more details, consult descriptions of the options in the following table for adding resource records of respective types individually.

To add the following two resource records to the domain DNS zone template, while removing all pre-existing resource records from the DNS zone:

• new MX resource record <domain> specifying subdomain name mail.<domain> as the mail exchanger for the record, and setting the mail exchanger's priority to 15:
• new NS resource record <domain> setting domain ns.<domain> as the name server:

  # ./server_dns --set "MX,"",mail.<domain>,15;NS,"",ns.<domain>"

or

# ./server_dns -s "MX,"",<domain>,15;NS,"",ns.<domain>"

--update-server or -u

Updates the Plesk server's domain DNS zone template.

To enable support for recursive DNS queries for hosts on the local network only:

# ./server_dns -u -recursion localnets

--update-soa

Updates the SOA record settings the Plesk server's domain DNS zone template.

To set the TTL parameter to 5 hours for the SOA record for the domain DNS zone template:

# ./server_dns --update-soa -soa-ttl 5H

--info

Displays the list of resource records for the Plesk server's domain DNS zone template.

To view the list of resource records in the domain DNS zone template:

# ./server_dns --info

--help or -h

Displays help on the use of the utility.

To view help on the use of the dns utility:

# ./server_dns --help

or

# ./server_dns –h

-recursion

any|localnets|localhost

Sets the Plesk name server DNS zone preferences:

• any - will support recursive DNS queries for any requesting host.
• localnets - will support recursive DNS queries for any host on the local network only.
• localhost - will support recursive DNS queries for the local host only

Used with the --update-server command only.

To enable support for recursive DNS queries for hosts on the local network only:

# ./server_dns -u -recursion localnets

-status

enabled|disabled

Sets the status of a domain's DNS zone when the domain DNS zone is created during domain creation.

Only newly created domains will inherit the DNS zone status.

Used with the --update-server command only.

To disable domain DNS zones for newly created domains:

# ./server_dns -u -status disabled

-add-acl

<IP_address_1>[[/<subnet_mask>],<IP_address_2>[/<subnet_mask>],...<IP address_N>[/<subnet_mask>]]

Adds host or network IP addresses to the Access Control list (ACL).

To add records 192.0.2.78 and 192.0.2.0/24 to the ACL:

# ./server_dns -u -add-acl 192.0.2.78,192.0.2.0/24

-a

<subdomain_name>

Specifies the A type resource record for a subdomain in the Plesk server's domain DNS zone template.

Used with the --add.

Requires the -ip option.

To add new A resource record sample.<domain> (specifying a placeholder for a domain IP address for the record) to the domain DNS zone template:

# ./server_dns -a -a sample -ip "<ip>"

-ip

<IP_address>|"<ip>"

Specifies an IP address or a placeholder for a domain's IP address for creating an A type resource record in the Plesk server's domain DNS zone template.

Used only with the --add command.

-ns

<subdomain_name>|""

Specifies the NS type resource record in the Plesk server's domain DNS zone template.

Used only with the --add command.

Requires the -nameserver option.

To add a new NS resource record <domain> specifying domain name <domain> as the name server to the DNS zone template:

# ./server_dns -a -ns "" -nameserver "ns.<domain>"

-nameserver

<domain_name>|"[<subdomain_name>.]<domain>"

Specifies the name of a nameserver or a placeholder for creating an NS type resource record in the Plesk server's domain DNS zone template.

-mx

<subdomain_name>|""

Specifies the MX type resource record in the Plesk server's domain DNS zone template.

Used with the --add command only.

Requires the -mailexchanger option.

To add new MX resource record <domain> specifying domain name mail.<domain> as the mail exchanger for the record, and setting the mail exchanger's priority to 15 to the domain DNS zone template:

# ./server_dns -a -mx "" -mailexchanger "mail.<domain>" -priority 15

-mailexchanger

<domain_name>|"[<subdomain_name>.]<domain>"

Specifies the name of a mailexchanger or a placeholder for creating an MX type DNS record in the Plesk server's domain DNS zone template.

-priority

<number>

Specifies the mail exchanger priority for creating an MX type DNS record in the Plesk server's domain DNS zone template.

-cname

<subdomain_name>|""

Specifies the CNAME type resource record in the Plesk server's domain DNS zone template.

Used with the --add command only.

Requires concomitant use of the -canonical option.

To add new CNAME type resource record subdom.<domain> for a canonical name <domain> to the domain DNS zone template:

# ./server_dns -a -cname subdom -canonical "<domain>"

-canonical

<domain_name>|[<subdomain_name>.]<domain>"

Specifies a canonical name or a placeholder for creating a CNAME type DNS record in the Plesk server's domain DNS zone template.

-ptr

<subdomain_name>|""

Specifies the PTR type resource record in the Plesk server's domain DNS zone template.

Used with the --add and --del commands only.

Requires concomitant use of the -subnet option.

To add new PTR type DNS record "<ip>"/16 for <domain> to the domain DNS zone template:

# ./server_dns -a -ptr "" -subnet "<ip>"/16

-subnet

<IP_address>/<subnet_mask>|"<ip>"/<subnet_mask>

Specifies an IP address and a subnet mask or a placeholder for creating a PTR type DNS record in the Plesk server's domain DNS zone template.

-txt

<text>|""

Specifies the TXT type resource record in the Plesk server's domain DNS zone template.

Used with the --add only.

Requires the -domain option if the record is created for a specific subdomain name.

To specify the TXT type DNS record "This record is used to implement the Senders Policy Framework and DomainKeys specifications" for the specific subdomain name subdom in the domain DNS zone template:

# ./server_dns -a -txt "This record is used to implement the Senders Policy Framework and DomainKeys specifications" -domain subdom

-domain

<subdomain_name>|""

Specifies a subdomain name for creating a TXT type resource record in the Plesk server's domain DNS zone template.

Used with the --add command only.

-soa-ttl

<number>[S|M|H|D|W]

Specifies the TTL value for the SOA record in the Plesk server's domain DNS zone template.

Used with the--update-soa command only.

To set the TTL value to 5 hours, the Refresh value to 4 hours, the Retry value to 10 seconds, the Expire value to 2 weeks, and the Minimum value to 2 days for the SOA record in the domain DNS zone template:

# ./server_dns --update-soa -soa-ttl 5H -soa-refresh 4H -soa-retry 10S -soa-expire 2W -soa-minimum 2D

-soa-refresh

<number>[S|M|H|D|W]

Specifies the Refresh value for the SOA record in the Plesk server's domain DNS zone template.

Used with the --update-soa command only.

-soa-retry

<number>[S|M|H|D|W]

Specifies the Retry value for the SOA record in the Plesk server's domain DNS zone template.

Used with the --update-soa command only.

-soa-expire

<number>[S|M|H|D|W]

Specifies the Expire value for the SOA record in the Plesk server's domain DNS zone template.

Used with the --update-soa command only.

-soa-minimum

<number>[S|M|H|D|W]

Specifies the Minimum value for the SOA record in the Plesk server's domain DNS zone template.

Used with the --update-soa command only.