Use this procedure to update the DNS server configuration across VMware Cloud Foundation components.

SDDC Manager uses DNS servers to provide name resolution for the components in the system. When you update the DNS server configuration, SDDC Manager performs DNS configuration updates for the following components:
  • SDDC Manager
  • vCenter Servers
  • ESXi hosts
  • NSX Managers
  • NSX Edge nodes
  • vRealize Suite Lifecycle Manager
  • vRealize Log Insight
  • vRealize Operations
  • vRealize Automation
If the update fails, SDDC Manager rolls back the DNS settings for the failed component. Fix the underlying issue and retry the update starting with the failed component.
Note: There is no rollback for vRealize Suite Lifecycle Manager. Check the logs, resolve any issues, and retry the update.

Updating the DNS server configuration can take some time to complete, depending on the size of your environment. Schedule DNS updates at a time that minimizes the impact to the system users.

This procedure uses the VMware Cloud Foundation API using the Developer Center from within the SDDC Manager UI.

Prerequisites

  • Verify that both forward and reverse DNS resolution is functional for each VMware Cloud Foundation component using the updated DNS server information.
  • Verify that the new DNS server is reachable from each of the VMware Cloud Foundation components.
  • Verify all VMware Cloud Foundation components are reachable from SDDC Manager.
  • Verify that all VMware Cloud Foundation components are in an Active state.

Procedure

  1. In a text editor, create a JSON specification with the following content:
    {
        "dnsServers": [
            { "ipAddress": " IP of Primary DNS Server ", "isPrimary": true },
            { "ipAddress": " IP of Secondary DNS Server ", "isPrimary": false }
        ]
    }
  2. In the SDDC Manager UI, click Developer Center > API Explorer.
  3. Validate the DNS configuration JSON specification and ensure the system is healthy.
    1. Expand the APIs for managing DNS & NTP configuration section, and click POST /v1/system/dns-configuration/validations.
    2. In the dnsConfiguration text box, paste the contents of the JSON specification, and click Execute.
    3. In the Response section, click Validation to expand the task and copy the id.
    4. Expand the APIs for managing DNS & NTP configuration section, and click GET /v1/system/dns-configuration/validations.
    5. In the executeStatus text box, paste the validation id and click Execute.
    6. In the Response section, click Validation and verify that resultStatus states SUCCEEDED.

      If the resultStatus indicates that validation failed, expand validationChecks and review which component failed.

  4. Perform the DNS configuration using the validated JSON specification.
    1. Expand the APIs for managing DNS & NTP configuration section and click PUT /v1/system/dns-configuration.
    2. In the dnsConfiguration text box, paste the contents of the JSON specification and click Execute.
    3. On the Are you sure dialog, click Continue.