Fortinet black logo

CLI Reference

system dns

system dns

Use this command to configure the FortiWeb appliance with its local domain name, and the IP addresses of the domain name system (DNS) servers that the FortiWeb appliance will query to resolve domain names such as www.example.com into IP addresses.

FortiWeb appliances require connectivity to DNS servers for DNS lookups. Use either the DNS servers supplied by your Internet service provider (ISP) or the IP addresses of your own DNS servers. You must provide unicast, non-local addresses for your DNS servers. Local host and broadcast addresses will not be accepted.

For improved performance, use DNS servers on your local network.

To use this command, your administrator account’s access control profile must have either w or rw permission to the sysgrp area. For details, see Permissions.

Syntax

config system dns

set primary "<dns_ipv4>"

set secondary "<dns_ipv4>"

set domain "<local-domain_str>"

end

Variable Description Default

primary "<dns_ipv4>"

Enter the IP address of the primary DNS server. 8.8.8.8

secondary "<dns_ipv4>"

Enter the IP address of the secondary DNS server. 0.0.0.0

domain "<local-domain_str>"

Enter the name of the local domain to which the FortiWeb appliance belongs, if any. The maximum length is 127 characters.

This field is optional. It will not appear in the Host: field of HTTP headers for client connections to protected web servers.

Note: You can also configure the host name. For details, see .

No default.

Example

This example configures the FortiWeb appliance with the name of the local domain to which it belongs, example.com. It also configures its host name, fortiweb. Together, this configures the FortiWeb appliance with its own fully qualified domain name (FQDN), fortiweb.example.com.

config system global

set hostname "fortiweb"

end

config system dns

set domain "example.com"

end

Related topics

system dns

Use this command to configure the FortiWeb appliance with its local domain name, and the IP addresses of the domain name system (DNS) servers that the FortiWeb appliance will query to resolve domain names such as www.example.com into IP addresses.

FortiWeb appliances require connectivity to DNS servers for DNS lookups. Use either the DNS servers supplied by your Internet service provider (ISP) or the IP addresses of your own DNS servers. You must provide unicast, non-local addresses for your DNS servers. Local host and broadcast addresses will not be accepted.

For improved performance, use DNS servers on your local network.

To use this command, your administrator account’s access control profile must have either w or rw permission to the sysgrp area. For details, see Permissions.

Syntax

config system dns

set primary "<dns_ipv4>"

set secondary "<dns_ipv4>"

set domain "<local-domain_str>"

end

Variable Description Default

primary "<dns_ipv4>"

Enter the IP address of the primary DNS server. 8.8.8.8

secondary "<dns_ipv4>"

Enter the IP address of the secondary DNS server. 0.0.0.0

domain "<local-domain_str>"

Enter the name of the local domain to which the FortiWeb appliance belongs, if any. The maximum length is 127 characters.

This field is optional. It will not appear in the Host: field of HTTP headers for client connections to protected web servers.

Note: You can also configure the host name. For details, see .

No default.

Example

This example configures the FortiWeb appliance with the name of the local domain to which it belongs, example.com. It also configures its host name, fortiweb. Together, this configures the FortiWeb appliance with its own fully qualified domain name (FQDN), fortiweb.example.com.

config system global

set hostname "fortiweb"

end

config system dns

set domain "example.com"

end

Related topics