BlackBerry Performance Monitor Counters are missing on Windows 64-bit Servers

Article ID: KB21534

Type: Support Content

Last Modified: 04-26-2012

 

Product(s) Affected:

  • BlackBerry Enterprise Server for Microsoft Exchange
  • BlackBerry Enterprise Server for IBM Domino
  • BlackBerry Enterprise Server for Novell GroupWise
CollapseEnvironment
  • BlackBerry® Enterprise Server 5.0 SP2 to SP3
  • Windows Server® 2003 64-bit
  • Windows Server® 2008 64-bit
  • Windows Server® 2008 R2 64-bit
  • DT 450279
  • DT 525515
  • DT 508561
  • DT 3562704
  • DT 1841401
CollapseOverview

BlackBerry® Performance Monitor (PerfMon) counters are not listed as available counters.

CollapseResolution

This is a previously reported issue that is being investigated by our development team. No resolution time frame is currently available.

CollapseWorkaround

The following factors are required to be considered so that the BlackBerry Performance Monitor counters will appear in PerfMon, using the workaround as stated below:

  • The BlackBerry Router and BlackBerry Controller services are started on the BlackBerry Enterprise Server
  • The Windows Management Instrumentation Service and WMI Performance Adapter Service are started on the BlackBerry Enterprise Server
  • A minimum of one BlackBerry smartphone user is required to be activated and running on the BlackBerry Enterprise Server
  • The BlackBerry Enterprise Server is not configured to connect directly to a Remote BlackBerry Router as the local BlackBerry Router is required to connected to the BlackBerry Enterprise Server, in order for the BlackBerry PerfMon counters to appear in PerfMon. If the BlackBerry Enterprise Server is required to connect to a Remote BlackBerry Router in the DMZ, use router chaining configuration as a workaround.

To manually resolve this issue, please complete the following steps:

  1. Open a command prompt with administrator privileges and navigate to the \tools\WMI folder from the BlackBerry Enterprise Server installer files (typically located at C:\Research In Motion\BlackBerry Enterprise Server <version> ).
  2. Run the following commands to unregister the existing counters and copy the needed files into the destination directory. Leave this window open when finished, as it will be used in a later step.

    Note: If the BlackBerry Enterprise Server is installed to a non-default directory, replace all instances of C:\Program Files (x86)\Research In Motion\BlackBerry Enterprise Server\ with the correct installation path.

    regsvr32 /U "C:\Program Files (x86)\Research In Motion\BlackBerry Enterprise Server\AgentPerfSession.dll"
    regsvr32 /U "C:\Program Files (x86)\Research In Motion\BlackBerry Enterprise Server\BypassRouter\RouterPerfClient.dll"
    regsvr32 /U "C:\Program Files (x86)\Research In Motion\BlackBerry Enterprise Server\BypassRouter\RouterPerfSession.dll"
    mkdir "C:\Program Files\Research In Motion\BlackBerry Enterprise Server\BypassRouter"
    copy AgentWMIPerf.mof "C:\Program Files\Research In Motion\BlackBerry Enterprise Server"
    copy "C:\Program Files (x86)\Research In Motion\BlackBerry Enterprise Server\BypassRouter\RouterClientPerf.mof" "C:\Program Files\Research In Motion\BlackBerry Enterprise Server\BypassRouter"
    copy "C:\Program Files (x86)\Research In Motion\BlackBerry Enterprise Server\BypassRouter\RouterSessionPerf.mof" "C:\Program Files\Research In Motion\BlackBerry Enterprise Server\BypassRouter"
    copy x64\AgentPerfSession.dll "C:\Program Files\Research In Motion\BlackBerry Enterprise Server"
    copy x64\RouterPerfClient.dll "C:\Program Files\Research In Motion\BlackBerry Enterprise Server\BypassRouter"
    copy x64\RouterPerfSession.dll "C:\Program Files\Research In Motion\BlackBerry Enterprise Server\BypassRouter"

  3. Open Windows Explorer and confirm that the following files are present:

    C:\Program Files\Research In Motion\BlackBerry Enterprise Server\AgentPerfSession.dll
    C:\Program Files\Research In Motion\BlackBerry Enterprise Server\AgentWMIPerf.mof

    C:\Program Files\Research In Motion\BlackBerry Enterprise Server\BypassRouter\RouterPerfClient.dll
    C:\Program Files\Research In Motion\BlackBerry Enterprise Server\BypassRouter\RouterPerfSession.dll
    C:\Program Files\Research In Motion\BlackBerry Enterprise Server\BypassRouter\RouterClientPerf.mof
    C:\Program Files\Research In Motion\BlackBerry Enterprise Server\BypassRouter\RouterSessionPerf.mof

  4. In the command prompt window from Step 1, run the following commands to register the new files:

    regsvr32 "C:\Program Files\Research In Motion\BlackBerry Enterprise Server\AgentPerfSession.dll"
    regsvr32 "C:\Program Files\Research In Motion\BlackBerry Enterprise Server\BypassRouter\RouterPerfClient.dll"
    regsvr32 "C:\Program Files\Research In Motion\BlackBerry Enterprise Server\BypassRouter\RouterPerfSession.dll"
    mofcomp.exe "C:\Program Files\Research In Motion\BlackBerry Enterprise Server\AgentWMIPerf.mof"
    mofcomp.exe "C:\Program Files\Research In Motion\BlackBerry Enterprise Server\BypassRouter\RouterClientPerf.mof"
    mofcomp.exe "C:\Program Files\Research In Motion\BlackBerry Enterprise Server\BypassRouter\RouterSessionPerf.mof"

  5. Restart the server.

    Important: Restarting the BlackBerry Enterprise Server or its services may delay message delivery to BlackBerry smartphones.

The new counters for the BlackBerry Enterprise Server can be accessed via PerfMon.

CollapseAdditional Information

If the steps above do not provide the performance counters, take ownership of the sysWOW64 (c:\windows\sysWOW64 ) folder and give the service account full rights.

Note: RouterClientPerf.mof and RouterSessionPerf.mof are created in C:\Program Files (x86)\Research In Motion\BlackBerry Enterprise Server\ByPassRouter as part of the installation of Blackberry Enterprise Server 5.0 SP3. For installations of other versions of Blackberry Enterprise Server software, these files are attached below.

The counters added by this process are as follows:

BlackBerry Router

These counters monitor the state of the active connections for the BlackBerry Router to BlackBerry smartphones via Wi-Fi or serial bypass.

  • Device Bypass Received Messages
  • Device Bypass Sent Messages
  • Device Connections
  • Router Work Queue Size
  • Service Connections

BlackBerry Router Service Sessions

These counters monitor the traffic along the active connections for the BlackBerry Router to BlackBerry smartphones via Wi-Fi or serial bypass, as well as traffic to and from the BlackBerry Infrastructure.

  • Bypass Messages Received
  • Messages Sent To Bypass
  • Messages Sent To Relay
  • Relay Messages Received

BlackBerry Server

These counters monitor the BlackBerry Enterprise Server Messaging Agents.

  • Connection State
  • Messages Expired
  • Messages Filtered
  • Messages Queued For Delivery
  • Messages Received
  • Messages Received/min
  • Messages Sent
  • Messages Sent/min
CollapseAttachments

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.