Installing the Debug Kernel

If you use the OS/2 Developer's toolkit to install the debug kernel then the installation is perfomed automatically using the supplied DBGINST command. If you choose to install the debug kernel manually then perform the following steps:

• Copy the debug kernel (OS2KRNLD or OS2KRNLB) to the root directory of the boot drive.

• Copy the symbol files into the same directories as their corresponding load modules. Usually system symbol files are distributed on a diskettes that have the same directory structure as OS/2 system code. This conveniently allows the UNPACK command to be used to copy all symbols files in one operation (per diskette).

• Unhide the RETAIL kernel module using the following command:

              ATTRIB -r -s -h OS2KRNL
  

• Rename the RETAIL kernel to something unique, e.g OS2KRNLR

• Rename the ALLSTRICT or HSTRICT kernel to OS2KRNL. There is no need to hide or make the replaced kernel read-only, unless you wish to protect yourself against accidents!

The MUT is now ready to use in debug mode as soon as it is re-booted. Before that happens the debug console needs to be set up.

Note:

It is possible to run the MUT with the debug kernel installed without setting up the debug console. This particularly useful when diagnosing pervasive problems. If the COM port settings are correct when the problem reoccurs then the debug consol may be connected at that time.