BlackBerry Analysis, Monitoring, and Troubleshooting Tools

You can use the BlackBerry Analysis, Monitoring, and Troubleshooting Tools to streamline management tasks, monitor events, collect statistics, and troubleshoot issues with the BlackBerry Enterprise Server components.

The following BlackBerry Analysis, Monitoring, and Troubleshooting Tools are available:

Tool

Description

BlackBerry Directory Sync Tool (DirectorySync.exe)

You can use this application to synchronize the membership of security groups and distribution groups in Microsoft Active Directory with groups on a BlackBerry Enterprise Server.

The tool can synchronize groups only if the user accounts in Microsoft Active Directory have matching user accounts on the BlackBerry Enterprise Server. If matching user accounts do not exist on the BlackBerry Enterprise Server, you can add the user accounts manually using the BlackBerry Administration Service, or you can enable the provisioning feature so that the tool can add user accounts during the synchronization process.

BlackBerry Application Reporting Tool (HHAppReport.exe)

You can use this command-line tool to list the applications that are installed on BlackBerry devices in an MDM domain. You can use this tool to audit the MDM domain and evaluate the applications that are installed on devices.

BlackBerry IT Policy Import and Export Tool (ITPolicyImportExport.exe)

You can use this command-line tool to export IT policy information from a BlackBerry Configuration Database to a backup file. You can use the backup file to import the information to a different BlackBerry Configuration Database, making the IT policies available to a different MDM domain.

BlackBerry Message Receipt Confirmation Tool (MessageConfirmService.exe)

You can use this application to verify that the BlackBerry Enterprise Server is successfully delivering messages to devices. At an interval that you specify, the tool sends a message to the specified user accounts, monitors the status of the message, and confirms that the devices received the message.

BlackBerry System Log Monitoring and Reporting Tool (BESSysLog.exe)

You can use this application to monitor the BlackBerry Enterprise Server log files for events generated by the BlackBerry Dispatcher and the BlackBerry Messaging Agent. You can specify which components to monitor, the events that you want to track, and the types of notifications and reports that you want the tool to send to administrators.

BlackBerry Enterprise Server Log Monitoring Tool (LogMonitor.exe)

You can use this command-line tool to monitor the information that is written to the log files for BlackBerry Enterprise Server components. You can specify actions that you want the tool to perform when it finds specific values, such as events or text strings. For example, you can configure the tool to run a custom batch file when it finds a specific event ID in the BlackBerry Dispatcher log file.

BlackBerry System Requirements Tool (BBCheckCmd.exe)

You can use this application to determine whether a computer can run a BlackBerry Enterprise Server component successfully.

BlackBerry Domain Administration History Reporting Tool (AdminHistory.exe)

You can use this command-line tool to read the ServerConfigHistory table in the BlackBerry Configuration Database. The tool displays configuration changes, such as newly added user accounts, in a .csv file. The tool records the date and time of each change and the name of the administrator who made the change.

The tool is designed for use only with BlackBerry Enterprise Server 4.1 SP7 and earlier.

BlackBerry Enterprise Server Log Analysis Tool

The BlackBerry Enterprise Server Log Analysis Tool is an application that you can use to run various log analysis tools that check the BlackBerry Enterprise Server log files and collect data about user accounts, message flow, server performance, and historical statistics. You can configure and run the log analysis tools from the BlackBerry Enterprise Server Log Analysis Tool, or you can run the tools individually using the command prompt.

Tool

Description

BlackBerry Calendar Synchronization Reporting Tool (CalSync.exe)

Collects data from the BlackBerry Messaging Agent (MAGT) log file about the calendar synchronization process that you can enable using the BlackBerry Enterprise Trait Tool.

BlackBerry Delayed Notifications Monitoring Tool (DelayedNotifications.exe)

Analyzes the BlackBerry Messaging Agent (MAGT) log file and detects when the BlackBerry Enterprise Server is no longer receiving regular notifications for new email messages and calendar items.

Designed for use in a Microsoft Exchange environment only.

BlackBerry Historical Statistics Tool (HistoricalStats.exe)

Analyzes the BlackBerry Dispatcher (DISP) log file and the BlackBerry Messaging Agent (MAGT) log file to provide statistics about daily use patterns for each user account.

BlackBerry MAPI and CDO Error Monitoring Tool (MapiCdoErrors.exe)

Analyzes the BlackBerry Messaging Agent (MAGT) log file to identify common MAPI and CDO errors and custom events.

Designed for use in a Microsoft Exchange environment only.

BlackBerry MDS Services Data Monitoring Tool (MDSPushvsPull.exe)

Analyzes the (MDAT) log file to determine whether the BlackBerry MDS Connection Service processes more data from push applications or from BlackBerry Browser requests.

BlackBerry Message Flow Reporting Tool (Messageflow.exe)

Analyzes the BlackBerry Dispatcher (DISP), BlackBerry Messaging Agent (MAGT), and BlackBerry Router (ROUT) log files to track the flow of messages through the BlackBerry Enterprise Server to devices.

BlackBerry Thread Analyzer Tool (NoResponseCheck.exe)

Analyzes all BlackBerry Enterprise Server log files (except for the MDAT and instant messaging log files) to identify threads that are nonresponsive, and to distinguish between true nonresponsive threads and slow threads.

BlackBerry Message Pending Delivery Tool (Pending.exe)

Analyzes the BlackBerry Messaging Agent (MAGT) log file to track user accounts that have a pending message count that is higher than a maximum count that you specify.

BlackBerry Usage Monitoring Tool (OutofCoverage.exe)

Analyzes the BlackBerry Dispatcher (DISP) log file to check for devices that do not send or receive data in a specified period of time.

BlackBerry User Activity Reporting Tool (AvailIndex.exe)

Analyzes the BlackBerry Messaging Agent (MAGT) log file to create a snapshot report of user account activity over a period of days.

Designed for use in a Microsoft Exchange environment only.



Was this information helpful? Send us your comments.