Blackberry PRD-10459-003 Administration Guide - Page 94

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

Page 94 highlights

Administration Guide Changing the promotion threshold and failover threshold 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 Before you begin: If you want to change the percentages of the health parameters for a BlackBerry® Enterprise Server pair, you must know the name of the primary BlackBerry Enterprise Server instance. In an IBM® Lotus® Domino® environment, you must type the name of the primary BlackBerry Enterprise Server instance in canonical format (for example, CN=server03/OU=servers/O=rimnet). 1. Copy the BlackBerry Enterprise Server installation media to the computer that hosts the primary BlackBerry Enterprise Server instance. 2. Extract the contents to a folder on the computer. 3. At the command prompt, navigate to \tools. 4. 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 , where 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 -trait UserHealthPercentage -set , where is the name of the primary BlackBerry Enterprise Server instance and is the percentage that you want to change the health parameter to. 5. To change the percentage of the health parameter for messaging servers, perform one of the following actions: 92

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330
  • 331
  • 332
  • 333
  • 334
  • 335
  • 336
  • 337
  • 338
  • 339
  • 340
  • 341
  • 342
  • 343
  • 344
  • 345
  • 346
  • 347
  • 348
  • 349
  • 350
  • 351
  • 352
  • 353
  • 354
  • 355
  • 356
  • 357
  • 358
  • 359
  • 360
  • 361
  • 362
  • 363
  • 364
  • 365
  • 366
  • 367
  • 368
  • 369
  • 370
  • 371
  • 372
  • 373
  • 374
  • 375
  • 376
  • 377
  • 378
  • 379
  • 380
  • 381
  • 382
  • 383
  • 384
  • 385
  • 386
  • 387
  • 388
  • 389
  • 390
  • 391
  • 392
  • 393
  • 394
  • 395
  • 396
  • 397
  • 398
  • 399
  • 400
  • 401
  • 402
  • 403
  • 404
  • 405
  • 406
  • 407
  • 408
  • 409
  • 410
  • 411
  • 412
  • 413
  • 414
  • 415
  • 416
  • 417
  • 418
  • 419
  • 420

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
Before you begin:
If you want to change the percentages of the health parameters for a BlackBerry® Enterprise Server
pair, you must know the name of the primary BlackBerry Enterprise Server instance. In an IBM® Lotus® Domino®
environment, you must type the name of the primary BlackBerry Enterprise Server instance in canonical format (for
example, CN=server03/OU=servers/O=rimnet).
1.
Copy the BlackBerry Enterprise Server installation media to the computer that hosts the primary BlackBerry
Enterprise Server instance.
2.
Extract the contents to a folder on the computer.
3.
At the command prompt, navigate to
<extracted_folder>
\tools.
4.
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.
5.
To change the percentage of the health parameter for messaging servers, perform one of the following actions:
Administration Guide
Changing the promotion threshold and failover threshold
92