Administration Guide

Local Navigation

How the BlackBerry Controller monitors the BlackBerry Enterprise Server components

The BlackBerry® Controller enables the BlackBerry® Enterprise Server to continue running if nonresponsive threads occur or BlackBerry Enterprise Server services become inactive. The BlackBerry Controller monitors the BlackBerry Messaging Agent, the extension plug-ins for the BlackBerry Messaging Agent, and the BlackBerry Dispatcher so that the BlackBerry Controller can detect when to start, restart, or stop the services. The BlackBerry Controller can also restart other BlackBerry Enterprise Server services if they stop responding.

Services that require database access are installed in manual start mode and the BlackBerry Controller starts the services when the BlackBerry Dispatcher verifies the connection to the database. Other services are installed in automatic start mode, and by default, the BlackBerry Controller restarts the services if the BlackBerry Controller detects that the services are inactive. By default, the BlackBerry Controller also restarts services if the BlackBerry Controller detects nonresponsive threads or that a service is inactive for a long period of time.

Registry keys determine how the BlackBerry Controller monitors the BlackBerry Enterprise Server components and restarts the services that are associated with the components. You can change the default behavior of the BlackBerry Controller by creating new registry keys and changing the default values of the registry keys.

Change how the BlackBerry Controller restarts the BlackBerry Messaging Agent

Before you begin: To create a user.dmp file, or to use a user.dmp file as a data collection option, you must download and install the User Mode Process Dumper application that is included as a part of the Microsoft® OEM Support Tools.
  1. On the computer that hosts the BlackBerry® Enterprise Server, open the Registry Editor.
  2. In the left pane, perform one of the following actions:
    • If you are running a 32-bit version of Windows®, navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion\BlackBerry Enterprise Server.
    • If you are running a 64-bit version of Windows, navigate to HKEY_LOCAL_MACHINE\Software\ WOW6432Node\Research In Motion\BlackBerry Enterprise Server.
  3. Click Controller.
  4. Perform any of the following tasks:
    Task Steps

    Change how the BlackBerry Controller restarts the BlackBerry Messaging Agent.

    1. Create a DWORD value that is named RestartAgentsOnCrash.
    2. Double-click the new DWORD value.
    3. In the Value data field, perform one of the following actions:
      • To prevent the BlackBerry Controller from restarting the BlackBerry Messaging Agent if the BlackBerry Messaging Agent stops responding, type 0.
      • To permit the BlackBerry Controller to restart the BlackBerry Messaging Agent if the BlackBerry Messaging Agent stops responding, type 1.

    Change the maximum number of times that the BlackBerry Messaging Agent restarts daily.

    1. Create a DWORD value that is named MaxAgentRestartPerDay.
    2. Double-click the new DWORD value.
    3. In the Value data field, type a value.

      The default maximum number of restarts that can occur daily is ten.

    Change the maximum number of missed health checks that can occur before the BlackBerry Messaging Agent restarts.

    1. Create a DWORD value that is named WaitToRestartAgentOnHung.
    2. Double-click the new DWORD value.
    3. In the Value data field, type a value that is greater than four, which provides the BlackBerry Controller with sufficient time to monitor thread health checks before the BlackBerry Controller restarts the BlackBerry Messaging Agent.

      The default value is 6.

    Health checks occur every ten minutes. If a health check does not receive a response from the thread that that the BlackBerry Controller monitors, the BlackBerry Enterprise Server tracks the missed health check in the BlackBerry Messaging Agent log file as the wait count.

    Example:

    [20148] (05/12 12:21:00):{0xC28} Thread:  *** No Response ***  Thread Id=0xB00, Handle=0x558, WaitCount=2

    Prevent the BlackBerry Controller from restarting the BlackBerry Messaging Agent when a nonresponsive thread occurs.

    1. Create a DWORD value that is named WaitToRestartAgentOnHung.
    2. Double-click the new DWORD value.
    3. In the Value data field, type 0.

      The default value is 6.

    Prevent the BlackBerry Controller from restarting the BlackBerry Messaging Agent for a specific time range if the BlackBerry Controller detects a nonresponsive thread.

    1. Create a DWORD value that is named RestartAgentOnHungBlackoutFrom.
    2. Double-click the new DWORD value.
    3. In the Base section, select the Decimal option.
    4. In the Value data field, type the lowest value of the time range.

      The values range from 0 to 23, where 0 is 12:00 AM and 23 is 11:00 PM.

    5. Create a DWORD value that is named RestartAgentOnHungBlackoutTo.
    6. Double-click the new DWORD value.
    7. In the Base section, select the Decimal option.
    8. In the Value data field, type the highest value of the time range.

    For example, if you configure the RestartAgentOnHungBlackoutFrom value to eight and the RestartAgentOnHungBlackoutTo value to 17, the BlackBerry Controller does not restart the BlackBerry Messaging Agent between 8:00 AM and 5:00 PM if it detects a nonresponsive thread.

    To turn off the time range, in the RestartAgentOnHungBlackoutFrom and RestartAgentOnHungBlackoutTo value fields, type 0.

    Change the maximum number of user.dmp files that each BlackBerry Enterprise Server creates daily before the BlackBerry Controller restarts the BlackBerry Messaging Agent.

    1. Create a DWORD value that is named MaxUserDumpPerDay.
    2. Double-click the new DWORD value.
    3. In the Value data field, type a value.

      The default value is 3.

    To turn off the daily creation of user.dmp files, change the MaxUserDumpPerDay value field to 0.

    Change the number of ten-minute intervals that the BlackBerry Controller waits for a successful health check before it restarts the BlackBerry Messaging Agent.

    1. Create a DWORD value that is named MissedHeartbeatThreshold.
    2. Double-click the new DWORD value.
    3. In the Value data field, type a value.

      The default value is 2.

    If you configure the MissedHeartbeatThreshold value to be three, the BlackBerry Controller waits for 30 minutes before it restarts the BlackBerry Messaging Agent.

    Prevent the BlackBerry Messaging Agent from restarting if the BlackBerry Controller does not receive health checks from it.

    1. Create a DWORD value that is named MissedHeartbeatThreshold.
    2. Double-click the new DWORD value.
    3. In the Value data field, type 0.
  5. Click OK.
