Administration Guide

Local Navigation

Changing the promotion threshold and failover threshold

Each primary and standby BlackBerry® Enterprise Server instance has a failover threshold and a promotion threshold. The BlackBerry Enterprise Server uses the failover threshold when it is an primary instance to determine when it needs to demote itself, and it uses the promotion threshold when it is a standby instance to determine whether it can promote itself to become the primary instance.

You can configure the thresholds for each BlackBerry Enterprise Server pair.

Change the promotion threshold and failover threshold and the order of the health parameters

You can change the promotion threshold and failover threshold and the order of the health parameters to meet the requirements of your organization.
  1. In the BlackBerry® Administration Service, on the Servers and components menu, expand High availability > Highly available BlackBerry Enterprise Servers.
  2. Click the name of the BlackBerry Enterprise Server pair that you want to change the health parameters and thresholds for.
  3. Click Edit Automatic Failover settings.
  4. To change the order of the health parameters and thresholds, click the Up and Down icons.
  5. Click Save.

Health parameters for the failover threshold and promotion threshold

Health parameter

Description

Wireless network access

This health parameter indicates whether the BlackBerry® Router can access the wireless network. You cannot configure the failover threshold or promotion threshold so that they are above this health parameter.

BlackBerry Dispatcher

This health parameter indicates whether the BlackBerry Dispatcher can compress and encrypt all of the data that BlackBerry devices send and receive. You cannot configure the failover threshold or promotion threshold so that they are above this health parameter.

BlackBerry Messaging Agent

This health parameter indicates whether the BlackBerry Messaging Agent is available and connected to the BlackBerry Dispatcher.

User accounts

This health parameter indicates whether a preconfigured percentage of user accounts are started in the BlackBerry Messaging Agent.

Connection to the messaging server(s)

This health parameter indicates whether the BlackBerry Messaging Agent can connect to the messaging server. If your organization's environment includes multiple messaging servers and the BlackBerry Messaging Agent instances cannot connect to a preconfigured percentage of the messaging servers, the status of this health parameter changes to "Configured percentage not connected".

At least one user account

This health parameter indicates whether at least one user account is started in the BlackBerry Messaging Agent.

Access to web content and application content

This health parameter indicates whether the BlackBerry MDS Connection Service can provide users with access to content from BlackBerry Java® Applications and content that is located on your organization's intranet or the Internet.

Address lookup

This health parameter indicates whether the BlackBerry Messaging Agent can look up addresses in the address book.

Calendar synchronization

This health parameter indicates whether the BlackBerry Messaging Agent can synchronize the calendar.

Attachment viewing

This health parameter indicates whether the BlackBerry Messaging Agent can provide services for attachment viewing.

Connection to the BlackBerry Configuration Database

This health parameter indicates whether BlackBerry® Enterprise Server components can connect to the BlackBerry Configuration Database.

Push application access

This health parameter indicates whether the BlackBerry MDS Connection Service can push application data to BlackBerry devices.

BlackBerry MDS Integration Service

This health parameter indicates whether the BlackBerry MDS Integration Service can provide application services.

BlackBerry Collaboration Service

This health parameter indicates whether the BlackBerry Collaboration Service can provide services for the collaboration client on BlackBerry devices.

BlackBerry Policy Service

This health parameter indicates whether the BlackBerry Policy Service is available. You cannot set the failover threshold or promotion threshold below this health parameter.

BlackBerry Synchronization Service

This health parameter indicates whether the BlackBerry Synchronization Service is available. You cannot configure the failover threshold or promotion threshold so that they are below this health parameter.

Organizer data synchronization

This health parameter indicates whether the BlackBerry Synchronization Service can synchronize organizer data between BlackBerry devices and the messaging server over the wireless network. You cannot configure the failover threshold or promotion threshold so that they are below this health parameter.

Changing when automatic failover occurs by customizing the health parameters for user accounts and messaging servers

By default, the health parameters for user accounts and messaging servers use percentages to determine when a BlackBerry® Enterprise Server instance is unhealthy. The User accounts health parameter indicates a BlackBerry Enterprise Server instance is unhealthy if less than 75% of the user accounts are started. The Connection to the messaging server(s) health parameter indicates that a BlackBerry Enterprise Server instance is unhealthy if the BlackBerry Enterprise Server instance cannot connect to at least 75% of the messaging servers in your organization.

If either of these health parameters indicate that the primary BlackBerry Enterprise Server is unhealthy and you turn on automatic failover, the BlackBerry Enterprise Server starts the failover process. You can change the percentages of these health parameters to customize when you want automatic failover to occur in your organization's environment.

For example, if your organization requires that all users can access email messages from BlackBerry devices at all times and that the BlackBerry Enterprise Server is connected to all of the messaging servers at all times, you can change the value of the Connection to the messaging server(s) health parameter to 100%.

If your organization's environment includes multiple BlackBerry Enterprise Server pairs, you can change the percentages of the health parameters for all of the BlackBerry Enterprise Server instances at the BlackBerry Domain level, or for each BlackBerry Enterprise Server pair. If you change the percentages of the health parameters at a BlackBerry Domain level and for a BlackBerry Enterprise Server pair, the percentage of the health parameters for the BlackBerry Enterprise Server pair overrides the percentage of the health parameters at the BlackBerry Domain level.

Change when automatic failover occurs by customizing the health parameters for user accounts and messaging servers

  1. Extract the contents to a folder on the computer.
  2. At the command prompt, navigate to <extracted_folder>\tools.
  3. To change the percentage of the User accounts health parameter, perform one of the following actions:
    • To change the percentage of the User accounts health parameter for all BlackBerry Enterprise Server instances, type traittool.exe -global -trait UserHealthPercentage -set <value>, where <value> is the percentage that you want to change the health parameter to.
    • To change the percentage of the User accounts health parameter for a BlackBerry Enterprise Server pair, type traittool.exe -host <instance_name> -trait UserHealthPercentage -set <value>, where <instance_name> is the name of the primary BlackBerry Enterprise Server instance and <value> is the percentage that you want to change the health parameter to.
  4. To change the percentage of the health parameter for messaging servers, perform one of the following actions:
    • To change the percentage of the health parameter for messaging servers for all BlackBerry Enterprise Server instances, type traittool.exe -global -trait ServerHealthPercentage -set <value>, where <value> is the percentage that you want to change the health parameter to.
    • To change the percentage of the health parameter for messaging servers for a BlackBerry Enterprise Server pair, type traittool.exe -host <instance_name> -trait ServerHealthPercentage -set <value>, where <instance_name> is the name of the primary BlackBerry Enterprise Server instance and <value> is the percentage that you want to change the health parameter to.

Example: Changing the percentage of the User accounts health parameter

If you want to change the percentage of the Connection to the messaging server(s) health parameter to 60% for all BlackBerry Enterprise Server instances, you can type traittool.exe -global -trait ServerHealthPercentage -set 60.


Was this information helpful? Send us your comments.