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.

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.

🚧

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. On ​Control Center​, go to > DNS SOLUTIONS > Edge DNS.

  2. On the Zone list page, click Add zone.

    📘

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

  3. On the Add zone page, enter the settings that you want for your primary zone:

    • 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.
  4. Click Create zone. The new zone's Edit zone page appears.

  5. Continue by adding 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.

📘

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

  1. On the Edit zone page, scroll down to the Zone record sets section and click Add new record set.
    The Add new record set for zone dialog opens.

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

  3. In the Record data field, enter your record set information according to the help instructions for your chosen record type.

    For a list of supported resource record types, see Supported resource record types.

  4. Click Add to change list.

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

  5. 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 alternatively choose to upload a DNS master file (as defined in RFC-1035, Section 6) containing all the records at one time.

  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.

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, you need to 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. The dialog closes.
    • To accept and implement the changes, click Activate zone at the bottom. All revisions immediately begin to propagate.
    • To abandon the changes, click Discard all changes near the top. Discarding the changes deletes them and closes the dialog.

Edit the record set

The Edit Record Set for zone dialog lists the record set you specified for this zone. Record data is expressed in RFC-1035 master file format.

📘

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, click the name of the zone with the record set you would like to edit.

  2. On the Edit zone page, click the name of the record set, or select Edit from its Actions menu.

  3. In the Edit record set for zone dialog, make your revisions. Then click Add to change list.

📘

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


Did this page help you?