BlackBerry Desktop Software

Silent Installation Guide

Version: 7.1

SWD-1690241-0720051432-001

Contents
About silently installing the BlackBerry Desktop Software................................................................................................................................
Prerequisites: Silent installation.........................................................................................................................................................................
Parameters for the silent installation.................................................................................................................................................................
Perform a silent installation using InstallShield.................................................................................................................................................
Perform a silent installation using Windows Installer........................................................................................................................................
Configure the email settings for users...............................................................................................................................................................
Configure certificate synchronization settings for users....................................................................................................................................

2
2
2
4
5
5
6

Legal notice........................................................................................................................................................................................................

10

About silently installing the BlackBerry Desktop Software

Silent Installation Guide

About silently installing the BlackBerry

Desktop Software

If you're an administrator, you can perform a silent installation to push the BlackBerry Desktop Software to BlackBerry device
users' computers within your organization's environment, without their involvement. You can either update an existing version
of the BlackBerry Desktop Software, or install a new version.

Prerequisites: Silent installation

If you're using Windows Installer, verify that the following software is available on the BlackBerry device users' computers.
If you're using InstallShield, this software is installed automatically with the BlackBerry Desktop Software.
Microsoft .NET Framework 3.5 SP 1 or later. You can download this software from: www.microsoft.com/downloads/
en/details.aspx?FamilyID=ab99342f-5d1a-413d-8319-81da479ab0d7&displaylang=en
Microsoft Visual C++ 2008 Redistributable Package. After you extract the BlackBerry Desktop Software .exe file, you
can find this package at the following location: <download directory>\ISSetupPrerequisites\{8D6472BE-E246-4e63A578-53EDAE1F40AB}\vcredist_x86.exe
If you're updating an existing version of the BlackBerry Desktop Software, verify that the existing BlackBerry Desktop
Software is version 4.7 or later.
If you're 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.

Parameters for the silent installation

You can customize the silent installation of the BlackBerry Desktop Software for the BlackBerry device users with the following
parameters.

Parameter

Description

Value

SHORTCUT_DESKTOP

Adds a shortcut to the BlackBerry Desktop

Software 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.

About silently installing the BlackBerry Desktop Software

Silent Installation Guide

Parameter

Description

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:

About silently installing the BlackBerry Desktop Software

Silent Installation Guide

Parameter

Description

Value
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

Perform a silent installation using InstallShield

If you are updating from BlackBerry Desktop Software 4.7 to 5.0.1, run the following command to remove all previous
components: InstallerUtils\InstallerUtils.exe /UninstallMediaApplications
1. Download the BlackBerry Desktop Software .exe file from www.blackberry.com/desktop. Extract the .exe file into a new
directory.
2. Use the following command: setup.exe /s /l<language_code> /v"/qn <parameter_list>"

About silently installing the BlackBerry Desktop Software

Silent Installation Guide

Don't include a space between the quotation marks or the character after the forward slash (/). If you're including an
installation directory that contains a space, enclose the path with quotation marks.
To use the default values, use the following command: setup.exe /s
If you want to 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""
If you want 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 the
BlackBerry device users' computers.
If you're updating from BlackBerry Desktop Software 4.7 to 5.0.1, run the following command to remove all previous
components: InstallerUtils\InstallerUtils.exe /UninstallMediaApplications

1. Download the BlackBerry Desktop Software .exe file from www.blackberry.com/desktop. Extract the .exe file into a new
directory.
2. 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

Configure the email settings for users

If you want to configure the email settings in the BlackBerry Desktop Software, you can send the following registry settings to
the BlackBerry device users' computers. These settings are applied to the first BlackBerry device that a user connects to the
BlackBerry Desktop Software.
New users might be prompted to generate an encryption key when they are setting up their devices with the BlackBerry
Desktop Software.
1. Create the following registry key: HKCU\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

About silently installing the BlackBerry Desktop Software

Silent Installation Guide

Registry Key

Parameter

Value

<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.

Configure certificate synchronization settings for users

If you want to configure the certificate synchronization settings in the BlackBerry Desktop Software, you can send the following
registry settings to BlackBerry device users' computers.
1. Create the following registry key: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Research In Motion\BlackBerry Desktop
\CertSync.
2. Add the following values, as necessary:

Registry Key

Parameter

Value

SyncTime

DWORD

Sets the time to resynchronize the certificates.

Enable = 0 to 24
Disable = (-1)
Every connection (decimal) = 0

AutomaticallySeedDeviceRNG

DWORD

Specifies if you want to use the Random Number

Generation for a user's device.
Enable (Yes) = 0x00000001

About silently installing the BlackBerry Desktop Software

Silent Installation Guide

Registry Key

Parameter

Value
Disable (No) = 0x00000000

CRLUpdateTime

DWORD

Sets a time to regularly update your CRL servers.

Enable = 0 to 24
Disable = (-1)
Every connection (decimal) = 0

CRLUpdateWarning

DWORD

Provides a status message if a CRL server can't be

updated.
Enable (Yes) = 0x00000001
Disable (No) = 0x00000000

SignSecurityDefault

DWORD

Sets the default security level for signing keys.

Low = 0x00000001
High = 0x00000002
Medium = 0x00000003

EnableCertSync

DWORD

Automatically enables certificate synchronization

the first time you open the BlackBerry Desktop
Software.
Enable (Yes) = 1
Disable (No) = 0

EncryptSecurityDefault

DWORD

Sets the default security level for decryption keys.

Low = 0x00000001
High = 0x00000002
Medium = 0x00000003

CertificateTabFilter

DWORD

Sets whether you want to view only personal

certificates or all certificates.
Personal certificates only = 0x00000001
All certificates=0xFFFFFFFE

CertificateUsageFilter

DWORD

Sets whether you want to view certificates for signed

or encrypted messages, client authentication, other
purposes, or a combination of the options.

About silently installing the BlackBerry Desktop Software

Silent Installation Guide

Registry Key

Parameter

Value
Secure/encrypted messages = 0x00000001
Client authentication = 0x00000002
Other purposes = 0xFFFFFFFC
Secure/encrypted messages and client
authentication = 0x00000003
Secure/encrypted messages and other purposes =
0xFFFFFFFD
Client authentication and other purposes =
0xFFFFFFFE

DownloadAddressBook

DWORD

Downloads your organization's address book for an

LDAP search.
Enable (Yes) = 0x00000001
Disable (No) = 0x00000000

OCSPUsage

DWORD

If you're using an OCSP server:

Use certificate extensions = 0x00000001
Use specified servers = 0x00000002
Use both = 0x00000003

CRLUsage

DWORD

If you're using a CRL server:

Use certificate extensions = 0x00000001
Use specified servers = 0x00000002
Use both = 0x00000003

CertServersFilePath

STRING

The file path to the pre-populated CertServers.dat

file to use for the default certificate server values.
To create this file, do the following:
1. Start the BlackBerry Desktop Software and
connect a previously connected smartphone.
2. Navigate to ~\Application Data\Research In
Motion\BlackBerry Desktop\Devices\<device
pin>

About silently installing the BlackBerry Desktop Software

Silent Installation Guide

Registry Key

Parameter

Value
3. Copy the CertServers.dat file to the shared
location, which should be used as the value of
the CertServersFilePath key.

Silent Installation Guide

Legal notice

Legal notice

