How to enable Verbose HTTP and IPPP logging for the BlackBerry MDS Connection Service

Article ID: KB02393

Type: Support Content

Last Modified: 09-16-2013

 

Product(s) Affected:

  • BlackBerry Enterprise Server 5
Jump to: Environment | Overview
CollapseEnvironment
  • BlackBerry Enterprise Server 2.2 to 5.0 SP4
  • BlackBerry MDS Connection Service
CollapseOverview

Turning on Hypertext Transfer Protocol (HTTP) logging for the BlackBerry Mobile Data System Connection Service has the following benefits:

  • Defines HTTP content formatting and related HTTP status codes
  • Helps to troubleshoot the BlackBerry MDS Connection Service

Note: In BlackBerry Enterprise Server 4.1 and earlier, the BlackBerry MDS Connection Service was known as BlackBerry Mobile Data Service or BlackBerry Mobile Data Services.

To turn on HTTP logging for the BlackBerry MDS Connection Service, complete the following steps:

For BlackBerry Enterprise Server 5.0

  1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution Topology > BlackBerry Domain > Component View > MDS Connection Service.
  2. Click the instance of the BlackBerry MDS Connection Service to be modified.
  3. On the Logging tab, click Edit instance.
  4. In the HTTP logging turned on drop-down list, click Yes.
  5. In the Verbose HTTP loggingturned on drop-down list, click Yes.
  6. In the IPPP loggingturned on drop-down list, click Yes.
  7. Confirm that in the File logging destination, UDP logging destination, and TCP logging destination sections, Debug is selected in the Log level drop-down list.
  8. Click Save all.
  9. Restart the MDS Connection Service.

For BlackBerry Enterprise Server 4.1

  1. In BlackBerry Manager, select the <Server Name >_MDS-CS service.
  2. On the Connection Service tab, click Edit Properties.
  3. On the Logs tab, verify that IPPP logging enabled is set to True.
  4. Set both the HTTP Logging Enabled and the Verbose HTTP Logging Enabled drop-down lists to True.
  5. Click Apply, and then click OK.
  6. Restart the MDS Connection Service.

For BlackBerry Enterprise Server 4.0 for Microsoft Exchange

  1. In BlackBerry Manager, right-click the BlackBerry Enterprise Server name, and then click Mobile Data Services Properties.
  2. On the Logs tab, verify that the IPPP check box is selected, select the HTTP Logging Enabled check box and the Verbose HTTP Logging check box.
  3. From the Log Level drop-down list, select the debugging level.
  4. In the Location field, specify a location for saving the file.
  5. Click Apply, and then click OK.
  6. Restart the MDS Connection Service.

For BlackBerry Enterprise Server 4.0 for IBM Domino and Novell GroupWise

  1. In BlackBerry Manager, click the BlackBerry Enterprise Server name.
  2. Select the Mobile Data Services tab, and then select Edit Properties.
  3. On the Logs tab, select the HTTP Logging Enabled check box and the Verbose HTTP Logging check box.
  4. From the Log Level drop-down list, select the debugging level.
  5. In the Location field, specify a location for saving the file.
  6. Click Apply, and then click OK.
  7. Restart the MDS Connection Service.

For BlackBerry Enterprise Server 2.2 and 3.6

  1. In Windows Explorer, go to C:\Program Files\Research In Motion\BlackBerry Enterprise Server\MDS\Servers\<BlackBerry_Enterprise_Server_name>\config .
  2. Open the rimpublic.property file using a text editor, such as Notepad.
  3. At the end of the file, type the following:
    [HTTP HANDLER]
    application.handler.http.logging=true
    application.handler.http.logging.verbose=true
  4. Close and save the file.
  5. In Windows Services, right-click BlackBerry Mobile Data Service, and select Restart.

Note:

  • In BlackBerry Enterprise Server 3.6 SP2 to 5.0, the logs are stored in:
    C:\Program Files\Research In Motion\BlackBerry Enterprise Server\Logs 
     
  • On a 64-bit computer, add (x86) to the Program Files portion of the path: 
    C:\Program Files(x86)\Research In Motion\BlackBerry Enterprise Server\Logs
     
     
  • In all other versions, the output log is stored in:
    C:\Program Files\Research In Motion\Blackberry Enterprise Server\MDS\Servers\Instance\<date>_debug.log

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.