Resource Kit
Page 4
... 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 associated with a source BlackBerry Enterprise Server 51 Configure the default settings to apply to specific user accounts 52 10 Moving user accounts ...54 Preview the migration process ...54 Move user accounts to a different MDM domain ...54 View the latest BlackBerry Enterprise Transporter log file 56 11 Running the BlackBerry Enterprise...
... 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 associated with a source BlackBerry Enterprise Server 51 Configure the default settings to apply to specific user accounts 52 10 Moving user accounts ...54 Preview the migration process ...54 Move user accounts to a different MDM domain ...54 View the latest BlackBerry Enterprise Transporter log file 56 11 Running the BlackBerry Enterprise...
Resource Kit
Page 5
Troubleshooting migration errors ...70 User migration failed messages ...70 User migration completed with warning messages ...71 User migration pending error messages ...72 IT policy error messages ...73 User account status: Skipped ...74 User account status: MigrationSkippedDueToValidationFailure 74 14 Port 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 the BlackBerry Administration Service, BlackBerry Administration API, and ...
Troubleshooting migration errors ...70 User migration failed messages ...70 User migration completed with warning messages ...71 User migration pending error messages ...72 IT policy error messages ...73 User account status: Skipped ...74 User account status: MigrationSkippedDueToValidationFailure 74 14 Port 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 the BlackBerry Administration Service, BlackBerry Administration API, and ...
Resource Kit
Page 6
.... Live mode Running the BlackBerry Enterprise Transporter in a different MDM domain. You can create a new MDM domain version 5.0.4 and use the BlackBerry Enterprise Transporter when your organization's BlackBerry Enterprise Server from a source MDM domain to a destination BlackBerry Enterprise Server in live mode or in bulk mode to move server settings to the destination BlackBerry Enterprise Server (for example, the software configurations or IT policies that are associated with it. You can use the BlackBerry Enterprise Transporter to move user accounts between...
.... Live mode Running the BlackBerry Enterprise Transporter in a different MDM domain. You can create a new MDM domain version 5.0.4 and use the BlackBerry Enterprise Transporter when your organization's BlackBerry Enterprise Server from a source MDM domain to a destination BlackBerry Enterprise Server in live mode or in bulk mode to move server settings to the destination BlackBerry Enterprise Server (for example, the software configurations or IT policies that are associated with it. You can use the BlackBerry Enterprise Transporter to move user accounts between...
Resource Kit
Page 7
... to migrating all user accounts. Bulk mode Running the BlackBerry Enterprise Transporter in bulk mode refers to the 7 You can modify the IT policy, software configuration, and group assignments using bulk mode, the tool does not monitor IT administration commands (such as part of the BlackBerry Enterprise Transporter. In a Microsoft Exchange or Novell GroupWise environment, you enable bulk mode and configure custom default settings to apply to individual user accounts (the IT policies, software configurations, and groups to assign...
... to migrating all user accounts. Bulk mode Running the BlackBerry Enterprise Transporter in bulk mode refers to the 7 You can modify the IT policy, software configuration, and group assignments using bulk mode, the tool does not monitor IT administration commands (such as part of the BlackBerry Enterprise Transporter. In a Microsoft Exchange or Novell GroupWise environment, you enable bulk mode and configure custom default settings to apply to individual user accounts (the IT policies, software configurations, and groups to assign...
Resource Kit
Page 8
... enable bulk mode, it is a best practice to use live mode. You can use the tool in bulk mode. The BlackBerry Enterprise Transporter does not move user accounts that cannot be assigned a device). If you enable bulk mode and configure custom default settings to apply to individual user accounts (the IT policies, software configurations, and groups to assign to user accounts), the destination BlackBerry Administration Service must process the different settings for example, administrator accounts that are enabled not BlackBerry-enabled (for each user account. Data...
... enable bulk mode, it is a best practice to use live mode. You can use the tool in bulk mode. The BlackBerry Enterprise Transporter does not move user accounts that cannot be assigned a device). If you enable bulk mode and configure custom default settings to apply to individual user accounts (the IT policies, software configurations, and groups to assign to user accounts), the destination BlackBerry Administration Service must process the different settings for example, administrator accounts that are enabled not BlackBerry-enabled (for each user account. Data...
Resource Kit
Page 9
... is applied to a destination BlackBerry Enterprise Server are assigned the Default IT policy after the migration process completes. Note: If you want to assign to the group. Installation and Administration Guide BlackBerry Enterprise Transporter Data Group data Software configurations IT policy data BlackBerry MDS Integration Service data BlackBerry Browser configuration settings Synchronized public contacts and databases, and additional private contact folders Description The migration process does not migrate groups or any data associated with groups. Instead, you can create...
... is applied to a destination BlackBerry Enterprise Server are assigned the Default IT policy after the migration process completes. Note: If you want to assign to the group. Installation and Administration Guide BlackBerry Enterprise Transporter Data Group data Software configurations IT policy data BlackBerry MDS Integration Service data BlackBerry Browser configuration settings Synchronized public contacts and databases, and additional private contact folders Description The migration process does not migrate groups or any data associated with groups. Instead, you can create...
Resource Kit
Page 10
... email address. • Verifies that the selected IBM Lotus Notes user.id can respond. • Verifies that the required API and web services are set to False, verifies that the user account exists in the source MDM domain. 10 The default location of the EnterpriseTransporter.exe.config file in the application data folder for the current user (for example, \Users \\AppData\Local\VirtualStore\Program Files (x86)\Research In Motion\BlackBerry Enterprise Server...
... email address. • Verifies that the selected IBM Lotus Notes user.id can respond. • Verifies that the required API and web services are set to False, verifies that the user account exists in the source MDM domain. 10 The default location of the EnterpriseTransporter.exe.config file in the application data folder for the current user (for example, \Users \\AppData\Local\VirtualStore\Program Files (x86)\Research In Motion\BlackBerry Enterprise Server...
Resource Kit
Page 12
....com/go/serverdocs to using the tool, evaluate the available migration options. Prior to read the BlackBerry Enterprise Server Upgrade Guide. Any of the source BlackBerry Enterprise Server and destination BlackBerry Enterprise Server. Item BlackBerry Enterprise Transporter version Operating system Requirement Use the latest available version of the BlackBerry Enterprise Transporter, regardless of the version of the following operating systems: • Windows 7 • Windows Server 2008 R2 • Windows Server 2008 • Windows Vista • Windows Server 2003 SP1 or later...
....com/go/serverdocs to using the tool, evaluate the available migration options. Prior to read the BlackBerry Enterprise Server Upgrade Guide. Any of the source BlackBerry Enterprise Server and destination BlackBerry Enterprise Server. Item BlackBerry Enterprise Transporter version Operating system Requirement Use the latest available version of the BlackBerry Enterprise Transporter, regardless of the version of the following operating systems: • Windows 7 • Windows Server 2008 R2 • Windows Server 2008 • Windows Vista • Windows Server 2003 SP1 or later...
Resource Kit
Page 13
... a device to create and manage groups, user accounts, IT policies, and software configurations. These permissions are installed automatically with a security administrator role or enterprise administrator role. If the destination BlackBerry Enterprise Server is 4.0.x, 4.1.x, or 5.0.1 or later, the required components are typically associated with the BlackBerry Enterprise Server. MDM domain If the destination MDM domain includes a BlackBerry Enterprise Server 5.0.x, all BlackBerry Enterprise Server instances must configure both the source and the destination to use to view BlackBerry...
... a device to create and manage groups, user accounts, IT policies, and software configurations. These permissions are installed automatically with a security administrator role or enterprise administrator role. If the destination BlackBerry Enterprise Server is 4.0.x, 4.1.x, or 5.0.1 or later, the required components are typically associated with the BlackBerry Enterprise Server. MDM domain If the destination MDM domain includes a BlackBerry Enterprise Server 5.0.x, all BlackBerry Enterprise Server instances must configure both the source and the destination to use to view BlackBerry...
Resource Kit
Page 14
... Enterprise Server Small Business Edition Known issues might function correctly with versions of Microsoft SQL Server that the BlackBerry Enterprise Server supports. Installation and Administration Guide System requirements Supported environments Item Environment BlackBerry Enterprise Server versions For information about the supported versions of the source and destination BlackBerry Enterprise Server, see the premigration considerations. BlackBerry Enterprise Server Express The BlackBerry Enterprise Transporter does not support the use of Microsoft Exchange that are not listed...
... Enterprise Server Small Business Edition Known issues might function correctly with versions of Microsoft SQL Server that the BlackBerry Enterprise Server supports. Installation and Administration Guide System requirements Supported environments Item Environment BlackBerry Enterprise Server versions For information about the supported versions of the source and destination BlackBerry Enterprise Server, see the premigration considerations. BlackBerry Enterprise Server Express The BlackBerry Enterprise Transporter does not support the use of Microsoft Exchange that are not listed...
Resource Kit
Page 17
... BlackBerry Enterprise Server Express, BlackBerry Professional Software, and BlackBerry Enterprise Server Small Business Edition The following table displays the migration paths that you try to migrate user accounts. 17 The BlackBerry Enterprise Transporter does not support bulk mode when moving user accounts from the destination server to the source server for troubleshooting purposes only. Note: Based on the version and the type of the source and destination server, there might be aware of. Installation and Administration Guide System requirements Table...
... BlackBerry Enterprise Server Express, BlackBerry Professional Software, and BlackBerry Enterprise Server Small Business Edition The following table displays the migration paths that you try to migrate user accounts. 17 The BlackBerry Enterprise Transporter does not support bulk mode when moving user accounts from the destination server to the source server for troubleshooting purposes only. Note: Based on the version and the type of the source and destination server, there might be aware of. Installation and Administration Guide System requirements Table...
Resource Kit
Page 20
... BlackBerry Enterprise Server Express, BlackBerry Professional Software, and BlackBerry Enterprise Server Small Business Edition, 17 Troubleshooting preview errors, 64 Troubleshooting migration errors, 70 Premigration considerations, 30 Required permissions in an IBM Lotus Domino environment To run the BlackBerry Enterprise Transporter in an IBM Lotus Domino environment, you require as an administrator of the LocalDomainServers group. Permission Notes.ini file Description You must be able to use the user ID if the user ID file name (username...
... BlackBerry Enterprise Server Express, BlackBerry Professional Software, and BlackBerry Enterprise Server Small Business Edition, 17 Troubleshooting preview errors, 64 Troubleshooting migration errors, 70 Premigration considerations, 30 Required permissions in an IBM Lotus Domino environment To run the BlackBerry Enterprise Transporter in an IBM Lotus Domino environment, you require as an administrator of the LocalDomainServers group. Permission Notes.ini file Description You must be able to use the user ID if the user ID file name (username...
Resource Kit
Page 46
... to specific user accounts. In the BlackBerry Enterprise Transporter, in the Step 3: Manifest Configuration section, in the drop-down lists, click the BlackBerry Enterprise Server, group, IT policy, and software configuration that you want to assign custom default settings to user accounts. If you want to apply to all user accounts. Note: If you can apply software configurations and IT policies directly to individual user accounts as part of the BlackBerry Configuration Database. 1. To apply different default settings to devices. Using the BlackBerry Enterprise...
... to specific user accounts. In the BlackBerry Enterprise Transporter, in the Step 3: Manifest Configuration section, in the drop-down lists, click the BlackBerry Enterprise Server, group, IT policy, and software configuration that you want to assign custom default settings to user accounts. If you want to apply to all user accounts. Note: If you can apply software configurations and IT policies directly to individual user accounts as part of the BlackBerry Configuration Database. 1. To apply different default settings to devices. Using the BlackBerry Enterprise...
Resource Kit
Page 63
Installation and Administration Guide Troubleshooting • Use the sample configuration file located in the location that you specified. Possible solution Try performing one of the BlackBerry Enterprise Server User Administration Tool on the computer that hosts the BlackBerry Enterprise Transporter. The BlackBerry Enterprise Transporter uses the BlackBerry Enterprise Server User Administration Tool to assign default settings for groups, IT policies, and software configurations to the user accounts that you specified. • Create and configure a new manifest file. The ...
Installation and Administration Guide Troubleshooting • Use the sample configuration file located in the location that you specified. Possible solution Try performing one of the BlackBerry Enterprise Server User Administration Tool on the computer that hosts the BlackBerry Enterprise Transporter. The BlackBerry Enterprise Transporter uses the BlackBerry Enterprise Server User Administration Tool to assign default settings for groups, IT policies, and software configurations to the user accounts that you specified. • Create and configure a new manifest file. The ...
Resource Kit
Page 68
...Failed to empty WLANBaseConfigSet: ConfigName Description This message appears when the BlackBerry Enterprise Transporter does not move the user account again. 68 Skipping WLAN configuration due to load UserConfig row for Microsoft SQL Server errors. Possible solution Manually remove, re-add, and reactivate the user accounts on the destination BlackBerry Enterprise Server using the BlackBerry Administration Service. Installation and Administration Guide Troubleshooting This message appears only if the BlackBerry Enterprise Server instances in the BlackBerry Configuration Database...
...Failed to empty WLANBaseConfigSet: ConfigName Description This message appears when the BlackBerry Enterprise Transporter does not move the user account again. 68 Skipping WLAN configuration due to load UserConfig row for Microsoft SQL Server errors. Possible solution Manually remove, re-add, and reactivate the user accounts on the destination BlackBerry Enterprise Server using the BlackBerry Administration Service. Installation and Administration Guide Troubleshooting This message appears only if the BlackBerry Enterprise Server instances in the BlackBerry Configuration Database...
Resource Kit
Page 69
Installation and Administration Guide Troubleshooting Failed to load PIM Sync data for Microsoft SQL Server errors to identify which indicates that the user account is greater than 0. Possible solution Try performing the following actions: • Review the BlackBerry Messaging Agent 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 for the user account on the source and destination...
Installation and Administration Guide Troubleshooting Failed to load PIM Sync data for Microsoft SQL Server errors to identify which indicates that the user account is greater than 0. Possible solution Try performing the following actions: • Review the BlackBerry Messaging Agent 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 for the user account on the source and destination...
Resource Kit
Page 71
... the error. By default, the log files are located at :\Users\\AppData\Roaming\Research In Motion\BlackBerry Enterprise Transporter \Logs. • Verify that the destination BlackBerry Configuration Database is not successfully applied to the BlackBerry device after it tries to send the Switch Service command to the BlackBerry device. Installation and Administration Guide Troubleshooting MIGRATION / FAILED Description This message appears when the BlackBerry Enterprise Transporter cannot add the data for the BlackBerry Policy Service are located at :\Program Files (x86...
... the error. By default, the log files are located at :\Users\\AppData\Roaming\Research In Motion\BlackBerry Enterprise Transporter \Logs. • Verify that the destination BlackBerry Configuration Database is not successfully applied to the BlackBerry device after it tries to send the Switch Service command to the BlackBerry device. Installation and Administration Guide Troubleshooting MIGRATION / FAILED Description This message appears when the BlackBerry Enterprise Transporter cannot add the data for the BlackBerry Policy Service are located at :\Program Files (x86...
Resource Kit
Page 72
... that the device is turned on the destination BlackBerry Enterprise Server. User migration pending error messages SWITCH_SERVICE or SET_IT_POLICY / PENDING Description These messages appear when the BlackBerry Policy Service sends the Switch Service command or the Set IT Policy command to reactivate the device and send the IT administration commands again. 72 By default, the log files are located at :\Users \\AppData\Roaming\Research In Motion\BlackBerry Enterprise Transporter\Logs . Use the BlackBerry Administration Service to the BlackBerry device, but did not stop the migration...
... that the device is turned on the destination BlackBerry Enterprise Server. User migration pending error messages SWITCH_SERVICE or SET_IT_POLICY / PENDING Description These messages appear when the BlackBerry Policy Service sends the Switch Service command or the Set IT Policy command to reactivate the device and send the IT administration commands again. 72 By default, the log files are located at :\Users \\AppData\Roaming\Research In Motion\BlackBerry Enterprise Transporter\Logs . Use the BlackBerry Administration Service to the BlackBerry device, but did not stop the migration...
Resource Kit
Page 73
... for the source Set IT Policy command to delete the data on the destination BlackBerry Enterprise Server after the migration process completes. Installation and Administration Guide Troubleshooting IT policy error messages Last IT Policy Command Failed or Pending Description These messages appear when the last Set IT Policy command that the source BlackBerry Enterprise Server sent to migrate a user account if the BlackBerry Device Software is earlier than version 4.0.2 and the destination BlackBerry Configuration Database does not contain the optional ITPolicyKeyMapping table. Possible...
... for the source Set IT Policy command to delete the data on the destination BlackBerry Enterprise Server after the migration process completes. Installation and Administration Guide Troubleshooting IT policy error messages Last IT Policy Command Failed or Pending Description These messages appear when the last Set IT Policy command that the source BlackBerry Enterprise Server sent to migrate a user account if the BlackBerry Device Software is earlier than version 4.0.2 and the destination BlackBerry Configuration Database does not contain the optional ITPolicyKeyMapping table. Possible...
Resource Kit
Page 80
... version of third party rights. Installation or use of any kind by a license or other agreements applicable thereto with a subscription to avoid infringement or violation of BlackBerry Enterprise Server, BlackBerry Desktop Software, and/or BlackBerry Device Software. Certain features outlined in relation thereto. The terms of use of their features. Some airtime service providers might not offer Internet browsing functionality with third parties, except to support all...
... version of third party rights. Installation or use of any kind by a license or other agreements applicable thereto with a subscription to avoid infringement or violation of BlackBerry Enterprise Server, BlackBerry Desktop Software, and/or BlackBerry Device Software. Certain features outlined in relation thereto. The terms of use of their features. Some airtime service providers might not offer Internet browsing functionality with third parties, except to support all...