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.