Administration Guide

Local Navigation

BlackBerry Manuals & Help  >  Administrator Documentation  >  BlackBerry Enterprise Server Express 5  >  BlackBerry Enterprise Server Express for Microsoft Exchange  >  Administration Guide BlackBerry Enterprise Server Express for Microsoft Exchange - 5.0.1

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 Express, 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 Express 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 Express 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.
Next topic: Change how the BlackBerry Controller restarts a BlackBerry Enterprise Server Express service
Previous topic: How the BlackBerry Controller monitors the BlackBerry Enterprise Server Express components

Was this information helpful? Send us your comments.