Skip to main content

August 21, 2026

Detecting and Resolving LDAP Entry and Schema Collisions Using the -X Option

You can use the vdmadmin command with the -X option to detect and resolve LDAP entry collisions and LDAP schema collisions on replicated Connection Server instances in a group. You can also use this option to detect and resolve LDAP schema collisions in a Cloud Pod Architecture environment.

Syntax

vdmadmin -X [-b authentication_arguments] -collisions [-resolve]
vdmadmin -X [-b authentication_arguments] -schemacollisions [-resolve] [-global]
vdmadmin -X [-b authentication_arguments] -seizeSchemaMaster
vdmadmin -X [-b authentication_arguments] -seizeSchemaMaster [-global]

Usage Notes

Duplicate LDAP entries on two or more Connection Server instances can cause problems with the integrity of LDAP data in Horizon 8. This condition can occur during an upgrade, while LDAP replication is inoperative. Although Horizon 8 checks for this error condition at regular intervals, you can run the vdmadmin command on one of the Connection Server instances in the group to detect and resolve LDAP entry collisions manually.

LDAP schema collisions can also occur during an upgrade, while LDAP replication is inoperative. Because Horizon 8 does not check for this error condition, you must run the vdmadmin command to detect and resolve LDAP schema collisions manually.

Options

The following table shows the options that you can specify to detect and resolve LDAP entry collisions.

Options for Detecting and Resolving LDAP Entry Collisions

OptionDescription
-collisionsSpecifies an operation for detecting LDAP entry collisions in a Connection Server group.
-resolveResolves all LDAP collisions in the LDAP instance. If you do not specify this option, the command only lists the problems that it finds.

The following table shows the options that you can specify to detect and resolve LDAP schema collisions.

Options for Detecting and Resolving LDAP Schema Collisions

OptionDescription
-schemacollisionsSpecifies an operation for detecting LDAP schema collisions in a Connection Server group or Cloud Pod Architecture environment.
-resolveResolves all LDAP schema collisions in the LDAP instance. If you do not specify this option, the command only lists the problems that it finds.
-globalApplies the checks and fixes to the global LDAP instance in a Cloud Pod Architecture environment. If you do not specify this option, the checks are run against the local LDAP instance.
  

The following table shows the options that you can specify to resolve LDAP schema master issues.

Options for Resolving LDAP Schema Master Issues

OptionDescription
-seizeSchemaMasterMakes the current node the schema master node on the cluster.
-globalThe schema role is seized on the global Horizon LDAP instance in a Cloud Pod Architecture environment. If you do not specify this option, the schema role is seized on the local Horizon LDAP instance.

Examples

Detect LDAP entry collisions in a Connection Server group.

vdmadmin -X -collisions

Detect and resolve LDAP entry collisions in the local LDAP instance.

vdmadmin -X -collisions -resolve

Detect and resolve LDAP schema collisions in the global LDAP instance.

vdmadmin -X -schemacollisions -resolve -global

Make the current node the schema master node on the cluster for a local LDAP instance.

vdmadmin -X -seizeSchemaMaster

Make the current node the schema master node on the cluster for a global LDAP instance in a Cloud Pod Architecture environment.

vdmadmin -X -seizeSchemaMaster -global

Was this page helpful?

Provide feedback for this topic

Was this topic helpful?

Please do not include any personal or confidential information.

Generating link…