Deobfuscate Obfuscate (verb): to confuse, bewilder, or stupefy.

BlackBerry Monitoring Console Service Wont Start With “service-specific error code 0″

At the time of this post the following BlackBerry KB is a draft and not available on their site. This problem occurs after applying service pack 1 which was the case with one of our clients.

Environment
BlackBerry Enterprise Server version 5.0
BlackBerry Monitoring Service version 5.0

Overview
After installing or upgrading to BlackBerry Monitoring Service 5.0, the BlackBerry Monitoring Console service will not start up.  When attempting to start the service the following error is observed:

The Tomcat logs for the BlackBerry Monitoring Service record the following entries:

[2009-12-13 13:22:06] [info] Procrun (2.0.3.0) started
[2009-12-13 13:22:06] [info] Running Service...
[2009-12-13 13:22:06] [info] Starting service...
[2009-12-13 13:22:06] [174  javajni.c] [error] The specified module could not be found.
[2009-12-13 13:22:06] [986  prunsrv.c] [error] Failed creating java \jre\bin\client\jvm.dll
[2009-12-13 13:22:06] [1260 prunsrv.c] [error] ServiceStart returned 1
[2009-12-13 13:22:06] [info] Run service finished.
[2009-12-13 13:22:06] [info] Procrun finished.

Typically, the BlackBerry Monitoring Service Tomcat logs are located in the following directory:

<drive>:\Program Files\Research In Motion\BlackBerry Enterprise Server\Monitoring Service\external\tomcat\logs

Cause
The Apache Tomcat process, which is required to run the BlackBerry Monitoring Service web page, is unable to access jvm.dll due to the incorrect path recorded in the Apache registry keys.

Resolution

1. Stop the all running BlackBerry Monitoring Services: Application Core, Data Collection Subsystem, and Polling Engine
2. Verify and notate the correct path where the jvm.dll file exists, typically "<drive>:\Program Files\Java\jdk1.6.0_15\jre\bin\client\jvm.dll"
3. Open the registry editor through Start > Run > regedit
4. Go to the Java registry key located under the Apache Software Foundation registry key:

HKEY_LOCAL_MACHINE\Software\Apache Software Foundation\Procrun 2.0\BBMonitoringConsole\Parameters\Java

HKEY_LOCAL_MACHINE\Software\Wow6432Node\Apache Software Foundation\Procrun 2.0\BBMonitoringConsole\Parameters\Java

5. Modify the Jvm value path of the jvm.dll file which was noted in step 2
6. Start all the BlackBerry Monitoring Services up and verify each service remains started
7. The BlackBerry Monitoring Console web page is now accessible