Manage GTM domains

The DNS forms a tree-structured namespace. For example, in this list of domain names each item is a domain, and each domain is also a subdomain of the one above it in the list.

com
customer.com
sales.customer.com

In the GTM system, the term domain is used in a slightly restricted sense. A GTM domain is a DNS domain, whose name usually ends in .akadns.net. These additional namespaces are also present: akadns6.net and akadns99.net. The namespace akadns6.net is currently not in use. The namespace akadns99.net is available for GTM domain names that require China Internet Content Provider (ICP) compliant workflow. A number of attributes are specified at the GTM domain level, the most important being portal access control. Anyone with permission to edit a GTM domain can modify or delete any of the properties (subdomains) within that domain.

Add new domain

The first step in using GTM is to create a GTM domain. You need to have Add Scope contract permissions to create a domain.

  1. Log in to ​Control Center​.

  2. Go to > DNS SOLUTIONS > Global Traffic Management. The Traffic Management Domains page opens.

  3. Click Add New Domain.

  4. Select the contract from the menu for the domain. This field is visible if you have at least one contract.

  5. Fill in the Domain Name field that usually ends in .akadns.net. The fully qualified domain name (FQDN) field warns you if the domain name format is invalid by underlining the location of the error.

  6. Enter a data center name and location. You need to specify at least one data center and the maximum number per domain is 213. Be sure to provide the most accurate location data possible to enable GTM to properly balance traffic to your data centers.

  7. Click Add Data Center. To remove an existing data center, click the X sign located to the right of the Data Center Name field.

  8. For those properties in which you set the weight of their Traffic Distribution Targets, the Load Imbalance Factor field determines the flexibility of the weight settings. The higher you set the Load Imbalance Factor, the more flexible you can be in letting GTM distribute traffic among your traffic targets. See Load Imbalance Factor in Load balancing.

  9. Check the Collapse CNAMEs checkbox to provide only the final CNAME answer rather than returning all the CNAMEs that might be returned by a DNS response.

  10. Click the Load Feedback checkbox to enable these performance-based property types.

  • Performance-Based Load Balancing with Load Feedback

  • Performance-Based Load Balancing with Load Feedback (targets computed from configured weights)

  • Performance-Based Load Balancing with Load Feedback Based on Liveness Test Download Scores

📘

Load Feedback setting

After you create a domain, you cannot change the Load Feedback setting. If you plan to use these property types, enable Load Feedback now as you will not to be able to do so after you create the domain.

  1. Click Save. The New Property-Basic Info page appears. The next step is to add a property to your domain. See Add a property.

If you save a domain before creating a property you are prompted to create a property the next time you open that domain.

Edit domain settings

Use these instructions to Edit domain settings for a variety of functions on properties, maps, data centers, and settings.

  1. Log in to ​Control Center​.

  2. Go to > DNS SOLUTIONS > Global Traffic Management. The Traffic Management Domains page opens.

  3. From the Traffic Management Domains page, click the name of the domain you want to edit. The domain page appears and displays these domain details.

    • Status. An icon that indicates the current state of the domain. Status can be complete, pending, or denied.

    • History. Lists a history of the changes that have been made to the domain. Click View to see details.

    • Configuration.

      • Click Upload File to upload configuration revisions to a whole domain you have revised. Uploading is limited to those that have permission to do so.

      • Click Download File to get a JSON file listing all the domain's information (properties, maps, and so forth). Anyone can download this information.

  4. Use these tabs to edit settings for the selected domain. Tabs that appear grayed out are not available based on your contract type.

    • Properties tab. This displays the domain's properties. From this tab you can.

      • View or edit an existing property's basic settings, traffic targets, and liveness tests.

      • Add a new property, delete a property, or duplicate an existing property.

      • Edit a property's static record sets.

        See Manage properties.

    • Geographic Maps tab. This displays the domain's geographic maps. From this tab you can.

      • View or edit existing map settings.

      • Add or delete geographic maps

        See Manage maps.

    • CIDR Maps tab. This displays the domain's CIDR maps. From this tab you can.

      • View or edit existing CIDR map settings.

      • Add or delete CIDR maps

        See Manage maps.

    • AS Maps tab. This displays the domain's AS maps. From this tab you can.

      • View or edit existing AS map settings.

      • Add or delete AS maps

        See Manage maps.

    • Data Centers tab. This displays the domain's data centers. From this tab you can.

      • View or edit existing data centers.

      • Add, delete, or clone data centers.

        See Manage data centers.

    • Resources tab. This displays the domain's resources. From this tab you can.

      • View or edit existing resources.

      • Add or delete resources.

      • View load feedback report.

        See Manage Resources.

    • Settings tab. This displays the domain's settings. From this tab you can.

      • Add or delete email addresses to the notification list.

      • Change the load imbalance factor.

      • Collapse CNAMEs.

      • Load Feedback. When Load Feedback is enabled, three performance-based property types are available. When Load Feedback is disabled, only the performance-based load balancing property type is available.

      • Edit the default SSL certificate for the domain.

View domain status

Use this procedure to view the status of domains.

  1. Log in to ​Control Center​.

  2. Go to > DNS SOLUTIONS > Global Traffic Management. The Traffic Management Domains page opens.

  3. In the Status column, view these icons that indicate the current state of the domain as complete, pending, or denied. Use Search Domains to filter the list to find a specific domain.

    Indicates a completed state.
    Indicates that a change list has been submitted to update the domain.
    Indicates a problem with the domain that needs to be fixed. The problem is described in the Comment column.

  4. In the Domain column, click a domain name to view or edit its configuration. Domain names are dynamically truncated based on screen width. Roll over the Domain name to display the complete name. See Edit domain settings.

    • Last Updated. Provides the date and time, in UTC, of the domain's most recent update.

    • Action. In this column, click the ellipsis to perform these tasks.

      • Download Configuration. Provides a JSON file with a domain's configuration data.

      • Validate Configuration. Click to validate the domain's configuration.

Activate domain changes

When you make any changes on the domain page, you need save those changes to activate them using this procedure.

  1. After you’re done making domain changes, click Add to Change List to save. This returns you to the main maps page.

  2. Click Review Change List, which is accessible from any of the tabs on the domain page.

  3. If you want to undo the changes you made, click Discard All Changes.

  4. In the Review Change List dialog box, add a required comment.

  5. To activate the changes you made, click Activate Domain.

Delete domains

You can delete domains individually or as a group.

  1. Log in to ​Control Center​.

  2. Go to > DNS SOLUTIONS > Global Traffic Management. The Traffic Management Domains page opens.

  3. Select the checkbox for domains you want to delete.

  4. In the Select Domains Action menu, click Delete.
    The Delete domains dialog opens with Run safety checks selected by default and a list of the selected domains.

📘

Safety checks allow deletions if the domain has received less than 2,000 requests in the last 24 hours.

  1. Choose one of these options:

    • To run safety checks and delete the selected list of domains, click Delete.
      A progress bar shows the percentage of deletions. On completion, the Domain delete status page opens. A red checkmark indicates prevented deletions with a status message for the reason the deletion did not occur.

    • To delete domains without running safety checks:
      a. Deselect Run safety checks. The Bypass safety checks confirmation dialog opens.
      b. Click Yes. The Delete domains dialog reopens with a message advising you of the risks if you proceed.
      c. Click Delete. A progress bar shows the percentage of deletions. On completion, the Domain status page opens showing the result.