Update Guide

Local Navigation

BlackBerry Manuals & Help  >  Administrator Documentation  >  BlackBerry Enterprise Server Express 5  >  BlackBerry Enterprise Server Express for Microsoft Exchange  >  Update Guide BlackBerry Enterprise Server Express - BlackBerry Device Software - 5.0.3

Installing the BlackBerry Desktop Software on computers without requiring action from users

Prerequisites: Installing the BlackBerry Desktop Software on computers

  • Visit www.blackberry.com/support/downloads/ to download the latest version of the BlackBerry® Desktop Software installation package.
  • If your organization's operating system supports UAC, verify that users have the appropriate permissions to install the BlackBerry Desktop Software.
  • If users have a version of BlackBerry Desktop Software earlier than version 6.0 installed on their computers, run the following command to remove all previous components: InstallerUtils\InstallerUtils.exe /UninstallMediaApplications.
If you are using the Windows® Installer to install the BlackBerry Desktop Software, perform the following actions:
  • Verify that Microsoft® .NET Framework 3.5 SP1 or later is installed on each user's computer.
  • Verify that the latest Microsoft® Visual C++ Redistributable Package (vcredist_x86.exe) is installed on each user's computer.

Properties for installing the BlackBerry Desktop Software on computers

The BlackBerry® Desktop Software is a software package that you can install on BlackBerry device users' computers without requiring any action from the users. You can install the BlackBerry Desktop Software using InstallShield® or the Windows® Installer. The following table describes the properties that you can use to specify how to install the BlackBerry Desktop Software on computers. The properties apply to BlackBerry Desktop Software 6.0.1 and later.

Property

Description

Values

SHORTCUT_DESKTOP

Use this property to specify whether you want a shortcut link to the BlackBerry Desktop Software to display on the desktop of each user's computer.

0 - A desktop shortcut is not installed.

1 - A desktop shortcut is installed.

The default value is 1.

ALL_USERS

Use this property to specify whether you want the BlackBerry Desktop Software to be used by the current user only or by all users that use the computer.

0 - Install the BlackBerry Desktop Software for the current user only.

1 - Install the BlackBerry Desktop Software for all users that use the computer.

The default value is 1.

INSTALLDIR

Use this property to specify the full path to the installation directory for the BlackBerry Desktop Software.

The default installation directory is C:\Program Files\Research In Motion\BlackBerry Desktop.

If you want to use InstallShield and the file path includes a space, use the following format: INSTALLDIR=\"<file_path>"

If you want to use the Windows Installer and the file path includes a space, use the following format: INSTALLDIR="<file_path>"

TRANSFORMS

Use this property to specify the name of the .mst transform file that you want to apply to the BlackBerry Desktop Software. If you use the Windows Installer, the transform file is used to specify the language of the BlackBerry Desktop Software.

By default, a transform is not applied and the BlackBerry Desktop Software is installed in English.

Install the BlackBerry Desktop Software on computers using InstallShield

You can use the following commands with the software distribution method that your organization uses (for example, a group policy) to install the BlackBerry® Desktop Software on computers without requiring any action from users. The commands and properties apply to BlackBerry Desktop Software 6.0.1 and later.
In the software distribution tool that your organization uses, type the following command: setup.exe /s /l<language_code> /v" /qn <install_properties>". <language_code> refers to standard Microsoft® Help LangId values. <install_properties> refers to the optional install properties that you can specify. For more information about the available properties, see Properties for installing the BlackBerry Desktop Software on computers.

Example: The command for installing the BlackBerry Desktop Software for use by all users on a computer and displaying a shortcut link on the desktop

setup.exe /s /l1033 /v" /qn SHORTCUT_DESKTOP=1 ALL_USERS=1 INSTALLDIR=\"C:\BlackBerry Software\""

setup.exe /s /l1036 /v" /qn SHORTCUT_DESKTOP=0 ALL_USERS=0 INSTALLDIR=C:\BlackBerryDesktop"

After you finish: Configure email settings for the BlackBerry Desktop Software on each user's computer using registry keys. For more information about configuring the required registry keys, see Configure email settings for the BlackBerry Desktop Software. If you do not configure email settings for users, when each user opens the BlackBerry Desktop Software for the first time, the BlackBerry Desktop Software prompts the user to select configuration options.

Install the BlackBerry Desktop Software on computers using the Windows Installer

You can use the following commands with the software distribution method that your organization uses (for example, a group policy) to install the BlackBerry® Desktop Software on computers without requiring any action from users. The commands and properties apply to BlackBerry Desktop Software 6.0.1 and later.
In the software distribution tool that your organization uses, type the following command: msiexec.exe /I "BlackBerry Desktop Software.msi" /q <install_properties>. <install_properties> refers to the optional install properties that you can specify. For more information about the available properties, see Properties for installing the BlackBerry Desktop Software on computers.

Example: The command for installing the BlackBerry Desktop Software for use by all users on a computer, and displaying a shortcut link on the desktop

msiexec.exe /I "BlackBerry Desktop Software.msi" /q SHORTCUT_DESKTOP=1 ALL_USERS=1 INSTALLDIR="C:\BlackBerry Software\"

msiexec.exe /I "BlackBerry Desktop Software.msi" /q SHORTCUT_DESKTOP=0 ALL_USERS=0 INSTALLDIR="C:\BlackBerry Software\" TRANSFORMS=1036.mst

After you finish: Configure email settings for the BlackBerry Desktop Software on each user's computer using registry keys. For more information about configuring the required registry keys, see Configure email settings for the BlackBerry Desktop Software. If you do not configure email settings for users, when each user opens the BlackBerry Desktop Software for the first time, the BlackBerry Desktop Software prompts the user to select configuration options.

Create a custom transform file

If you plan to install the BlackBerry® Desktop Software on computers using the Windows® Installer, and you do not want to specify the installation properties using the command line, you have the option of creating a custom transform file that you can use to specify the installation properties.
  1. Open the Windows Installer .msi file with a tool that supports the .msi file type.
  2. In the Properties table, change the parameter properties as required and generate a transform file.
  3. Use the following command to apply the transform file to the BlackBerry Desktop Software installation: msiexec.exe /I "BlackBerry Desktop Software.msi" /q TRANSFORMS= <transform_file_name>.mst. If you want to apply more than one transform file, separate the transform file names using a semicolon (;), for example, TRANSFORMS=Custom.mst;1033.mst.

Configure email settings for the BlackBerry Desktop Software

If you want to configure email settings for the BlackBerry® Desktop Software that you installed on each user's computer, you can send the following registry settings to each user's computer. The settings are applied to the first BlackBerry device that a user connects to the BlackBerry Desktop Software.
  1. In the Windows® Registry Editor, create one or more of the following registry keys, as required:
    • HKEY_LOCAL_MACHINE\Software\Policies\Research In Motion\BlackBerry Desktop\EnterpriseEmail
    • HKEY_CURRENT_USER\Software\Policies\Research In Motion\BlackBerry Desktop\EnterpriseEmail
  2. Create a DWORD value named Type. If your organization uses Microsoft® Exchange, set the value to 0. If your organization uses IBM® Lotus® Domino®, set the value to 1.
  3. If your organization uses the BlackBerry® Enterprise Server Express Express for Microsoft® Exchange, create a STRING value named Profile. Set the value to the name of the Microsoft Exchange profile.
  4. If your organization uses the BlackBerry® Enterprise Server Express Express for IBM® Lotus® Domino®, create a text file that lists the names of the BlackBerry Enterprise Server Express Express instances that are available in your organization's environment. Store the text file in a location that each user's computer can access. The text file must use the following format: 
    <blackberry-server_list> 

<BES value="<server_name>" /> 
<BES value="<server_name>" /> 

</blackberry-server_list>
  5. If your organization uses the BlackBerry Enterprise Server Express Express for IBM Lotus Domino, create a STRING value named DominoServers. Set the value to the file path of the text file that you created in step 4.
Next topic: Create the BlackBerry Device Software update instructions for users that use the BlackBerry Desktop Software
Previous topic: Permitting users to update the BlackBerry Device Software using the BlackBerry Desktop Software

Was this information helpful? Send us your comments.