Back To Top

Change how the BlackBerry Controller restarts a BlackBerry Enterprise Server service

By default, the BlackBerry® Controller restarts a BlackBerry® Enterprise Server service if it stops responding.
  1. On the computer that hosts the BlackBerry Enterprise Server component that you want to change, open the Registry Editor.
  2. In the left pane, perform one of the following actions:
    • If you are running a 32-bit version of Windows®, navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion.
    • If you are running a 64-bit version of Windows, navigate to HKEY_LOCAL_MACHINE\Software\WOW6432Node\Research In Motion.
  3. Perform any of the following tasks:
    Task Steps

    Change how the BlackBerry Controller restarts the BlackBerry Attachment Service.

    1. Click BBAttachServer.
    2. Double-click the DWORD value that is named RestartOnCrash.
    3. In the Value data field, perform one of the following actions:
      • To prevent the BlackBerry Controller from restarting the BlackBerry Attachment Service if the service stops responding, type 0.
      • To permit the BlackBerry Controller to restart the BlackBerry Attachment Service if the service stops responding, type 1.

    Change how the BlackBerry Controller restarts the BlackBerry Collaboration Service.

    1. Click BlackBerry Collaboration Service.
    2. Double-click the DWORD value that is named RestartOnCrash.
    3. In the Value data field, perform one of the following actions:
      • To prevent the BlackBerry Controller from restarting the BlackBerry Collaboration Service if the service stops responding, type 0.
      • To permit the BlackBerry Controller to restart the BlackBerry Collaboration Service if the service stops responding, type 1.

    Change how the BlackBerry Controller restarts the BlackBerry MDS Connection Service.

    1. Click BlackBerry Mobile Data Server.
    2. Double-click the DWORD value that is named RestartOnCrash.
    3. In the Value data field, perform one of the following actions:
      • To prevent the BlackBerry Controller from restarting the BlackBerry MDS Connection Service if the service stops responding, type 0.
      • To permit the BlackBerry Controller to restart the BlackBerry MDS Connection Service if the service stops responding, type 1.

    Change how the BlackBerry Controller restarts the BlackBerry Router.

    1. Click BlackBerryRouter.
    2. Double-click the DWORD value that is named RestartOnCrash.
    3. In the Value data field, perform one of the following actions:
      • To prevent the BlackBerry Controller from restarting the BlackBerry Router if the service stops responding, type 0.
      • To permit the BlackBerry Controller to restart the BlackBerry Router if the service stops responding, type 1.

    Change how the BlackBerry Controller restarts the BlackBerry Mail Store Service.

    1. Navigate to BlackBerry Enterprise Server.
    2. Click MailStore.
    3. Double-click the DWORD value that is named RestartOnCrash.
    4. In the Value data field, perform one of the following actions:
      • To prevent the BlackBerry Controller from restarting the BlackBerry Mail Store Service if the service stops responding, type 0.
      • To permit the BlackBerry Controller to restart the BlackBerry Mail Store Service if the service stops responding, type 1.

    Change how the BlackBerry Controller restarts the BlackBerry Policy Service.

    1. Navigate to BlackBerry Enterprise Server.
    2. Click PolicyServer.
    3. Double-click the DWORD value that is named RestartOnCrash.
    4. In the Value data field, perform one of the following actions:
      • To prevent the BlackBerry Controller from restarting the BlackBerry Policy Service if the service stops responding, type 0.
      • To permit the BlackBerry Controller to restart the BlackBerry Policy Service if the service stops responding, type 1.

    Change how the BlackBerry Controller restarts the BlackBerry Synchronization Service.

    1. Navigate to BlackBerry Enterprise Server.
    2. Click SyncServer.
    3. Double-click the DWORD value that is named RestartOnCrash.
    4. In the Value data field, perform one of the following actions:
      • To prevent the BlackBerry Controller from restarting the BlackBerry Synchronization Service if the service stops responding, type 0.
      • To permit the BlackBerry Controller to restart the BlackBerry Synchronization Service if the service stops responding, type 1.
  4. Click OK.
Back To Top

Was this information helpful? Send us your comments.