Administration Guide

Local Navigation

Configuring BlackBerry Policy Service throttling

You can configure BlackBerry® Policy Service throttling on a BlackBerry® Enterprise Server Express instance to limit the database usage of the BlackBerry Policy Service when it performs the following actions:

  • sends IT policies and service books that you update to all BlackBerry devices that are associated with the BlackBerry Enterprise Server Express instance that the BlackBerry Policy Service runs on
  • sends updated PIN encryption keys to all devices that are associated with the BlackBerry Enterprise Server Express instance that the BlackBerry Policy Service runs on

  • performs an application poll to verify whether the BlackBerry Policy Service must send applications to all devices that are associated with the BlackBerry Enterprise Server Express instance that the BlackBerry Policy Service runs on

You can configure BlackBerry Policy Service throttling using the BlackBerry Enterprise Trait Tool. You can access the BlackBerry Enterprise Trait Tool in the Tools folder of the BlackBerry Enterprise Server Express installation files.

View the current settings for BlackBerry Policy Service throttling

  1. Copy the BlackBerry® Enterprise Server Express installation files to a computer that hosts the BlackBerry Enterprise Server Express instance.
  2. Extract the contents to a folder on the computer.
  3. At the command prompt, navigate to <extracted_folder>\tools.
  4. Type traittool -global -list
  5. Press ENTER. If the BlackBerry Enterprise Trait Tool does not list any BlackBerry Policy Service throttling traits, no BlackBerry Policy Service throttling traits have been changed from their default values.

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 Express instances, an update to an IT policy or service book that affects many users on multiple BlackBerry Enterprise Server Express 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 Express instance that the BlackBerry Policy Service runs on require a new IT policy or service book. The BlackBerry Policy Service also 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 Express requests IT policies or service books during device activation or when you request that the BlackBerry Enterprise Server Express 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 Express installation files to a computer that hosts the BlackBerry Enterprise Server Express 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.
    • To configure the maximum number of IT policies and service books that a BlackBerry Policy Service can send to BlackBerry devices each minute, type traittool -global -trait PolicyThrottlingMaxBESJobs -set <value>, where <value> is 1 or greater. The default value is 100.
    • To configure the maximum number of IT policies and service books that all BlackBerry Policy Service instances can send to devices each minute, type traittool -global -trait PolicyThrottlingMaxDomainJobs -set <value>, where <value> is 1 or greater. The default value is 300.
  5. Press ENTER.

Example: Configuring the maximum number of IT policies or service books that a BlackBerry Policy Service can send

If you want to configure the maximum number of IT policies or service books that a BlackBerry Policy Service can send to 500, type traittool -global -trait PolicyThrottlingMaxDomainJobs -set 500.

Configuring BlackBerry Policy Service throttling for PIN encryption keys

If the BlackBerry® Policy Service detects that you updated the PIN encryption keys in the BlackBerry Configuration Database, the BlackBerry Policy Service verifies which BlackBerry device users require a new key and then schedules a certain number of users at equal intervals over the next 60 second period. The default setting is 60, or one process per second. You can adjust the number of users that the BlackBerry Policy Service schedules over the 60 second interval using throttling.

The BlackBerry Policy Service only applies throttling when it automatically detects updates to the PIN encryption keys. The BlackBerry database notification system starts automatic detection. If you turn off the BlackBerry database notification system, a five-minute timer starts automatic detection.

Configure BlackBerry Policy Service throttling for PIN encryption keys

  1. Copy the BlackBerry® Enterprise Server Express installation files to a computer that hosts the BlackBerry Enterprise Server Express instance.
  2. Extract the contents to a folder on the computer.
  3. At the command prompt, navigate to <extracted_folder>\tools.
  4. To configure the maximum number of processes for PIN encryption keys that a BlackBerry Policy Service can process at one time before it schedules additional processes, type traittool -global -trait PolicyThrottlingP2PKeyRate -set <value>, where <value> is 0 or greater. The default value is 60. If you configure a value of 0, theBlackBerry Policy Service will not throttle the processes to update PIN encryption keys.
  5. Press ENTER.

Example: Configuring the maximum number of processes for PIN encryption keys

If you want to configure the maximum number of processes for PIN encryption keys to 30, you can type traittool -global -trait PolicyThrottlingP2PKeyRate -set 30.

Configuring BlackBerry Policy Service throttling for application polling

The BlackBerry® Policy Service performs application polling to verify when it must send applications to all BlackBerry devices that are associated with the BlackBerry® Enterprise Server Express instance that the BlackBerry Policy Service runs on. You can configure BlackBerry Policy Service throttling on a BlackBerry Enterprise Server Express instance to limit the database usage of the BlackBerry Policy Service when it sends applications to devices.

If you do not configure throttling, the BlackBerry Policy Service tries to process tasks as fast as the server permits, which might result in an unexpected increase in CPU usage and database usage. If you configure throttling, the BlackBerry Policy Service sends applications to devices using the same method that it uses to throttle IT policies and service books.

Configure BlackBerry Policy Service throttling for application polling

  1. Copy the BlackBerry® Enterprise Server Express installation file to a computer that hosts the BlackBerry Enterprise Server Express 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 BlackBerry Policy Service to send applications using the same method that it uses to throttle IT policies and service books, type traittool -global -trait PolicyThrottlingAppPush -set true.
    • To configure the BlackBerry Policy Service to not send applications using throttling, and to process the requests as quickly as possible, type traittool -global -trait PolicyThrottlingAppPush -set false.
    The default value is false.
  5. Press ENTER.

Delete a BlackBerry Policy Service throttling setting

  1. Copy the BlackBerry® Enterprise Server Express installation files to a computer that hosts a BlackBerry Enterprise Server Express instance.
  2. Extract the contents to a folder on the computer.
  3. At the command prompt, navigate to the Tools folder where the TraitTool.exe file is located.
  4. Type traittool -global -trait <trait_name> -erase, where <trait_name> is the configuration that you want to delete.
  5. Press ENTER.

Example: Deleting a BlackBerry Policy Service throttling setting

If you want to delete the maximum number of IT policies and service books that all BlackBerry Policy Service instances can send to BlackBerry devices each minute, type traittool -global -trait PolicyThrottlingMaxDomainJobs -erase.


Was this information helpful? Send us your comments.