How to enable BlackBerry Messenger logging on the BlackBerry Enterprise Server

Article ID: KB13805

Type: Support Content

Last Modified: 07-10-2014

 

Product(s) Affected:

  • BlackBerry Messenger for BlackBerry OS 7 and earlier
  • BlackBerry Enterprise Server for Microsoft Exchange
  • BlackBerry Enterprise Server for IBM Domino
  • BlackBerry Enterprise Server for Novell GroupWise
CollapseEnvironment
  • BlackBerry Enterprise Server 4.1 to 5.0 SP3
  • BlackBerry Messenger for BlackBerry smartphones
CollapseOverview

To turn on logging for BlackBerry Messenger, configure the appropriate setting within an IT policy by completing the following steps:

BlackBerry Enterprise Server 4.1

  1. Open the BlackBerry Manager and select BlackBerry Domain in the Explorer view.
  2. In the Tasks pane, select Edit Properties.
  3. In the Properties list, select IT Policy.
  4. In the right pane, double-click IT Policies.
  5. Select the IT policy to be edited, and select Properties.
  6. In the left pane, select BlackBerry Messenger Policy Group.
  7. Make sure the following parameters are set:
    1. Disable BlackBerry Messenger: Leave blank or choose False. A blank entry defaults to a False value.
    2. Messenger Audit Email Address: Type the email address that logging entries will be sent to. Leaving this value blank disables logging. Note, the CSV file will remain in the log location and a copy of the log emailed to the specified email address.
    3. Messenger Audit UID: Specify which service book is used to send BlackBerry Messenger logs by entering the unique identifier (UID) here. The UID on a BlackBerry smartphone can be found by going to Options > Advanced Options > Service Book. Select the desired service book and click View to see the UID. A blank value results in the first available encrypted message service being used.
    4. Messenger Audit Report Interval: Specify, in hours, how often the BlackBerry Messenger application sends a new report if there is new data. A blank value results in the default 24 hours being used.
    5. Messenger Audit Max Report Interval: Specify, in hours, how often BlackBerry Messenger sends a new report whether or not there is new data. A blank value results in the default 168 hours being used.
  8. Click OK to go back to the Home screen.

BlackBerry smartphone Users assigned to the modified IT policy will see BlackBerry Messenger messages in the Sent Items folder on their BlackBerry smartphones.

BlackBerry Enterprise Server 5.0

  1. Open the BlackBerry Administrator Service Console.
  2. In the BlackBerry solution management pane, expand Policy.
  3. Click on Manage IT Policies.
  4. Select the IT policy to be edited.
  5. Click Edit IT policy.
  6. Select the BlackBerry Messenger tab.
  7. Make sure the following parameters are set:
    1. Disable BlackBerry Messenger: Leave blank or choose False. A blank entry defaults to a False value.
    2. Messenger Audit Email Address: Type the email address that logging entries will be sent to. Leaving this value blank disables logging. Note, the CSV file will remain in the log location and a copy of the log emailed to the specified email address.
    3. Messenger Audit UID: The service book to send BlackBerry Messenger logs can be specified by entering the unique identifier (UID) here.
      Note: For BlackBerry device software 5.0 the UID on a BlackBerry smartphone can be found by going to Options >Advanced Options > Service Book.
      Note: For BlackBerry device software 6.0 the UID can be found by going to Options > Device > Advanced Settings > Service Book. Select the desired service book and click View to see the UID.
      A blank value results in the first available encrypted message service being used.
    4. Messenger Audit Report Interval: Specify, in hours, how often the BlackBerry Messenger application sends a new report if there is new data. A blank value results in the default 24 hours being used.
    5. Messenger Audit Max Report Interval: Specify, in hours, how often the BlackBerry Messenger application sends a new report whether or not there is new data. A blank value results in the default 168 hours being used.
    6. Click Save All.

BlackBerry Enterprise Server 5.0 SP1 through 5.0 SP4

In addition to the steps listed under BlackBerry Enterprise Server 5.0, BlackBerry Messenger 5.0 is required to configure and utilize the IT policy rule Disable BlackBerry Messenger Wireless Synchronization:

  1. Open the BlackBerry Administrator Service Console.
  2. In the BlackBerry solution management pane, expand Policy.
  3. Click on Manage IT Policies.
  4. Select the IT policy to be edited.
  5. Click Edit IT policy.
  6. Select the PIM Synchronization tab.
  7. Set the Disable BlackBerry Messenger Wireless Synchronization IT policy rule to No.
  8. Click Save All.

The BlackBerry Enterprise Server creates a log file in the following format: BBMMessageLog_<yyyymmdd>.csv

If configured to email the BBM log file, the email arrives at the specified audit email address From the Username associated with the activated email address, with Subject: BlackBerry Messenger Usage Report <Date><Time_range_of_log>

CollapseAdditional Information

Ensure that the Messenger Audit Email Address field contains a valid Simple Mail Transfer Protocol (SMTP) email address or the audit report will bounce back to the BlackBerry smartphone user.

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.