Blackberry PRD-10459-016 Administration Guide - Page 355

Configuring BlackBerry Policy Service throttling for IT policies and service books

Page 355 highlights

Administration Guide Configuring BlackBerry Policy Service throttling Configuring BlackBerry Policy Service throttling for IT policies and service books If the BlackBerry® Policy Service detects that you updated an IT policy or service book in the BlackBerry Configuration Database, it schedules a task to create and deliver the IT policy or service book to BlackBerry device users that must receive the update. The BlackBerry Policy Service tries to process tasks as fast as the server permits, which can result in an unexpected increase in CPU usage and database usage. Because you cannot synchronize multiple BlackBerry Policy Service instances on multiple BlackBerry® Enterprise Server instances, an update to an IT policy or service book that affects many users on multiple BlackBerry Enterprise Server instances can increase the CPU usage and database usage significantly for a long period of time. The increased CPU usage and database usage can lead to unexpected behavior such as database updates not completing. To avoid this scenario, you can throttle the processing of IT policies and service books. You can specify the maximum number of processes for IT policies and service books that a BlackBerry Policy Service can run at one time before the BlackBerry Policy Service schedules additional processes for IT policies and service books. You can also specify the maximum number of IT policies and service books that a BlackBerry Policy Service can send to devices each minute and the maximum number of IT policies and service books that all BlackBerry Policy Service instances can send to devices each minute. If you configure throttling, the BlackBerry Policy Service determines which users that are associated with the BlackBerry Enterprise Server instance that the BlackBerry Policy Service runs on require a new IT policy or service book. The BlackBerry Policy Servicealso determines how many users to schedule for processing in the next 60 seconds. The BlackBerry Policy Service then schedules the same number of users for processing at equal intervals over the next 60 seconds to distribute the usage on the BlackBerry Configuration Database. The BlackBerry Policy Service only applies throttling when it automatically detects updates to IT policies or service books. The BlackBerry database notification system starts automatic detection. If you configure the BlackBerry database notification system to be turned off, a five-minute timer starts automatic detection. The BlackBerry Policy Service does not apply throttling when the BlackBerry Enterprise Server requests IT policies or service books during device activation or when you request that the BlackBerry Enterprise Server send IT policies or service books to users. Configure BlackBerry Policy Service throttling for IT policies and service books 1. Copy the BlackBerry® Enterprise Server installation files to a 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. Perform one of the following actions: • To configure the maximum number of processes that a BlackBerry Policy Service can run for IT policies and services books at one time before the BlackBerry Policy Service schedules additional processes, type traittool -global -trait PolicyThrottlingInProcessJobs -set , where is 0 or greater. The default value is 30. 353

  • 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
  • 421
  • 422
  • 423
  • 424
  • 425
  • 426
  • 427
  • 428
  • 429
  • 430
  • 431
  • 432

Configuring BlackBerry Policy Service throttling for IT policies and service
books
If the BlackBerry® Policy Service detects that you updated an IT policy or service book in the BlackBerry Configuration
Database, it schedules a task to create and deliver the IT policy or service book to BlackBerry device users that must
receive the update. The BlackBerry Policy Service tries to process tasks as fast as the server permits, which can result
in an unexpected increase in CPU usage and database usage.
Because you cannot synchronize multiple BlackBerry Policy Service instances on multiple BlackBerry® Enterprise
Server instances, an update to an IT policy or service book that affects many users on multiple BlackBerry Enterprise
Server instances can increase the CPU usage and database usage significantly for a long period of time. The increased
CPU usage and database usage can lead to unexpected behavior such as database updates not completing.
To avoid this scenario, you can throttle the processing of IT policies and service books. You can specify the maximum
number of processes for IT policies and service books that a BlackBerry Policy Service can run at one time before the
BlackBerry Policy Service schedules additional processes for IT policies and service books. You can also specify the
maximum number of IT policies and service books that a BlackBerry Policy Service can send to devices each minute
and the maximum number of IT policies and service books that all BlackBerry Policy Service instances can send to
devices each minute.
If you configure throttling, the BlackBerry Policy Service determines which users that are associated with the
BlackBerry Enterprise Server instance that the BlackBerry Policy Service runs on require a new IT policy or service
book. The BlackBerry Policy Servicealso determines how many users to schedule for processing in the next 60 seconds.
The BlackBerry Policy Service then schedules the same number of users for processing at equal intervals over the
next 60 seconds to distribute the usage on the BlackBerry Configuration Database.
The BlackBerry Policy Service only applies throttling when it automatically detects updates to IT policies or service
books. The BlackBerry database notification system starts automatic detection. If you configure the BlackBerry
database notification system to be turned off, a five-minute timer starts automatic detection. The BlackBerry Policy
Service does not apply throttling when the BlackBerry Enterprise Server requests IT policies or service books during
device activation or when you request that the BlackBerry Enterprise Server send IT policies or service books to users.
Configure BlackBerry Policy Service throttling for IT policies and service books
1.
Copy the BlackBerry® Enterprise Server installation files to a 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.
Perform one of the following actions:
To configure the maximum number of processes that a BlackBerry Policy Service can run for IT policies and
services books at one time before the BlackBerry Policy Service schedules additional processes, type
traittool
-global -trait PolicyThrottlingInProcessJobs -set
<value>
, where
<value>
is 0 or greater. The default value is
30.
Administration Guide
Configuring BlackBerry Policy Service throttling
353