Configure primary zones

Use ​Akamai Control Center​ or the Edge DNS Zone Management API to perform the initial configuration of your Edge DNS service.

📘

The Edge DNS Zone Management API also includes bulk zone operations and operations that let you retrieve data about your Edge DNS configuration.

Workflow to configure primary zones

Complete the following steps to configure primary zones using ​Akamai Control Center​.

  1. Add a primary DNS zone

  2. Add a new record set

  3. Review and submit the change list

Add a primary DNS zone

Primary DNS zones let ​Akamai​ serve your domains' DNS records without the need for you to maintain your own master DNS servers.

To add a primary DNS zone, complete the next procedure.

🚧

Use caution when adding a primary zone that's a subzone

If you're adding a primary zone that's a subzone of an existing secondary zone, the contents of the primary zone that you're creating might override those of the secondary zone. Use caution to ensure that there is no collision in the namespace between the existing secondary zone and the new primary zone.

  1. Log in to ​Control Center​.

  2. Go to > DNS SOLUTIONS > Edge DNS. The Zone list page opens.

  3. On the top toolbar, click Add zone.

    📘

    If Add zone is grayed out, you've reached your maximum allotted zones. To increase your limit, contact your service representative.

  4. On the Add zone page, configure the settings for your primary zone using the following field descriptions as guidance.

    • Contract. Select the contract for this zone configuration.

    • Zone type. Select Primary.

    • Zone names. Enter one or more zone names using this format: zone.example.com. A zone name and any of its subdomains must be unique to a specific account (for example, the account in which zone.example.com resides).

    • DNSSEC Sign and Serve. Select this checkbox to have ​Akamai​ automatically set up DNSSEC for the zone. If you want to manually configure your own DNSSEC records for the zone, leave this checkbox deselected.

    • DNSSEC algorithm. If you selected the DNSSEC Sign and Serve checkbox, select the algorithm to use.

    • Customer ID. Optional. Enter a descriptive name for the customer. For example, you might enter your organization's billing reference for the customer.

    • Comments. Describe the new zone.

  5. Click Create zone. The new zone's Edit zone page appears.

  6. Add a new record set.

Add a new record set

After adding a primary DNS zone, you need to add records to create the record set. Initially, the record set is empty.

You can add records individually to create a record set, or, for new empty zones, you can upload a DNS master file instead.

📘

Each primary zone record set must contain one start of authority (SOA) record and at least one name server (NS) record.

Add records individually

To create a record set for a primary DNS zone by adding records individually, complete the following procedure.

  1. On the Zone list page, in the zone list table, Zone column, select the zone that you want to edit.
    The Edit zone page for the selected zone opens.

  2. Scroll down to the Zone record sets panel and click Add new record set.
    The Add new record set dialog for the selected zone opens.

  3. Fill in the Name, Type, and TTL fields.

  4. In the Record data field, enter your record set information according to the help instructions for your chosen record type. See Supported resource record types for a list of supported resource record types.

📘

Record data is encoded in master file format. RFC-1035, Section 5 defines master file format for most record types.

  1. Click Add to change list.

    The Add new record set dialog closes. On the Edit zone page, the Zone record sets panel is updated to include the new record set, and a Pending changes not activated banner appears at the top of the page.

  2. Continue adding records for this zone until the record set is complete.

📘

Changes do not propagate until you review and submit the change list.

Upload a DNS master file

For new, empty zones, you can choose to upload a DNS master file (as defined in RFC-1035, Section 5) instead of adding records individually to create a record set.

To upload a DNS master file, complete the next procedure.

  1. On the Edit zone page, in the Zone record sets section, click Upload zone file.
    The Upload zone file dialog opens.

  2. Click Browse files and select the zone file. Then click Upload zone file.
    The Upload zone file dialog closes. The zone configuration propagates immediately after upload.

Edit the record set

To edit a record set for a zone, complete the next procedure.

📘

Each primary zone record set must contain only one start of authority (SOA) record, and at least two name server (NS) records.

  1. On the Zone list page, select the zone name with the record set that you want to edit.
    The Edit zone page for the selected zone opens.

  2. In the Zone record sets panel, either click the name of the record set, or select Edit from its Actions menu.
    The Edit record set for [zone] dialog opens.

  3. Update the editable fields as desired.

📘

Record data is expressed in RFC-1035 master file format.

  1. Click Add to change list.
    The dialog closes, and you return to the Edit zone page. In the Zone record sets panel, a red dot appears in the Modified column corresponding to the record set that you edited. Additionally, a Pending changes not activated banner appears at the top of the page.

📘

Changes do not propagate until you review and submit your change list.

Review and submit the change list

Edge DNS queues record-set changes in the change list as you make them. When you finish editing your configurations, review the change list and submit the revisions to propagate the changes.

  1. On the Edit zone page, click Review change list.
    The Review change list dialog opens.

  2. Review the change list and decide whether you want to keep the changes. The dialog highlights all zone additions in green and deletions in red.

  3. Complete one of the following actions:

    • To make additional changes, click Back at the bottom of the dialog. The dialog closes.
    • To accept and implement the changes, click Activate zone at the bottom of the dialog. All revisions immediately begin to propagate.
    • To abandon the changes, click Discard all changes near the top of the dialog. Discarding the changes deletes them and closes the dialog.