www.gsx.com | log in | register

Last update: . Author: Cyril LEROY .

BlackBerry Enterprise Server HA Advanced Configuration: Disabling Specific Health Parameters

When monitoring BlackBerry Enterprise Servers (BES) with a customized BES Cluster promotion or failover threshold, you may receive undesired GSX Monitor alerts showing BES as Down. For each cluster pair, the failover threshold determines if the BES cluster should be demoted to standby or promoted to primary if the promotion threshold is reached. GSX Monitor is generating alerts about the BES Cluster health statistics directly from the BlackBerry Administration Service.

This article describes an advanced configuration in GSX Monitor for customizing BES 5.x cluster settings to prevent false alerts being generated by one or many of the BES health parameters.

GSX Monitor 10.8.2 and above | BES 5.x cluster

Symptoms

  • Following cluster rules are not met: Connection to the messaging server(s) Not connected. 
  • Primary Server Down.

How to Solve the issue

The best practice would be to customize the BES Server health parameter using the Trait Tool utility available from BlackBerry. This can prevent generating an unhealthy status even if automatic failover is not effected.

Possible Workaround

Disabling specific BAS health states:

  1. Create a backup of C:\GSX Monitor\Data\GSXScanEngine.ini
  2. Open the GSXScanEngine.ini file in a text editor and locate the [options] section.
  3. We are going to add a line in this file that will disable a specific health parameter on a specific BES instance. 
    • If we wanted to disable the health parameter USER_ACCOUNTS on SRV_BES01, we would add the following line under options.
      • BBITSTODISABLE=SRV_BES01#1;
      • The code #1 refers to the table below, 1 corresponds to USER_ACCOUNTS.
    • If we wanted to disable the USER_ACCOUNTS on SRV_BES01 and both the USER_ACCOUNTS and the CONNECTION_TO_MESSAGING_SERVER on the second instance SRV_BES02, we would use the following line under options.
      • BBITSTODISABLE=SRV_BES01#1;SRV_BES02#1#2;
      • The format is: BBITSTODISABLE=<instance_name1>#<healthstate1>#<healthstate n>;<instance_name2>#<healthstate1>#<healthstate n>; 
  4. Save and close the ini file then restart GSX Monitor.

GSX Monitor retrieves health state details from the BES SQL database, each state is associated with a code.

The following Health states are available for BES Servers:

Health State Code
BES_MESSAGING_AGENT   0
USER_ACCOUNTS   1
CONNECTION_TO_MESSAGING_SERVER   2
AT_LEAST_ONE_USER_ACCOUNT   3
CALENDAR_SYNCHRONIZATION   8
ADDRESS_LOOKUP   10
ATTACHMENT_VIEWING   12
BES_POLICY_SERVICE   20
BES_SYNCHRONIZATION_SERVICE   24
ORGANIZER_DATA_SYNCHRONIZATION   25
BES_DISPATCHER   28
CONNECTION_TO_BES_DB   29
WIRELESS_NETWORK_ACCESS   30
ACCESS_TO_WEB_AND_APP_CONTENT   32
PUSH_APP_ACCESS   33
BES_MDS_INTEGRATION_SERVICE   34
BES_COLLABORATION_SERVICE   36

 

In the example above, the line "BBITSTODISABLE=SRV_BES01#1;SRV_BES02#1#2;" means two health parameter warnings are disabled in GSX Monitor. User Accounts on both server instances, and Connection to the Messaging Server on instance 2. Their codes are respectively #1 and #2 (the # must be included).

This means if the user accounts health parameter dropped below threshold, neither server would generate an alert for cluster rules. The second instance SRV_BES02 would not alert on the connection to the messaging service but the SRV_BES01 still would. This may also be done if a particular health parameter was never updated or always reported the wrong value.

BlackBerry Related articles

You can find more details about BES Cluster configuration and health status customization from the following BlackBerry technical articles:



Not finding what you are looking for?

Have more questions? Submit a request


Was this article helpful?

0 out of 0 found this helpful