BlackBerry Device Software configuration in BlackBerry Enterprise Server 5.0

Article ID: KB20556

Type: Support Content

Last Modified: 04-15-2014


Product(s) Affected:

  • BES5
Jump to: Environment | Overview
  • BlackBerry Enterprise Server 5.0 for IBM Domino
  • BlackBerry Enterprise Server 5.0 for Microsoft Exchange

BlackBerry Device Software configuration is a feature in BlackBerry Enterprise Server 5.0 which allows an administrator control over how BlackBerry Enterprise Server users' smartphones can upgrade their device software.

Task 1 - Configure the BlackBerry Administration Service to manage BlackBerry Device Software deployment:

By default, the BlackBerry Administration Service does not display the BlackBerry Device Software pages that permit creation of the BlackBerry Device Software configuration. Follow these steps to enable this feature:

  1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > BlackBerry Administration Service.
  2. Click BlackBerry Administration Service.
  3. Click Edit component.
  4. In the Software Management section, in the BlackBerry Device Software deployment managed by BlackBerry Administration Service drop-down list, click Yes.
  5. Click Save All.

Note: When these changes have been applied, the values change for the following IT policy rules in the Wireless Software Upgrades policy group, and the rules cannot be viewed or changed:

  • The Allow Non Enterprise Upgrade IT policy rule changes to the default value No.
  • The Disallow Device User Requested Upgrade IT policy rule changes to the default value Yes.
  • The Disallow Device User Requested Rollback IT policy rule changes to the default value Yes.

Task 2 - Search for available Device Software bundles and assign to a Device Software Configuration:

  1. In the BlackBerry Administration Service, on the BlackBerry solution management menu, expand Software.
  2. Expand BlackBerry Device Software
  3. Select Search for new wireless BlackBerry Device Software bundles.
  4. Change the support type drop down menu and click Search. (The blank option will return all results).
  5. Click Edit supported BlackBerry Device Software bundles.
  6. Change the desired source and destination bundle to Supported and select Save all.
  7. Click on Create a BlackBerry Device Software Configuration.
  8. Specify the configuration name and description and save it.
  9. Select the name of the Device Software configuration that was created, and select the BlackBerry Device Software Bundles tab
  10. Select Edit BlackBerry Device Software Configuration, and select Add BlackBerry Device Software bundles to Device Software Configuration
  11. Perform a Search for the bundle that was set to supported in step 5, ensure it is checked, and select Add to BlackBerry Device Software Configuration.
  12. In the Configuration Information tab, set the required configuration options and select Save all.

Task 3 - Create a Software Configuration and add the Device Software Configuration to it:

  1. On the left-pane, under BlackBerry Solution Management, select Create a software configuration.
  2. Enter the name of the software configuration.
  3. Make selections for Disposition for unlisted applications and Application control policy for unlisted applications.
  4. Click Save.
  5. Click View Software Configuration List and select the new software configuration.
  6. Click Edit software Configuration.
  7. Select the drop-down under BlackBerry Device Software Configuration.
  8. Select the BlackBerry Device Software Configuration that was created.
  9. Click Save All.

Task 4 - Assign the software configuration to the BlackBerry smartphone user:

  1. On the left-pane, under BlackBerry Solution Management, expand User.
  2. Click Manage Users.
  3. Click Search.
  4. Click on a BlackBerry Enterprise Server user account.
  5. Click on the Software Configuration tab.
  6. Click Edit User.
  7. Under Available Software Configurations, select the software configuration.
  8. Click Add.
    The software configuration should then appear under Current Software Configurations.
  9. Click Save all.

Note: Once a Software Configuration has been assigned to a BlackBerry Enterprise Server user, by searching for the BlackBerry Enterprise Server user and opening the View User screen one can click on View resolved BlackBerry Device Software bundles under the Software Configuration tab to ensure that the bundle appears.

Afterwards, navigate to Devices > Deployment Jobs > Manage deployment job tasks and verify that the BlackBerry Device Software jobs are created.   From the list of jobs produced, click on more, to view the BlackBerry Enterprise Server user name and application deployment status.   Allow sometime for the job Status to change from Ready to deliver to Success.


By downloading, accessing or otherwise using the Knowledge Base documents you agree:

   (a) that the terms of use for the documents found at apply to your use or reference to these documents; and

   (b) not to copy, distribute, disclose or reproduce, in full or in part any of the documents without the express written consent of RIM.

Visit the BlackBerry Technical Solution Center at