background image

Moving user accounts from a BlackBerry

Enterprise Server or BlackBerry

Professional Software to a BlackBerry

Enterprise Server Express

Consideration

Description

The BlackBerry Enterprise Transporter

does not support bulk mode when

moving user accounts from a

BlackBerry Enterprise Server or

BlackBerry Professional Software to a

BlackBerry Enterprise Server Express.

The BlackBerry Enterprise Transporter does not support the use of bulk mode

when moving user accounts from a source BlackBerry Enterprise Server or

BlackBerry Professional Software to a destination BlackBerry Enterprise Server

Express.

By default, the BlackBerry Enterprise

Transporter cannot connect to the

BlackBerry Administration Service of a

BlackBerry Enterprise Server Express.

As a result, the BlackBerry Enterprise

Transporter can move user accounts,

but you cannot assign IT policies or

software 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 BlackBerry

Administration Service of the destination server using port 443, the default port

connection for the BlackBerry Administration Service of the BlackBerry

Enterprise Server. The BlackBerry Administration Service of the BlackBerry

Enterprise Server Express uses port 3443 by default.
If you want to move user accounts to a destination BlackBerry Enterprise Server

Express and assign IT policies, software configurations, and groups to the user

accounts, you must add the following text to the appSettings section of the

EnterpriseTransporter.exe.config file: 

<add key="basUrl"

value="<

BlackBerry_Administration_Server_URL

>:

<

BlackBerry_Administration_Service_port

>"/>

Do not specify http or https for the BlackBerry Administration Service web

address (for example, <add key="basUrl" value="bas.test.org.net:3443"/>).

Installation and Administration Guide

Premigration considerations

43

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: