How to silently install BlackBerry Desktop Software

Article ID: KB03744

Type: Support Content

Last Modified: 06-06-2012

 

Product(s) Affected:

  • BlackBerry Desktop Software for Windows
CollapseEnvironment
  • BlackBerry® Desktop Software 4.5 to 6.1
  • Windows®
CollapseOverview

Silent installation permits an administrator to install BlackBerry® Desktop Software on a large number of computers without the involvement of BlackBerry smartphone users.

To silently install BlackBerry Desktop Software for 6.1, complete the following steps:

Prerequisites

  • If using Windows® Installer, verify that the following software is available on computer. If using InstallShield®, this software is installed automatically with the BlackBerry Desktop Software.
  1. Microsoft® .NET Framework 3.5 SP 1 or later. Can be downloaded here .
  2. Microsoft® Visual C++® 2008 Redistributable Package. After extract the BlackBerry Desktop Software .exe file,Package can be found at the following location: <download directory>\ISSetupPrerequisites\{8D6472BE-E246-4e63-A578-53EDAE1F40AB}\vcredist_x86.exe
  • If updating an existing version of the BlackBerry Desktop Software, verify that the existing BlackBerry Desktop Software is version 4.7 or later.
  • If installing the BlackBerry Desktop Software to a computer that runs Windows Vista™ or Windows 7, run the command as an administrator to match the UAC of the operating system.

Perform a silent installation using InstallShield:

If updating from BlackBerry Desktop Software 4.7 to 5.0.1, run the following command to remove all previous components:

InstallerUtils\InstallerUtils.exe /UninstallMediaApplications

  • Download the BlackBerry Desktop Software 6.1 .exe file from www.blackberry.com/desktop. Extract the .exe file into a new directory.
  • Use the following command:

setup.exe /s /l<language_code> /v"/qn <parameter_list>"

Don't include a space between the quotation marks or the character after the forward slash (/).
If the installation directory contains a space, enclose the path with quotation marks.

  • To use the default values, use the following command: setup.exe /s
  • Use an installation path that contains a space, use the following command:

setup.exe /s /l1033 /v"/qn ALL_USERS=1 SHORTCUT_DESKTOP=1 INSTALLDIR=\"c:\Research In Motion\BlackBerry Desktop""

  • In order to use an installation path that doesn't contain a space, use the following command:

setup.exe /s /l1033 /v"/qn ALL_USERS=1 SHORTCUT_DESKTOP=1 INSTALLDIR=\c:\BlackBerryDesktop"

Perform a silent installation using Windows Installer:

  • Verify that Microsoft .NET Framework 3.5 SP 1 and Microsoft® Visual C++® 2008 Redistributable Package are installed on computer.
  • If updating from BlackBerry Desktop Software 4.7 to 5.0.1, run the following command to remove all previous components:

InstallerUtils\InstallerUtils.exe /UninstallMediaApplications

  • Download the BlackBerry Desktop Software 6.0.1 .exe file from www.blackberry.com/desktop . Extract the .exe file into a new directory
  • Use the following command:

msiexec.exe /I "BlackBerry Desktop Software.msi" /q <parameter list>

Don't include a space between the quotation marks or the character after the forward slash (/).
  • To use the default values, use the following command:

msiexec.exe /I "BlackBerry Desktop Software.msi" /q

  • To use a different installation path and list the parameters, use the following command:

msiexec.exe /I "BlackBerry Desktop Software.msi" /q ALL_USERS=1 SHORTCUT_DESKTOP=1 INSTALLDIR="c:\BlackBerry Desktop" TRANSFORMS=1033.mst


Create a customized transform file

As an option, create a custom transform file to set parameters with the silent installation command.

  1. Open the Windows Installer .msi file with a tool that supports this file type.
  2. In the Properties table, edit the parameter properties and generate a transform file.
  3. Apply the transform file to the BlackBerry Desktop Software silent installation using the following command:

    msiexec.exe /I "BlackBerry Desktop Software.msi" /q TRANSFORMS= MyCompanyTransform.mst

  4. If using more than one transform, use the following command:

    msiexec.exe /I "BlackBerry Desktop Software.msi" /q TRANSFORMS= MyCompanyTransform.mst;1033.mst

