The following are a selection of general tips on troubleshooting SysDiff.
SysDiff uses the Windows error numbering
system to report problems. To determine the meaning of a SysDiff
error message, that is, to translate the error number into a message, switch to the
NET HELPMSG <number>
where <number> is the number of the SysDiff error message.
For example, SysDiff stops responding and the following error message appears:
ERROR MESSAGE: SYSTEM ERROR 5
When you type
NET HELPMSG 5
at the
Access is denied.
When you use this same method to decode the error message "SYSTEM ERROR 32," the following information appears:
The process cannot access the file because it is being used by another process.
In this way, you can decode the meaning of the error numbers.
There are many causes for this error message. It is not the purpose of this article to try to catalog all of them. This article shows you how to determine exactly where the apply command is failing and explains some general reasons for such failures.
The .inf file is created by the sysdiff /inf /m command and is placed in the $OEM$ directory. This file contains changes that are to be made to the registry. It also tells you the version of SysDiff that was used to create it, the system root directory and the total diff count.
The .inf file is executed sequentially, from the bottom up. To determine where it has failed, it is necessary to open the file in a text editor (such as Notepad) beside the registry editor. Each line of the file, following the [AddReg] section heading, represents a single change to the registry. These are abbreviated; HKCR stands for HKEY_CLASSES_ROOT, HKLM stands for HKEY_LOCAL_MACHINE, and so on.
Instead of starting at the bottom and working your way up, it might be better to start at the middle and work your way out. Look at the line in the .inf file and check the registry to see if that line was written. If it was, move to the halfway mark between there and the end of the file until you find a line that was not written. From there, locate the last line that was written; this will show you the last thing SysDiff successfully wrote to the registry.
When SysDiff encounters an entry that it cannot write, it stops writing from that point forward and reports an error message that tells you that the installation failed. SysDiff will then prompt you to continue. SysDiff will continue, but all entries from that point forward are not written. Changes that are made to .ini files are included in the [updateinis] section near the end of the .inf file. If you suspect the problem is in updating .ini files, comment out this section and see if SysDiff will continue.
Debugging .inf files can be a time-consuming process. It is not, however, necessary to do a full SysDiff /apply command to test it each time you comment something out. Because all the Cmdlines.txt is doing is reading the .inf file and writing each entry, you can configure it to do only that:
Copy Cmdlines.txt and the .inf file from the $oem$ directory to the local Windows 2000 installation.
Copy Cmdlines.txt to a *.bat file (like Go.bat).
Open the *.bat file in a text editor (such as Notepad), delete the [Commands] heading and remove the quotation marks and save the changes.
Carry out the go.bat.
The above procedure is much faster than doing a full SysDiff /apply to debug an error in the .inf file.
Note
Make certain that the \%WinDir%\System32 is in the environment path.
Important
Make certain that you do this to a computer that has already failed in the installation. The main reason for verifying that this is done to a failed installation as opposed to a clean install is that if the application directories and .ini files do not exist, SysDiff will always return an error when it tries to write to files that are not there.
Things that cause an .inf file to fail include:
One of the problems with creating the snapshot, diff, and .inf file over the network is network problems or bottlenecks. The diff file contains an image of all of the files that have been added since the image file was created. Creating this large a file over a network connection can leave you wide open for data corruption.
A corrupted diff file may be the cause when you do everything right, and you verify the integrity of the .inf file (using the Go.bat procedure outlined above) but the apply still fails. Diff files are huge. If there are any network bottlenecks at all, it is easy for these files to become corrupted. To resolve this, try the following: