Microsoft KB Archive/814167

= Description of the “Restore in Progress” Registry Key in Active Directory =

Article ID: 814167

Article Last Modified on 2/28/2007

-

APPLIES TO


 * Microsoft Windows 2000 Server
 * Microsoft Windows 2000 Advanced Server
 * Microsoft Windows 2000 Datacenter Server

-





SUMMARY
This article describes the registry values for the   registry key that is created when you restore Active Directory on a Windows 2000 Server-based computer.

Note The log file, drive letter, and registry data entries in this article are for example purposes only and may differ on your computer.



MORE INFORMATION
The following registry key indicates that a restore operation is in progress and is awaiting information:

 

The following parameters are used by this registry subkey:  The following registry value displays the path where the backup program has stored the Edb*.log files from the backup media.

Note Typically, this is the same path as used in the   registry value in the   subkey:

Value name: BackupLogPath

Value data:  

Value type: REG_SZ

 The following registry value indicates the location where the checkpoint file (Edb.chk) is stored:

Value name: CheckpointFilePath

Value data:  

Value type: REG_SZ

 The following registry value displays the roll forward log file path. Rolling forward is the process where uncommitted transactions from the transaction log files are committed to the database. Active Directory performs circular logging so you cannot roll forward with incremental backups that are made up of only log files. Typically, the backup program sets this path to the same as that specified in the BackupLogPath value:

Value name: LogPath

Value data:  

Value type: REG_SZ

 The following registry value indicates if the actual database restore operation has occurred:

Value name: NTDS Database recovered

Value data: 00 (hexadecimal)

Value type: REG_BINARY

 The following registry value specifies the lowest-numbered log file from the Edb*.log transaction log files that were previously backed up:

Value name: LowLog Number

Value data:  

Value type: REG_DWORD

 The following registry value specifies the highest-numbered log file from the Edb*.log transaction log files that were previously backed up:

Value name: HighLog Number

Value data:  

Value type: REG_DWORD

 The following two registry values make up the restore map. The restore map has two parts, a number of entries specified by the   registry value, and the actual map specified by the   registry value. In Active Directory, the size always has a value of 1 because there is only one Active Directory database. On a Microsoft Exchange computer, the value may be more because there may be more than one database file:

Value name: NTDS_RstMap Size

Value data: 1

Value type: REG_DWORD

Each entry in the restore map is made up of two multi-string entries that go together. Consider the following entry:

\\ServerName\C$\WINNT\NTDS\ntds.dit\0 \\ServerName\C$\WINNT\NTDS\ntds.dit\0

Note A multi-string is a set of null-terminated strings terminated with another NUL character at the end (it is double-NUL terminated). This map is a mapping of the database location at the time of the backup to the database location as it is being restored to the hard disk. A particular entry in the restore map for Active Directory always has the same values as that taken during backup. The database is never moved to a new location during a restore operation because the Windows registry is also being restored. To restate this, the database must be restored to its original location.

Value name: NTDS_RstMap

Value data: (hexadecimal) 

Value type: REG_MULTI_SZ

</li></ul>

Active Directory stores other configuration information in the following registry subkey:

 

The following registry values are used in this registry key: <ul> The following registry value displays the path that is passed to the Jet database engine. This is where the Jet database stores the Edb.chk file:

Value name: DSA Working Directory

Value data:  

Value type: REG_SZ

</li> The following registry value indicates the location of the Active Directory database file. This file is not sufficient to perform a recovery or restore of Active Directory. You also require the checkpoint file and the transaction log files so the database engine can maintain a consistent database during a recovery or restore operation:

Value name: DSA Database file

Value data:  

Value type: REG_SZ

</li> The following registry value indicates the location of the transaction log files:

Value name: Database log files path

Value data:  

Value type: REG_SZ

</li> The following registry value determines if the database engine performs logging. Microsoft recommends that you do not turn off logging or change this value. You can use the logging function to troubleshoot issues that you may experience during a recovery or restore operation:

Value name: Database logging/recovery

Value data: ON(default)

Value type: REG_SZ

</li> The following registry value stores a GUID for each non-removable volume in the computer. During initialization, the GUIDs are recorded as the drives are mapped and all paths are determined. When this process is complete, the Jet database starts:

Value name: DS Drive Mappings

Value data: (hexadecimal) 

Value type: REG_MULTI_SZ

</li> The following registry value is entered in the registry by the restore process. It is the new database GUID to be used as the new invocation ID during the Active Directory restore operation:

Value name: New Database GUID

Value data:  

Value type: REG_SZ

</li></ul>

<div class="moreinformation_section">

For more information about related topics, click the following article numbers to view the articles in the Microsoft Knowledge Base:

216993 Useful shelf life of a system-state backup of Active Directory

200941 XADM: How the Restore in Progress registry key works

Keywords: kbinfo KB814167

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.