Configure the email settings for users

If email settings in the BlackBerry Desktop Software is needed, send the following registry settings to users'
computers. These settings are applied to the first BlackBerry smartphone that connects to the BlackBerry Desktop Software.

New users might be prompted to generate an encryption key when they are setting up their smartphones with the BlackBerry Desktop Software.

  1. Create the following registry key: HKEY_CURRENT_USER\Policies\Research In Motion\BlackBerry Desktop.
  2. Add the following values, as necessary:

Registry Key Parameter Value

<Root>\EnterpriseEmail\Type

DWORD
0 = Microsoft® Exchange
1 = IBM® Lotus® Domino®

<Root>\EnterpriseEmail\Profile

STRING
If you're using Microsoft Exchange, this is the profile name.
This value is optional.

<Root>\EnterpriseEmail\DominoServers

STRING If you're using Lotus Domino servers, this is a path to a text file that lists the names of available Lotus Domino servers. When you create this text file, use the following format: <blackberry-server_list> <BES value="Server1" /> <BES value="Server2" /> </blackberry-server_list> Replace "Server1" and "Server2" with the full computer name of the BlackBerry® Enterprise Server computers in the domain. You can store this file on a different computer as long as
your users can access that computer.

 

Parameters for the silent installation

 

 

Parameter

Description

Value

SHORTCUT_DESKTOP

Adds a shortcut to the BlackBerry DesktopSoftware on a user's computer desktop. • 0 = A shortcut isn't added.
• 1 = A shortcut is added. This is the default value.

ALL_USERS

Specifies if you want all users to use the BlackBerry Desktop Software on the computer or only the current user for the computer.

• 0 = Current user only.
• 1 = All users. This is the default value.

INSTALLDIR

Specifies the installation directory for the BlackBerry Desktop Software.

The full path of the installation. The default path is C:\Research In Motion\BlackBerry Desktop

your_language_code

Specifies the language for the BlackBerry Desktop Software if you're using InstallShield.

English = 1033. This is the default language.

To specify another language, use one of the following values:

Arabic = 1025
Brazilian Portuguese = 1046
Czech = 1029
Dutch = 1043
European Portuguese = 2070
French = 1036
German = 1031
Greek = 1032
Hebrew = 1037
Hungarian = 1038
Indonesian = 1057
Italian = 1040
Japanese = 1041
Korean = 1042
Polish = 1045
Russian = 1049
Simplified Chinese = 2052
Spanish = 1034
Traditional Chinese = 1028
Turkish = 1055

TRANSFORMS

Specifies the language for the BlackBerry Desktop Software if you're using Windows Installer.

English = 1033.mst. This is the default language.

To specify another language, use one of the following values:

Arabic = 1025.mst
Brazilian Portuguese = 1046.mst
Czech = 1029.mst
Dutch = 1043.mst
European Portuguese = 2070.mst
French = 1036.mst
German = 1031.mst
Greek = 1032.mst
Hebrew = 1037.mst
Hungarian = 1038.mst
Indonesian = 1057.mst
Italian = 1040.mst
Japanese = 1041.mst
Korean = 1042.mst
Polish = 1045.mst
Russian = 1049.mst
Simplified Chinese = 2052.mst
Spanish = 1034.mst
Traditional Chinese = 1028.mst
Turkish = 1055.mst

