DNSUI User Guide

Printer-friendly versionPrinter-friendly version

Accessing the MCNC DNS UI

The MCNC DNS UI is available at https://dns.mcnc.org and uses MCNC's federated single sign service. In order to access the site you will need an account with one of the institutions recognized by MCNC or an NCREN Community account (which can be created here). You will also need to contact MCNC support to have your account authorized for access to the DNS site. Only users listed as a contact for an institution will be granted access.

Logging in

The login process is the same as for accessing many MCNC web services. If accessing a federated site for the first time you will be prompted to select the organization associated with your login credentials. If your organization is not listed and does not have federated identity management then you will need an NCREN Community account (which can be created here).

If you are not presented with the 'Where Are You From?' page, as seen below, and are having trouble logging in you may need to clear any Cookies for mcnc.org and/or restart your browser after closing out all open browser windows.

Wayf

After selecting your institution you will then be prompted for your username and password. The screen below shows an NCREN Community login, your login page may be different if you are using credentials for your organization.

signin

The main page

On logging into the site, a list of zones is presented, these are the zones (and related reverse zones) that you are able to edit.

zonelist

Common actions

Within the DNS system common actions are indicated by the following icons:

edit - Clicking on this icon will allow editing of the related item.

edit - Clicking on this icon will allow deleting of the related item, after a confirmation step.

Please note that using the browser back button is discouraged on this site, to return to this start page at any point click on the List zones entry in the menu bar.

The menu has the following options:

1. Search

This allows you to search for records and zones and you may enter either a partial or complete domain name or IP address. For PTR records you may wish to enter the address in reverse notation, such as '1.168.192.in-addr.arpa'.

A search will return any matching records and/or zones for which you have access. Each record returned will have edit and delete options. There will only be an edit option for any zones returned since non-administrative users are not allowed to delete a zone.

search

2. List zone

The 'List zones' page is the landing page for the site and lists all of the zones for which you have access. You can click on the edit icon to the left of a zone name to edit the zone, add or remove records, or get a listing of current records.

zonelist

3. User information

Allows you to view your account information. Please notify support if information on this page is incorrect.

Adding a record

From the List zones or Search page click on the edit icon to edit the the zone in which you wish to add a record. This will take you to the edit page, shown below.

example

Enter the record name in the box at the top of the page, this is the domain name minus the actual domain, so for 'www.test.org' you would enter 'www'. Enter the record content and optionally a priority and TTL.

For address records (either A or AAAA) you can check the Add also reverse record box which will create the necessary PTR record in the reverse zone. Note that this can only happen if you also control the reverse zone.

addrecord

Click Add record to add the record to the zone, you can then click on the link in the green confirmation message area to return to your zone.

afteradd

Note that in this example, two records were added as the option to auto create the PTR record was selected.

Adding a SRV Record

Adding a SRV record is slightly different from other record types since these records have additional fields of information, specifically the weight and port, and typically include a sub domain. For instance, you may need to add the following:

Type Service Protocol Port Weight Priority TTL Name Target
SRV _sip _tls 443 1 100 1 hour domain.com sipdir.online.lync.com
SRV _sipfederationtls _tcp 50601 1 100 1 hour domain.com sipfed.online.lync.com

In this example, the records would be configured in the DNS interface as follows:

Name Type Content Priority TTL
[service].[protocol] SRV [Weight] [Port] [Target] [Priority] [TTL]
_sip._tls SRV 1 443 sipdir.online.lync.com 100 14400
_sipfederationtls._tcp SRV 1 5061 sipfed.online.lync.com 100 14400

Editing a record

From the List zones or Search page click on the edit icon to edit the the zone in which you wish to edit a record.

Click on the edit icon to the left of the zone you wish to edit, this will take you to the Edit record page. Make the changes to the record and click Commit changes to save, or Reset changes to revert to the original values.

'

edit

In the above example records related to the record you are editing have been found. If this is the case a link will be displayed that will open the edit page for the related record (in a new browser tab).

Deleting a record

From the List zones or Search page click on the edit icon to edit the the zone in which you wish to delete a record.

Click on the delete icon to the left of the record you wish to delete - you will be asked to confirm the deletion prior to any changes being made.

delete

Again related records (if found) will be displayed.

Warnings and Errors

A warning may be displayed when editing or adding a record if making the change may cause unexpected results, or may not be the optimal way to make a change. In the example below a warning has been generated due to an attempt to add an A record with an IP that already is in use. This is not necessarily wrong, but could indicate a typo, or perhaps be better achieved using a CNAME.

warning

Clicking on the Confirm button will commit the change.

An error will be displayed when the system is unable to make the change requested, this might be due to a formatting problem (as in the example below) or even due to a system error.

error

Additional features

IP Address list view

When viewing a reverse zone (IPv4 only), clicking on the Address List View link will open a page that list all the IP addresses in the reverse zone, this can be easier to work with than the normal view, as the IP addresses will be sorted and grouped in a more convenient way (forward notation).

ip-list