BlackBerry manuslk

download BlackBerry manuslk

of 7

Transcript of BlackBerry manuslk

  • 8/9/2019 BlackBerry manuslk

    1/14

    BlackBerry Desktop SoftwareSilent Installation GuideVersion: 7.1

  • 8/9/2019 BlackBerry manuslk

    2/14

    SWD-1690241-0720051432-001

  • 8/9/2019 BlackBerry manuslk

    3/14

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

    Configure certificate synchronization settings for users.................................................................................................................................... 6

    Legal notice........................................................................................................................................................................................................ 10

  • 8/9/2019 BlackBerry manuslk

    4/14

    About silently installing the BlackBerryDesktop SoftwareIf you're an administrator, you can perform a silent installation to push the BlackBerry Desktop Software to BlackBerry deviceusers' computers within your organization's environment, without their involvement. You can either update an existing versionof 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-4e63-A578-53EDAE1F40AB}\vcredist_x86.exe

    • If you're updating an existing version of the BlackBerry Desktop Software, verify that the existing BlackBerry DesktopSoftware 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 thecommand as 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 the BlackBerry device users with the followingparameters.

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

    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=enhttp://www.microsoft.com/downloads/en/details.aspx?FamilyID=ab99342f-5d1a-413d-8319-81da479ab0d7&displaylang=en

  • 8/9/2019 BlackBerry manuslk

    5/14

    Parameter Description 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

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

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

    To specify another language, use one of thefollowing values:

    Silent Installation Guide About silently installing the BlackBerry Desktop Software

    3

  • 8/9/2019 BlackBerry manuslk

    6/14

    Parameter Description Value

    Arabic = 1025.mst

    Brazilian Portuguese = 1046.mst

    Czech = 1029.mst

    Dutch = 1043.mst

    European Portuguese = 2070.mst

    French = 1036.mstGerman = 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 .exe file from www.blackberry.com/desktop . Extract the .exe file into a newdirectory.

    2. Use the following command: setup.exe /s /l< language_code > /v"/qn < parameter_list >"

    Silent Installation Guide About silently installing the BlackBerry Desktop Software

    4

    http://www.blackberry.com/desktop

  • 8/9/2019 BlackBerry manuslk

    7/14

    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.

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

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

    \EnterpriseEmail\Type DWORD 0 = Microsoft Exchange

    1 = IBM Lotus Domino

    Silent Installation Guide About silently installing the BlackBerry Desktop Software

    5

    http://www.blackberry.com/desktop

  • 8/9/2019 BlackBerry manuslk

    8/14

    Registry Key Parameter Value

    \EnterpriseEmail\Profile STRING If you're using Microsoft Exchange, this is the profilename. This value is optional.

    \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:

    Replace "Server1" and "Server2" with the fullcomputer name of the BlackBerry Enterprise Servercomputers 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 usersIf you want to configure the certificate synchronization settings in the BlackBerry Desktop Software, you can send the followingregistry 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 24Disable = (-1)

    Every connection (decimal) = 0

    AutomaticallySeedDeviceRNG DWORD Specifies if you want to use the Random NumberGeneration for a user's device.

    Enable (Yes) = 0x00000001

    Silent Installation Guide About silently installing the BlackBerry Desktop Software

    6

  • 8/9/2019 BlackBerry manuslk

    9/14

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

    Enable (Yes) = 0x00000001

    Disable (No) = 0x00000000

    SignSecurityDefault DWORD Sets the default security level for signing keys.

    Low = 0x00000001

    High = 0x00000002Medium = 0x00000003

    EnableCertSync DWORD Automatically enables certificate synchronizationthe first time you open the BlackBerry DesktopSoftware.

    Enable (Yes) = 1

    Disable (No) = 0EncryptSecurityDefault 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 signedor encrypted messages, client authentication, otherpurposes, or a combination of the options.

    Silent Installation Guide About silently installing the BlackBerry Desktop Software

    7

  • 8/9/2019 BlackBerry manuslk

    10/14

    Registry Key Parameter Value

    Secure/encrypted messages = 0x00000001

    Client authentication = 0x00000002

    Other purposes = 0xFFFFFFFC

    Secure/encrypted messages and clientauthentication = 0x00000003

    Secure/encrypted messages and other purposes =0xFFFFFFFD

    Client authentication and other purposes =0xFFFFFFFE

    DownloadAddressBook DWORD Downloads your organization's address book for anLDAP 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.datfile to use for the default certificate server values.

    To create this file, do the following:

    1. Start the BlackBerry Desktop Software andconnect a previously connected smartphone.

    2. Navigate to ~\Application Data\Research InMotion\BlackBerry Desktop\Devices\

    Silent Installation Guide About silently installing the BlackBerry Desktop Software

    8

  • 8/9/2019 BlackBerry manuslk

    11/14

    Registry Key Parameter Value

    3. Copy the CertServers.dat file to the sharedlocation, which should be used as the value ofthe CertServersFilePath key.

    Silent Installation Guide About silently installing the BlackBerry Desktop Software

    9

  • 8/9/2019 BlackBerry manuslk

    12/14

    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 countriesaround the world.

    IBM, Lotus, and Domino are trademarks of International Business Machines Corporation. InstallShield is a trademark of FlexeraSoftware. 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 thisdocumentation. In order to protect RIM proprietary and confidential information and/or trade secrets, this documentationmay describe some aspects of RIM technology in generalized terms. RIM reserves the right to periodically change informationthat 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 t imely 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 anyway.

    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, INCLUDINGWITHOUT LIMITATION, ANY CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS OR WARRANTIES OFDURABILITY, FITNESS FOR A PARTICULAR PURPOSE OR USE, MERCHANTABILITY, MERCHANTABLE QUALITY, NON-INFRINGEMENT, SATISFACTORY QUALITY, OR TITLE, OR ARISING FROM A STATUTE OR CUSTOM OR A COURSE OF DEALING ORUSAGE OF TRADE, OR RELATED TO THE DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANYSOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN, ARE HEREBYEXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTS THAT VARY BY STATE OR PROVINCE. SOME JURISDICTIONS MAY NOT ALLOWTHE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES AND CONDITIONS. TO THE EXTENT PERMITTED BY LAW, ANYIMPLIED WARRANTIES OR CONDITIONS RELATING TO THE DOCUMENTATION TO THE EXTENT THEY CANNOT BE EXCLUDED ASSET 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 FORANY TYPE 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

    10

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

  • 8/9/2019 BlackBerry manuslk

    13/14

    ANY PORTION THEREOF OR OF ANY AIRTIME SERVICES, COST OF SUBSTITUTE GOODS, COSTS OF COVER, FACILITIES ORSERVICES, COST OF CAPITAL, OR OTHER SIMILAR PECUNIARY LOSSES, WHETHER OR NOT SUCH DAMAGES WERE FORESEEN ORUNFORESEEN, 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 NEGLIGENCEOR STRICT 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

    THE ESSENTIAL 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 your

    airtime 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 orviolation of third party rights. You are solely responsible for determining whether to use Third Party Products and Services andif any third party licenses are required to do so. If required you are responsible for acquiring them. You should not install or useThird Party Products and Services until all necessary licenses have been acquired. Any Third Party Products and Services thatare provided with RIM's products and services are provided as a convenience to you and are provided "AS IS" with no expressor implied conditions, endorsements, guarantees, representations, or warranties of any kind by RIM and RIM assumes noliability whatsoever, in relation thereto. Your use of Third Party Products and Services shall be governed by and subject to youagreeing to the terms of separate licenses and other agreements applicable thereto with third parties, except to the extentexpressly 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 applicablethereto. 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 Limited295 Phillip StreetWaterloo, ON N2L 3W8Canada

    Research In Motion UK Limited200 Bath RoadSlough, Berkshire SL1 3XE

    Silent Installation Guide Legal notice

    11

  • 8/9/2019 BlackBerry manuslk

    14/14

    United Kingdom

    Published in Canada

    Silent Installation Guide Legal notice

    12