Deploying Java Applications

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

Contents
Executive summary .............................................................................................................................................3
Audience ...............................................................................................................................................................3
BlackBerry solutions ...........................................................................................................................................3
BlackBerry Internet Solution.........................................................................................................................3
BlackBerry Enterprise Solution.....................................................................................................................4
Developing Java applications for BlackBerry devices...................................................................................5
Application deployment .....................................................................................................................................5
Deployment options .......................................................................................................................................5
Overview of application deployment from a user’s computer .....................................................................6
Using the BlackBerry Desktop Software .........................................................................................................6
Usage .........................................................................................................................................................6
Prerequisites ....................................................................................................................................................6
Application deployment using BlackBerry Desktop Software.................................................................7
Using the BlackBerry Application Web Loader ..............................................................................................8
Usage .........................................................................................................................................................8
Prerequisites ....................................................................................................................................................8
Application deployment using the BlackBerry Application Web Loader...............................................10
Using the standalone Application Loader.......................................................................................................10
Usage .........................................................................................................................................................10
Prerequisites ....................................................................................................................................................11
Application deployment using the standalone Application Loader .......................................................11
Application deployment using the standalone Application Loader in automated mode ...................12
Overview of application deployment over a wireless network ....................................................................13
Using a web browser...........................................................................................................................................13
Usage .........................................................................................................................................................13
Prerequisites ....................................................................................................................................................13
Application deployment using a web browser ...........................................................................................13
Using the BlackBerry Enterprise Server and Application Control policy rules.........................................14
Usage .........................................................................................................................................................14
Prerequisites ....................................................................................................................................................14
Application deployment using the BlackBerry Enterprise Server and
Application Control policy rules ...................................................................................................................15
Related resources................................................................................................................................................19

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

Deploying Java Applications 3

Executive summary
This document provides information about how to distribute and install applications written in Java™ on
BlackBerry® devices and BlackBerry-enabled devices (BlackBerry Connect™ or BlackBerry Built-In™ devices),
and it directs you to the related development and administration resources that are available on
www.blackberry.com. The document describes the BlackBerry Internet Solution™ and the BlackBerry Enterprise
Solution™ and highlights the similarities and differences in the deployment of third-party applications in the two
solutions. Third-party applications are applications that Research In Motion (RIM) did not develop. They are
sometimes referred to as custom applications.
The document describes the following methods for deploying applications:
• BlackBerry Desktop Software (BlackBerry device connected to a user’s computer)
• BlackBerry Application Web Loader (BlackBerry device connected to a user’s computer)
• Standalone Application Loader, also referred to as Application Loader Lite (BlackBerry device connected to a
user’s computer)
• web browser (wireless download)
• Application Control policies (wireless push)

Audience
This document is intended for system administrators and application developers. It assumes that you have a
working knowledge of the following areas:
• BlackBerry Enterprise Server Version 4.0 or BlackBerry Internet Solution Version 2.0
• Java applications
If you have installed BlackBerry Enterprise Server Version 4.1, visit www.blackberry.com/knowledgecenterpublic/
to read the BlackBerry Enterprise Server System Administration Guide for information about application
distribution and installation.

BlackBerry solutions
The BlackBerry Internet Solution and the BlackBerry Enterprise Solution have been designed to address the
increasingly diverse needs of mobile professionals in a variety of work environments.

BlackBerry Internet Solution

The BlackBerry Internet Solution has been developed for individual users and small and medium-sized
organizations. It is designed to provide mobile connectivity to the Internet, Internet-based email, and Internet-
based applications through a wireless service provider.
The BlackBerry Internet Solution includes the following components:
• BlackBerry devices or BlackBerry-enabled devices
• BlackBerry Internet Service™, which provides delivery of email messages, mobile access to email
attachments and images, instant messaging, and access to web pages and content on the Internet
• BlackBerry Desktop Software
The BlackBerry Internet Solution can also include third-party applications and BlackBerry accessories.

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

4 Deploying Java Applications

Typical message flow through the BlackBerry Internet Solution

BlackBerry Enterprise Solution

The BlackBerry Enterprise Solution has been developed for the mobile workforce in organizations that can
support the BlackBerry Enterprise Server. This solution is designed to provide access to Internet-based resources,
as the BlackBerry Internet Solution does. In addition, the BlackBerry Enterprise Solution provides users with
integrated access to an enterprise’s infrastructure, including email, data, applications, and intranet.
The BlackBerry Enterprise Solution includes the following components and services:
• BlackBerry devices or BlackBerry-enabled devices
• The BlackBerry Enterprise Server software, which acts as the centralized link between BlackBerry devices,
wireless networks, and enterprise applications. The BlackBerry Enterprise Server integrates with an
organization’s messaging and collaboration systems and other resources. All data between applications and
BlackBerry devices flows centrally through the BlackBerry Enterprise Server.
• The BlackBerry Mobile Data System™ (BlackBerry MDS™), which is a framework that you can use to create,
distribute, and manage applications for the BlackBerry Enterprise Solution.

Typical message flow through the BlackBerry Enterprise Solution

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

Deploying Java Applications 5

Developing Java applications for BlackBerry devices

The BlackBerry Java Development Environment (BlackBerry JDE) provides tools for building Java applications for
BlackBerry devices. With the BlackBerry JDE, you can build and test Java applications and package them for
deployment either from a user’s computer or wirelessly. In the BlackBerry JDE, you can compile Java applications
and generate .cod files, which are the application files that can run on BlackBerry devices. The BlackBerry JDE
also provides tools to generate .jad or .alx descriptor files, which are used during the application deployment
process. Visit the BlackBerry Developer Zone at www.blackberry.com/developers/ for resources to assist in the
development of Java applications for BlackBerry devices.
MIDlets are Java applications that conform to the Mobile Information Device Profile (MIDP) standard and
that are designed to run on any mobile device that can run Java applications. Most MIDlets are distributed as
.jar files. The BlackBerry JDE provides tools for converting existing MIDlets that are in the form of .jad and .jar
files into .cod files for use on a BlackBerry device. Visit www.blackberry.com/knowledgecenterpublic/ to read
article DB-00055, which provides information about recompiling MIDlets.

Application deployment
The BlackBerry solutions provide several options for deploying third-party applications. Some of these options
can be used to deploy applications on any BlackBerry device, while other options are exclusive to BlackBerry
devices that are part of the BlackBerry Enterprise Solution.

Deployment options
You have five options for deploying third-party applications on BlackBerry devices.

Application BlackBerry BlackBerry Notes

deployment option Internet Enterprise
Solution Solution
Application deployment from a user’s computer
BlackBerry Desktop 3 3 You can use this option for most applications.
Software The option uses the Application Loader that is installed
as part of the BlackBerry Desktop Software.
An automated application installer installs the
application’s .alx file locally on the user’s computer. The
user then navigates to the file and installs it on the
BlackBerry device.
BlackBerry 3 3 This option does not require the BlackBerry Desktop
Application Web Software. The option is available for BlackBerry devices
Loader but not for BlackBerry-enabled devices.
You can use this option to install applications from a
web site using the web browser on the user’s computer.
Standalone 3 This option requires the BlackBerry Device Manager but
Application Loader does not require a full installation of the BlackBerry
Desktop Software.
This is the same Application Loader tool that is included
with the Desktop Software, but it is packaged
separately so that an administrator can install it in a
shared network location.

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

6 Deploying Java Applications

Application BlackBerry BlackBerry Notes

deployment option Internet Enterprise
Solution Solution
Application deployment over a wireless network
Web browser or 3 3 With this option, a BlackBerry device does not require a
BlackBerry Browser physical connection to a computer.
In a BlackBerry Internet Solution environment, users
can download a publicly available application from an
Internet site by using a web browser on their BlackBerry
devices.
In a BlackBerry Enterprise Solution environment, users
can download an application using either a web
browser for an Internet site or the BlackBerry Browser
for an intranet site.
BlackBerry 3 The administrator in a BlackBerry Enterprise Solution
Enterprise Server environment can use this option to push applications
and Application and application upgrades to BlackBerry devices.
Control policy rules

Overview of application deployment from a user’s computer

Users can install an application on a BlackBerry device by connecting the BlackBerry device to a computer. The
BlackBerry device then uses either the BlackBerry Device Manager or the BlackBerry Application Web Loader to
download and install applications.
In an enterprise environment, you can connect a BlackBerry device to the Handheld Configuration Tool (for
Microsoft® Exchange) or the BlackBerry Manager (for IBM® Lotus® Domino® or Novell® GroupWise®) and then
use the Application Loader to install the application. Alternatively in this environment, you can provide a link to
the standalone Application Loader so that users can download and install applications from a shared location.

Using the BlackBerry Desktop Software

Typically, an .alx identifier file and the application .cod files are installed locally on the user’s computer by an
automated application installer that is created in the BlackBerry JDE by an application developer. Using the
Application Loader tool, which is part of the BlackBerry Desktop Software, a user navigates to the .alx file and
installs the application on the BlackBerry device.

Usage
The BlackBerry Desktop Software is designed to present a familiar environment for users to download and install
new or updated applications on BlackBerry devices. This software can be used to install or upgrade both the
BlackBerry Device Software and third-party applications.

Prerequisites
Component Requirement
BlackBerry device or • able to run Java applications
BlackBerry-enabled
device
User’s computer • Microsoft Windows® 2000 or Microsoft Windows XP
• BlackBerry Desktop Software Version 4.0 or later
• RIM® USB drivers and USB connection for the BlackBerry device

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

Deploying Java Applications 7

Component Requirement
Application • .alx files and .cod files: The .alx file is an identifier for the application files.
A .cod file contains compiled and packaged application code. The Application
Loader requires both of these file types to install an application.
• optional modules: Some third-party applications require optional modules that
are part of the BlackBerry Device Software. In these cases, the required
modules are listed in the .alx file within a <requires> tag. If these required
modules are not preloaded on the BlackBerry device, you might need to install
the BlackBerry Device Software for the BlackBerry device on the user’s
computer. Visit www.blackberry.com/knowledgecenterpublic/ to read the
BlackBerry Application Developer Guide, Volume 1: Fundamentals for more
information about dependencies.
• installer: If you want the installer to update registry settings so that an
application displays automatically in the Application Loader in BlackBerry
Desktop Manager, visit the Technical Knowledge Center at
www.blackberry.com/knowledgecenterpublic/ to read article DB-00061, “How
to — Update the registry to deploy Java applications using Desktop Manager.”