2012 Research In Motion Limited. All rights reserved. BlackBerry, RIM, Research In Motion, and related trademarks,
names, and logos are the property of Research In Motion Limited and are registered and/or used in the U.S. and countries
around the world.
IBM, Lotus, and Domino are trademarks of International Business Machines Corporation. InstallShield is a trademark of Flexera
Software. Microsoft, Microsoft Exchange, Visual C++, Windows, and Windows Vista are trademarks of Microsoft Corporation.
All other trademarks are the property of their respective owners.
This documentation including all documentation incorporated by reference herein such as documentation provided or made
available at www.blackberry.com/go/docs is provided or made accessible "AS IS" and "AS AVAILABLE" and without condition,
endorsement, guarantee, representation, or warranty of any kind by Research In Motion Limited and its affiliated companies
("RIM") and RIM assumes no responsibility for any typographical, technical, or other inaccuracies, errors, or omissions in this
documentation. In order to protect RIM proprietary and confidential information and/or trade secrets, this documentation
may describe some aspects of RIM technology in generalized terms. RIM reserves the right to periodically change information
that is contained in this documentation; however, RIM makes no commitment to provide any such changes, updates,
enhancements, or other additions to this documentation to you in a timely manner or at all.
This documentation might contain references to third-party sources of information, hardware or software, products or services
including components and content such as content protected by copyright and/or third-party web sites (collectively the "Third
Party Products and Services"). RIM does not control, and is not responsible for, any Third Party Products and Services including,
without limitation the content, accuracy, copyright compliance, compatibility, performance, trustworthiness, legality, decency,
links, or any other aspect of Third Party Products and Services. The inclusion of a reference to Third Party Products and Services
in this documentation does not imply endorsement by RIM of the Third Party Products and Services or the third party in any
way.
EXCEPT TO THE EXTENT SPECIFICALLY PROHIBITED BY APPLICABLE LAW IN YOUR JURISDICTION, ALL CONDITIONS,
ENDORSEMENTS, GUARANTEES, REPRESENTATIONS, OR WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
WITHOUT LIMITATION, ANY CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS OR WARRANTIES OF
DURABILITY, FITNESS FOR A PARTICULAR PURPOSE OR USE, MERCHANTABILITY, MERCHANTABLE QUALITY, NONINFRINGEMENT, SATISFACTORY QUALITY, OR TITLE, OR ARISING FROM A STATUTE OR CUSTOM OR A COURSE OF DEALING OR
USAGE OF TRADE, OR RELATED TO THE DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY
SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN, ARE HEREBY
EXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTS THAT VARY BY STATE OR PROVINCE. SOME JURISDICTIONS MAY NOT ALLOW
THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES AND CONDITIONS. TO THE EXTENT PERMITTED BY LAW, ANY
IMPLIED WARRANTIES OR CONDITIONS RELATING TO THE DOCUMENTATION TO THE EXTENT THEY CANNOT BE EXCLUDED AS
SET OUT ABOVE, BUT CAN BE LIMITED, ARE HEREBY LIMITED TO NINETY (90) DAYS FROM THE DATE YOU FIRST ACQUIRED THE
DOCUMENTATION OR THE ITEM THAT IS THE SUBJECT OF THE CLAIM.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO EVENT SHALL RIM BE LIABLE FOR
ANY TYPE OF DAMAGES RELATED TO THIS DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY
SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN INCLUDING WITHOUT
LIMITATION ANY OF THE FOLLOWING DAMAGES: DIRECT, CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, INDIRECT, SPECIAL,
PUNITIVE, OR AGGRAVATED DAMAGES, DAMAGES FOR LOSS OF PROFITS OR REVENUES, FAILURE TO REALIZE ANY EXPECTED
SAVINGS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, LOSS OF BUSINESS OPPORTUNITY, OR CORRUPTION OR
LOSS OF DATA, FAILURES TO TRANSMIT OR RECEIVE ANY DATA, PROBLEMS ASSOCIATED WITH ANY APPLICATIONS USED IN
CONJUNCTION WITH RIM PRODUCTS OR SERVICES, DOWNTIME COSTS, LOSS OF THE USE OF RIM PRODUCTS OR SERVICES OR

10

Silent Installation Guide

Legal notice

ANY PORTION THEREOF OR OF ANY AIRTIME SERVICES, COST OF SUBSTITUTE GOODS, COSTS OF COVER, FACILITIES OR
SERVICES, COST OF CAPITAL, OR OTHER SIMILAR PECUNIARY LOSSES, WHETHER OR NOT SUCH DAMAGES WERE FORESEEN OR
UNFORESEEN, AND EVEN IF RIM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, RIM SHALL HAVE NO OTHER OBLIGATION,
DUTY, OR LIABILITY WHATSOEVER IN CONTRACT, TORT, OR OTHERWISE TO YOU INCLUDING ANY LIABILITY FOR NEGLIGENCE
OR STRICT LIABILITY.
THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A) IRRESPECTIVE OF THE NATURE OF THE CAUSE OF
ACTION, DEMAND, OR ACTION BY YOU INCLUDING BUT NOT LIMITED TO BREACH OF CONTRACT, NEGLIGENCE, TORT, STRICT
LIABILITY OR ANY OTHER LEGAL THEORY AND SHALL SURVIVE A FUNDAMENTAL BREACH OR BREACHES OR THE FAILURE OF
THE ESSENTIAL PURPOSE OF THIS AGREEMENT OR OF ANY REMEDY CONTAINED HEREIN; AND (B) TO RIM AND ITS AFFILIATED
COMPANIES, THEIR SUCCESSORS, ASSIGNS, AGENTS, SUPPLIERS (INCLUDING AIRTIME SERVICE PROVIDERS), AUTHORIZED RIM
DISTRIBUTORS (ALSO INCLUDING AIRTIME SERVICE PROVIDERS) AND THEIR RESPECTIVE DIRECTORS, EMPLOYEES, AND
INDEPENDENT CONTRACTORS.
IN ADDITION TO THE LIMITATIONS AND EXCLUSIONS SET OUT ABOVE, IN NO EVENT SHALL ANY DIRECTOR, EMPLOYEE, AGENT,
DISTRIBUTOR, SUPPLIER, INDEPENDENT CONTRACTOR OF RIM OR ANY AFFILIATES OF RIM HAVE ANY LIABILITY ARISING FROM
OR RELATED TO THE DOCUMENTATION.
Prior to subscribing for, installing, or using any Third Party Products and Services, it is your responsibility to ensure that your
airtime service provider has agreed to support all of their features. Some airtime service providers might not offer Internet
browsing functionality with a subscription to the BlackBerry Internet Service. Check with your service provider for availability,
roaming arrangements, service plans and features. Installation or use of Third Party Products and Services with RIM's products
and services may require one or more patent, trademark, copyright, or other licenses in order to avoid infringement or
violation of third party rights. You are solely responsible for determining whether to use Third Party Products and Services and
if any third party licenses are required to do so. If required you are responsible for acquiring them. You should not install or use
Third Party Products and Services until all necessary licenses have been acquired. Any Third Party Products and Services that
are provided with RIM's products and services are provided as a convenience to you and are provided "AS IS" with no express
or implied conditions, endorsements, guarantees, representations, or warranties of any kind by RIM and RIM assumes no
liability whatsoever, in relation thereto. Your use of Third Party Products and Services shall be governed by and subject to you
agreeing to the terms of separate licenses and other agreements applicable thereto with third parties, except to the extent
expressly covered by a license or other agreement with RIM.
Certain features outlined in this documentation require a minimum version of BlackBerry Enterprise Server, BlackBerry
Desktop Software, and/or BlackBerry Device Software.
The terms of use of any RIM product or service are set out in a separate license or other agreement with RIM applicable
thereto. NOTHING IN THIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANY EXPRESS WRITTEN AGREEMENTS OR
WARRANTIES PROVIDED BY RIM FOR PORTIONS OF ANY RIM PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION.
Research In Motion Limited
295 Phillip Street
Waterloo, ON N2L 3W8
Canada
Research In Motion UK Limited
200 Bath Road
Slough, Berkshire SL1 3XE

11

Silent Installation Guide

United Kingdom
Published in Canada

12

Legal notice