The Dr. Watson tool supplied with Windows must be configured to save the proper information. This setup step must be performed prior to saving the hang documentation.
AFPA must be disabled and IBM HTTP Server restarted in order to collect some of the information below. You must be aware of whether or not AFPA is enabled in the web server configuration file before gathering the hang information. We recommend that AFPA be disabled in advance if the hang is reproducible so that the best set of information is available for analysis.
These steps must be performed at the time of the hang
Press OK, then select the Processes tab, then press Image Name to sort the list of processes by name. Find the two Apache.exe processes.
The Apache.exe process with the larger number of threads (52 threads in the example above) is the IHS child process. Make a note of the associated PID (PID 2244 in the example above) for the IHS child process. It will be used later.
With the Task Manager window selected, press
<Alt><PrtSc>
to save an image of the window
to the clipboard.
Run the Windows Wordpad program and paste the image of the Task Manager window into the new file. Save it as taskmgr.doc or taskmgr.rtf.
You must skip this step if AFPA is enabled.
Note: On Win2000, this step will terminate the IBM HTTP Server child process when it completes. But this information is critical for determining the cause of the hang. |
Run DRWTSN32.EXE -p CHILDPID
to create Dr. Watson log
and crash files representing the current state of the web server.
Replace CHILDPID with the IHS child process PID, as found in
the previous step from the Task Manager display.
If a dialog box appears stating that an error log is being created, don't press Cancel. Instead, wait for the text of the button to change to OK. Then press OK.
The Dr. Watson files can now be found in the locations configured in the DRWTSN32.EXE program, as displayed above under System preparation. Example:
C:\Documents and Settings\All Users\Documents\DrWatson>dir Volume in drive C is C_Drive Volume Serial Number is 98E7-6D3C Directory of C:\Documents and Settings\All Users\Documents\DrWatson 08/05/2003 09:32a <DIR> . 08/05/2003 09:32a <DIR> 04/05/2005 03:48p 1,118,951 drwtsn32.log 04/05/2005 03:49p 12,969,444 user.dmp 2 File(s) 14,088,395 bytes 2 Dir(s) 18,162,450,432 bytes free
The files drwtsn32.log and user.dmp are the files to save.
Please ensure that "ExtendedStatus On" is enabled in the web server configuration file.
From a web browser, request
http://www.example.com/server-status/?showmodule
from a web
browser. (Replace www.example.com with your web server
address.) If the web server is completely hung, it may not respond.
Otherwise, save the server status report to a file.
Run netstat -an > netstat.txt
to save TCP connection
information.
Run ipconfig /all >ipconfig.txt
to save information
about the network configuration.
Use the System and web server
information tool to gather this information. This will result in
a directory of information called
ServerConfig.timestamp
, which should then be
zipped.
The default file is
install_root\conf\httpd.conf
The default file is
install_root\logs\error.log
The configuration file may have been changed to specify a different error log.
The actual location is specified in plugin-cfg.xml
and
is generated by configuring LogLevel="Trace"
.
Example:
c:\WebSphere\AppServer\logs\http_plugin.log
Run Start/Programs/Accessories/System Tools/System Information.
If the top level in the tree on the left says "System Information", then highlight the top level "System Information" selection, right mouse click, select "Save as Text File", enter "system_info" for the filename to save as, and then "Save" (this may take a few minutes):
If the top level in the tree on the left says "System Summary", then highlight the top level "System Summary" selection, select File/Export... from the menu, enter "system_info" for the filename to save as, and then "Save" (this may take a few minutes):
taskmgr.doc
or taskmgr.rtf
netstat.txt
ipconfig.txt
ihs_version.txt
system_info.txt
by the System Information program