Introduction

A Host record allows a single primary Name (fully-qualified domain name) to be associated with any of the following, managed collectively in Grid Manager as a single database object:

one or more IPv4 addresses, which manifest as matching pairs of A and PTR records
one or more IPv6 addresses, which manifest as matching pairs of AAAA and PTR records
one or more Host Aliases, which manifest as CNAME records pointing to the primary name
optional DHCP fixed address configuration for each IP address

Host records provide several advantages compared to managing an equivalent collection of Stand-alone DNS Records, the most important of which is that if you change one part of a Host record, the other parts will automatically update to stay in sync.

The trade-off is that you must be VERY careful when deleting a Host record!

Best Practice Recommendations:

In general, use Host records instead of stand-alone A, AAAA, and PTR records, except when you do not want matching pairs.
Do not create multiple Host records for the same IP address.
Use stand-alone CNAME records instead of Host Aliases if the desired alias name resides in a different zone (from the primary name) which is not managed by the same set of people.
In general, use DHCP-enabled Host records instead of DHCP Fixed Addresses.

For more information, see When should I use stand-alone A records? and When should I use stand-alone CNAME records?

Creating a Host record

To create a new Host record:

Open the DNS Zone which will contain the desired primary name. (alternative: open a Network in IPAM View and select the desired IP address). Opening Zones and Networks is described in Getting Started with IPAM.
Click the dropdown arrow next to the Add (+) icon above the table in the main workspace, then choose “Host”, and finally “Host” again.

screenshot

This opens the Add Host dialog box. (alternative: in IPAM View click Add, then “Host”, then “New Host”)
If necessary, click the “Select Zone” button and choose the zone which will contain the desired primary name (e.g. to create “myhost.sandbox.illinois.edu”, you would select the zone “sandbox.illinois.edu”).

If you opened a DNS zone in the main workspace, it will be automatically pre-selected for you.
Type the leading portion of the Name (e.g. “myhost“) into the text box to the left of the selected zone name, so that both pieces together form the desired fully-qualified domain name.

screenshot
- You may leave the text box empty to create a record with the same name as the zone itself (e.g. “sandbox.illinois.edu”).
- You may type e.g. “foo.bar” in the text box to create a record named “foo.bar.sandbox.illinois.edu” even if there is no zone “bar.sandbox.illinois.edu”.
If necessary, add one or more IPv4 Addresses to your Host: click the drop-down arrow next to the Add (+) icon just above the IPv4 Addresses table and choose “Add Address” to place a new row in the table, then click the IPv4 Address field in that row and type the desired IPv4 address. Press return or click elsewhere when you are done typing.

screenshot

If you opened a Network and selected an IPv4 address in the main workspace, it will be automatically pre-populated for you.

Adding more than one IPv4 address to a Host will create multiple matching pairs of A and PTR records for the same primary Name, resulting in “round-robin DNS” behavior.
If necessary, add one or more IPv6 Addresses to your Host.
Add a comment in the “Comment” field (optional).
Click “Next” at the bottom of the dialog window.
If desired, add one or more Extensible Attributes (e.g. “Property Tag”).
Click “Next”.
If desired, you may schedule this change to occur at a later time instead of taking effect immediately (see Scheduled Tasks).
Click “Save & Close” at the bottom of the dialog window.

Editing a Host Record

Before changing the primary Name of a Host record, it is advisable to perform a Basic Search by DNS Name for the current primary Name (fully-qualified domain name), in order to identify any Stand-alone DNS Records (CNAME, MX, etc) pointing to it.

Navigate to the Host record you want to edit (see Getting Started with IPAM); you can find it either by name or by IP.
Select the checkbox for the Host record and click the Edit (notepad) icon above the table.

screenshot

This opens the Edit Host dialog.
Make any desired changes (several possibilities are discussed below).
Click “Save & Close” at the bottom of the dialog window.

Adjusting TTL

For changes to high-profile DNS records (e.g. migrating a live production service), Technology Services recommends that you temporarily lower the TTL of the record in question (e.g. to 1 minute) at least one hour prior to making the actual change, and then restore the TTL to the campus default (1 hour) after the change is complete and you have confirmed that everything is working properly.

To set a custom TTL for a Host record:

Choose the “TTL” subscreen in the Edit dialog.
Click “Override” next to the TTL value, and enter the new desired value (e.g. 1 Minute).

screenshot
Click “Save & Close”.

When your high-profile change is complete, Edit the record again and click “Inherit” on the same TTL subscreen to resume using the campus default.

