Editing How to use HEXONET's DNS with your domains

{{Sidebar}}
<div style="font-size: 150%;">'''How to use Hexonet's DNS with your domain'''</div><br/>
<p> 

= HEXONET's Nameserver Set =

 ns1.hexonet.net (194.50.187.134)
 ns2.hexonet.net (194.0.182.1)
 ns3.hexonet.net (193.227.117.124)

or alternatively

 ns1.ispapi.net
 ns2.ispapi.net
 ns3.ispapi.net

'''Please remember to adjust the NS records in the DNS zone so that they reflect HEXONET's Nameserver set.'''

= Configure Default Nameservers =
=== Control Panel ===

Every domain registration requires a set of nameservers to be assigned to the domain name.  To automate this process, a default set of nameservers can be configured in the Control Panel to have the system automatically assign these nameservers for every new domain registration. Existing domains can also be easily updated in bulk to use a configured default nameserver set. 

* Login and navigate to ''"Domain Extras > Default Domain Settings"'' in the left menu
* Enter in the nameservers you wish to use as the automatic "default" nameservers  for use with any new domain registration or existing domain name without a configured nameserver.
* Please note every account uses a default set of nameservers regardless of whether this configuration has been set.  The system will utilize the parent user's default nameservers, which for most cases will be HEXONET's default nameservers. 

[[Image:DefaultNameservers.png]]

=== API ===

<pre>
COMMAND=SETENVIRONMENT
ENVIRONMENTKEY0=_system/defaults
ENVIRONMENTKEY1=_system/defaults
ENVIRONMENTNAME0=parkingip0
ENVIRONMENTVALUE0=(default A record destination ip address)
ENVIRONMENTNAME1=nameserver
ENVIRONMENTVALUE1=(nameservers, comma seperated)
</pre>

= Register Domain with HEXONET's Nameservers =
=== Control Panel ===

* During any registration or configuration of a domain name, the system will offer HEXONET's nameservers as an option - ''"Preset Nameservers"''

[[Image:AddDefaultNameservers.png]]

You can also choose to use Hexonet's system nameservers if your preset nameservers are external nameservers.


=== API ===

To be completed

== Use HEXONET's Nameservers With Custom Hostnames ==

You can use Hexonet nameservers with custom subdomains, such as ns1.'''mydomain.com'''. This involves setting the A records for those subdomains to Hexonet nameserver IP addresses, and then supplying your nameserver names with the registration.

Please see "Hexonet's Nameserver Set" for our nameserver IP addresses and then follow the "Register Domain with External Nameservers" instructions to set your nameservers for the domain.


= Register Domain with External Nameservers =

=== Control Panel ===
If you have a foreign DNS provider or maybe have your own DNS to use, you can of course set the nameservers during the registration.

* While looking at the domain order in the shopping cart, click on "Configure" below the domain price.
* Go to the Nameserver tab.
* Ensure the "Preset Nameservers" and "Use System Nameservers" options are deselected. 
* Enter in the desired nameservers in the available fields, clicking on "Save" once you are done.

[[Image:AddCustomNameservers.png]]

{{Warnbox|Please note that some TLD registries perform nameserver checks during registration to ensure domain resolution.  Incorrect nameserver settings may lead to registration failure.  With External Nameservers, please ensure the DNS zone for the domain is already created and properly configured on the external nameserver before registration.}}

=== API ===
You provide the external nameservers with the nameserver#= parameter as mentioned in "Registering domains with HEXONET's Nameservers".

= Configure Existing Domain with HEXONET's Nameservers =

=== Control Panel ===
Clients with their own Nameservers or have DNS services from another third party may have entered these nameservers at registration. You can follow these steps to update the nameservers to Hexonet Nameservers.

* Navigate in the left menu to ''"Domains > Domain Names"''
* Click on the domain name in question to access the domain details
* Open the "Nameserver" tab and choose the option to ''"Use System Nameservers"''

[[Image:ModifySystemNameservers.png]]


=== API ===

Modifying the nameservers of an existing domain is the same regardless of if Hexonet or External Nameservers are used.

<pre>
command = ModifyDomain
domain  = (DOMAIN)
nameserver0 = (NAMESERVER)
nameserver1 = (NAMESERVER)
</pre>

== Create Custom Host Records ==

=== Control Panel ===

Using IP addresses, there are two methods in which to create customized hostnames for HEXONET's DNS:

* Hosts Managed as Objects:
** In the Control Panel, navigate to ''"Domains > Domain Names"''
** Click on the domain name to access the domain details
** Open the ''"Nameserver"'' tab and select ''"Nameserver Hosts"'' and then ''"New Hostname"''.
** In the provided dialog window please enter in the desired hostname (e.g. ns1.yourdomain.net) followed by the respective IP address for a corresponding HEXONET nameserver. The standard IP addresses for HEXONET's nameservers are as follows:
*** ns1: 194.50.187.134
*** ns2: 194.0.182.1
*** ns3: 193.227.117.124
** After creating the host objects you can assign the hostnames as nameservers to this or any other desired domain.

[[Image:AddHostRecords.png]]


* Hosts Managed as Attributes:
** In the Control Panel, navigate to ''"Domains > Domain Names"''
** Click on the domain name to access the domain details
** Open the ''"Nameserver"'' tab
** Directly enter the desired hostname, followed by a blank space, and then the IP address of a HEXONET corresponding nameserver (example: "ns1.yourdomain.net 194.50.187.134")
** Use the hostnames as the nameservers for any other domain. 

[[Image:AddHostRecordsAttr.png]]

=== API ===

Hosts Managed as Objects:

You can create host records with the following command:

<pre>
COMMAND = ADDNAMESERVER
NAMESERVER = (subdomain)
IPADDRESS0 = (IP address)
</pre>

The commands StatusNameserver, CheckNameserver, and ModifyNameserver also exist.

Hosts Managed as Attributes:

The destination IP addresses are included with the nameserver names.

<pre>
COMMAND = ModifyDomain
DOMAIN = (domain)
NAMESERVER0 = (subdomain) (IP address)
NAMESERVER1 = (subdomain) (IP address)
NAMESERVER2 = (subdomain) (IP address)
</pre>

= Configure Existing Domain with External Nameservers =

=== Control Panel ===

* Navigate to ''"Domains > Domain Names"''
* Click on the domain name to open the domain details
* Open the ''"Nameserver"'' tab, ensuring the "Preset Nameservers" and "Use System Nameservers" options are deselected.
* Enter in the desired nameservers.

[[Image:AddCustomNameservers.png]]

{{Warnbox|Please note that some TLD registries perform nameserver checks during registration or modification to ensure domain resolution.  Incorrect nameserver settings may lead to registration or modification failure.  With External Nameservers, please ensure the DNS zone for the domain is already created and properly configured on the external nameservers.}}

=== API ===

Submit the following command to change the nameservers for Existing Domains to external nameservers. Please ensure that the relevant host records have been created at the registry.

<pre>
command = AddDomain
domain  = (DOMAIN)
nameserver0 = (NAMESERVER)
nameserver1 = (NAMESERVER)
</pre>

{{Warnbox|Please note that some TLD registries perform nameserver checks during registration or modification to ensure domain resolution.  Incorrect nameserver settings may lead to registration or modification failure.  With External Nameservers, please ensure the DNS zone for the domain is already created and properly configured on the external nameservers.}}