blackberry desktop software silent installation guide 1401961 1213082823 001 6.0.1 us

BlackBerry Desktop SoftwareVersion: 6.0.1

Silent Installation Guide

SWD-1401961-1213082823-001

ContentsAbout silently installing the BlackBerry Desktop Software................................................................................................................................ 2

Prerequisites: Silent installation......................................................................................................................................................................... 2

Parameters for the silent installation................................................................................................................................................................. 2

Perform a silent installation using InstallShield................................................................................................................................................. 4

Perform a silent installation using Windows Installer........................................................................................................................................ 5

Configure the email settings for your users....................................................................................................................................................... 5

Legal notice........................................................................................................................................................................................................ 7

About silently installing the BlackBerry DesktopSoftwareIf you're an administrator, you can perform a silent installation to push the BlackBerry® Desktop Software to users' computerswithin your organization's environment, without their involvement. You can either update an existing version of the BlackBerryDesktop Software, or install a new version.

Prerequisites: Silent installation• If you're using Windows® Installer, you verify that the following software is available on your 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-4e63-A578-53EDAE1F40AB}\vcredist_x86.exe

• If you're updating an existing version of the BlackBerry Desktop Software, verify that the existing BlackBerry Desktop Softwareis 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 commandas an administrator to match the UAC of the operating system.

Parameters for the silent installationYou can customize the silent installation of the BlackBerry® Desktop Software for your users with the following parameters.

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

ALL_USERS Specifies if you want all users to use theBlackBerry Desktop Software on thecomputer or only the current user for thecomputer.

• 0 = Current user only.

• 1 = All users. This is the default value.

INSTALLDIR Specifies the installation directory for theBlackBerry Desktop Software.

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

Silent Installation Guide About silently installing the BlackBerry Desktop Software

2

http://www.microsoft.com/downloads/en/details.aspx?FamilyID=ab99342f-5d1a-413d-8319-81da479ab0d7&displaylang=en

http://www.microsoft.com/downloads/en/details.aspx?FamilyID=ab99342f-5d1a-413d-8319-81da479ab0d7&displaylang=en


your_language_code Specifies the language for the BlackBerryDesktop Software if you're usingInstallShield®.

English = 1033. This is the default language.

To specify another language, use one of thefollowing 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 BlackBerryDesktop Software if you're using Windows®Installer.

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

To specify another language, use one of thefollowing values:

Arabic = 1025.mst


3


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 InstallShieldIf you are updating from BlackBerry® Desktop Software 4.7 to 5.0.1, run the following command to remove all previouscomponents: InstallerUtils\InstallerUtils.exe /UninstallMediaApplications

1. Download the BlackBerry® Desktop Software 6.0.1 .exe file from www.blackberry.com/desktop. Extract the .exe file into anew directory.

2. 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 you're including aninstallation directory that contains a space, enclose the path with quotation marks.


4

http://www.blackberry.com/desktop

• 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

your users' computers.• 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 6.0.1 .exe file from www.blackberry.com/desktop. Extract the .exe file into a newdirectory.

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

Create a customized transform fileAs an option, you can 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.mst4. If you're 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 your usersIf you want to configure the email settings in the BlackBerry® Desktop Software, you can send the following registry settings toyour users' computers. These settings are applied to the first BlackBerry device that a user connects to the BlackBerry DesktopSoftware.

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

1. Create the following registry key: HKCU\Policies\Research In Motion\BlackBerry Desktop.


5

http://www.blackberry.com/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 profilename. This value is optional.

<Root>\EnterpriseEmail\DominoServers

STRING If you're using Lotus Domino servers, this is a path toa text file that lists the names of available LotusDomino servers.

When you create this text file, use the followingformat:

<blackberry-server_list> <BES value="Server1" /><BES value="Server2" /> </blackberry-server_list>

Replace "Server1" and "Server2" with the fullcomputer name of the BlackBerry® EnterpriseServer computers in the domain.

You can store this file on a different computer as longas your users can access that computer.


6

Legal notice©2010 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 theworld.

IBM, Lotus, and Domino are trademarks of International Business Machines Corporation. InstallShield is a trademark ofMacrovision Corporation. Microsoft, Microsoft Exchange, Visual C++, Windows, and Windows Vista are trademarks of MicrosoftCorporation. All other trademarks are the property of their respective owners.

