How to deploy third-party applications wirelessly from BlackBerry Enterprise Server to BlackBerry smartphones

Article ID: KB03748

Type: Support Content

Last Modified: 10-31-2013

 

Product(s) Affected:

  • BlackBerry Enterprise Server for Microsoft Exchange
  • BlackBerry Enterprise Server for IBM Lotus Domino
  • BlackBerry Enterprise Server for Novell GroupWise
Jump to: Environment | Overview
CollapseEnvironment
  • BlackBerry Enterprise Server 4.0 to 5.0 SP4
CollapseOverview

Complete the following tasks for the appropriate version of BlackBerry Enterprise Server to deploy and install third-party applications on the BlackBerry smartphone over the wireless network.

Note: In order to wirelessly deploy third-party applications, it is necessary to have the installation files (.ALX and .COD extensions)


For BlackBerry Enterprise Server 5.0 to 5.0 SP4:

  1. Create and share the application folder.
  2. Define the share in the BlackBerry Administration Service.
  3. Publish the application.
  4. Configure the software configuration using BlackBerry solution management.
  5. (Optional) Configure the application deployment schedule by completing the following steps.
  6. Assign the software configuration to a user.
  7. View the status of a job.
  8. Verify that the application is installed on the BlackBerry smartphone.

 

Task 1

Complete the following steps to create and share the application folder:

  1. On the BlackBerry Enterprise Server or any network enabled computer, create a new folder.
  2. Right-click the folder and select Properties.
  3. Click the Sharing tab.
  4. Click Share this folder. (For Windows 2008 Server and Windows 2008 R2 Server select Advanced Sharing)
  5. Click Permissions.
  6. Click Add.
  7. Enter the service account, select Check Name, then OK.
  8. Under the Allow column, select the Full Control permission and close the Permissions window.
  9. Click on the Security tab.
  10. Click Permissions.
  11. Click Add.
  12. Enter the service account, select Check Name, then OK.
  13. Under the Allow column, select the Full Control permission and close the Permissions window.
  14. Click Close to close the Properties window of the folder.

If the above path should not be shared, see the BlackBerry Enterprise Server v5.0 Administration Guide. This is a Recommendation for larger environments where sharing of any sub-folders within the Program Files directory is prohibited or not desirable. If this is the case, a folder can be created at another location with the following structure: \Research In Motion\Shared\Applications\<application folder> .

Note: Only the Service Account(s) which are used to start the Policy Service and BlackBerry Administration Service require Full Control over this folder.

Task 2

Complete the following steps to define the share in the BlackBerry Administration Service:

  1. In the BlackBerry Administration Service, on the left pane, expand BlackBerry Solution Topology > BlackBerry Domain > Component View.
  2. Select BlackBerry Administration Service.
  3. Scroll to the bottom and select Edit Component.
  4. In the Software Management area, in the field next to BAS Application Shared Network Drive, type \\<hostname>\ <sharename> .
  5. Select Save all.

Task 3

Complete the following steps to publish the application:

  1. In the left-pane, under BlackBerry solution management, expand Software.
  2. Expand Applications.
  3. Select Add or Update Applications.
  4. Browse to a ZIP file containing the ALX and COD that is to be deployed, and click Next.
  5. Click Publish Application.
  6. Confirm that a new folder exists for the application under the Applications folder in the share created in Task 1.
  7. Confirm that PkgDBCache.xml and Specification.pkg exist in this new folder.

Task 4

Complete the following steps to configure the software configuration using BlackBerry solution management:

  1. Open the BlackBerry Administration Service.
  2. On the left pane, expand Software.
  3. Select Create a software configuration.
  4. Enter the name of the software configuration.
  5. Set the Disposition for unlisted Applications to Optional.
  6. Click Save.
  7. Click View Software Configuration List and select the new software configuration.
  8. Click Edit software configuration.
  9. Click the Applications tab.
  10. Click Add Applications To Software Configuration.
  11. Click Search.
  12. Check the box beside the name of the new software configuration application.
  13. Set the Disposition to Required or Optional.
  14. Set the Deployment to Wireless.
  15. Verify the Application control policy is set to the same setting as the Disposition in the above step 12.
  16. Click Add to Software Configuration.
  17. Click Save All.