screenshot

You may find it helpful to add the TTL column to the table of Records in a Zone. Note that this column only displays customized TTLs; it is left blank for records which inherit the default TTL.

Adding Host Aliases

A Host Alias is functionally equivalent to a stand-alone CNAME record which points to the Host’s primary Name, but carries trade-offs with respect to ease of future maintenance. For more information, see When should I use stand-alone CNAME records?

To add a Host Alias to a Host Record:

Choose the “Aliases” subscreen in the Edit dialog
Click the Add (+) icon to place a new row in the table, then click the Aliases field in that row and type the new fully-qualified domain name that should point to this Host. Press return or click elsewhere when you are done typing.

screenshot
Click “Save & Close”.

Enabling DHCP for Host addresses

Enabling DHCP within a Host record is functionally equivalent to creating a stand-alone DHCP Fixed Address, but makes it easy to keep the DNS and DHCP configuration for a client in sync (in case you later decide to migrate the same client to a different IP address or retire it altogether).

To enable DHCP for an IP address in a Host record (either while adding a new Host record or while editing an existing one):

Click the DHCP checkbox to the right of the desired IP address.
For IPv4 addresses: click the “MAC Address” field in that row and type the MAC address of the client that will use this IP. Press return or click elsewhere when you are done typing.

Click here to expand…
For IPv6 addresses: click the “DUID” field in that row and type the DHCP Unique Identifier (see also Limitations of DHCPv6 fixed address allocation) of the client that will use this IP. Press return or click elsewhere when you are done typing.
Optionally, you can also select the IP address using the checkbox to its left and then click the Edit (notepad) icon above the table to configure custom DHCP options that will apply only to this individual fixed address (but are otherwise similar to Setting DHCP Options for a Range). Hint: don’t forget to enable Advanced Mode for the sub-dialog.
Click “Save & Close”.

Please note that your network must have autoconfiguration service appropriately enabled (see Requesting DHCP for Networks) in order for enabling DHCP within a Host record to have any effect.

Displaying Host records in a Zone

When displaying Records within a Zone (see Getting Started with IPAM), we recommend that you click “Toggle flat view” so that each manifestation of a Host record is displayed in its own table row. After you click it, the link text changes to “Toggle hierarchical view”. It should look like this:

screenshot

If you instead choose to display Records in hierarchical view, the Host record will appear only as a single row for the primary Name, and any Host Aliases in other zones will not be visible at all when displaying the contents of those zones. This view is not recommended, as it may cause you to overlook important data.

screenshot

Note that your choice of flat view or hierarchical view for the Records tab is independent of your choice for the Subzones tab.

Deleting a Host Record

BE VERY CAREFUL when deleting a Host Record, as this will remove ALL of its manifest A records, AAAA records, PTR records, CNAME records, and DHCP configuration!

If you only want to remove one of the IP addresses or one of the Host Aliases, Edit the Host instead.

Before deleting a Host record, it is advisable to perform a Basic Search by DNS Name for the primary Name (fully-qualified domain name) in order to identify any Stand-alone DNS Records (CNAME, MX, etc) pointing to it.

To delete a Host record:

Navigate to the Host record you want to delete (see Getting Started with IPAM).
Optional but highly recommended: Edit the Host first and look at all of its IPv4 Addresses, IPv6 Addresses, and Host Aliases to make sure there’s nothing there you want to keep.
Select the checkbox for the Host (making sure no other checkboxes are selected), and click the Delete (trash can) icon above the table.
If you’re sure, click “Yes” when the confirmation dialog appears.

Bulk Host Records

A Bulk Host record (different from a regular Host record) is a single database object which names a contiguous range of IPv4 addresses according to a pattern with a customizable prefix, manifesting as matching pairs of A and PTR records. For example:

myprefix-192-168-1-10.sandbox.illinois.edu. IN A 192.168.1.10
myprefix-192-168-1-11.sandbox.illinois.edu. IN A 192.168.1.11
...
10.1.168.192.in-addr.arpa. IN PTR myprefix-192-168-1-10.sandbox.illinois.edu.
11.1.168.192.in-addr.arpa. IN PTR myprefix-192-168-1-11.sandbox.illinois.edu.
...

Unfortunately we are not able to offer self-service configuration of Bulk Host records at this time; please email hostmgr if you would like to request one. Note that for relatively small address ranges it may be simpler to just create a normal Host record for each address (perhaps using CSV Import).