Chapter 14. debugging problems, The imageultra builder image-installation process – Lenovo ThinkPad SL300 User Manual
Page 189
Chapter 14. Debugging problems
Occasionally, you might have to debug problems during the test phase of your development process. This
chapter provides information about some of the debugging tools provided by the ImageUltra Builder program
and some best practices to follow to avoid some problems that are difficult to debug.
The ImageUltra Builder image-installation process
To debug a problem, you must have some level of understanding of the processes that take place during the
image-installation phase. All files referenced in this section are located either in the service partition of the
target computer, or, in the case of a direct-network installation, in the network-staging folder.
The AUTOEXEC.CMD file is the first program launched at the beginning of the image-installation phase
and acts as the master control program for all activities during the image-installation phase. Activities
include the following:
1. Establishing global variables and PATHs.
2. Controlling the installation menus. The Mapmenu program runs and processes the Before Menu
Options. Once the Before Menu items are complete, all of the menu items in the basemap are
displayed. Once a selection is made from the basemap, the Post Menu options are processed, and the
EXECUTE.CMD file is written into the IUTEMP directory.
3. Once the menu processing is complete, the EXECUTE.CMD file runs to process and queued utilities
from the basemap.
4. All of the selected modules are written into the AOD.DAT and the process installs all of the modules
in this file.
5. Customer-first-boot module processing. Upon the successful completion of the audit boot, the modules
in the \IUWORK folder are processed.
Finding debug data in the target computer user partition
During the image-installation process, the ImageUltra Builder program creates a MODULES.LOG file in the
\SWTOOLS folder of the target computer user partition. The MODULES.LOG provides a listing of each
module that installed successfully. If a problem occurs during installation, you can use this log to detect the
last module that installed successfully, and use that as a starting point for debugging.
Finding debug data in the service partition or network-staging folder
During the image-installation process, the ImageUltra program creates several logs in the IUTEMP folder of
staging area (service partition or network-staging folder). If an error occurs during the installation process,
the installation process is halted, an error message is posted, and you can exit from the installation process
and view the logs to determine where the error occurred.
The following is a listing of those logs:
• The IUTEMP\STAMP.LOG: log contains time-stamped entries for all activities performed in the staging area
To get to a command prompt, press and hold the Shift+Ctrl+C keys, and then click
Restart. To view the STAMP.LOG file, type the following at the command prompt: notepad
%BootDrive%/Recovery/IUB/IUTEMP/STAMP.LOG
If you are performing a standard network-deployment or deployment from CD, USB Key, or USB hard disk
drive, the debug data is located in the service partition of the target computer. The volume label of the
© Copyright Lenovo 2008, 2010
175