Task 5 (This task is optional and recommended for testing only)

If the application needs to be installed as soon as possible, configure the application deployment schedule by completing the following steps:

  1. On the left pane, under Devices, expand Deployment jobs.
  2. Click Specify Job Schedule Settings.
  3. Click Edit Job Schedule Settings.
  4. Set the Default Delay to one minute (this can be left as default).
  5. Click Save All.

    Note: The Deploy Now option no longer exists.

Task 6

Complete the following steps to assign the software configuration to a user:

  1. On the left pane, under BlackBerry solution management, expand User.
  2. Click Manage Users.
  3. Click Search.
  4. Click on a 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.
  9. The software configuration should then appear under Current Software Configurations.
  10. Click Save all.

Task 7

After a software configuration is created and assigned to a BlackBerry smartphone user, or an existing software configuration that is currently assigned to a BlackBerry smartphone user is changed, the BlackBerry Administration Service creates a job to deliver BlackBerry Device Software, Java applications, or application settings to the BlackBerry smartphone.

To view the status of a job, complete the following steps:

  1. From the BlackBerry Administration Service, on the left pane, on the Devices menu, expand Deployment jobs.
  2. Click Manage deployment jobs.
  3. Click Search.
  4. In the search results area, in the Status column, view the status of the job.
  5. To view more information about a job or to change a job, click the ID of the job.

Task 8

Verify that the application is installed on the BlackBerry smartphone:

  1. From the home screen, open Options.
  2. Select Applications.
  3. Verify the application is listed.


BlackBerry Enterprise Server 4.0 to 4.1 SP7

  1. Create and share the application folder.
  2. Index the third-party application.
  3. Create a software configuration.
  4. Create or assign an application control policy.
  5. Assign the software configuration to a BlackBerry smartphone user or group.

 

Task 1

Complete the following steps to create and share the application folder:

  1. In <drive>:\Program Files\Common Files , right-click the Research In Motion folder.
  2. Right-click the folder and select Properties.
  3. Click the Sharing tab.
  4. Click Share this folder. (For Windows 2008 Server and Windows 2008 R2 Server select Advanced Sharing)
  5. Click Permissions.
  6. Click Add
  7. Enter the service account, select Check Name, then OK.
  8. Under the Allow column, clear all of the options except Read.
  9. Click Close to close the Properties window of the folder.

Note: If it is preferred not to share a directory on the BlackBerry Enterprise Server, install the most current version of BlackBerry Device Software on any workstation and then complete the previous steps on that workstation.

Note: Only the Service Account(s) which are used to start the Policy Service and BlackBerry Administration Service require Read access over this folder.

Task 2