Application deployment using BlackBerry Desktop Software

In both the BlackBerry Internet Solution environment and the BlackBerry Enterprise Solution environment,
perform the following actions to deploy a Java application using the BlackBerry Desktop Software.

Action Procedure
Make the application The administrator or application developer completes this action.
available to users.
1. Obtain the application installer from the application’s vendor, developer, or
wireless service provider.
Note: The installer is usually distributed as either an .exe file or a .zip file.
2. If the installer is a .zip file, unzip it.
3. Run the .exe file.
This action places the .alx identifier file and the .cod file in an installation
folder on the user’s computer.
Note: In an enterprise environment, you can perform several actions at this
point that can affect the distribution and behavior of the application. These
actions include the following:
• Index the application.
• Set a software configuration to include the application.
• Set an Application Control policy rule for the application.
See “Using the BlackBerry Enterprise Server and Application Control policy
rules” on page 14 for information about how to complete these tasks.

Install the application. Typically, the user completes this action, but an administrator in an enterprise
environment might complete it instead.
1. Connect the BlackBerry device to your computer.
2. In the BlackBerry Desktop Manager, open Application Loader.
3. In the Application Loader wizard, click Next.
4. Type your password, if prompted, and click Next.
5. In the Device Application Selection window, click Add.
6. Navigate to the folder of the program that you want to add.

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

8 Deploying Java Applications

Action Procedure
7. Click the .alx file for the program, and click Open.
8. After the application displays in the Application Name list, make sure that its
check box is selected, and click Next.
9. If the Device Backup window displays, select a backup option, and click Next.
10. Verify the information that displays in the Completing the Application Loader
Wizard window, and click Finish.
The application installs, and you are notified when the installation is complete.
11. Click Close.

Using the BlackBerry Application Web Loader

The BlackBerry Application Web Loader can simplify the deployment of third-party applications on BlackBerry
devices. This tool, which is based on Microsoft ActiveX®, is added to a web page.
Users connect their BlackBerry devices to a computer and then use the computer’s browser to navigate to the
web page that contains the BlackBerry Application Web Loader.
After a user opens the BlackBerry Application Web Loader and accepts the permission prompt, the tool installs on
the user’s computer if it is not already present and communicates with the BlackBerry device connected to the
computer. Using the .jad and .cod files for the application that are stored on the web server, the tool installs the
application on the BlackBerry device.
When you enable the BlackBerry Application Web Loader on a web page, use any scripting language that works
with Microsoft Internet Explorer and Microsoft ActiveX.
The BlackBerry Application Web Loader supports only .cod files. To install a MIDlet, convert the .jar file to a .cod
file. Visit www.blackberry.com/knowledgecenterpublic/ to read the BlackBerry Application Developer Guide,
Volume 1: Fundamentals for information about how to compile .java and .jar files into the .cod file format. In
addition, the BlackBerry Application Web Loader Developer Guide provides developer information and a sample
development template.

Usage
The BlackBerry Application Web Loader is designed to facilitate the download and installation of new or updated
applications on to BlackBerry devices. You can host applications centrally on a company intranet or public web
server, making it easy to post application updates for BlackBerry device users to download.
Users connect their BlackBerry devices to a computer with the RIM USB drivers installed and a USB connection,
visit the hosted web site, and load applications on to their BlackBerry devices. They do not require the BlackBerry
Desktop Software.

Prerequisites
Component Requirement
BlackBerry device or • able to run Java applications
BlackBerry-enabled Notes: Users do not require the BlackBerry Desktop Software to download and
device install the .cod files.
You cannot use the BlackBerry Application Web Loader to install applications from a
web page to a BlackBerry Connect device that was manufactured or distributed by a
third party.

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

Deploying Java Applications 9

Component Requirement
User’s computer • Microsoft Windows 2000 or Microsoft Windows XP
• Microsoft Internet Explorer Version 5.0 or later (users must use Microsoft
Internet Explorer to access the web site with the BlackBerry Application Web
Loader)
• Microsoft ActiveX Version 8.0 or later
• BlackBerry Application Web Loader (if the Application Web Loader is not
present, it is loaded as the first step in the installation)
• RIM USB drivers and USB connection for the BlackBerry device
Web server Configure the following Multipurpose Internet Mail Extensions (MIME) types on the
web server to enable the download and installation of Java applications on
BlackBerry devices:
• .cod files: application/vnd.rim.cod
• .jad files: text/vnd.sun.j2me.app-descriptor
Application • scripting language: Use any language that works with Microsoft Internet
Explorer and Microsoft ActiveX.
• AxLoader.cab file: Place this file in the same folder as the web page .html files
(or update the <object> element URL information in the .html file to the new
location).
• .jad files and .cod files: The .jad file is the application descriptor that provides
information about the application and the location of .cod files. A .cod file
contains compiled and packaged application code. Both of these file types are
required to install an application.
• maximum .jad file size: The maximum file size is 4096 bytes.
• maximum number of .cod files: The maximum number of .cod files is 12.
• MIDlet support: The BlackBerry Application Web Loader supports Connected
Limited Device Configuration (CLDC) applications that reference the
BlackBerry application programming interface (BlackBerry API) or MIDlets that
have been converted to the .cod file format.
• installer: If you want the installer to update registry settings so that an
application displays automatically in the Application Loader, visit the Technical
Knowledge Center at www.blackberry.com/knowledgecenterpublic/ to read
article DB-00061.

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

10 Deploying Java Applications

Application deployment using the BlackBerry Application Web Loader

In both the BlackBerry Internet Solution environment and the BlackBerry Enterprise Solution environment,
perform the following actions to deploy a Java application using the BlackBerry Application Web Loader.

Action Procedure
Enable the BlackBerry The administrator or application developer completes this action.
Application Web
Loader on a web 1. Create a web page for application distribution.
server. 2. Create or obtain the .jad and .cod files for the application.
3. Place the AxLoader.cab file in the same folder as the web page’s .html files.
4. Place the application .jad and .cod files on the web server that hosts the web
page.
5. Reference a specific version of the BlackBerry Application Web Loader.
6. Associate the BlackBerry Application Web Loader with the application .jad file.
7. To load the .jad file, invoke the application web loader loadJad() method.
Use a string parameter that represents one of the following:
• .jad file is in the same location as the AxLoader.cab file: Use the .jad
filename.
• .jad file is in a different location from the AxLoader.cab file: Use the
relative location address of the .jad file.
8. Distribute the web page link to users.
Note: The BlackBerry Application Web Loader requires the user password on the
BlackBerry device before installing an application. If a password is set, the
AxLoaderPassword control is used to obtain the device password. This control is
included in the AxLoader.cab file. See the BlackBerry Application Web Loader
Developer Guide for more information about how to obtain a device password.

Install the application Typically, the user completes this action.

on the BlackBerry
device. 1. Connect the BlackBerry device to your computer.
2. Access the web page using Microsoft Internet Explorer on your computer.
3. If the current version of the BlackBerry Application Web Loader is not already
installed, accept the installation on the computer.
4. Follow the prompts to install the application.

Using the standalone Application Loader

The standalone Application Loader that is included with the BlackBerry Enterprise Server software is the same
tool as the Application Loader that is part of the BlackBerry Desktop Software. The standalone tool is provided so
that you can make it available from a central network location for users to install or upgrade applications. The
BlackBerry Desktop Software that is installed on the user’s computer manages the connection between the
wizard and the user’s BlackBerry device.

Usage
To use the standalone Application Loader, you create a shared folder or network drive. In this shared location,
you place the applications that you want to deploy and then index the applications. You then provide users with
a link to the shared location.

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

Deploying Java Applications 11

Application deployment in automated mode

You can use the standalone Application Loader to deploy applications in automated mode. Automated mode is
designed to simplify application deployment to a large number of client computers in an automated manner
without the need for user interaction.

Prerequisites
Component Requirement
BlackBerry device or • able to run Java applications
BlackBerry-enabled
device
User’s computer • Microsoft® Windows® 2000 or Microsoft Windows XP
• RIM USB drivers and USB connection, or a serial connection (for serial devices)
• BlackBerry Desktop Software Version 4.0 (or BlackBerry Device Manager
Version 4.1 for automated installation)
Application • .alx file and .cod files: The .alx file is an identifier file for the application files.
A .cod file contains compiled and packaged application code. The Application
Loader requires both of these file types to install an application.
• optional modules: Some third-party applications are dependent on optional
modules that are part of the BlackBerry Device Software. In these cases, the
required modules are listed in the .alx file within a <requires> tag. If these
required modules are not preloaded on the BlackBerry device, then you might
need to install the BlackBerry Device Software for the specific device model on
the local computer. Visit www.blackberry.com/knowledgecenterpublic/ to read
the BlackBerry Application Developer Guide, Volume 1: Fundamentals for more
information about dependencies.
• required applications: To set an application as required on a user’s BlackBerry
device, complete the following actions:
• Open the .alx file.
• Locate the copyright statement. For example, <copyright>Copyright 1998-
2006 Research In Motion</copyright>.
• Add the following tag: <required>true</required>.
Each application that the .alx file references is now required in the Application
Loader.

Application deployment using the standalone Application Loader

In the BlackBerry Enterprise Solution environment, perform the following actions to deploy a Java application
using the standalone Application Loader.

Action Procedure
Add the application The administrator or application developer completes these actions.
files to a shared folder.
1. Create or obtain the .alx and .cod files for the application.
2. Create a uniquely named folder for the application, maintaining
the application’s file structure, in a shared network location:
<drive:>\Program Files\Common Files\Research In
Motion\Shared\Applications\.
3. Copy the .cod, .alx, and .dll files to the unique folder.

Index the application ¾ See “Using the BlackBerry Enterprise Server and Application Control policy
rules” on page 14 for information about how to index an application.

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

12 Deploying Java Applications

Action Procedure
Share the application 1. Navigate to the application’s folder.
folder.
2. Right-click the folder, and then click Properties.
3. Click the Sharing tab.
4. Select Share this folder. Provide read-only permissions.
5. Set any other required options, and then click OK.

Set a software ¾ This action is optional. Set a software configuration if you want the Handheld
configuration. Configuration Tool (for Microsoft Exchange) or the BlackBerry Manager (for
IBM Lotus Domino or Novell GroupWise) to monitor or track whether users
install an application on their BlackBerry devices. See “Using the BlackBerry
Enterprise Server and Application Control policy rules” on page 14 for
information about how to set a software configuration.

Distribute a link to the ¾ Using your preferred distribution method (for example, a link in a message
application. or a link on an intranet web page), provide users with a URL link to the
loader.exe file. For example, \\<shared computer name>\Research In
Motion\Apploader\loader.exe.

Install the application. Typically, the user completes this action.

Note: The BlackBerry Desktop Software must be installed on your computer.
1. Connect the BlackBerry device to your computer.
Note: Do not disconnect your BlackBerry device from your computer until the
installation is complete.
2. If prompted, type your BlackBerry device password, and then click Next.
3. On your computer, click the link to the loader.exe file that was provided by
your administrator.
4. If a security warning displays, click Run. The Application Loader wizard
displays.
5. Follow the on-screen instructions. You are notified when the loading process
completes.
6. Click Close.

Application deployment using the standalone Application Loader in automated mode

In a BlackBerry Enterprise Solution environment with the BlackBerry Device Manager Version 4.1, perform the
following actions to deploy a Java application using the standalone Application Loader in automated mode.

Action Procedure
Deploy the application ¾ The actions required to deploy an application in automated mode are identical
in automated mode. to the actions using the Application Loader described on page 11, with the
following exception.
When you distribute the application link, specify the loading command based
on the type of connection (USB or serial) that the BlackBerry device uses, as
shown in the following examples:
• USB: \\<shared computer name>\Research In
Motion\Apploader\loader.exe /defaultUSB /forceload
• Serial: \\<shared computer name>\Research In
Motion\Apploader\loader.exe

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

Deploying Java Applications 13

Overview of application deployment over a wireless network

Wireless application downloads are available to users in both the BlackBerry Internet Solution and the
BlackBerry Enterprise Solution environments. With wireless deployment, a BlackBerry device is not physically
connected to another computer.
In both environments, users can download and install applications over a wireless network by browsing to a
public Internet site using the BlackBerry Internet Browser or the wireless solution provider’s Wireless Application
Protocol (WAP) Browser. Users in a BlackBerry Enterprise Solution environment can also download applications
by browsing to an intranet site using the BlackBerry Browser.

Using a web browser

The application provider places the .jad file and application .cod or .jar files on a web server. To install the
application, the user points a web browser on the BlackBerry device to the .jad file, and the application installs
automatically.

Usage
Wireless application download using a web browser on the BlackBerry device is designed to provide a flexible
way for users to install new applications without a connection to another computer.

Prerequisites
Component Requirement
BlackBerry device • able to run Java applications
Web server Configure the following MIME types on the web server to allow the download and
installation of Java applications on BlackBerry devices:
• .cod files: application/vnd.rim.cod
• .jad files: text/vnd.sun.j2me.app-descriptor
• .jar files (optional): application/java-archive
Application The following file types are required to install an application:
• .jad file: The .jad file is the application descriptor that provides information
about the application and the location of the application’s .cod or .jar files.
• .cod or .jar files: These files contain compiled and packaged application code.

Application deployment using a web browser

In both the BlackBerry Internet Solution environment and the BlackBerry Enterprise Solution environment,
perform the following actions to deploy a Java application using a web browser.

Action Procedure
Install the application The administrator or application developer completes these actions.
on the web server.
1. Create a web page for application distribution.
2. Create or obtain the .jad and .cod or .jar files for the application.
3. Place the .jad and .cod or .jar files on the web server.

Send the application’s ¾ Using your preferred distribution method (for example, a link in a message or a
link to users. link on an intranet web page), provide users with a URL link to the .jad file.

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

14 Deploying Java Applications

Action Procedure
Install the application Typically, the user completes this action.
on a BlackBerry
device. 1. Open a browser on the BlackBerry device.
2. Click Download. Using the URL specified in the .jad file, the BlackBerry device
begins downloading the application .cod or .jar files using HTTP.
3. After verifying that there is sufficient space on the BlackBerry device, the
BlackBerry device installs the application and presents a notification message
at completion.

Using the BlackBerry Enterprise Server and Application Control policy rules
Application Control policy rules are designed to provide you with the ability to centrally manage the
third-party applications that are present on BlackBerry devices and to control the privileges associated
with each application. For example, you can specify an application’s operating environment, require or
exclude applications, and set policies for API usage, internal data access, and external connections. You can
also audit or remotely administer applications.
To deploy an application from the BlackBerry Enterprise Server using Application Control policy rules, you
provide the .alx and .cod files for the application on a shared network drive. You create a software configuration
to send the application wirelessly to each user account that is assigned the Application Control policy rule within
the software configuration.
Visit www.blackberry.com/knowledgecenterpublic/ to read the BlackBerry Enterprise Server Handheld
Management Guide for your platform for more information about how to use Application Control policy rules.

Usage
Application Control policy rules work with BlackBerry devices that can connect to a BlackBerry Enterprise Server.
When you set an Application Control policy rule, you can install third-party applications without user
intervention. This helps to make sure that the mobile professionals in your organization always have access to
the most complete and up-to-date applications.

Prerequisites
Component Requirement
BlackBerry device • able to run Java applications
• BlackBerry Device Software Version 4.0 and later
BlackBerry Enterprise • BlackBerry Enterprise Server software Version 3.0 or later
Server
Application The following files are installed on the shared network drive:
• .alx file and .cod files: The .alx file is an identifier file for the application files.
A .cod file contains compiled and packaged application code. The Application
Loader requires both of these file types to install an application.
• optional modules: Some third-party applications depend on optional modules
that are part of the BlackBerry Device Software. In these cases, the required
modules are listed in the .alx file within a <requires> tag. If these required
modules are not preloaded on the BlackBerry device, then you might need to
install the BlackBerry Device Software for the specific device model on the
local computer.
Visit www.blackberry.com/knowledgecenterpublic/ to read the BlackBerry
Application Developer Guide, Volume 1: Fundamentals for more information
about dependencies.

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

Deploying Java Applications 15

Application deployment using the BlackBerry Enterprise Server and Application Control
policy rules
In the BlackBerry Enterprise Solution environment, perform the following actions to deploy a Java application
using the BlackBerry Enterprise Server and Application Control policy rules.
Note: Allow four hours for application deployment on multiple BlackBerry devices.

Action Procedure
Add the application The administrator or application developer completes these actions.
files to a shared folder.
1. Create or obtain the .alx and .cod files for the application.
2. Create a uniquely named folder, maintaining the application’s file structure, in
the network location that hosts your shared applications:
<drive:>\Program Files\Common Files\Research In
Motion\Shared\Applications\.
3. Copy the .alx, .cod, and .dll files to the unique folder.

Configure a required This action is optional. The administrator or application developer completes the
application. action for a third-party application that is required on the BlackBerry device. When
an application is configured as “required,” users cannot remove it from their
BlackBerry devices.
1. Open the .alx file.
2. In the <application> element, type <required>true</required>.
3. Save the .alx file.

Index the application. The Application Loader reads the list of installed software in the software index and
uses the index to locate the applications to install.
1. At the command prompt, type cd <drive:>\Program Files\Common
Files\Research In Motion\Apploader.
2. Type loader.exe /index. The Application Loader builds the software index
structure and adds any missing index files.
Note: If you modify an .alx file after you create a software index, re-index the
applications.
• At the command prompt, type cd <drive:>\Program Files\Common
Files\Research In Motion\Apploader.
• Type loader.exe /reindex.

Share the application Software configurations must be able to access the application through a Universal
folder. Naming Convention (UNC) path to the shared network drive.
1. Navigate to the application’s folder.
2. Right-click the folder, and then click Properties.
3. Click the Sharing tab.
4. Select Share this folder. Provide read-only permissions.
5. Set any other required options, and then click OK.

Set an IT policy rule This action is optional.

for the user account. Notes: You must set the Disallow Third Party Application Downloads policy to
False.
The following steps describe the procedure for setting an IT policy rule for the
BlackBerry Enterprise Server Version 4.0.4. If you have a BlackBerry Enterprise
Server Version 4.1, see the BlackBerry Enterprise Server System Administration

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

16 Deploying Java Applications

Action Procedure
Guide for your platform. The BlackBerry Enterprise Server Policy Reference Guide
provides information about setting IT policy rules.
For Microsoft Exchange
1. In the Handheld Configuration Tool, right-click the name of the BlackBerry
Enterprise Server.
2. Click IT Policy.
3. Click New.
4. Type a policy name.
5. From the Policy rule list, add policy rules to the IT policy.
6. Click OK.
For IBM Lotus Domino and Novell GroupWise
1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.
2. On the Global tab, click Edit Properties.
3. Click IT Policy.
4. In the IT Policy Administration section, double-click IT Policies.
5. Click New.
6. Double-click IT Policy Name.
7. Type a name for the new policy.
8. Configure the policy rules by performing the following actions:
• In the left pane, click a policy group.
• In the right pane, double-click the rule to assign a value or to choose
between True and False.
9. Click OK.

Assign users to the Users can be assigned to only one IT policy.

IT policy rule.
For Microsoft Exchange
1. In the Policy Name list, click the new IT policy.
2. Click Edit User List.
3. Click Add Users to This Policy.
4. Click the user to add to the policy.
5. Click Add.
6. Click Close.
7. Click OK.
For IBM Lotus Domino and Novell GroupWise
Manage the IT policy-to-user assignment from either the IT policy or the user
account.

Manage an IT policy assignment in the policy

