background image

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, DB2, Domino, Lotus, and Lotus Notes are trademarks of International Business Machines Corporation. Microsoft,

Active Directory, SQL Server, Windows, and Windows Server 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 websites
(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, NON-INFRINGEMENT, 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-

16

Installation and Administration Guide

Legal notice

79

Summary of Contents for Enterprise Server Server Resource Kit

Page 1: ...BlackBerry Enterprise Server Resource Kit BlackBerry Enterprise Transporter Version 5 0 Service Pack 4 Installation and Administration Guide...

Page 2: ...Published 2012 10 15 SWD 20121015112452250...

Page 3: ...23 Encrypt the information about database connections in the BlackBerry Enterprise Transporter configuration file 24 Configure the BlackBerry Enterprise Transporter to skip certificate validation 25 5...

Page 4: ...move 49 Import a file with email addresses 50 Add the information for a single user account 50 Bulk mode Selecting user accounts to migrate 51 Enable bulk mode to select all user accounts that are ass...

Page 5: ...rt information for the BlackBerry Enterprise Server Resource Kit tools 75 Port information for tools that connect to the BlackBerry Configuration Database 75 Port information for tools that connect to...

Page 6: ...he destination BlackBerry Enterprise Server resends the service book to devices over the wireless network device activation starts and the synchronization of organizer data and calendar information st...

Page 7: ...source BlackBerry Enterprise Server instances When using bulk mode the tool does not monitor IT administration commands such as Resend IT Policy or Switch Service to verify that the migration process...

Page 8: ...etting to apply to all user accounts You can modify the IT policy software configuration and group assignments using the BlackBerry Administration Service after the migration is complete If you want t...

Page 9: ...erver 5 0 or later there might be a delay before the destination BlackBerry Enterprise Server applies the selected IT policies or group assigned IT policies to devices During this delay the Default IT...

Page 10: ...BlackBerry Enterprise Transporter If skipDominoBBSDReplication and skipDominoBBSDValidation are not present or are set to False verifies that the selected IBM Lotus Notes user id can open the BlackBe...

Page 11: ...Verifies whether the user s BlackBerry state database has been marked for deletion in the BlackBerry profiles database on the destination BlackBerry Enterprise Server Verifies whether a duplicate Blac...

Page 12: ...lackBerry Enterprise Transporter regardless of the version of the source BlackBerry Enterprise Server and destination BlackBerry Enterprise Server Operating system Any of the following operating syste...

Page 13: ...nd the admin web services AdminWS to migrate user accounts and user configuration settings If the destination BlackBerry Enterprise Server is 4 0 x 4 1 x or 5 0 1 or later the required components are...

Page 14: ...r For more information see the premigration considerations BlackBerry Enterprise Server Express The BlackBerry Enterprise Transporter does not support the use of bulk mode when moving user accounts fr...

Page 15: ...rry Enterprise Server for Microsoft Exchange and the BlackBerry Enterprise Server for IBM Lotus Domino The following table displays the migration paths that the BlackBerry Enterprise Transporter suppo...

Page 16: ...S BO S S S S S Related information BlackBerry Enterprise Server compatibility 30 BlackBerry Device Software compatibility 35 BlackBerry Enterprise Transporter compatibility matrix for the BlackBerry E...

Page 17: ...rmation BlackBerry Enterprise Server compatibility 30 BlackBerry Device Software compatibility 35 BlackBerry Enterprise Transporter compatibility matrix for the BlackBerry Enterprise Server Express Bl...

Page 18: ...s not supported due to compatibility issues Destination server BlackBerry Enterprise Server Small Business Edition 4 0 7 and 4 1 7 BlackBerry Professional Software 4 1 4 BlackBerry Enterprise Server E...

Page 19: ...ures and environments For more information about BlackBerry Enterprise Transporter compatibility see Supported environments Item Environment MDM domains The BlackBerry Enterprise Transporter does not...

Page 20: ...ino For more information visit www blackberry com go serverdocs to read the BlackBerry Enterprise Server Installation Guide and the BlackBerry Enterprise Server Administration Guide Permission Descrip...

Page 21: ...Server Resource Kit Perform one of the following actions If skipDominoBBSDReplication is not set to True do not replicate the IBM Lotus Domino databases before you run the BlackBerry Enterprise Trans...

Page 22: ...prise Server Resource Kit to download the latest installation package for the tools brk version exe Complete the download instructions on the website Double click brk version exe Extract the contents...

Page 23: ...seconds 1 On the computer that hosts the BlackBerry Enterprise Transporter navigate to drive Program Files x86 Research In Motion BlackBerry Enterprise Server Resource Kit BlackBerry Enterprise Trans...

Page 24: ...or move the configuration file to a different computer you cannot decrypt the information about database connections on the new computer 1 On the computer that hosts the BlackBerry Enterprise Transpo...

Page 25: ...ermit you to modify the configuration file at this location open the virtualized copy of the EnterpriseTransporter exe config file in the application data folder for the current user for example drive...

Page 26: ...ist of the IT policies policy rules and default settings that you want to duplicate in the destination MDM domain BlackBerry Enterprise Server Administration Guide Create a list of the SRP information...

Page 27: ...fy users that applications on the BlackBerry device that use a data connection through the BlackBerry MDS Connection Service might experience a service interruption until the user account is migrated...

Page 28: ...cies roles and software configurations that you want to duplicate from the source MDM domain If you enable bulk mode and configure custom default settings to apply to individual user accounts the IT p...

Page 29: ...change or Novell GroupWise environment configure the destination BlackBerry Enterprise Server instances to use the same instance names ServerConfig ServiceName and SRP IDs as the source instances In a...

Page 30: ...accounts to the destination MDM domain Before you try to move the user accounts upgrade the source BlackBerry Enterprise Server for Microsoft Exchange to version 4 1 SP6 MR5 or later Moving user accou...

Page 31: ...se Server for Microsoft Exchange In specific circumstances if the version of the source BlackBerry Enterprise Server for Microsoft Exchange is earlier than version 4 1 SP6 MR5 the BlackBerry Enterpris...

Page 32: ...e the user accounts to a destination BlackBerry Enterprise Server for IBM Lotus Domino duplicate contact list entries might appear on devices Permanently delete the data on the devices and activate th...

Page 33: ...M Lotus Domino duplicate contact list entries might appear on devices Permanently delete the data on the devices and activate the devices again If the version of the source BlackBerry Enterprise Serve...

Page 34: ...o the BlackBerry Enterprise Server again and activate the BlackBerry device If the source BlackBerry Enterprise Server is 5 0 or later consider the following information Consideration Description Dupl...

Page 35: ...kBerry Device Software 4 3 0 consider the following information Consideration Description IT policies might not be applied to BlackBerry devices After you move user accounts to the destination BlackBe...

Page 36: ...ver if the IT policy is not applied to the devices You are not required to permanently delete the data on the devices before you activate the user accounts again Moving user accounts to a destination...

Page 37: ...kBerry devices use BlackBerry Device Software 4 0 0 to 4 0 1 consider the following information Consideration Description IT policies might not be applied to BlackBerry devices If the destination Blac...

Page 38: ...ses the BlackBerry Enterprise Server for IBM Lotus Domino consider the following information Consideration Description Duplicate contact list entries might appear on BlackBerry devices If organizer da...

Page 39: ...rmation Consideration Description Issues might occur if the user ID of a user account already exists on the destination BlackBerry Enterprise Server If the user ID of a user account on the source Blac...

Page 40: ...not applied to devices after you move the user accounts Before you move the user accounts update the BlackBerry Device Software on devices to 4 0 2 or later or add the ITPolicyKeyMapping table to the...

Page 41: ...licate contact list entries might appear on devices Permanently delete the data on the devices and activate the devices again If devices use BlackBerry Device Software 4 3 0 consider the following inf...

Page 42: ...r accounts from a BlackBerry Enterprise Server Express to a destination BlackBerry Enterprise Server The BlackBerry Enterprise Transporter does not support the use of bulk mode when moving user accoun...

Page 43: ...oftware configurations to the user accounts when they are moved and you cannot assign the user accounts to groups when they are moved The BlackBerry Enterprise Transporter tries to connect to the Blac...

Page 44: ...y Enterprise Transporter 2 In the Step 1 User Manifest section click New 3 Type a file name 4 Click Save After you finish Configure the source and destination instances of the BlackBerry Configuration...

Page 45: ...base administrator account click Windows NT Authentication Specify User In the User Name and Password fields type the login information for the database administrator account The domain of the specifi...

Page 46: ...want to apply to the user accounts by default during the migration process 3 Select the Use current defaults for all new entries check box 4 Click Done To apply different default settings to specific...

Page 47: ...finish To turn off notification messages clear the Enable check box Configure how long the BlackBerry Enterprise Transporter tries to open a connection to the source BlackBerry Configuration Database...

Page 48: ...rise Server Resource Kit 2 In a text editor open the EnterpriseTransporter exe config file 3 In the connectionStrings section locate the connection strings for the source BlackBerry Configuration Data...

Page 49: ...ver the tool will migrate all of the users associated with that BlackBerry Enterprise Server Live mode Selecting user accounts to migrate Search for and select user accounts to move You can search for...

Page 50: ...ETE Import a file with email addresses Before you begin Configure the source and destination instances of the BlackBerry Configuration Database Create a CR delimited flat text file that contains the e...

Page 51: ...the different settings for each user account As a result the migration process might take longer than expected to complete If you enable bulk mode it is a best practice to configure a single default s...

Page 52: ...source and destination instances of the BlackBerry Configuration Database Before you select the user accounts that you want to move to the destination MDM domain in the Step 3 Manifest Configuration s...

Page 53: ...assigned software configurations and IT policies from the user accounts For more information about reconciliation rules see the BlackBerry Enterprise Server Administration Guide Note If you move user...

Page 54: ...tion section click Abort When you click Abort the BlackBerry Enterprise Transporter stops after it migrates the batch of user accounts that it is currently processing Before you begin Before you use t...

Page 55: ...a best practice to use this option when you move user accounts during low usage periods If you do not select this option the destination BlackBerry Enterprise Server synchronizes the organizer data fo...

Page 56: ...at user accounts were migrated or to troubleshoot migration issues In the BlackBerry Enterprise Transporter on the Help menu click View Log By default the log files are located at drive Users user_nam...

Page 57: ...interface 1 On the computer that hosts the BlackBerry Enterprise Transporter at the command prompt navigate to drive Program Files x86 Research in Motion BlackBerry Resource Kit BlackBerry Enterprise...

Page 58: ...environment only dominopassword password This parameter specifies the password that the BlackBerry Enterprise Transporter uses for the user id file This parameter is required in a BlackBerry Enterpri...

Page 59: ...ration Service authentication you must also specify the basusername and baspassword parameters mailbox_auth use mailbox authentication IBM Lotus Domino environment only If you do not specify an authen...

Page 60: ...baspassword password manifestPath C Users besadmin Desktop ET manifest files Example Preview the migration process using Active Directory authentication enterprisetransporter console execute basauthty...

Page 61: ...e 2 In the Label drop down list click the label for the former destination BlackBerry Configuration Database 3 Click OK 4 In the Step 2 BlackBerry Databases section in the Destination Domain section c...

Page 62: ...override the proxy server that you configured in the EnterpriseTransporter exe config file add the following text inside the configuration tags system net defaultProxy proxy usesystemdefault false def...

Page 63: ...user accounts to a destination BlackBerry Enterprise Server 5 0 and the BlackBerry Enterprise Transporter cannot detect the BlackBerry Enterprise Server User Administration Tool The BlackBerry Enterp...

Page 64: ...lder than 5 0 Description This message appears if BlackBerry Enterprise Server 5 0 x and an earlier version of the BlackBerry Enterprise Server are both present in the destination MDM domain Possible...

Page 65: ...ers user_name AppData Roaming Research In Motion BlackBerry Enterprise Transporter Manifests If you are running the BlackBerry Enterprise Transporter in bulk mode you selected the Bulk Server Mode che...

Page 66: ...ination server does not support the current encryption scheme Description This message appears when the destination BlackBerry Enterprise Server does not support the encryption scheme that is used by...

Page 67: ...empty Description This message appears when there is no routing information for the user account in the source BlackBerry Configuration Database The user account might not be active The user s BlackBe...

Page 68: ...device version string Version found in database Description This message appears when the BlackBerry Enterprise Transporter cannot process the version of the BlackBerry Device Software that is associa...

Page 69: ...log file for the destination BlackBerry Enterprise Server to determine why the BlackBerry Enterprise Server did not queue a switch service command automatically Verify that the routing information fo...

Page 70: ...te the user account on the source BlackBerry Enterprise Server then retry the migration Run the migration process with Ignore warnings selected then activate the user account on the destination BlackB...

Page 71: ...ation BlackBerry Policy Service reports an error after it tries to send the Switch Service command to the BlackBerry device Possible solution Check the log file for the BlackBerry Policy Service to de...

Page 72: ...the BlackBerry Enterprise Transporter log file for details By default the log files are located at drive Users user_name AppData Roaming Research In Motion BlackBerry Enterprise Transporter Logs User...

Page 73: ...scription This message appears when the BlackBerry Enterprise Transporter detects a condition where the destination BlackBerry Enterprise Server might not be able to apply a new IT policy to the Black...

Page 74: ...pedDueToValidationFailure Description On the Report tab this status message appears for user accounts that were not moved to the destination BlackBerry Enterprise Server because the BlackBerry Enterpr...

Page 75: ...number BlackBerry Application Reporting Tool TCP 1433 BlackBerry Domain Administration History Reporting Tool TCP 1433 BlackBerry Enterprise Transporter TCP 1433 BlackBerry IT Policy Import and Expor...

Page 76: ...ion Tool TCP BlackBerry Enterprise Server 443 BlackBerry Enterprise Server Express 8443 BlackBerry Enterprise Transporter TCP BlackBerry Enterprise Server 443 BlackBerry Enterprise Server Express 8443...

Page 77: ...mber Listens for packets UDP 514 Sends messages over SMTP TCP 25 Port information for the BlackBerry Message Receipt Confirmation Tool Action Connection type Default port number Sends messages MAPI 12...

Page 78: ...abase and any BlackBerry Mobile Fusion services or components that are associated with it An MDM domain can refer to any of the following environments BlackBerry Enterprise Server domain A BlackBerry...

Page 79: ...y 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 perfo...

Page 80: ...UPPLIER 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...

Page 81: ...on might require additional development or Third Party Products and Services for access to corporate applications Research In Motion Limited 295 Phillip Street Waterloo ON N2L 3W8 Canada Research In M...

Reviews: