Introduction

Deploying any type of internet-base service often requires setting up a domain name. For example, a domain is needed to obtain SSL certificates or primarily allow users to locate your web application by a pre-assigned name.

Creating a domain in nobus, enables you to effectively manage the domain's DNS records via the nobus dashboard. Domain name records are used as a naming system for servers, computer systems and various Internet-based services.

Domain Name System (DNS) enables the mapping of domain names to Internet resources. It translates human readable domain names (for example, www.example.com) to numerical IP addresses (for example, 115.87.56.102) which is essential for locating these internet resources. It delegate the responsibility of name assignment and mapping by designating authoritative name servers for each domain. Also, Network administrators may delegate authority over sub-domains of their allocated name space to other name servers thus, ensuring a distributed and fault-tolerant service.

DNS management is available for Nobus all resources as well as non-Nobus resources at no extra cost.

Features

  • Address (A) record; holds the IPv4 address of a domain and is the most important of these records. and are used to point a domain or sub-domain to an IP address. For example, your request from your browser to the subdomain www.example.com; is directed to the server with IP address 154.75.34.119.
  • AAAA record; equivalent to A record but basically for IPv6 addresses.
  • Pointer (PTR) record; resolves an IP address to a domain or host name. PTR records are used for reverse DNS lookup.
  • Canonical (CNAME) record; maps a domain or sub-domain to another domain without. This can be a better option when running several services from a single IP address.
  • Mail exchanger (MX) record; directs mail to an email server. you can setup multiple MX records to point to a collection of mail servers thereby ensuring redundancy.
  • Text (TXT) record; lets you associate text with a hostname or zone. It can be used for several purposes including verification and mail security.
  • Name Server (NS) record; indicates the permissive name servers. A domain often has multiple name servers. Thus, NS record can asscertain which server contains the actual DNS records.

Nobus name servers are dns2.nobus.io, dns.google.com, and dns1.nobus.io.

You can check any existing records using domain name lookup tools such as nslookup or dig.

nslookup dns2.nobus.io 
nslookup -q=ns dns2.nobus.io 
dig dns2.nobus.io 
dig dns2.nobus.io txt 

These lookup tools can be very useful when troubleshooting issues with domain name records. The process of creating domain name records will largely depend on the domain name registrar you are using to manage your domain. A good number of registrars have comprehensive documentation on domain name records configurations.

Nobus does not currently provide domain registration services. To use Nobus DNS, you need to register a domain name with a registrar and update your domain's NS records to point to Nobus's name servers

DNS Quickstart

To set up a domain with Nobus, you need to add it (and any of its existing DNS records) to the dashboard, then delegate the domain by updating your registrar to use Nobus's name servers.

Note: If the domain is already in use, recreate the domain's records on Nobus before delegating the domain to avoid downtime.
  1. Log in to the Nobus Management Dashboard

    Goto Project > DNS >

    click Create in the top right.

  2. In the Enter Domain section, enter the domain name.

    This is basically domain, such as dns2.nobus.io. To add subdomains, like www.dns2.nobus.io or app.dns2.nobus.io, create DNS records for them after adding the main domain.

  3. Click Add Domain. This takes you to the Create Record Set page and adds NS records for the domain on Nobus's name servers.

  4. For each record, select the record type, fill in the necessary data, and click Create Record.

Example record ; you could add a subdomain for your web-app server such as app.dns2.nobus.io and enable an A record that points to that subdomain.

DNS A record, that maps your domain name to the server’s public IP address ( you cannot use your Server's private IP since they unaccessible from outside your own private network).
   Name                      Type                Address                 TTL 
app.dns2.nobus.io            A               192.168.166.23            700

The TTL sets the time-to-live in seconds. This is the amount of time the record is cached by a dns resolver. note that longer TTL making updates slower.

Delegate your domain by pointing your domain name to Nobus's name servers through your registrar.

Add Domains

To add a domain from the Nobus Management Dashboard

Goto Project > DNS> Zones, click the Create Zone

This brings you to the Domains (zone) tab. Enter your domain into the Enter domain field, then click Submit.

The system performs a DNS lookup to see if the domain has already been added to Nobus. If the domain has not been previously added to Nobus's DNS service, it will be added. otherwise, it will not be created

Domains you've added are listed on the Domains dashboard.

you can click the name to view and modify its DNS records.

You can add records in the Create record set section. The DNS records section lists any existing records for the domain, and you can update or delete records by clicking the More menu.

Add Subdomain

A subdomain is a domain that is part of an apex domain. For example, www.example.com and goal.example.com are subdomains of the example.com domain, which in turn is a subdomain of the com apex domain (TLD). Subdomains also point traffic to a particular IP address.

This example uses the A record to give a basic understanding of how to add a new hostname to your domain name and create records for it. Also, follow this procedure to set up a hostname using any DNS record supported by nobus.

Ensure you have met the following requirements below:

If you have not already added a domain to your Nobus account, you can follow the steps in quickstart; to add a domain on Nobus.

Verify Your Domain's Delegation

click the Record Sets, Goto the NS Records section under Types.

If the NS records contain data, other than Nobus's name server addresses ( example.com. 1500 IN NS dns.google.com.,dns1.nobus.io.,dns2.nobus.io. ), you perhaps, did not delegated the domain correctly.

You can also use the dig command line tool to verify your domain's delegation by running the command:

dig @ns1.nobus.io <YOUR-DOMAIN> NS
Note
If you have changed your domain's delegation recently, it may take up to 2 days for your domain's new delegation to propagate through the internet.

Create a Hostname with an A Record

In this step, you'll add a new hostname to your domain and point it to a target IP address. The target IP address can be the your instances or Load Balancers public IP addresses.

To add the hostname from the dashboard,

Log in to the Nobus Management Dashboard

Goto Project > DNS > Zones.

Select the domain name you would like to add the new hostname to

Click Create Record Set

In the Create Record Set window, choose the A record.

Enter the new hostname into the Name field. The characters entered into the Hostname field append to your domain name. Enter the target IP address (the server you would like to direct traffic to) into the Records field. Leave the TTL (Time To Live) duration as is, 3600 seconds.

Click Submit. The record is created at the new hostname.

Test the New Hostname

In this step, you'll verify that the DNS changes have propagated across the internet. Below are three different methods for verifying your DNS changes.

All DNS records have a TTL that specifies how long a record should remain in a resolver's cache before the resolver should query a DNS name server for an updated set of records for hostname. This means if a DNS record has a TTL of 3600 seconds (1 hour), a resolver will cache the record for 3600 seconds after it receives the initial query for a hostname. DNS propagation is the process of allowing DNS records’ TTLs to expire in resolver caches across the internet.

If you want to verify your DNS changes without needing to account for propagation times, use the dig option to query Nobus's name servers directly.

Click the Record Sets tab, below the Types, an A record containing the data of your target IP address (also below the Records) should exist beside A - address record . If no A record exist under the Type , check the DNS records section of your domain in the Nobus dashboard and ensure that the record was created. If the record exists, give the record at least 48 hours to propagate across the internet. Otherwise, try creating it again.

  • Through you web browser You can also enter the newly created hostname into your browser's URL field to ensure that the new hostname is resolving to the correct website. If the website does not resolve, your server may need additional configuration or you may need to allow more time for the new DNS record to propagate across the internet.

  • dig (command line tool) You can use the BIND's dig tool to retrieve DNS record information from Nobus's name servers without having to account for propagation time. dig DNS look up tool for macOS and Linux operating systems that you can access via the terminal. On windows, you can install the dig tool .

To use dig to see if your DNS record has been set up correctly, enter the following command into your terminal:

dig @dns1.nobus.io <your new hostname>`

dig returns DNS record information about your hostname. In the Feed back, you should see the newly created A record. If no A record exists, check the DNS records section of your domain in the Nobus dashboard and ensure that the record was created.

Important

If you are pointing your newly created hostname at a web application or a separate web directory on your server, your target instance or application may require additional network configuration to access it from the hostname.

Delete Domain

If you no longer want to manage the DNS records for a domain on Nobus, you can delete the domain. This removes the domain and its DNS records from the account.

However, deleting a domain from Nobus does not delete the domain name registration. Registrations are managed by the domain registrar.

To Delete a domain from the Nobus Management Dashboard

Goto Project > DNS > Zones.

Find the domain name you would like to delete the new hostname to

Click the dropdown menu, arrow at the far right of the domain you want to delete, then select Delete. In the confirmation window, click Delete Domain to permanently delete the domain and its records from the account.