To silently install BlackBerry Desktop Software 4.5 up to 5.0.1, complete the following steps:

  1. On the administration computer, create a new directory (for example, C:\silent ). The following steps refer to this new directory as the installation directory.
  2. Download BlackBerry Desktop Software from http://na.blackberry.com/eng/services/desktop/.
  3. Use WinZip® (or another data compression tool) to extract all files to the installation directory.
  4. In the installation directory, open the setup.ini file using a text editor application.
  5. Using a text editor application, open the install.txt file.
  6. Copy the text from the install.txt file, and then paste it at the bottom of the setup.ini file.
  7. Modify the following information at the end of the setup.ini file. The following example is text pasted from an install.txt file that has been modified:

    [INSTALL_OPTIONS]

    COUNTRY = Canada

    SETUPTYPE = Enterprise

    REDIRECTOR = Enterprise

    MAILSERVER = Exchange

    USERS = AllUsers

    SHORTCUTSTARTUP = True

    SHORTCUTDESKTOP = True

  8. Refer to the install.txt file in the installation directory for the correct country to type into the COUNTRY parameter.

    Adjust the parameters according to the following table:

    Installation Option Function Default
    COUNTRY Specifies the country United States
    SETUPTYPE Determines if the setup type is Enterprise or Internet Enterprise
    REDIRECTOR Specifies email message redirection as Enterprise or Desktop Enterprise
    MAILSERVER Specifies the messaging server as Microsoft Exchange, IBM Lotus Domino or Novell® GroupWise® Novell GroupWise
    USERS Determines if AllUsers or only the CurrentUser has access to BlackBerry Desktop Software AllUsers
    SHORTCUTSTARTUP Specifies True or False to run BlackBerry Desktop Manager during startup False
    SHORTCUTDESKTOP Specifies True or False to add a BlackBerry Desktop Manager shortcut to the computer desktop False
    HANDHELDINSTALLERDIR

    Contains the path to optional BlackBerry smartphone installers

    Note: Place the BlackBerry smartphone code installer files in the <drive>:\<network directory>\Device\directory. Each BlackBerry smartphone code installer file located in this directory will be installed onto every BlackBerry smartphone user's local drive during the BlackBerry Desktop Manager install.

    Device folder in the network directory (for example, <drive>:\<network directory>\Device)
    UNINSTALLEXISTINGHANDHELD Specifies True or False to remove existing BlackBerry® Device Software False
    SUPPRESSREBOOT Specifies True or False as to whether to suppress all computer restarts during installation False
    ENABLE_AUTOMATIC_UPDATE Specifies True or False to enable automatic updates of the BlackBerry Desktop Manager software. True
    BLACKBERRY_AUTOMATIC_UPDATE Specifies True of False to a check for updates of the BlackBerry Device Software installed on the connected BlackBerry smartphone True
    URL Specify a path to a URL to be launched at the end of a BlackBerry® Internet Service installation No URL is launched

  9. Save the setup.ini file.
  10. From a command prompt, go to the installation directory and then type the following:

    C:\network directory\setup.exe /s /l<language_ID> /v INSTALLLEVEL=<X>

    Note: If installing BlackBerry Desktop Manager 4.2 to 5.0 SP1, type the following:

    C:\network directory\BlackBerrySetup.exe /s /l<language_ID> /v INSTALLLEVEL=<X>

    The following table shows possible language ID values. English is the default value. For an English installation, omit /l<language_ID> from the command.

    Language Language ID Supported in BlackBerry Desktop Manager version
    French 1036 4.0 to 5.0 SP1
    German 1031 4.0 to 5.0 SP1
    Italian 1040 4.0 to 5.0 SP1
    Spanish 1034 4.0 to 5.0 SP1
    Hungarian 1038 4.1 to 5.0 SP1
    Czech 1029 4.1 to 5.0 SP1
    Polish 1045 4.1 to 5.0 SP1
    Turkish 1055 4.1 to 5.0 SP1
    Russian 1049 4.2 SP2 to 5.0 SP1
    Brazilian Portuguese 1046 4.1 to 5.0 SP1
    Portuguese 2070 4.3 to 5.0 SP1
    Simplified Chinese 2052 4.1 to 5.0 SP1
    Traditional Chinese 1028 4.2 SP2 to 5.0 SP1
    Korean 1042 4.2 SP2 to 5.0 SP1
    Japanese 1041 4.2 SP2 to 5.0 SP1

    The following table shows the possible installation levels represented by <X> in the command above.

    Installation Level Value
    BlackBerry® Device Manager 1
    BlackBerry Device Manager and BlackBerry Desktop Manager 100
    BlackBerry Desktop Manager 4.2 SP2 to 4.7, BlackBerry Device Manager, BlackBerry Desktop Manager, and Roxio® Media Manager 110
    BlackBerry Desktop Manager 5.0 to 5.0 SP1, BlackBerry Device Manager, BlackBerry Desktop Manager, and BlackBerry® Media Sync 110
    BlackBerry Desktop Manager 5.0 to 5.0 SP1, BlackBerry Device Manager, BlackBerry Desktop Manager, BlackBerry Media Sync, and Roxio Media Manager 120
    BlackBerry Desktop Manager 4.2 SP2 to 4.7, BlackBerry Device Manager, BlackBerry Desktop Manager, Roxio Media Manager and certificate synchronization tool 125
    BlackBerry Desktop Manager 5.0 to 5.0 SP1, BlackBerry Device Manager, BlackBerry Desktop Manager, BlackBerry Media Sync, Roxio Media Manager and certificate synchronization tool 125

    Note: During the installation, in Task Manager, a process called Setup.exe or BlackBerrySetup.exe will appear. If this process does not appear, please verify the pre-requisites of the version of Desktop Manager you are running (MSXML, .NET Framework, etc) have been met by running a regular installation of the BlackBerry Desktop Manager.


  11. After the installation is complete, go to C:\Program Files\Research In Motion\BlackBerry and type the following:

    desktopmgr/r "<installation_directory>"

    For example, when typing desktopmgr/r "C:\silent", BlackBerry Desktop Manager opens.

  12. In the BlackBerry Desktop Manager, configure Intellisync® and BlackBerry® Desktop Redirector settings, as they should be deployed for all BlackBerry smartphones who will receive the silent installation.
  13. Close the BlackBerry Desktop Manager to save the settings.
  14. In the installation directory, verify that the following files appear:

    File Name Related Tool
    DefaultsDesktop.xml BlackBerry Desktop Manager configuration
    DefaultsIntellisync.xml Intellisync configuration
    DefaultsRedirectorSettings.xml BlackBerry Desktop Redirector settings configuration

  15. Copy the contents of the installation directory to a shared folder on the network.
  16. To run the silent installation to all BlackBerry smartphones from a command prompt, go to the shared folder and type the following:

    <network_drive>\network directory\setup.exe /s /l<language_ID> /v INSTALLLEVEL=<X>

    Note: If using BlackBerry Desktop Manager 4.2 to 5.0.1, type the following:

    <network_drive>\network directory\BlackBerrySetup.exe /s /l<language_ID> /v INSTALLLEVEL=<X>

    The values for <language_ID> and <X> are described in the table in step 10.

