3.2.4.3 Upgrade
Upgrade is the act of promotion using values suggested from a previously existing source.<11> No upgrade-specific constraints are applied to these values; for example, the NetBIOS name of the new domain is not required to match that of a legacy domain. An implementation can choose any specific values as part of promotion as long as the result satisfies the abstract state required of a domain controller's existence as described in [MS-ADTS] section 6.1.2.1.
When the upgrade event begins:
A promotion event MUST be triggered.
ComputerUpgrade MUST be set to TRUE.
PreviousServerState MUST be set to DsRoleServerPrimary if it is promoting the first domain controller in the domain; otherwise, PreviousServerState MUST be set to DsRoleServerBackup. Note that if this event is promoting the first domain controller in the domain, after promotion ComputerRole will be set to DsRole_RolePrimaryDomainController; otherwise, after promotion ComputerRole will be set to DsRole_RoleBackupDomainController.
The upgrade event is complete when the triggered promotion event is complete. When the upgrade event is complete:
ComputerUpgrade MUST be set to FALSE.
PreviousServerState MUST be set to DsRoleServerUnknown.
The operation or set of operations that constitute upgrade are server-to-server operations and are not included in this document; they are not required for interoperation with clients.