
	Applies To

	Product(s):	APM Implementation and Performance Management
	Version(s):	All versions prior to 25.0.0
	Environment:	N/A
	Area:	N/A
	Subarea:	N/A
	Original Author:	Giselle Crawford

This installation requires .Net 4.0 and higher.

ADPlus 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:

Windows 8.1 and Windows Server 2012 R2
Windows 8 and Windows Server 2012
Windows 7 and Windows Server 2008 R2
Windows 10 and Windows Server 2016

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.

After installation, ADPlus must be activated on the server. Before changing the settings, you will need to stop the instance that you are changing or the settings may not be saved.

Open the Ivara Server Settings Editor for the server instance to be set up with ADPlus.

Select the File menu, and then the Show Advanced Settings option.
In the Settings tree, select the Diagnostics node.
In the Process Dumps section:

Set “Adplus (x64) file path”, similar to the following: “C:\Program Files\Debugging Tools for Windows (x64)\adplus.exe” or “C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\adplus.exe”
Set “Monitor Process On Startup” to True.
Restart the server(s).

After restarting the server, you should see “Dumps” folder in the Default Log Directory (e.g., C:\ProgramData\Bentley\IvaraEXP\Logs\dumps”. In this folder you should find one or more folders for each server instance. Each server instance folder will have a “Crash_Mode” folder created each time the server is started. The folder is time-stamped with the start date and time, and suffixed with “_Crash_Mode”. When first-chance and second-chance exceptions occur, memory dumps will be written to these folders.

For each client crash and/or server crash, we will need the ADPlus folder that matches the server instance start date, which is typically the most recent folder. ã€€The easiest means to get the dumps to us is to zip the folder to include all its contents, and upload it to the customer folder on our FTP site. We also need the server log files. For client crashes, we also need the client log files. These can also be uploaded to the FTP site.

NOTE: If the memory dumps are harvested after the server is restarted, the most recent “Crash_Mode” folder will be for the currently running instance, and the folder we need would then be the second most-recent folder.

Installing ADPlus

This installation requires .Net 4.0 and higher.

See Also