Note: BlackBerry Desktop Manager 4.2.2 with Roxio Media Manager for BlackBerry smartphones currently requires a restart after installation. This is intentionally forced in silent mode, since the BlackBerry smartphone user would be otherwise unaware.

 

CollapseAdditional Information

The BlackBerry device software can also be silently installed. If the device software is failing to install please see KB28315


Note: BlackBerry Desktop Software 6.0.0 does not support silent installs via a configurable INI file as it did in previous versions.

Additional notes for BlackBerry Desktop Software 4.5 to 5.0.1 silent install. Below does not apply to BlackBerry Desktop Software 6.0.1.


To distribute a modified Windows Installer (.msi) file for BlackBerry Desktop Software to the BlackBerry smartphones without user interaction, add the following string to the CmdLine= parameter in the setup.ini file:

/v"INSTALLLEVEL=<install_level_ID>"

where <install_level_ID> is a BlackBerry Desktop Software configuration.

Another way will be to add the following switch to prevent dialog boxes from appearing on the user's screen:

/v USEINI=setup.ini /qn

This switch permits users to install BlackBerry Desktop Software without using an executable (.exe) file.


The default installation directory is derived from the Windows setting for the Program Files. If the Windows setting points to C:\Program Files, no change is required. If the Windows setting does not point to C:\Program Files, the installation directory, which is a Windows installer property, can be set on the command line for the BlackBerry Desktop Software components.

To customize the location of the BlackBerry Desktop Software, navigate to the BlackBerrysetup.exe directory in the command prompt and type:

BlackBerrySetup.exe /s /v"INSTALLDIR=C:\BB"

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.