How to setup Adplus to monitor APM processes


  Product(s): APM Implementation and Performance Management  
  Version(s): All versions prior to APM 25.0  
  Environment: N\A  
  Area: N/A  
  Subarea: N\A  

 

Set-up Adplus manually to get crash dumps on APM server, clients, or scheduled actions that crash during processing.
This is for temporary monitoring only, do not setup unless requested by the Support team as part of troubleshooting a crash of a scheduled action as it seems to take up quite a bit of CPU while monitoring.
Prerequisites
.Net 4.0 and later
Install AdPlus. 

(ADPlus is a component in Microsoft’s “Debugging Tools for Windows” module,  the “Microsoft Windows SDK for Windows x  and .NET Framework ” package.   Search for the appropriate version of the tool in the Microsoft download center.)

Which version to download and install?  The following is a guide to client and server operating system pairs: 

When installing, only the “Debugging Tools for Windows” module is necessary.

Both a 32-bit version and a 64-bit version will be installed. Only the 64-bit version is needed for server dumps.

Set up
  1. Create a folder C:\adplus
  2. Find the adplus.config file in the Bin folder of the APM installation. ie C:\Program Files\Bentley\AssetWise Performance Management\bin\adplus.config
  3. Copy adplus.config file to c:\adplus folder
Run
1.      In a Command line window, change directory to the x64 Adplus install directory

Eg cd c:\program files\debugging tools for windows (x64)
2.      Enter the following command:
adplus.exe -crash -o C:\adplus -c C:\adplus\adplus.config -pmn SimpleMethodInvoker.exe
or,
adplus.exe -crash -o C:\adplus -c C:\adplus\adplus.config -pmn IvaraClient.exe
or,
adplus.exe -crash -o C:\adplus -c C:\adplus\adplus.config -pmn IvaraServer.exe
3.      Leave the Command window open for the duration of the monitoring.
4.      When monitoring is done, press Enter to stop the monitoring.
Results
A date_time_crash_mode folder will be created in c:\adplus.  A full memory dump will be generated into this folder when a crash occurs.

 

  Original Author: Giselle Crawford