This documentation including all documentation incorporated by reference herein such as documentation provided or madeavailable 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 thisdocumentation. In order to protect RIM proprietary and confidential information and/or trade secrets, this documentation maydescribe some aspects of RIM technology in generalized terms. RIM reserves the right to periodically change information that iscontained 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 servicesincluding components and content such as content protected by copyright and/or third-party web sites (collectively the "ThirdParty 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 Servicesin 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 WITHOUTLIMITATION, ANY CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS OR WARRANTIES OF DURABILITY, FITNESSFOR A PARTICULAR PURPOSE OR USE, MERCHANTABILITY, MERCHANTABLE QUALITY, NON-INFRINGEMENT, SATISFACTORYQUALITY, OR TITLE, OR ARISING FROM A STATUTE OR CUSTOM OR A COURSE OF DEALING OR USAGE OF TRADE, OR RELATED TOTHE DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, ORANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN, ARE HEREBY EXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTSTHAT VARY BY STATE OR PROVINCE. SOME JURISDICTIONS MAY NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIEDWARRANTIES AND CONDITIONS. TO THE EXTENT PERMITTED BY LAW, ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TOTHE DOCUMENTATION TO THE EXTENT THEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE LIMITED, ARE HEREBYLIMITED TO NINETY (90) DAYS FROM THE DATE YOU FIRST ACQUIRED THE DOCUMENTATION OR THE ITEM THAT IS THE SUBJECTOF THE CLAIM.

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO EVENT SHALL RIM BE LIABLE FOR ANYTYPE OF DAMAGES RELATED TO THIS DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANYSOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN INCLUDING WITHOUTLIMITATION 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 EXPECTEDSAVINGS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, LOSS OF BUSINESS OPPORTUNITY, OR CORRUPTION ORLOSS OF DATA, FAILURES TO TRANSMIT OR RECEIVE ANY DATA, PROBLEMS ASSOCIATED WITH ANY APPLICATIONS USED INCONJUNCTION WITH RIM PRODUCTS OR SERVICES, DOWNTIME COSTS, LOSS OF THE USE OF RIM PRODUCTS OR SERVICES OR

Silent Installation Guide Legal notice

7

http://www.blackberry.com/go/docs

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

THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A) IRRESPECTIVE OF THE NATURE OF THE CAUSE OFACTION, DEMAND, OR ACTION BY YOU INCLUDING BUT NOT LIMITED TO BREACH OF CONTRACT, NEGLIGENCE, TORT, STRICTLIABILITY OR ANY OTHER LEGAL THEORY AND SHALL SURVIVE A FUNDAMENTAL BREACH OR BREACHES OR THE FAILURE OF THEESSENTIAL PURPOSE OF THIS AGREEMENT OR OF ANY REMEDY CONTAINED HEREIN; AND (B) TO RIM AND ITS AFFILIATEDCOMPANIES, THEIR SUCCESSORS, ASSIGNS, AGENTS, SUPPLIERS (INCLUDING AIRTIME SERVICE PROVIDERS), AUTHORIZED RIMDISTRIBUTORS (ALSO INCLUDING AIRTIME SERVICE PROVIDERS) AND THEIR RESPECTIVE DIRECTORS, EMPLOYEES, ANDINDEPENDENT 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 FROMOR RELATED TO THE DOCUMENTATION.

Prior to subscribing for, installing, or using any Third Party Products and Services, it is your responsibility to ensure that yourairtime service provider has agreed to support all of their features. Some airtime service providers might not offer Internetbrowsing 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 productsand services may require one or more patent, trademark, copyright, or other licenses in order to avoid infringement or violationof third party rights. You are solely responsible for determining whether to use Third Party Products and Services and if any thirdparty licenses are required to do so. If required you are responsible for acquiring them. You should not install or use Third PartyProducts and Services until all necessary licenses have been acquired. Any Third Party Products and Services that are providedwith RIM's products and services are provided as a convenience to you and are provided "AS IS" with no express or impliedconditions, 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 termsof separate licenses and other agreements applicable thereto with third parties, except to the extent expressly covered by alicense or other agreement with RIM.

Certain features outlined in this documentation require a minimum version of BlackBerry® Enterprise Server, BlackBerry® DesktopSoftware, 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 WARRANTIESPROVIDED BY RIM FOR PORTIONS OF ANY RIM PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION.

Research In Motion Limited295 Phillip StreetWaterloo, ON N2L 3W8Canada

Research In Motion UK Limited Centrum House 36 Station Road


8

Egham, Surrey TW20 9LF United Kingdom

Published in Canada


9

blackberry desktop software silent installation guide 1401961 1213082823 001 6.0.1 us

Documents