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

Article ID: KB28744

Type: Support Content

Last Modified: 09-03-2013

 

Product(s) Affected:

  • BlackBerry Enterprise Server 5
  • BlackBerry Mobile Fusion Studio
  • BlackBerry Device Service
  • Universal Device Service
CollapseEnvironment
  • BlackBerry Enterprise Server 5.0 SP2 and 5.0 SP3
  • BlackBerry Mobile Fusion Studio
  • BlackBerry Device Service
  • Universal Device Service
  • Windows Server 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.exe to facilitate this; however, in Windows Server 2008, Userdump.exe is no longer supported.

The BlackBerry Controller can be configured to automatically use CDB.exe instead of Userdump.exe. This is performed through the Windows 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 (for example, C:\Program Files\Debugging Tools for Windows (x64) )
Path:

  • For 32-bit Windows ServerHKEY_LOCAL_MACHINE\Software\Research In Motion\BlackBerry Enterprise Server\Controller 
  • For 64-bit Windows ServerHKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\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.