How do I use adplus to capture a Windows process dump to troubleshoot FileNet P8 and Image Services (IS) issues?
Often Engineering requests a process dump of a process that is hung or appears to be hung, or a crash dump when the software fails. On a Windows server you can capture such a dump using the adplus tool that is included in the “Debugging Tools for Windows” package from Microsoft.
Install the adplus tool as described on the Microsoft “Debugging Tools for Windows” download website.
To use adplus, you must run it from the folder where adplus is located, include the adplus path name in your PATH, or specify the full path name when running the tool.
To capture a dump of a hung process: Once the hung process has been identified, collect the process dump by entering one of the following types of commands:
cscript adplus.vbs -hang -pn <process_name>.exe -o <output_directory>
In this example, the –pn option is used to indicate the name of the hung process. For example, to dump the “VWJs.exe” processes:
cscript adplus.vbs -hang -pn VWJs.exe -o c:\temp\VWJS_dump.txt
Alternatively, the PID (process ID number) can be used:
cscript adplus.vbs -hang –p <PID#> -o <output_directory>
For example, if the hung PID is 6144, enter:
cscript adplus.vbs -hang -p 6144 -o c:\temp\\dump_6144.out
If time permits, repeat these commands two or three more times, specifying a different output directory for each run. The additional collections will show if the process is truly hung or just processing very slowly.
To capture a dump on a crash condition: If a specific process is crashing, the following commands can be used to force a dump at the time of failure. The adplus command must be executed prior to the failure, so that the crash will automatically trigger the dump. For example:
cscript adplus -quiet -crash -pn <process_name>.exe -nodumponfirst -ctcf -o <output_directory> -y c:\winnt\symbols
The above command allows First Chance Exceptions to be logged without forcing a dump.
However, the following command will force a dump on any exception:
cscript adplus -crash -pn <process_name>.exe -ctcf -o <output_directory> -y c:\winnt\symbols
Data to collect: All files in the output directory specified on the adplus command. Include a description of how the dump was captured and any known circumstances leading up to the issue. Also provide the Application and System Event Logs, and document the time at which the issue occurred.
For more information: See the Microsoft website.
|Enterprise Content Management||FileNet P8 Platform||Application Engine||Windows||3.5|
|Enterprise Content Management||FileNet P8 Platform||Process Engine||Windows||3.5|
|Enterprise Content Management||FileNet Image Services||Windows||4.1.2, 4.1.1, 4.1, 4.0, 3.6.10, 3.6, 3.5|
|Enterprise Content Management||FileNet Content Federation Services||Windows||4.1, 4.0, 3.6, 3.5.1, 3.5|