How to configure the BlackBerry Controller to automatically use "CDB.exe", an alternative to Userdump

Article ID: KB28744

Type: Support Content

Last Modified: 11-20-2012

 

Product(s) Affected:

  • BlackBerry Enterprise Server
CollapseEnvironment
  • BlackBerry Enterprise Server 5.0 SP2 and 5.0 SP3
  • Microsoft Windows 2008
CollapseOverview

The BlackBerry Controller can automatically use a debugger to produce a dump file when troubleshooting issues that require debugging. By default the BlackBerry Controller uses Userdump to facilitate this, however in Windows 2008 Userdump is no longer supported.

The BlackBerry Controller can be configured to automatically use CDB.exe instead of Userdump. This is performed through the registry.

Warning: The following procedure involves modifying the computer registry. This can cause substantial damage to the Windows operating system. Document and back up the registry entries prior to implementing any changes.

Add the following registry key:

Name: CDBPath
Type: String
Value: CDB installation path (i.e. C:\Program Files\Debugging Tools for Windows (x64) )
Path: HKEY_LOCAL_MACHINE\Software\Research In Motion\BlackBerry Enterprise Server\Controller

Note: The BlackBerry Controller must be restarted for the changes to take affect. This will perform a restart of the BlackBerry Messaging Agents and disrupt mailflow.

Once the registry key is configured the following log line will be seen in the BlackBerry Controller log:

[30000] (01/27 00:00:01.670):{0x1330} [CFG] Controller will generate max 3 userdump files per day using cdb.exe

CollapseAdditional Information

CDB.exe is leveraged by debugging applications such as ADPlus, DebugDiag and WinDBG.

Disclaimer

By downloading, accessing or otherwise using the Knowledge Base documents you agree:

   (a) that the terms of use for the documents found at www.blackberry.com/legal/knowledgebase apply to your use or reference to these documents; and

   (b) not to copy, distribute, disclose or reproduce, in full or in part any of the documents without the express written consent of RIM.


Visit the BlackBerry Technical Solution Center at www.blackberry.com/btsc.