Complete the following steps to index the third-party application:

  1. On the host computer in <drive>:\Program Files\Common Files\Research In Motion , create a folder called Shared.
  2. In the Shared folder, create a folder called Applications.
  3. In the Applications folder, create a folder for each third-party application that is to be sent to the BlackBerry smartphone.
  4. Copy the third-party application files, ALX or COD files, into their respective folders.
  5. From a command prompt, navigate to <drive>:\Program Files\Common Files\Research In Motion\Apploader.
  6. Type loader.exe /index and press Enter.
  7. In <drive>:\Program Files\Common Files\Research In Motion\Shared\Applications\<application name> , make sure that the pkgdbcache.xml files and specification.pkg files exist.

    Note: When indexing the application files, it is important to maintain the directory structure expected by the ALX file. See the following excerpt from an application loader (ALX) file for IBM Cognos 8 Go! Mobile software:

    <name>Cognos 8 Go! Mobile</name> (Name as it will appear in software configuration)
    <directory_blackberryVersion="[4.0.2,4.1.0)">4.0.2</directory>

    The preceding directory structure indicates that Cognos 8 Go! Mobile software for BlackBerry Device Software 4.0.2 is located in the 4.0.2 directory. The square left brace prior to the version numbers indicates versions starting at and including 4.0.2 are stored in this directory. The rounded right brace following the version numbers indicates versions up to but not including 4.1.0 are stored in this directory. Semicolons are acceptable, as well as commas between versions.

    When running loader.exe /index, the loader.exe tool goes to the following folder structure .. \shared\applications\cognos client\ and looks for COD files under the 4.0.2 folder. If this folder is not found, the application software in software configuration does not include the Cognos 8 Go! Mobile software.

    In the preceding example, the Cognos 8 Go! Mobile software is extracted to ..\shared\applications\Cognos client\Client\rim\4.0.2. For the software configuration to be successful, the COD files should be extracted to ..\shared\applications\Cognos client\4.0.2.

    or

    Modify the ALX file to change the directory path to something like the following:

    <directory _blackberryVersion="[4.0.2,4.1.0)">client\rim\4.0.2</ directory>

    If the <directory> </directory> tags do not exist in the ALX file, the COD files can be extracted to any folder under <drive>:\Program Files\Common Files\Research In Motion\Shared\Applications.

Task 3

Complete the following steps to create a software configuration:

  1. For BlackBerry Enterprise Server 4.0, start the BlackBerry Handheld Configuration Tool. For BlackBerry Enterprise Server 4.1, open BlackBerry Manager and click BlackBerry Domain on the left.
  2. Click the Configurations or Software Configurations tab.
  3. Click Add New Configuration.
  4. Type a name for the software configuration.
  5. Click the Change button next to Device Software Location.
  6. Type \\<hostname>\Research in Motion. The BlackBerry Device Software and the Applications folder should appear in the list.
  7. Change the Delivery field to wireless instead of wireline only for the software package to be pushed out over the wireless network.

Task 4

Complete the following steps to create or assign an application control policy:

To assign an existing application control policy, perform the following steps:

  1. In the Software Configurations window, click the application that is to be deployed.
  2. From the Policy drop-down list, click the name of the application control policy to assign to the application.

To create a new application control policy, perform the following steps:

  1. Click the Configurations or Software Configurations tab.
  2. Click Manage Application Policies.
  3. Click New and type a name for the application control policy in the Name field.
  4. Click the Disposition field and click Required.
  5. Click OK, and then click OK again.
  6. From the Configurations or Software Configurations tab, click the application.
  7. Click the name of the application control policy from the Policy drop-down list.

Task 5

Complete the following steps to assign the software configuration to a BlackBerry smartphone user or group:

For BlackBerry Enterprise Server 4.0, perform the following steps:

  1. Open the BlackBerry Handheld Configuration Tool.
  2. Click the Handhelds tab.
  3. Select the BlackBerry smartphone user.
  4. Click Assign Software Configuration and select the name of the software configuration from the list.

For BlackBerry Enterprise Server 4.1 to 4.1 SP7, perform the following steps:

  1. Open the BlackBerry Manager.
  2. In the left-pane, select BlackBerry Domain.
  3. Click the All Users or User Groups List tab.
  4. Select a BlackBerry smartphone user or group from the list.

    Note: BlackBerry smartphone users can also be selected by clicking on the name of the BlackBerry Enterprise Server on the left side and then selecting the Users tab.

  5. In the Tasks panel, expand Device Management.
  6. Click Assign Software Configuration.
  7. Select the name of the software configuration from the list.

    Note: The application is sent to the BlackBerry smartphone over the wireless network within four hours.

Disclaimer

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

   (a) that the terms of use for the documents found at www.blackberry.com/legal/knowledgebase 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 www.blackberry.com/btsc.