1. In the BlackBerry Manager, in the left pane, click BlackBerry Domain.
2. On the Global tab, click Edit Properties.
3. Click IT Policy.

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

Deploying Java Applications 17

Action Procedure
4. In the IT Policy Administration section, double-click IT Policy to User
Mapping.
5. In the left pane, click a user.
6. In the right pane, click an IT policy.
7. Repeat steps 5 and 6 to move additional users to the IT policy.
8. Click OK.

Manage an IT policy assignment in the user account

1. In the BlackBerry Manager, in the left pane, click the server name.
2. In the User List, double-click a user.
3. Click IT Policy.
4. Click IT Policy Name.
5. From the list, select a new IT policy.
6. Click OK.

Set a software This action is optional. Complete the step if you want the Handheld Configuration
configuration. Tool (for Microsoft Exchange) or the BlackBerry Manager (for IBM Lotus Domino or
Novell GroupWise) to monitor or track whether users install an application on their
BlackBerry devices.
1. In the Handheld Configuration Tool (Microsoft Exchange) or in the BlackBerry
Manager (IBM Lotus Domino or Novell GroupWise), in the left pane, click
Software Configurations.
2. Click Add New Configuration.
3. In the Configuration Name field, type a name.
4. In the Configuration Description field, type a description.
5. To define the application’s location, click Change, and then specify the
location. For example, \\<shared computer name>\Research In Motion\.
6. Click OK.
7. In the Application Name list, select the check box beside each BlackBerry
device series that you are configuring.
8. Select the check box for each application that you are installing.
9. Click Policies to define Application Control policy rules for the application.
From the Policy list, select an Application Control policy rule for the
third-party application.
10. Click OK.

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

18 Deploying Java Applications

Action Procedure
Set an Application This action is required if you create an Application Control policy rule and are not
Control policy rule. using one of the default policies.
Visit www.blackberry.com/knowledgecenterpublic/ to read the BlackBerry
Enterprise Server Handheld Management Guide for your platform for more
information about Application Control policy rule options.
1. In the Handheld Configuration Tool (Microsoft Exchange) or in the BlackBerry
Manager (IBM Lotus Domino or Novell GroupWise), in the left pane, click
Software Configurations.
2. Click Manage Application Policies.
3. Click New.
4. Type a new policy name.
5. Customize the properties for the Application Control policy rules.
6. Click OK.

Assign an Application This step is optional. Assign an Application Control policy rule if you want to
Control policy rule to manage an application after it is installed.
an application.
1. In the Handheld Configuration Tool (Microsoft Exchange) or in the BlackBerry
Manager (IBM Lotus Domino or Novell GroupWise), in the left pane, click
Software Configurations.
2. Click Manage Application Policies.
3. In the Policy column, specify the policy to assign to the application.
• To assign an Application Control policy rule to all applications that are not
already assigned to an Application Control policy rule, click a policy rule at
the application software level.
• To assign an Application Control policy rule at the application software
level, click <default>. An asterisk is added to the policy name.
• To assign the default Application Control policy rules that are
preconfigured on the BlackBerry device, click <none>.
4. Click OK. When you assign a new Application Control policy rule, the
BlackBerry Enterprise Server automatically sends the policy to the specified
BlackBerry devices.

Send the application 1. In the Handheld Configuration Tool (Microsoft Exchange) or in the BlackBerry
to the BlackBerry Manager (IBM Lotus Domino or Novell GroupWise), click Software
device over the Configurations.
wireless network.
2. In the Configuration Name list, click a software configuration.
3. Click Edit Configuration.
4. Expand the application, and then select the check boxes beside the
applications to push over the wireless network.
5. From the Delivery list, select Wireless.
6. Click OK.

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

Deploying Java Applications 19

Related resources
Resource Description
BlackBerry Application Web Loader Developer • installation of applications from a web page
Guide
• AxLoader.cab controls
• BlackBerry Application Web Loader web page template
BlackBerry Enterprise Server System • IT policy rules
Administration Guide
• selection of a network drive
BlackBerry Enterprise Server Handheld • third-party application controls
Management Guide
• IT policy rules for third-party applications
• Application Control policy rules
• installation and configuration of third-party
applications on a BlackBerry device
BlackBerry Enterprise Server Policy Reference • IT policy rules for third-party applications
Guide
• access to enterprise applications
BlackBerry Java Development Environment Volume 1: Fundamentals
Application Developer Guide • BlackBerry Integrated Development Environment
• third-party application development, packaging,
distribution, and installation
• integration of enterprise applications
Volume 2: Advanced Topics
• BlackBerry device applications
• BlackBerry Browser integration
• data storage and backup
BlackBerry MIDlet Developer Guide • design and creation of MIDlets for BlackBerry devices
• BlackBerry and MIDP APIs
Managing Wireless Data Transport in the • Part 1: Understanding TCP and HTTP transport options
BlackBerry Solution Version 4.0 for Java applications for BlackBerry
• Part 2: Alternative Transport Options for Java
applications for BlackBerry
www.blackberry.com/knowledgecenterpublic/ • BlackBerry technical documentation
• DB-00019: What Is — An .alx file
• DB-00055: How to — Compile a MIDlet into a COD file
• DB-00061: How to — Update the registry to deploy
Java applications using Desktop Manager
www.blackberry.com/developers/ • BlackBerry Developer Zone
• BlackBerry device documentation
• developer support
• application development tools for the BlackBerry device

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com

20 Deploying Java Applications

Part number: 9943440 Version 2

© 2006 Research In Motion Limited. All Rights Reserved. The BlackBerry and RIM families of related marks, images, and
symbols are the exclusive properties of Research In Motion Limited. RIM, Research In Motion, BlackBerry, “Always On, Always
Connected” and the “envelope in motion” symbol are registered with the U.S. Patent and Trademark Office and may be
pending or registered in other countries.
IBM, Lotus, and Domino are either registered trademarks or trademarks of International Business Machines Corporation in
the United States, other countries, or both. Java is either a registered trademark or a trademark of Sun Microsystems, Inc. in
the United States or other countries. Microsoft, Windows, and ActiveX are either registered trademarks or trademarks of
Microsoft Corporation in the United States and/or other countries. Novell and GroupWise are either registered trademarks or
trademarks of Novell, Inc., in the United States and other countries. All other brands, product names, company names,
trademarks and service marks are the properties of their respective owners.
The BlackBerry device and/or associated software are protected by copyright, international treaties, and various patents,
including one or more of the following U.S. patents: 6,278,442; 6,271,605; 6,219,694; 6,075,470; 6,073,318; D445,428;
D433,460; D416,256. Other patents are registered or pending in various countries around the world. Visit
www.rim.com/patents.shtml for a current list of RIM (as hereinafter defined) patents.
This document is provided “as is” and Research In Motion Limited and its affiliated companies (“RIM”) assume no
responsibility for any typographical, technical, or other inaccuracies in this document. In order to protect RIM proprietary and
confidential information and/or trade secrets, this document may describe some aspects of RIM technology in generalized
terms. RIM reserves the right to periodically change information that is contained in this document; however, RIM makes no
commitment to provide any such changes, updates, enhancements, or other additions to this document to you in a timely
manner or at all. RIM MAKES NO REPRESENTATIONS, WARRANTIES, CONDITIONS OR COVENANTS, EITHER EXPRESS OR
IMPLIED (INCLUDING WITHOUT LIMITATION, ANY EXPRESS OR IMPLIED WARRANTIES OR CONDITIONS OF FITNESS FOR
A PARTICULAR PURPOSE, NON-INFRINGEMENT, MERCHANTABILITY, DURABILITY, TITLE, OR RELATED TO THE
PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE REFERENCED HEREIN OR PERFORMANCE OF ANY
SERVICES REFERENCED HEREIN). IN CONNECTION WITH YOUR USE OF THIS DOCUMENTATION, NEITHER RIM NOR
THEIR RESPECTIVE DIRECTORS, OFFICERS, EMPLOYEES, OR CONSULTANTS SHALL BE LIABLE TO YOU FOR ANY
DAMAGES WHATSOEVER BE THEY DIRECT, ECONOMIC, COMMERCIAL, SPECIAL, CONSEQUENTIAL, INCIDENTAL,
EXEMPLARY, OR INDIRECT DAMAGES, EVEN IF RIM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES,
INCLUDING WITHOUT LIMITATION, LOSS OF BUSINESS REVENUE OR EARNINGS, LOST DATA, DAMAGES CAUSED BY
DELAYS, LOST PROFITS, OR A FAILURE TO REALIZE EXPECTED SAVINGS.
This document might contain references to third-party sources of information, hardware or software, products or services
and/or third-party web sites (collectively the “Third-Party Information”). RIM does not control, and is not responsible for, any
Third-Party Information, including, without limitation the content, accuracy, copyright compliance, compatibility,
performance, trustworthiness, legality, decency, links, or any other aspect of Third-Party Information. The inclusion of Third-
Party Information in this document does not imply endorsement by RIM of the Third-Party Information or the third party in
any way. Installation and use of Third-Party Information with RIM’s products and services may require one or more patent,
trademark, or copyright licenses in order to avoid infringement of the intellectual property rights of others. Any dealings with
Third-Party Information, including, without limitation, compliance with applicable licenses and terms and conditions, are
solely between you and the third party. You are solely responsible for determining whether such third-party licenses are
required and are responsible for acquiring any such licenses relating to Third-Party Information. To the extent that such
intellectual property licenses may be required, RIM expressly recommends that you do not install or use Third-Party
Information until all such applicable licenses have been acquired by you or on your behalf. Your use of Third-Party
Information shall be governed by and subject to you agreeing to the terms of the Third-Party Information licenses. Any Third-
Party Information that is provided with RIM’s products and services is provided “as is.” RIM makes no representation,
warranty, or guarantee whatsoever in relation to the Third-Party Information and RIM assumes no liability whatsoever in
relation to the Third-Party Information even if RIM has been advised of the possibility of such damages or can anticipate such
damages.

© 2006 Research In Motion Limited. All Rights Reserved. www.blackberry.com