VCF Diagnostic Tool for vSphere (VDT) reports failure for vmdird domain functional level (DFL) check
search cancel

VCF Diagnostic Tool for vSphere (VDT) reports failure for vmdird domain functional level (DFL) check

book

Article ID: 414645

calendar_today

Updated On:

Products

VMware vCenter Server

Issue/Introduction

  • Running the vSphere Diagnostic Tool (VDT) on a vCenter Server reports a failure during the vmdir domain-functional-level (DFL) check.

     [FAIL]    VMdir DFL Check

                            VMDIR Domain Functional Level is incorrect!

  • DFL value of vCenter server is set to 1, which can be retrieved with the following command.

    # /usr/lib/vmware-vmafd/bin/dir-cli domain-functional-level get

Environment

  • VMware vCenter Server 7.x
  • VMware vCenter Server 8.x

Cause

  • The failure is rooted in a discrepancy between the DFL value stored in the vmdir and the value expected by the current version of vCenter Server. Specifically, this issue impacts vCenter Servers that have been upgraded from older versions, such as vCenter Server 6.5.
    • After upgrading from vCenter server version 6.5, which used a DFL of 1, the vmdir can incorrectly retain this value.
    • For vCenter Server 7.0 and later, the expected DFL is 4.

Resolution

Note: Take a Snapshot of the vCenter Server Appliance before proceeding with the steps below. If the vCenter Server is part of ELM, take offline snapshots of all the vCenter Server which is part of ELM. Please refer to Snapshot Best practices for vCenter Server Virtual Machines.

  1. Set the DFL of the affected node to 4 with the following command.

    /usr/lib/vmware-vmafd/bin/dir-cli domain-functional-level set --level 4 --login [email protected] --domain-name vsphere.local

    Note: Update vsphere.local to match current SSO domain name.

  2. Restart the vmdir service on all linked vCenter nodes.

service-control --restart vmdird

Note: Restart vmdir on all nodes only after updating the DFL of all the nodes in the ELM topology. Otherwise, vmdir will fail to start on the nodes which have a higher DFL than their partners.

Additional Information

Powered by Wolken Software