Wednesday, April 9, 2008

How to wirelessly deploy third-party applications to BlackBerry smartphones

Procedure
The following procedure outlines the tasks needed for the wireless deployment of third-party applications to BlackBerry smartphones.
Task 1 - Create and share the application folder
1. From the BlackBerry Enterprise Server, go to :\Program Files\Common Files\Research In Motion.
2. Right-click the Research In Motion folder and select Properties.
3. Select the Sharing tab.
4. Select the Share this folder option.
5. Click Permissions.
6. Clear all the selections except Allow for Read, and then close the Permissions window.
Note: If you do not want to share a directory on the BlackBerry Enterprise Server, you can install the latest BlackBerry Device Software on a workstation and then share the :\Program Files\Common Files\Research In Motion folder here.
Task 2 - Index the third-party application
1. On the host computer, go to C:\Program Files\Common Files\Research In Motion and create a folder called Shared.
2. In the Shared folder, create an Applications folder.
3. In the Applications folder, create a folder for the third-party application you want to deploy to the BlackBerry smartphone users.
4. Copy the third-party application files (such as ALX and COD files) into the folder you created in the prior step.
5. From a command prompt, go to :\Program Files\Common Files\Research in Motion\Apploader.
6. Run the command loader /index.
7. Go to the Applications\ folder created in step 2 and confirm that the pkgdbcache.xml and specification.pkg files exist.
When indexing the files, it is important that you maintain correct directory structure as expected by the ALX file. Here is an excerpt from an ALX file for Cognos® 8 Go! Mobile software:
Cognos 8 Go! Mobile (Name as it will appear in software configuration)
4.0.2
The above directory structure indicates that Cognos software for BlackBerry Device Software versions 4.02 and 4.1.0 is located in the 4.0.2 directory.
On running loader/index, the loader.exe utility will go to folder structure ..\shared\applications\cognos client\ and look for COD files under the 4.0.2 folder. If this folder is not found, application software in software configuration will not include the Cognos software.
Cognos application software was being extracted to ..\shared\applications\Cognos client\Client\rim\4.0.2. If you want the software configuration to work, the COD files should be extracted in ..\shared\applications\Cognos client\4.0.2.
-or-
Modify the ALX file to change the directory path to something like the following:
client/rim/4.0.2
If the tags do not exist in the ALX file, the COD files can be extracted to any folder under :\program files\common files\research in motion\shared\applications.
Task 3 - Create a Software Configuration
1. For BlackBerry Enterprise Server software version 4.0, launch BlackBerry Handheld Configuration Tool. For BlackBerry Enterprise Server software version 4.1, launch BlackBerry Manager and select BlackBerry Domain on the left.
2. Select the Software Configurations (or 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 \\\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 wireless only for the software package to be pushed out wirelessly.
Task 4 - Create or Assign an Application Control Policy
In the Software Configurations window, with the application highlighted, select the Application Control Policy to be assigned to the third-party software from the Policy drop-down list.

-or-

Create a new Application Control Policy by completing the following steps:
1. Select the Software Configurations (or Configurations) tab.
2. Click Manage Application Policies.
3. Click New and type a name for the policy in the Name field.
4. Select the Disposition field and specify the setting Required.
5. Click OK, and then OK again.
6. Back in the Software Configurations (or Configurations) tab, select the application.
7. Select the Application Control Policy from the Policy drop-down list.
Task 5 - Assign the Software Configuration to a BlackBerry smartphone user/group
For BlackBerry Enterprise Server software version 4.0, complete the following:
1. Select the Handhelds tab.
2. Select the BlackBerry smartphone user.
3. Click Assign Software Configuration and select the software configuration from the list.
For BlackBerry Enterprise Server software version 4.1, complete the following:
1. In the left-pane, select BlackBerry Domain.
2. Select the All Users or User Groups List tab.
3. Select a BlackBerry smartphone user or group from the list. (Note: BlackBerry smartphone users can also be selected from the BlackBerry Enterprise Server Users tab).
4. In the Tasks pane, expand Device Management.
5. Select Assign Software Configuration.
6. Select the software configuration from the list.
Note: The application will be wirelessly pushed to BlackBerry smartphone within four hours.

No comments: