Personal tools

From HEXONET Wiki

Jump to: navigation, search
(Updated to add API and cp3)
 
Line 1: Line 1:
{{Sidebar}}__NOTOC__
+
{{Sidebar}}
 +
<div style="font-size: 150%;">'''How to use Hexonet's DNS with your domain'''</div><br/>
 +
<p>
  
==How to use Hexonet's DNS with your domain==
+
= 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)
  
=== Configuring Default Nameservers ===
+
or alternatively
= Control Panel =
+
 
 +
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.  
 
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.  
Line 15: Line 28:
 
[[Image:DefaultNameservers.png]]
 
[[Image:DefaultNameservers.png]]
  
= API =
+
=== API ===
  
 
<pre>
 
<pre>
Line 27: Line 40:
 
</pre>
 
</pre>
  
== Registering domains with HEXONET's Nameservers ==
+
= Register Domain with HEXONET's Nameservers =
=Control Panel=
+
=== Control Panel ===
  
 
* During any registration or configuration of a domain name, the system will offer HEXONET's nameservers as an option - ''"Preset Nameservers"''
 
* During any registration or configuration of a domain name, the system will offer HEXONET's nameservers as an option - ''"Preset Nameservers"''
Line 37: Line 50:
  
  
= API =
+
=== API ===
  
 
To be completed
 
To be completed
  
== Registering Domains Using HEXONET's Nameservers With Custom Hostnames ==
+
== 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.
 
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 "Registering Domains Using External Nameservers" instructions to set your nameservers for the domain.
+
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.
  
  
== Registering Domains Using External Nameservers ==
+
= Register Domain with External Nameservers =
  
= Control Panel =
+
=== 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.
 
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.
  
Line 62: Line 75:
 
{{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.}}
 
{{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 =
+
=== API ===
 
You provide the external nameservers with the nameserver#= parameter as mentioned in "Registering domains with HEXONET's Nameservers".
 
You provide the external nameservers with the nameserver#= parameter as mentioned in "Registering domains with HEXONET's Nameservers".
  
== Using Hexonet's DNS for Existing Domains ==
+
= Configure Existing Domain with HEXONET's Nameservers =
  
= Control Panel =
+
=== 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.
 
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.
  
Line 77: Line 90:
  
  
= API =
+
=== API ===
  
 
Modifying the nameservers of an existing domain is the same regardless of if Hexonet or External Nameservers are used.
 
Modifying the nameservers of an existing domain is the same regardless of if Hexonet or External Nameservers are used.
Line 88: Line 101:
 
</pre>
 
</pre>
  
=== HEXONET's Nameserver Set ===
+
== Create Custom Host Records ==
 
+
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.'''
+
 
+
 
+
== Creating Custom Host Records for Hexonet's DNS (using an existing domain) ==
+
  
= Control Panel =
+
=== Control Panel ===
  
 
Using IP addresses, there are two methods in which to create customized hostnames for HEXONET's DNS:
 
Using IP addresses, there are two methods in which to create customized hostnames for HEXONET's DNS:
Line 131: Line 129:
 
[[Image:AddHostRecordsAttr.png]]
 
[[Image:AddHostRecordsAttr.png]]
  
= API =
+
=== API ===
  
 
Hosts Managed as Objects:
 
Hosts Managed as Objects:
Line 157: Line 155:
 
</pre>
 
</pre>
  
== Choosing External Nameservers for Existing Domains ==
+
= Configure Existing Domain with External Nameservers =
  
= Control Panel =
+
=== Control Panel ===
  
 
* Navigate to ''"Domains > Domain Names"''
 
* Navigate to ''"Domains > Domain Names"''
Line 170: Line 168:
 
{{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.}}
 
{{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 =
+
=== 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.
 
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.

Latest revision as of 19:19, 26 September 2018

How to use Hexonet's DNS with your domain

Contents

[edit] 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.

[edit] Configure Default Nameservers

[edit] 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.

DefaultNameservers.png

[edit] API

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

[edit] Register Domain with HEXONET's Nameservers

[edit] Control Panel

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

AddDefaultNameservers.png

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


[edit] API

To be completed

[edit] 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.


[edit] Register Domain with External Nameservers

[edit] 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.

AddCustomNameservers.png

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.


[edit] API

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

[edit] Configure Existing Domain with HEXONET's Nameservers

[edit] 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"

ModifySystemNameservers.png


[edit] API

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

command = ModifyDomain
domain  = (DOMAIN)
nameserver0 = (NAMESERVER)
nameserver1 = (NAMESERVER)

[edit] Create Custom Host Records

[edit] 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.

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.

AddHostRecordsAttr.png

[edit] API

Hosts Managed as Objects:

You can create host records with the following command:

COMMAND = ADDNAMESERVER
NAMESERVER = (subdomain)
IPADDRESS0 = (IP address)

The commands StatusNameserver, CheckNameserver, and ModifyNameserver also exist.

Hosts Managed as Attributes:

The destination IP addresses are included with the nameserver names.

COMMAND = ModifyDomain
DOMAIN = (domain)
NAMESERVER0 = (subdomain) (IP address)
NAMESERVER1 = (subdomain) (IP address)
NAMESERVER2 = (subdomain) (IP address)

[edit] Configure Existing Domain with External Nameservers

[edit] 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.

AddCustomNameservers.png

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.


[edit] 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.

command = AddDomain
domain  = (DOMAIN)
nameserver0 = (NAMESERVER)
nameserver1 = (NAMESERVER)
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.