What does Windows error code 8221 (ERROR_PROMOTION_ACTIVE) mean?

 
Previous Next
ERROR_POLICY_ONLY_IN_DS ERROR_NO_PROMOTION_ACTIVE

ERROR_PROMOTION_ACTIVE

A domain controller promotion is currently active.

ERROR_PROMOTION_ACTIVE is Win32 error 8221 (0x0000201D) and concerns a domain-controller promotion already in progress.

What to verify

Verify whether only one promotion workflow owns the server role transition and its directory changes at a time. Check promotion process and stage, Server Manager or deployment logs, and reboot-pending state.

Likely causes

  • a second promotion request was submitted.
  • an earlier promotion is still running.
  • automation lost track of the active workflow.
  • reboot-pending promotion state remains.

Troubleshooting steps

  1. Collect promotion process and stage.
  2. Record Server Manager or deployment logs.

Handling, retry, and recovery

Allow the active promotion to finish or fail, collect its result, and resume through the supported deployment workflow instead of starting another promotion.

Related errors

ERROR_NO_PROMOTION_ACTIVE is returned when an operation requires an active promotion but none exists

Example

An orchestrator times out while promotion continues in the background and attempts to start it again. Querying deployment state prevents the duplicate role transition.

References


Looking for a different code? Search another status or error code.