Logtool Reference: Step-by-Step procedures

• Running the Logtool Utility
• Viewing a Log
• Troubleshooting Disk Problems
• Troubleshooting Memory Problems

Running the Logtool Utility. To run the Logtool Utility:

1. If desired, change the options for the Logtool Utility at the main STM window. Options include the level of logging for the tool. For example, you might want Logtool to put error and warning messages into its Test Activity Log if it encounters problems during its operation. For more information, see online help for STM as a whole (use the Help menu in the STM main window).
2. Run the Logtool Utility. (Tools->Utility->Run->logtool)
3. To select the desired commands, use the pull-down menus in Logtool's main window. For more information, see:
   • Viewing a Log
   • Troubleshooting Disk Problems
   • Troubleshooting Memory Problems
   • Commands and Buttons
4. Information is displayed in the main window of Logtool or in pop-up windows.
5. If you run into problems, see the Troubleshooting Tool help topic.
6. Exit Logtool by selecting the Exit command from the File Menu.

Viewing a Log. Logtool offers many different ways to select log entries and view them. A typical method for viewing logs involves these steps:

1. Select a raw (unformatted) log file (Select Raw command in the File Menu). The current log file ends in ".cur", e.g., "log1.raw.cur". You do not have to switch logs in order to view the current log file. Once the file has been selected, the summary will be displayed automatically.
2. If the raw log summary indicates some entries relevant to your problem:
   1. Set up a format filter to select the types of entries you wish to see (Format command in the Filters Menu). To see all entries, skip this step.
   2. Format the raw log file (Format Raw command from the File Menu).
   3. Display the formatted log file (Formatted Log command in the View Menu).
3. If desired, you can further narrow the types of entries that are displayed:
   1. Set the formatted display filter to the appropriate values (Formatted command in the Filters->Display Menu.)

For example, you may have used a format filter that resulted in all entries from the SCSI disk driver being formatted. After viewing a summary of the formatted entries, you may decide that only entries for a particular device are of interest or, perhaps, only entries after a certain date and time. You could then set the formatted display filter to specify a specific device path or date and time and re-display the formatted log.

Troubleshooting Disk Problems. To troubleshoot a disk problem (sample procedure):

Follow the general procedure described in Viewing a Log, but specify disk-related parameters in any of the filters commands.

For example, activate the "Filter I/O Errors" radio button under the title "I/O Error Entries" and de-activate all the other checkboxes, such as the checkbox for "LVM Entries." Under "Products:", select only the relevant products (for example select "SCSI Disk" and not "LAN Interface").

Troubleshooting Memory Problems. To troubleshoot a suspected problem with memory (sample procedure):

The method for viewing the memory error log file involves these steps:

1. Select the Report Log command from the Memory Menu
2. To see the entire error log select the View Detail command in the Report Log Menu.
3. To see errors regarding deallocated pages only, select the ViewDealloc command in the Report Log Menu.

If most of the errors in the file indicate the same slot for the memory controller, then the SIMM module in that particular slot is probably bad.

If occasional errors report the same slot for the memory controller, then the SIMM module in that particular slot is suspect.

If the same bit number is indicated across many slots then the memory controller is bad.