blackberry enterprise server resource kit installation and administration guide 1322936 0127022526...

BlackBerry Enterprise ServerResource KitBlackBerry Enterprise TransporterVersion: 5.0 | Service Pack: 3

Installation and Administration Guide

Published: 2011-06-20SWD-1322936-0620025635-001

Contents1 BlackBerry Enterprise Transporter................................................................................................................... 4

BlackBerry Enterprise Transporter modes........................................................................................................ 4Options for moving user accounts with the BlackBerry Enterprise Transporter.............................................. 5Data that the migration process does not move.............................................................................................. 5Validation that the BlackBerry Enterprise Transporter performs..................................................................... 7

Global validation........................................................................................................................................ 7User validation........................................................................................................................................... 7

What's new in BlackBerry Enterprise Transporter 5.0 SP3............................................................................... 8

2 System requirements........................................................................................................................................ 9System requirements: BlackBerry Enterprise Transporter............................................................................... 9Installation considerations................................................................................................................................ 10

Supported environments........................................................................................................................... 10Unsupported features and environments................................................................................................. 15Required permissions in an IBM Lotus Domino environment................................................................... 16Replicating IBM Lotus Domino databases................................................................................................. 16

3 Installing or upgrading the BlackBerry Enterprise Transporter........................................................................ 18Install or upgrade the BlackBerry Enterprise Transporter................................................................................ 18

4 Configuring the BlackBerry Enterprise Transporter.......................................................................................... 19Configure how long the BlackBerry Enterprise Transporter waits for the Microsoft SQL Server to processcommands........................................................................................................................................................ 19Encrypt the information about database connections in the BlackBerry Enterprise Transporterconfiguration file............................................................................................................................................... 19

5 Preparing the source BlackBerry Domain for the migration process............................................................... 21

6 Preparing the destination BlackBerry Domain for the migration process........................................................ 22

7 Premigration considerations............................................................................................................................. 23BlackBerry Enterprise Server compatibility...................................................................................................... 23

Moving user accounts to a destination BlackBerry Enterprise Server version 5.0 or later....................... 23Moving user accounts to a destination BlackBerry Enterprise Server version 4.1 SP4 to 4.1 SP7............ 23Moving user accounts to a destination BlackBerry Enterprise Server version 4.1 to 4.1 SP3................... 24Moving user accounts to a destination BlackBerry Enterprise Server version 4.0 SP7............................. 26Moving user accounts to a destination BlackBerry Enterprise Server version 4.0 to 4.0 SP6................... 27

BlackBerry Device Software compatibility........................................................................................................ 28Moving user accounts to a destination BlackBerry Enterprise Server version 5.0 or later....................... 28

Moving user accounts to a destination BlackBerry Enterprise Server version 4.1 SP4 to 4.1 SP7............ 30Moving user accounts to a destination BlackBerry Enterprise Server version 4.1 to 4.1 SP3................... 31Moving user accounts to a destination BlackBerry Enterprise Server version 4.0 SP7............................. 33Moving user accounts to a destination BlackBerry Enterprise Server version 4.0 to 4.0 SP6................... 35

Moving user accounts from a BlackBerry Enterprise Server Express to a BlackBerry Enterprise Server.......... 37Moving user accounts from a BlackBerry Enterprise Server or BlackBerry® Professional Software to aBlackBerry Enterprise Server Express............................................................................................................... 38

8 Preparing to move user accounts..................................................................................................................... 39Create the manifest file.................................................................................................................................... 39Configure the source and destination instances of the BlackBerry Configuration Database........................... 39Configure how long the BlackBerry Enterprise Transporter tries to open a connection to the sourceBlackBerry Configuration Database and the destination BlackBerry Configuration Database......................... 40Configure the default settings that apply to all user accounts......................................................................... 41Configure the BlackBerry Enterprise Transporter to send notification email messages to user accounts....... 42

9 Selecting the user accounts to move to the destination BlackBerry Domain................................................... 43Search for and select user accounts to move................................................................................................... 43Import a file with email addresses.................................................................................................................... 43Select all user accounts that are associated with a source BlackBerry Enterprise Server................................ 44Add the information for a single user account................................................................................................. 44Configure the default settings that apply to specific user accounts................................................................. 45

10 Moving user accounts....................................................................................................................................... 47Verify the user account information................................................................................................................. 47Move user accounts.......................................................................................................................................... 47View the latest BlackBerry Enterprise Transporter log file............................................................................... 48

11 Running the BlackBerry Enterprise Transporter from the command prompt.................................................. 49Parameters for the BlackBerry Enterprise Transporter.................................................................................... 49Preview moving user accounts using the command prompt........................................................................... 50Move user accounts using the command prompt............................................................................................ 51

12 Return user accounts to the source BlackBerry Domain.................................................................................. 52

13 Troubleshooting................................................................................................................................................ 53Configuration errors and warnings................................................................................................................... 53

The BlackBerry Enterprise Transporter cannot connect to the BlackBerry Administration Service.......... 53Configuration file error.............................................................................................................................. 53XML Manifest Failed to Load..................................................................................................................... 53

Destination 5.0 server found but unable to find BUA installation............................................................. 54One or more user accounts do not have a Destination Server set............................................................ 54

Troubleshooting preview errors....................................................................................................................... 54ERROR: Destination contains servers older than 5.0................................................................................. 54Application error messages....................................................................................................................... 55User validation error messages................................................................................................................. 56User validation warning messages............................................................................................................ 59

Troubleshooting migration errors.................................................................................................................... 59User migration failed messages................................................................................................................. 60User migration completed with warning messages.................................................................................. 60User migration pending error messages................................................................................................... 61IT policy error messages............................................................................................................................ 61User account status: Skipped.................................................................................................................... 62User account status: MigrationSkippedDueToValidationFailure............................................................... 62

14 Port information for the BlackBerry Enterprise Server Resource Kit tools....................................................... 63Port information for tools that connect to the BlackBerry Configuration Database........................................ 63Port information for tools that connect to the BlackBerry Administration Service, BlackBerryAdministration API, and BlackBerry Web Services........................................................................................... 63Port information for BlackBerry Domain Search.............................................................................................. 63Port information for the BlackBerry System Log Monitoring and Reporting Tool............................................ 64Port information for the BlackBerry Message Receipt Confirmation Tool....................................................... 64

15 Glossary............................................................................................................................................................ 65

16 Provide feedback.............................................................................................................................................. 66

17 Legal notice....................................................................................................................................................... 67

BlackBerry Enterprise Transporter 1You can use the BlackBerry® Enterprise Transporter to move one or more user accounts from one BlackBerry Domainto a different BlackBerry Domain.

You can use the BlackBerry Enterprise Transporter when your organization upgrades the BlackBerry Enterprise Serverand you want to create a new BlackBerry Domain, or if you need to move user accounts between BlackBerry Domaininstances. For example, if you want to upgrade your organization's BlackBerry Enterprise Server from version 4.1 SP6to version 5.0, you can create a separate BlackBerry Domain version 5.0 and use the BlackBerry Enterprise Transporterto move user accounts to the new BlackBerry Configuration Database. You can also use the BlackBerry EnterpriseTransporter to move user accounts from a production BlackBerry Domain to a test BlackBerry Domain and back.

When you run the BlackBerry Enterprise Transporter, users do not need to delete BlackBerry device data or reactivatetheir devices, if the BlackBerry Enterprise Transporter supports the BlackBerry® Device Software version that theyare using. The destination BlackBerry Enterprise Server resends service books, and the devices can start receivingnew messages after the devices receive the service books. Synchronization of organizer data and calendar informationover the wireless network occurs after the migration process completes.

Note that the BlackBerry Enterprise Transporter does not move server settings to the destination BlackBerryEnterprise Server. Prior to using the BlackBerry Enterprise Transporter, evaluate the available migration options. Formore information on the available migration options, visit www.blackberry.com/go/serverdocs to read theBlackBerry Enterprise Server Upgrade Guide.

Related topicsSupported environments, 10Unsupported features and environments, 15

BlackBerry Enterprise Transporter modesLive mode

You can use live mode to move user accounts when the BlackBerry® Enterprise Server instances in both the destinationBlackBerry Domain and the source BlackBerry Domain are running. If you choose this mode, the BlackBerry EnterpriseServer instances in both BlackBerry Domain instances must use different SRP IDs.

In this mode, the BlackBerry Enterprise Server instances in the destination BlackBerry Domain must be running. Thismust occur so that the BlackBerry Enterprise Transporter can monitor the organizer data synchronization andcalendar synchronization processes and IT administration commands (such as Resend IT Policy or Switch Service)that the destination BlackBerry Enterprise Server instances send to the BlackBerry devices to complete the migrationprocess.

Bulk mode

You can use bulk mode to move all user accounts on a BlackBerry Enterprise Server. During the migration process,you must turn off the BlackBerry Enterprise Server instances in both the source BlackBerry Domain and the destinationBlackBerry Domain. In the destination BlackBerry Domain, however, you must turn on the BlackBerry AdministrationService. In an IBM® Lotus® Domino® environment, the IBM Lotus Domino services must be running.

Installation and Administration Guide BlackBerry Enterprise Transporter

4

In bulk mode, you select a BlackBerry Enterprise Server. Then, during the migration process, the BlackBerry EnterpriseTransporter searches the source BlackBerry Configuration Database for all user accounts that are associated withthe BlackBerry Enterprise Server, and moves them.

In a Microsoft® Exchange or Novell® GroupWise® messaging environment, you must configure the destinationBlackBerry Enterprise Server instances to use the same BlackBerry Enterprise Server instance names(ServerConfig.ServiceName) and SRP IDs that the source BlackBerry Enterprise Server instances use. In an IBM LotusDomino messaging environment, you must configure the destination BlackBerry Enterprise Server instances to usethe same SRP IDs that the source BlackBerry Enterprise Server instances use.

The BlackBerry Enterprise Transporter does not monitor IT administration commands.

Options for moving user accounts with the BlackBerryEnterprise Transporter

Option Description

one or more user accounts at a time If your organization's environment includes more than one BlackBerry®Domain instance, you can use this option if users move to a different areain your organization and you need to move the user accounts to a differentBlackBerry Domain. You can move these user accounts in live mode.

all user accounts on a BlackBerry®Enterprise Server

You can use this option to upgrade your organization's environment inphases to the latest version of the BlackBerry Enterprise Server. You canmove these user accounts in bulk mode.

Data that the migration process does not move

Data Description

user accounts that are notBlackBerry enabled

The BlackBerry® Enterprise Transporter does not move user accounts thatare not BlackBerry enabled.

administrative role assignment If you move user accounts from a BlackBerry® Enterprise Server version 5.0or later to a different BlackBerry Enterprise Server version 5.0 or later, themigration process does not move the administrative roles that are assignedto the user accounts. You can manually assign the administrative roles tothe user accounts after the migration process completes, or you can creategroups for user accounts and assign roles to the groups in the destinationBlackBerry Enterprise Server.

group data The migration process does not move group data. Instead, you can createa group in the destination BlackBerry Domain and specify it as the groupthat you want to assign user accounts to during the migration process.

Installation and Administration Guide Options for moving user accounts with the BlackBerry Enterprise Transporter

5

Data Description

software configuration data The migration process does not move software configuration data,including BlackBerry® MDS Runtime application data.

You can create a software configuration on the destination BlackBerryDomain and specify it as the software configuration that you want to assignto user accounts during the migration process.

IT policy data By default, the user accounts that you move to a destination BlackBerryDomain are assigned the Default IT policy after the migration processcompletes. Before you start the migration process, you can select the ITpolicies on the destination BlackBerry Enterprise Server that you want toapply to user accounts after the migration process completes. Alternatively,before a migration, you can assign an IT policy to a group in the destinationBlackBerry Enterprise Server and then move user accounts to the group.

Note: If you move user accounts to a destination BlackBerry EnterpriseServer 5.0 or later, there might be a delay before the destination BlackBerryEnterprise Server applies the selected IT policies or group-assigned ITpolicies to BlackBerry devices. During this delay, the Default IT policy isapplied to the devices.

BlackBerry MDS Integration Servicedata

The migration process does not move BlackBerry MDS Integration Servicedata. For more information about the BlackBerry MDS Integration Service,visit www.blackberry.com/go/serverdocs to read the BlackBerry EnterpriseServer Feature and Technical Overview for your organization's messagingenvironment.

Note that the BlackBerry MDS Integration Service has been deprecated asof BlackBerry Enterprise Server 5.0 SP3.

BlackBerry® Browser configurationsettings

The migration process does not move the BlackBerry Browser configurationsettings on the BlackBerry device that is associated with a user account.

synchronized public contacts anddatabases and additional privatecontact folders

The migration process does not move public contact folders and databasesthat you have not published globally on the destination BlackBerryAdministration Service. The BlackBerry Enterprise Transporter does notpublish public contact folders and databases.

In a Microsoft® Exchange environment, synchronized public contacts andadditional private contact folders can be moved only to a BlackBerryEnterprise Server that is version 5.0 SP1 or later.

Installation and Administration Guide Data that the migration process does not move

6

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

Validation that the BlackBerry Enterprise Transporterperforms

Global validationThe BlackBerry® Enterprise Transporter performs the following actions before it begins the migration process:• verifies that the BlackBerry Administration Service is installed in the destination BlackBerry Domain• if the BlackBerry Administration Service is installed, verifies that the BlackBerry Enterprise Server User

Administration Tool is installed on the computer that hosts the BlackBerry Enterprise Transporter• sends a test BlackBerry Administration Service command to verify that the BlackBerry Administration Service is

available and can respond

In an IBM® Lotus® Domino® environment, the BlackBerry Enterprise Transporter verifies whetherskipDominoBBSDReplication and skipDominoBBSDValidation are set to True in the EnterpriseTransporter.exe.configfile to determine how to validate. It then performs the following actions:• verifies that IBM® Lotus Notes® is installed on the computer that hosts the 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 BlackBerry profiles databases in both the source BlackBerryDomain and the destination BlackBerry Domain

User validationThe BlackBerry® Enterprise Transporter performs the following validation before it migrates a user account:• verifies that the user account is associated with a valid email address• verifies that the user account exists in the source BlackBerry Domain• verifies that the user account does not already exist in the destination BlackBerry Domain• checks whether it can preserve the user ID that is associated with a BlackBerry device• verifies that an IT policy can be applied to a BlackBerry device; however, this verification might not be possible

in one of the following scenarios:• BlackBerry device is running an unspecified version of the BlackBerry® Device Software• BlackBerry device is operating on BlackBerry Device Software version 4.0.2, and the ITPolicyKeyMapping

table does not exist• BlackBerry device is operating on BlackBerry Device Software version 4.3.0

In an IBM® Lotus® Domino® environment, the BlackBerry Enterprise Transporter performs the following additionalactions:• if SkipDominoBBSDReplication is set to True in the EnterpriseTransporter.exe.config file, checks whether the

user’s BlackBerry state database already exists on the destination BlackBerry Enterprise Server• verifies that the user’s source BlackBerry state database can be opened on the source BlackBerry Enterprise

Server• checks whether the user’s BlackBerry state database has been marked for deletion in the BlackBerry profiles

database on the destination BlackBerry Enterprise Server

Installation and Administration Guide Validation that the BlackBerry Enterprise Transporter performs

7

• checks whether a duplicate BlackBerry state database exists on the destination BlackBerry Enterprise Server

What's new in BlackBerry Enterprise Transporter 5.0 SP3

Feature Description

Encrypt information about databaseconnections

You can encrypt the information about database connections in theBlackBerry® Enterprise Transporter configuration file.

Configure the timeout period forcommands

You can configure how long the BlackBerry Enterprise Transporter waits forthe Microsoft® SQL Server® to process commands.

Configure the connection timeoutperiod

You can configure how long the BlackBerry Enterprise Transporter tries toopen a connection to the source BlackBerry Configuration Database and thedestination BlackBerry Configuration Database.

Installation and Administration Guide What's new in BlackBerry Enterprise Transporter 5.0 SP3

8

System requirements 2

System requirements: BlackBerry Enterprise TransporterNote: You can use the BlackBerry® Enterprise Transporter to move user accounts to a destination BlackBerry®Enterprise Server, but the BlackBerry Enterprise Transporter does not move server settings to the destinationBlackBerry Enterprise Server. Prior to using the BlackBerry Enterprise Transporter, evaluate the available migrationoptions. For more information on the available migration options, visit www.blackberry.com/go/serverdocs to readthe BlackBerry Enterprise Server Upgrade Guide.

Item Requirement

BlackBerry EnterpriseTransporter version

Use the latest available version of the BlackBerry Enterprise Transporter,regardless of the version of the source BlackBerry Enterprise Server anddestination BlackBerry Enterprise Server.

operating system Any of the following operating systems:• Windows® 7• Windows Server® 2008 R2• Windows Server 2008• Windows Vista®• Windows® XP Professional SP2• Windows Server 2000 SP4 Server or Advanced Server• Windows Server 2003 SP1 or later

Microsoft® .NET Framework Microsoft .NET Framework 2.0encryption algorithm Triple DES, AES, or both Triple DES and AES

You must configure the source BlackBerry Enterprise Server and the destinationBlackBerry Enterprise Server to use the same option for the encryption algorithm.For example, if you configure the source BlackBerry Enterprise Server to use 3DESand the destination BlackBerry Enterprise Server to use 3DES and AES, thisconfiguration is not supported for user migration. You must configure both thesource and the destination BlackBerry Enterprise Server to use the same optionfor the encryption algorithm (for example, configure both servers to use 3DESand AES).

BlackBerry Enterprise Server Before you use the BlackBerry Enterprise Transporter for the first time, you mustlog in to the BlackBerry Administration Service and verify that you can create auser account, assign a BlackBerry device to the user account, and activate thedevice.

Installation and Administration Guide System requirements

9

Item Requirement

permissions for the BlackBerryAdministration Service

In the BlackBerry Administration Service, you must create an administratoraccount that you can use to view BlackBerry Enterprise Server instances, andcreate and manage groups, user accounts, IT policies, and softwareconfigurations. These permissions are typically associated with a securityadministrator role or enterprise administrator role.

BlackBerry Enterprise ServerUser Administration Tool

BlackBerry Enterprise Transporter 5.0 SP1 and later use the BlackBerry®Administration API to assign configuration settings to user accounts when youmove the user accounts to BlackBerry Enterprise Server 5.0 SP1 or later. TheBlackBerry Administration API is installed with the BlackBerry AdministrationService. The BlackBerry Enterprise Server User Administration Tool is not requiredif the destination BlackBerry Enterprise Server is version 5.0 SP1 or later.

To move user accounts to BlackBerry Enterprise Server 5.0, you must install acompatible version of the BlackBerry Enterprise Server User AdministrationTool. The BlackBerry Enterprise Transporter uses the BlackBerry Enterprise ServerUser Administration Tool to assign default settings for groups, IT policies, andsoftware configurations to the user accounts that you want to move to thedestination BlackBerry Enterprise Server.

The BlackBerry Enterprise Server User Administration Tool is not required if thedestination BlackBerry Enterprise Server is version 4.0 or 4.1 (any service packrelease).

BlackBerry Web Services The BlackBerry Enterprise Transporter uses the BlackBerry® Web Services whenmoving user accounts to BlackBerry Enterprise Server 5.0 SP3 or later. TheBlackBerry Web Services are installed when you install BlackBerry EnterpriseServer 5.0 SP3 or later, so you do not need to download and install it separately.

BlackBerry Domain If the destination BlackBerry Domain includes BlackBerry Enterprise Server 5.0,all BlackBerry Enterprise Server instances in the BlackBerry Domain must beversion 5.0 or later.

screen resolution The BlackBerry Enterprise Transporter requires a minimum screen resolution of1024 x 768.

Installation considerations

Supported environments

Item Environment

BlackBerry® Enterprise Serverversions

For information about the supported versions of the source and destinationBlackBerry Enterprise Server, see the appropriate compatibility matrix:

Installation and Administration Guide Installation considerations

10

Item Environment

• BlackBerry Enterprise Transporter compatibility matrix for the BlackBerryEnterprise Server for Microsoft Exchange and the BlackBerry EnterpriseServer for IBM Lotus Domino

• BlackBerry Enterprise Transporter compatibility matrix for the BlackBerryEnterprise Server for Novell GroupWise

• BlackBerry Enterprise Transporter compatibility matrix for the BlackBerryEnterprise Server Express, BlackBerry Professional Software, and BlackBerryEnterprise Server Small Business Edition

Known issues might apply depending on the versions of the source BlackBerry®Enterprise Server and the destination BlackBerry Enterprise Server. For moreinformation, see the Premigration considerations chapter in the BlackBerryEnterprise Transporter Installation and Configuration Guide.

BlackBerry® Enterprise ServerExpress

The BlackBerry Enterprise Transporter does not support the use of bulk modewhen moving user accounts from a source BlackBerry Enterprise Server Expressor to a destination BlackBerry Enterprise Server Express.

database servers (source anddestination)

The BlackBerry Enterprise Transporter supports the following database servers:

• Microsoft® SQL Server® 2005 SP2 Enterprise, Professional, or Express Edition• Microsoft SQL Server 2005 SP3• Microsoft SQL Server 2005 Express Edition SP3• Microsoft SQL Server 2008 SP1• Microsoft SQL Server 2008 Express Edition SP1• Microsoft SQL Server 2008 SP2 (32-bit or 64-bit)• Microsoft SQL Server 2008 R2• Microsoft SQL Server 2008 R2 Express Edition (32-bit or 64-bit)

Microsoft® Exchangemessaging server

The BlackBerry Enterprise Transporter supports any version of MicrosoftExchange that the BlackBerry Enterprise Server supports.

IBM® Lotus® Domino®messaging server

The BlackBerry Enterprise Transporter supports any version of Lotus Domino thatthe BlackBerry Enterprise Server supports and that is version 6.5.4 or later.

Novell GroupWise messagingserver

The BlackBerry Enterprise Transporter supports any version of Novell GroupWisethat the BlackBerry Enterprise Server supports.

email application for users The BlackBerry Enterprise Transporter supports the following versions of IBM®Lotus Notes®:• Lotus Notes 7.0 (to support encrypted message display when the user.id file

is stored in BlackBerry® Desktop Manager 4.1)• Lotus Notes 8.0• Lotus Notes 8.5

BlackBerry® Device Software For more information about BlackBerry Device Software compatibility, see theBlackBerry Device Software compatibility chapter in the BlackBerry EnterpriseTransporter Installation and Configuration Guide.


11

Related topicsPremigration considerations, 23

BlackBerry Enterprise Transporter compatibility matrix for the BlackBerry EnterpriseServer for Microsoft Exchange and the BlackBerry Enterprise Server for IBM LotusDomino

The following table displays the migration paths that the BlackBerry® Enterprise Transporter supports.

Note: Based on the version and the type of the source BlackBerry® Enterprise Server and the destination BlackBerryEnterprise Server, there might be important conditions that you must be aware of. Read the premigrationconsiderations section of the BlackBerry Enterprise Transporter Installation and Administration Guide before you tryto move user accounts from a source BlackBerry Enterprise Server to a destination BlackBerry Enterprise Server.

Legend

Designation Abbreviation Description

Supported S The migration path has been tested and is supported for movingusers from the source server to the destination server, and formoving users back from the destination server to the source serverfor troubleshooting purposes only.

Back Out Only BO The migration path is supported for troubleshooting purposes only.Best Effort BE The migration path has not been tested and is not officially

supported.Not Supported NS The migration path is not supported due to compatibility issues.

Destination server

4.0 - 4.0.6 4.0.7 4.1 - 4.1.5 4.1.6 -4.1.7

5.0 5.0.1 5.0.2 5.0.3

Sour

ce s

erve

r 4.0 - 4.0.6 NS NS BE BE BE BE BE BE4.0.7 NS NS BE BE S S S S4.1 - 4.1.5 NS NS BE BE BE BE BE BE4.1.6 -4.1.7

NS NS BE BE S S S S

5.0 NS BO NS BO S S S S5.0.1 NS BO NS BO S S S S5.0.2 NS BO NS BO S S S S5.0.3 NS BO NS BO S S S S

Related topicsBlackBerry Enterprise Server compatibility, 23BlackBerry Device Software compatibility, 28


12

BlackBerry Enterprise Transporter compatibility matrix for the BlackBerry EnterpriseServer for Novell GroupWise


Note: Based on the version and the type of the source BlackBerry® Enterprise Server and the destination BlackBerryEnterprise Server, there might be important conditions that you must be aware of. Read the premigrationconsiderations section of the BlackBerry Enterprise Transporter Installation and Administration Guide before you tryto move user accounts from a source BlackBerry Enterprise Server to a destination BlackBerry Enterprise Server.

Legend





Destination server

4.0 - 4.0.6 4.0.7 4.1 - 4.1.4 4.1.6 - 4.1.7 5.0.1

Sour

ce s

erve

r 4.0 - 4.0.6 NS NS BE BE BE4.0.7 NS NS BE BE S4.1 - 4.1.4 NS NS BE BE BE4.1.6 - 4.1.7 NS NS BE BE S5.0.1 NS BO NS BO S

Related topicsBlackBerry Enterprise Server compatibility, 23BlackBerry Device Software compatibility, 28

BlackBerry Enterprise Transporter compatibility matrix for the BlackBerry EnterpriseServer Express, BlackBerry Professional Software, and BlackBerry Enterprise ServerSmall Business Edition


The BlackBerry Enterprise Transporter does not support bulk mode when moving user accounts from a BlackBerry®Enterprise Server Express to a destination BlackBerry® Enterprise Server. The BlackBerry Enterprise Transporter doesnot support bulk mode when moving user accounts to a BlackBerry Enterprise Server Express.


13

Note: Based on the version and the type of the source server and the destination server, there might be importantconditions that you must be aware of. Read the premigration considerations section of the BlackBerry EnterpriseTransporter Installation and Administration Guide before you try to move user accounts from a source server to adestination server.

Legend





Destination server

BlackBerryEnterpriseServer SmallBusinessEdition 4.0.7and 4.1.7

BlackBerryProfessionalSoftware4.1.4

BlackBerryEnterpriseServerExpress5.0.1

BlackBerryEnterpriseServerExpress5.0.2 andlater

BlackBerryEnterpriseServer 4.0 -5.0.1

BlackBerryEnterpriseServer 5.0.2and later

Sour

ce s

erve

r BlackBerryEnterpriseServer SmallBusinessEdition 4.0.7and 4.1.7

NS NS BE S NS* NS*

BlackBerryProfessionalSoftware4.1.4

NS NS BE S NS NS

BlackBerryEnterpriseServerExpress5.0.1

NS NS BE BE BE BE

BlackBerryEnterpriseServer

BO BO BE BE BE S


14

Destination server

Express5.0.2 andlaterBlackBerryEnterpriseServer 4.0 -5.0.1

NS NS NS NS Seeappropriatematrix

Seeappropriatematrix

BlackBerryEnterpriseServer 5.0.2and later

NS NS NS BO Seeappropriatematrix

Seeappropriatematrix

*To move user accounts from the source server, you must install an upgrade key to upgrade the source server to theBlackBerry Enterprise Server.

Related topicsBlackBerry Enterprise Server compatibility, 23BlackBerry Device Software compatibility, 28Moving user accounts from a BlackBerry Enterprise Server Express to a BlackBerry Enterprise Server, 37Moving user accounts from a BlackBerry Enterprise Server or BlackBerry® Professional Software to a BlackBerry Enterprise Server Express, 38

Unsupported features and environmentsFor more information about BlackBerry® Enterprise Transporter compatibility, see the supported environmentssection of the BlackBerry Enterprise Transporter Installation and Administration Guide.

Item Environment

messaging server environment The BlackBerry Enterprise Transporter does not support migration from onemessaging server environment to a different environment (for example,migration from IBM® Lotus® Domino® to Microsoft® Exchange).

BlackBerry® Device Software The BlackBerry Enterprise Transporter does not support BlackBerry DeviceSoftware versions that are earlier than version 4.0; version 4.3.0 is supportedwith conditions.

IBM® DB2® UDB The BlackBerry Enterprise Transporter does not support DB2 UDB.

Related topicsSupported environments, 10BlackBerry Enterprise Transporter compatibility matrix for the BlackBerry Enterprise Server for Microsoft Exchange and the BlackBerryEnterprise Server for IBM Lotus Domino, 12BlackBerry Enterprise Transporter compatibility matrix for the BlackBerry Enterprise Server for Novell GroupWise, 13BlackBerry Enterprise Transporter compatibility matrix for the BlackBerry Enterprise Server Express, BlackBerry Professional Software, andBlackBerry Enterprise Server Small Business Edition, 13Troubleshooting preview errors, 54Troubleshooting migration errors, 59Premigration considerations, 23


15

Required permissions in an IBM Lotus Domino environmentTo run the BlackBerry® Enterprise Transporter in an IBM® Lotus® Domino® environment, you require the samepermissions in both the source BlackBerry Domain and the destination BlackBerry Domain that you require as anadministrator of the BlackBerry® Enterprise Server for IBM® Lotus® Domino®.

For more information, visit www.blackberry.com/go/serverdocs to read the BlackBerry Enterprise Server InstallationGuide and the BlackBerry Enterprise Server Administration Guide.

Permission Description Resource

notes.ini file You must configure read and write permissions in thenotes.ini file.

BlackBerry EnterpriseServer Installation Guide• Section: System

requirements:BlackBerry EnterpriseServer

IBM® Lotus Notes® user.idfile

The BlackBerry Enterprise Transporter uses the IBMLotus Notes user ID of the administrator to perform IBMLotus Notes operations in the same way that theBlackBerry® Enterprise Server uses a server ID toperform IBM Lotus Notes operations.

The BlackBerry Enterprise Transporter prompts for theuser ID and password before it runs a migrationpreview.

The IBM Lotus Notes user ID must be a member of theLocalDomainServers group. The BlackBerry EnterpriseTransporter might not be able to use the user ID if theuser ID file name (username.id), stored in the notes.inifile, contains accented characters (for example, ã).

—

Replicating IBM Lotus Domino databasesBefore you begin the migration process, you must verify the setting for skipDominoBBSDReplication in theconfiguration file for the BlackBerry® Enterprise Transporter. The file name is EntepriseTransporter.exe.config.

You must then 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 Transporter. The BlackBerry Enterprise Transporter performs a databasereplication before it migrates user accounts.


16

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

• If skipDominoBBSDReplication is set to True, you must replicate the BlackBerry state database for each useraccount in the destination BlackBerry Domain before you begin the migration process. If you migrate a useraccount without replicating the user’s BlackBerry state database in the destination BlackBerry Domain, allinformation for the user account is lost, and you must remove the user account from the BlackBerry® EnterpriseServer, delete all data on the BlackBerry device that is associated with the user account, add the user accountagain to the BlackBerry Enterprise Server, and reactivate the BlackBerry device.


17

Installing or upgrading the BlackBerryEnterprise Transporter

3

Install or upgrade the BlackBerry Enterprise TransporterBefore you begin: Verify that the computer you want to use has access to the database servers that host the sourceBlackBerry® Configuration Database and the target BlackBerry Configuration Database.

1. Create a folder to store the BlackBerry Enterprise Transporter files.

2. In a browser, visit na.blackberry.com/eng/support/server_resourcekit.jsp.

3. Download the BlackBerry Enterprise Transporter installation package.

4. Extract the contents of the installation package to the folder that you created.

5. Double-click the brk-bbenterprisetransporter.msi file.

6. Complete the instructions on the screen.

Installation and Administration Guide Installing or upgrading the BlackBerry Enterprise Transporter

18

http://na.blackberry.com/eng/support/server_resourcekit.jsp

Configuring the BlackBerry EnterpriseTransporter

4

Configure how long the BlackBerry Enterprise Transporterwaits for the Microsoft SQL Server to process commandsWhen you try to move user accounts to a destination BlackBerry® Enterprise Server, the BlackBerry EnterpriseTransporter sends commands to the Microsoft® SQL Server® to process. By default, the BlackBerry EnterpriseTransporter waits for a timeout period of 30 seconds for the Microsoft SQL Server to process a command and returna response to the BlackBerry Enterprise Transporter. If the timeout period expires and the BlackBerry EnterpriseTransporter has not received a response from the Microsoft SQL Server, the BlackBerry Enterprise Transporter stopswaiting for a response and considers the command to be failed.

You can configure how long you want the BlackBerry Enterprise Transporter to wait for the Microsoft SQL Server toprocess a command and return a response. You can change the timeout period to any value between 30 and 300seconds.

1. On the computer that hosts the BlackBerry Enterprise Transporter, navigate to <drive>:\Program Files\ResearchIn Motion\BlackBerry Enterprise Server Resource Kit\BlackBerry Enterprise Transporter.

2. In a text editor, open the EnterpriseTransporter.exe.config file.

3. In the <appSettings> section, type the following information: <add key="sqlCommandTimeout"value="<timeout_value>"/>, where <timeout_value> is the number of seconds that you want the BlackBerryEnterprise Transporter to wait for the Microsoft SQL Server to process commands and return responses.

4. Save and close the EnterpriseTransporter.exe.config file.

Encrypt the information about database connections in theBlackBerry Enterprise Transporter configuration fileWhen you configure the source BlackBerry® Configuration Database and the destination BlackBerry ConfigurationDatabase in the BlackBerry Enterprise Transporter, information about the database connections is stored in theBlackBerry Enterprise Transporter configuration file (EnterpriseTransporter.exe.config). If you select Microsoft® SQLServer® Authentication for a BlackBerry Configuration Database, the password information is stored in theconfiguration file in plain text. You can modify the configuration file to encrypt the information that it contains aboutdatabase connections.Note: If you encrypt the information about database connections in the BlackBerry Enterprise Transporterconfiguration file and you copy or move the configuration file to a different computer, you cannot decrypt theinformation about database connections on the new computer.



Installation and Administration Guide Configuring the BlackBerry Enterprise Transporter

19

3. In the <appSettings> section, type the following: <add key="encryptConnectionStrings" value="true"/>.


After you finish: Restart the BlackBerry Enterprise Transporter.

Installation and Administration Guide Encrypt the information about database connections in the BlackBerry Enterprise Transporterconfiguration file

20

Preparing the source BlackBerry Domain for themigration process

5

To view documentation for administrators of the BlackBerry® Enterprise Server, visit www.blackberry.com/go/serverdocs.

Task Resource

Back up the BlackBerry Configuration Database. BlackBerry Enterprise ServerUpgrade Guide

Create a list of the software configurations and applications that you wantto duplicate in the destination BlackBerry Domain.

BlackBerry Enterprise ServerAdministration Guide

Create a list of the IT policies, policy rules, and default settings that youwant to duplicate in the destination BlackBerry Domain.


Create a list of the SRP information and CAL keys that you want to duplicatein the destination BlackBerry Domain.


If you want the BlackBerry Enterprise Transporter to use the user importlist file, export the email addresses for the user accounts that you want tomigrate to a flat text file that is CR-delimited. Verify that the file uses thefollowing format:

<emailaddress1><emailaddress2><emailaddress3>

—

For BlackBerry Enterprise Server version 5.0 only, create a list of roles thatyou assigned to administrator accounts.


If you set up replication for the BlackBerry Configuration Database, stop thereplication process.

—

Notify users that applications on the BlackBerry device that use a dataconnection through the BlackBerry MDS Connection Service mightexperience a service interruption until the user account is moved to andactivated on the destination BlackBerry Enterprise Server.

—

Installation and Administration Guide Preparing the source BlackBerry Domain for the migration process

21

http://www.blackberry.com/support/serverdocs/index.shtml


Preparing the destination BlackBerry Domainfor the migration process

6

To view documentation for administrators of the BlackBerry® Enterprise Server, visit www.blackberry.com/go/serverdocs.

Task Resource

If you plan to move user mailboxes to the destination BlackBerry Domain,as a best practice, consider moving the user mailboxes before you migrateuser accounts to the destination BlackBerry Domain.

—

Create a BlackBerry Configuration Database, and install the BlackBerryEnterprise Server instances. During the installation process, if theBlackBerry Enterprise Server instances use the same SRP information as theBlackBerry Enterprise Server instances in the source BlackBerry Domain, donot verify the SRP credentials and do not start any BlackBerry EnterpriseServer services except for the BlackBerry Administration Service services.

BlackBerry Enterprise ServerInstallation Guide

In the BlackBerry Administration Service, create the groups, IT policies,roles, and software configurations that you want to duplicate from thesource BlackBerry Domain.


Back up the BlackBerry Configuration Database. BlackBerry Enterprise ServerUpgrade Guide

In an IBM® Lotus® Domino® environment, you can copy the BlackBerry statedatabases and BlackBerry profiles databases from the source BlackBerryEnterprise Server instances to the destination BlackBerry Enterprise Serverinstances. You can perform this task if you do not want the BlackBerryEnterprise Transporter to replicate the databases during the migrationprocess.

IBM Lotus Domino documentation

If you plan to use the BlackBerry Enterprise Transporter in bulk mode, in aMicrosoft® Exchange or Novell® GroupWise® messaging environment, youmust configure the destination BlackBerry Enterprise Server instances touse the same BlackBerry Enterprise Server instance names(ServerConfig.ServiceName) and SRP IDs that the source BlackBerryEnterprise Server instances use. In an IBM Lotus Domino messagingenvironment, you must configure the destination BlackBerry EnterpriseServer instances to use the same SRP IDs that the source BlackBerryEnterprise Server instances use.

—

Notify users that applications on the BlackBerry device that use a dataconnection through the BlackBerry MDS Connection Service mightexperience a service interruption until the user account is moved to andactivated on the destination BlackBerry Enterprise Server.

—

Installation and Administration Guide Preparing the destination BlackBerry Domain for the migration process

22



Premigration considerations 7

BlackBerry Enterprise Server compatibility

Moving user accounts to a destination BlackBerry Enterprise Server version5.0 or laterIf the version of the source BlackBerry® Enterprise Server for Microsoft® Exchange is earlier than version 5.0, considerthe following information:

Consideration Description

The BlackBerry Enterprise Transporter might requiremore time than expected to move user accounts to thedestination BlackBerry Enterprise Server for MicrosoftExchange.

In specific circumstances, if the version of the sourceBlackBerry Enterprise Server for Microsoft Exchange isearlier than version 4.1 SP6 MR5, the BlackBerryEnterprise Transporter might require more time thanexpected to move user accounts to the destinationBlackBerry Domain. Before you try to move the useraccounts, upgrade the source BlackBerry EnterpriseServer for Microsoft Exchange to version 4.1 SP6 MR5or later.

Moving user accounts to a destination BlackBerry Enterprise Server version4.1 SP4 to 4.1 SP7If you move user accounts to a destination BlackBerry® Enterprise Server that is version 4.1 SP4 to 4.1 SP7, considerthe following information:


Issues might occur if the user ID of a user account alreadyexists on the destination BlackBerry Enterprise Server.

If the user ID of a user account on the source BlackBerryEnterprise Server is the same as a user ID on thedestination BlackBerry Enterprise Server, the user'sBlackBerry device might not work as expected after youmove the user account to the destination BlackBerryEnterprise Server. Before you move the user account,delete the user account from the source BlackBerryEnterprise Server, add it to the BlackBerry EnterpriseServer again, and activate the BlackBerry device.

If the source BlackBerry® Enterprise Server is version 5.0 or later, consider the following information:

Installation and Administration Guide Premigration considerations

23


Duplicate contact list entries might appear onBlackBerry devices.

If organizer data synchronization is turned on for useraccounts and you try to move the user accounts to adestination BlackBerry Enterprise Server for IBM LotusDomino, duplicate contact list entries might appear onBlackBerry devices. Permanently delete the data on theBlackBerry devices and activate the BlackBerry devicesagain.

If the version of the source BlackBerry® Enterprise Server for Microsoft® Exchange is earlier than version 5.0, considerthe following information:




If your organization's environment uses the BlackBerry® Enterprise Server for Novell® GroupWise®, consider thefollowing information:


The BlackBerry Enterprise Transporter does not supportthe version of the destination BlackBerry EnterpriseServer.

Upgrade the destination BlackBerry Enterprise Server toa version that the BlackBerry Enterprise Transportersupports.

Moving user accounts to a destination BlackBerry Enterprise Server version4.1 to 4.1 SP3If you move user accounts to a destination BlackBerry® Enterprise Server that is version 4.1 to 4.1 SP3, consider thefollowing information:




Installation and Administration Guide BlackBerry Enterprise Server compatibility

24















25

Moving user accounts to a destination BlackBerry Enterprise Server version4.0 SP7If you move user accounts to a destination BlackBerry® Enterprise Server that is version 4.0 SP7, consider the followinginformation:











In specific circumstances, if the version of the sourceBlackBerry Enterprise Server for Microsoft Exchange isearlier than version 4.1 SP6 MR5, the BlackBerryEnterprise Transporter might require more time thanexpected to move user accounts to the destinationBlackBerry Domain. Before you try to move the user


26


accounts, upgrade the source BlackBerry EnterpriseServer for Microsoft Exchange to version 4.1 SP6 MR5or later.














If organizer data synchronization is turned on for useraccounts and you try to move the user accounts to adestination BlackBerry Enterprise Server for IBM LotusDomino, duplicate contact list entries might appear on


27


BlackBerry devices. Permanently delete the data on theBlackBerry devices and activate the BlackBerry devicesagain.





BlackBerry Device Software compatibility

Moving user accounts to a destination BlackBerry Enterprise Server version5.0 or laterIf you move user accounts to a destination BlackBerry® Enterprise Server that is version 5.0 or later, consider thefollowing information:


The BlackBerry Enterprise Transporter does not supporta destination BlackBerry Domain that contains bothBlackBerry Enterprise Server version 5.0 or later and aversion of the BlackBerry Enterprise Server that is earlierthan version 5.0.

Upgrade all BlackBerry Enterprise Server instances inthe destination BlackBerry Domain to version 5.0 orlater.

If BlackBerry devices use BlackBerry® Device Software version 4.3.0, consider the following information:


IT policies might not be applied to BlackBerry devices. After you move user accounts to the destinationBlackBerry Enterprise Server, the IT policies on thedestination BlackBerry Enterprise Server might not beapplied to BlackBerry devices. Before you move the user

Installation and Administration Guide BlackBerry Device Software compatibility

28


accounts, update the BlackBerry Device Software onBlackBerry devices to version 4.5.0 or later. You can alsorun the BlackBerry Enterprise Transporter with theIgnore Warnings check box selected, and activate theuser accounts again on the destination BlackBerryEnterprise Server if the IT policy is not applied to theBlackBerry devices. You are not required to permanentlydelete the data on the BlackBerry devices before youactivate the user accounts again.

If BlackBerry devices use BlackBerry Device Software version 4.0.2 to 4.2.2, and your organization's environmentuses the BlackBerry® Enterprise Server for Novell® GroupWise®, consider the following information:




If BlackBerry devices use BlackBerry Device Software version 4.0.0 to 4.0.1, consider the following information:


IT policies might not be applied to BlackBerry devices. If the destination BlackBerry Configuration Databasedoes not contain the optional ITPolicyKeyMappingtable, the IT policies on the destination BlackBerryEnterprise Server are not applied to BlackBerry devicesafter you move the user accounts. Before you move theuser accounts, update the BlackBerry Device Softwareon BlackBerry devices to version 4.0.2 or later, or addthe ITPolicyKeyMapping table to the destinationBlackBerry Configuration Database. You can also run theBlackBerry Enterprise Transporter with the IgnoreWarnings check box selected, and activate the useraccounts again on the destination BlackBerry EnterpriseServer if the IT policy is not applied to the BlackBerrydevices. You are not required to permanently delete thedata on the BlackBerry devices before you activate theuser accounts again.


29

Moving user accounts to a destination BlackBerry Enterprise Server version4.1 SP4 to 4.1 SP7If you move user accounts to a destination BlackBerry® Enterprise Server that is version 4.1 SP4 to 4.1 SP7, considerthe following information:




If BlackBerry devices use BlackBerry® Device Software version 4.5.0 or later or version 5.0 or later, and yourorganization's environment uses the BlackBerry® Enterprise Server for IBM® Lotus® Domino®, consider the followinginformation:




If BlackBerry devices use BlackBerry Device Software version 4.3.0, consider the following information:


IT policies might not be applied to BlackBerry devices. After you move user accounts to the destinationBlackBerry Enterprise Server, the IT policies on thedestination BlackBerry Enterprise Server might not beapplied to BlackBerry devices. Before you move the useraccounts, update the BlackBerry Device Software onBlackBerry devices to version 4.5.0 or later. You can alsorun the BlackBerry Enterprise Transporter with theIgnore Warnings check box selected, and activate theuser accounts again on the destination BlackBerry


30


Enterprise Server if the IT policy is not applied to theBlackBerry devices. You are not required to permanentlydelete the data on the BlackBerry devices before youactivate the user accounts again.










31












IT policies might not be applied to BlackBerry devices. After you move user accounts to the destinationBlackBerry Enterprise Server, the IT policies on thedestination BlackBerry Enterprise Server might not beapplied to BlackBerry devices. Before you move the useraccounts, update the BlackBerry Device Software onBlackBerry devices to version 4.5.0 or later. You can alsorun the BlackBerry Enterprise Transporter with theIgnore Warnings check box selected, and activate theuser accounts again on the destination BlackBerryEnterprise Server if the IT policy is not applied to the


32


BlackBerry devices. You are not required to permanentlydelete the data on the BlackBerry devices before youactivate the user accounts again.




Moving user accounts to a destination BlackBerry Enterprise Server version4.0 SP7If you move user accounts to a destination BlackBerry® Enterprise Server that is version 4.0 SP7, consider the followinginformation:



If the user ID of a user account on the source BlackBerryEnterprise Server is the same as a user ID on thedestination BlackBerry Enterprise Server, the user'sBlackBerry device might not work as expected after youmove the user account to the destination BlackBerryEnterprise Server. Before you move the user account,


33


delete the user account from the source BlackBerryEnterprise Server, add it to the BlackBerry EnterpriseServer again, and activate the BlackBerry device.







IT policies might not be applied to BlackBerry devices. After you move user accounts to the destinationBlackBerry Enterprise Server, the IT policies on thedestination BlackBerry Enterprise Server might not beapplied to BlackBerry devices. Before you move the useraccounts, update the BlackBerry Device Software onBlackBerry devices to version 4.5.0 or later. You can alsorun the BlackBerry Enterprise Transporter with theIgnore Warnings check box selected, and activate theuser accounts again on the destination BlackBerryEnterprise Server if the IT policy is not applied to theBlackBerry devices. You are not required to permanentlydelete the data on the BlackBerry devices before youactivate the user accounts again.



IT policies might not be applied to BlackBerry devices. If the destination BlackBerry Configuration Databasedoes not contain the optional ITPolicyKeyMappingtable, the IT policies on the destination BlackBerryEnterprise Server are not applied to BlackBerry devices


34


after you move the user accounts. Before you move theuser accounts, update the BlackBerry Device Softwareon BlackBerry devices to version 4.0.2 or later, or addthe ITPolicyKeyMapping table to the destinationBlackBerry Configuration Database. You can also run theBlackBerry Enterprise Transporter with the IgnoreWarnings check box selected, and activate the useraccounts again on the destination BlackBerry EnterpriseServer if the IT policy is not applied to the BlackBerrydevices. You are not required to permanently delete thedata on the BlackBerry devices before you activate theuser accounts again.










If the user ID of a user account on the source BlackBerryEnterprise Server is the same as a user ID on thedestination BlackBerry Enterprise Server, the user'sBlackBerry device might not work as expected after youmove the user account to the destination BlackBerryEnterprise Server. Before you move the user account,


35


delete the user account from the source BlackBerryEnterprise Server, add it to the BlackBerry EnterpriseServer again, and activate the BlackBerry device.







IT policies might not be applied to BlackBerry devices. After you move user accounts to the destinationBlackBerry Enterprise Server, the IT policies on thedestination BlackBerry Enterprise Server might not beapplied to BlackBerry devices. Before you move the useraccounts, update the BlackBerry Device Software onBlackBerry devices to version 4.5.0 or later. You can alsorun the BlackBerry Enterprise Transporter with theIgnore Warnings check box selected, and activate theuser accounts again on the destination BlackBerryEnterprise Server if the IT policy is not applied to theBlackBerry devices. You are not required to permanentlydelete the data on the BlackBerry devices before youactivate the user accounts again.



IT policies might not be applied to BlackBerry devices. If the destination BlackBerry Configuration Databasedoes not contain the optional ITPolicyKeyMappingtable, the IT policies on the destination BlackBerryEnterprise Server are not applied to BlackBerry devices


36


after you move the user accounts. Before you move theuser accounts, update the BlackBerry Device Softwareon BlackBerry devices to version 4.0.2 or later, or addthe ITPolicyKeyMapping table to the destinationBlackBerry Configuration Database. You can also run theBlackBerry Enterprise Transporter with the IgnoreWarnings check box selected, and activate the useraccounts again on the destination BlackBerry EnterpriseServer if the IT policy is not applied to the BlackBerrydevices. You are not required to permanently delete thedata on the BlackBerry devices before you activate theuser accounts again.

Moving user accounts from a BlackBerry Enterprise ServerExpress to a BlackBerry Enterprise Server


The BlackBerry® Enterprise Transporter does notsupport bulk mode when moving user accounts from aBlackBerry® Enterprise Server Express to a destinationBlackBerry Enterprise Server.

The BlackBerry Enterprise Transporter does not supportthe use of bulk mode when moving user accounts froma source BlackBerry Enterprise Server Express to adestination BlackBerry® Enterprise Server.

User accounts with BlackBerry devices that have beenactivated using the BlackBerry® Internet Service cannotbe moved to a destination BlackBerry Enterprise Server.

If a user account is associated with a BlackBerry devicethat was provisioned using the BlackBerry InternetService, you cannot move the user account from thesource BlackBerry Enterprise Server Express to thedestination BlackBerry Enterprise Server. TheBlackBerry Enterprise Server does not supportBlackBerry devices that are provisioned using theBlackBerry Internet Service.

Installation and Administration Guide Moving user accounts from a BlackBerry Enterprise Server Express to a BlackBerry Enterprise Server

37

Moving user accounts from a BlackBerry Enterprise Serveror BlackBerry® Professional Software to a BlackBerryEnterprise Server Express


The BlackBerry® Enterprise Transporter does notsupport bulk mode when moving user accounts from aBlackBerry® Enterprise Server or BlackBerry®Professional Software to a BlackBerry® EnterpriseServer Express.

The BlackBerry Enterprise Transporter does not supportthe use of bulk mode when moving user accounts froma source BlackBerry Enterprise Server or BlackBerry®Professional Software to a destination BlackBerryEnterprise Server Express.

By default, the BlackBerry Enterprise Transportercannot connect to the BlackBerry AdministrationService of a BlackBerry Enterprise Server Express. As aresult, the BlackBerry Enterprise Transporter can moveuser accounts, but you cannot assign IT policies orsoftware configurations to the user accounts when theyare moved, and you cannot assign the user accounts togroups when they are moved.

The BlackBerry Enterprise Transporter tries to connectto the BlackBerry Administration Service of thedestination server using port 443, the default portconnection for the BlackBerry Administration Service ofthe BlackBerry Enterprise Server. The BlackBerryAdministration Service of the BlackBerry EnterpriseServer Express uses port 3443 by default.

If you want to move user accounts to a destinationBlackBerry Enterprise Server Express and assign ITpolicies, software configurations, and groups to the useraccounts, you must add the following text to theappSettings section of theEnterpriseTransporter.exe.config file: <addkey="basUrl"value="<BlackBerry_Administration_Server_URL>:<BlackBerry_Administration_Service_port>"/>

Do not specify http or https for the BlackBerryAdministration Service web address (for example, <addkey="basUrl" value="bas.test.org.net:3443"/>).

Installation and Administration Guide Moving user accounts from a BlackBerry Enterprise Server or BlackBerry® Professional Software to aBlackBerry Enterprise Server Express

38

Preparing to move user accounts 8

Create the manifest fileThe manifest file contains information about the BlackBerry® Domain instances, default settings, and email addressesthat the BlackBerry Enterprise Transporter requires to run the migration process.

1. In the BlackBerry Enterprise Transporter, in the Step 1: User Manifest section, click New.

2. Type a file name.

3. Click Save.

After you finish: To use bulk mode, select the Bulk Server Mode check box.

Configure the source and destination instances of theBlackBerry Configuration DatabaseThe BlackBerry® Enterprise Transporter requires the names of the database servers and the names of the BlackBerryConfiguration Database instances. The BlackBerry Enterprise Transporter might also require database credentials sothat it can access the source and destination BlackBerry Configuration Database instances during the migrationprocess. To configure the BlackBerry Enterprise Transporter with the database information, you create a label forthe source BlackBerry Configuration Database and a label for the destination BlackBerry Configuration Database.

Before you begin: Create or open a manifest file.

1. In the BlackBerry Enterprise Transporter, in the Step 2: BlackBerry Databases section, in the Source Domainsection, click Configure.

2. In the Label drop-down list, perform one of the following actions:• To choose an existing source BlackBerry Configuration Database, click the name of the label that contains

the database information.• To configure the source BlackBerry Configuration Database information for the first time, click <new>.

3. In the Edit/New section, in the Label field, type a label for the source BlackBerry Configuration Database.

4. In the SQL Server field, type the FQDN or IP address of the Microsoft® SQL Server® that hosts the sourceBlackBerry Configuration Database.

5. In the Authentication drop-down list, perform one of the following actions:• To use database authentication to access the source BlackBerry Configuration Database, click SQL Server

Authentication. In the User Name and Password fields, type the login information for the databaseadministrator account that you want the BlackBerry Enterprise Transporter to use to access the sourceBlackBerry Configuration Database.

• To use Windows® authentication to access the source BlackBerry Configuration Database using the logininformation of the current database administrator account, click Windows NT Authentication (Current User).

Installation and Administration Guide Preparing to move user accounts

39

• To use Windows authentication to access the source BlackBerry Configuration Database using the logininformation of a different database administrator account, click Windows NT Authentication (SpecifyUser). In the User Name and Password fields, type the login information for the database administratoraccount that you want the BlackBerry Enterprise Transporter to use to access the source BlackBerryConfiguration Database. The domain of the specified administrator account must trust the current domainthat the BlackBerry Enterprise Transporter is executed from.

If you click Windows NT Authentication (Specify User), the Authentication drop-down list changes to WindowsNT Authentication (Current User) when you open the Configure Database window again.

6. In the Database field, type the name of the source BlackBerry Configuration Database (for example, BESMgmt).

7. Click Test Connection.

8. Click OK.

9. In the Step 2: BlackBerry Databases section, in the Destination Domain section, click Configure.

10. To configure the destination BlackBerry Configuration Database, repeat steps 2 to 8.

Configure how long the BlackBerry Enterprise Transportertries to open a connection to the source BlackBerryConfiguration Database and the destination BlackBerryConfiguration DatabaseWhen you try to move user accounts, the BlackBerry® Enterprise Transporter tries to open a connection to theMicrosoft® SQL Server® that is used by the source BlackBerry® Enterprise Server and the Microsoft SQL Server thatis used by the destination BlackBerry Enterprise Server. By default, the BlackBerry Enterprise Transporter tries toopen a connection to a Microsoft SQL Server for a timeout period of 15 seconds, the default value for establishingMicrosoft SQL connections. If the timeout period expires and a connection is not established, the BlackBerryEnterprise Transporter stops trying to connect to the Microsoft SQL Server.

You can configure how long you want the BlackBerry Enterprise Transporter to try to open a connection to a MicrosoftSQL Server.

Before you begin: Create the manifest file and configure the source and destination instances of the BlackBerryConfiguration Database. You must configure the source and destination instances of the BlackBerry ConfigurationDatabase so that you can modify the connection information for the databases in the BlackBerry EnterpriseTransporter configuration file.



3. In the <connectionStrings> section, locate the connection strings for the source BlackBerry ConfigurationDatabase and the destination BlackBerry Configuration Database.

Installation and Administration Guide Configure how long the BlackBerry Enterprise Transporter tries to open a connection to the sourceBlackBerry Configuration Database and the destination BlackBerry Configuration Database

40

4. At the end of each connection string, after Password=<password> for connections using SQL authentication orafter Integrated Security=<value> for connections using NT authentication, type the followinginformation: ;Connection Timeout=<timeout_value>, where <timeout_value> is a value in seconds.For example:

<add name="Label 1" providerName="System.Data.SqlClient" connectionString="Data Source=Computer1;Initial Catalog=Database1;User Id=User1;Password=Password1;Connection Timeout=50" />


Related topicsCreate the manifest file, 39Configure the source and destination instances of the BlackBerry Configuration Database, 39

Configure the default settings that apply to all useraccountsBefore you select the user accounts that you want to move, you can configure the default settings for the destinationBlackBerry® Enterprise Server, group, IT policy, and software configuration that you want to apply to all user accountsthat you move to the destination BlackBerry Domain. Alternatively, you can select the user accounts that you wantto move and then apply different default settings to specific user accounts.

Before you begin:• In the destination BlackBerry Domain, create the group, IT policy, and software configuration that you want to

apply to the user accounts that you want to move to the destination BlackBerry Domain.• Create or select labels for the source BlackBerry Configuration Database and the destination BlackBerry

Configuration Database.

1. In the BlackBerry Enterprise Transporter, in the Step 3: Manifest Configuration section, in the Summary section,click Details.

2. In the Default Destination Assignments section, in the drop-down lists, click the BlackBerry Enterprise Server,group, IT policy, and software configuration that you want to apply to the user accounts.

3. Select the Use current defaults for all new entries check box.

4. Click Done.

To apply different default settings to specific user accounts that you want to move, clear the Use current defaultsfor all new entries check box and see the Configure the default settings that are applied to specific user accountstopic.

Using the BlackBerry Enterprise Transporter, you can apply software configurations and IT policies directly to useraccounts. You can also assign user accounts to groups that are associated with existing software configurations andIT policies. The BlackBerry Administration Service uses preconfigured rules that give priority to user-assigned softwareconfigurations and IT policies over the software configurations and IT policies that you assign to groups. If you want

Installation and Administration Guide Configure the default settings that apply to all user accounts

41

the group-assigned software configurations and IT policies to take precedence, remove the user-assigned softwareconfigurations and IT policies from the user accounts. For more information about reconciliation rules, see theBlackBerry Enterprise Server Administration Guide.

Note: If you move user accounts to a destination BlackBerry Enterprise Server 5.0 or later, there might be a delaybefore the destination BlackBerry Enterprise Server applies the selected IT policy or group-assigned IT policies toBlackBerry devices. During this delay, the Default IT policy is applied to the devices.

Related topicsConfigure the default settings that apply to specific user accounts, 45

Configure the BlackBerry Enterprise Transporter to sendnotification email messages to user accountsYou can configure the BlackBerry® Enterprise Transporter to send a notification message to user accounts after theBlackBerry Enterprise Transporter moves the user accounts to a destination BlackBerry® Enterprise Server. Youcannot send a notification message to user accounts when you use the BlackBerry Enterprise Transporter in bulkmode.

1. On the Config menu, click Email Configuration.

2. In the Email option section, select the Enable check box.

3. In the SMTP Server Configuration section, type the information for the host SMTP server.

4. In the Email section, type the information for the notification message.

5. Click OK.

After you finish: To turn off notification messages, clear the Enable check box.

Installation and Administration Guide Configure the BlackBerry Enterprise Transporter to send notification email messages to useraccounts

42

Selecting the user accounts to move to thedestination BlackBerry Domain

9

You can select the user accounts that you want to move using one of the following methods:• search for a list of user accounts in a BlackBerry® Domain, on a BlackBerry® Enterprise Server, or in a group• type the email addresses of the user accounts one at a time in the BlackBerry Enterprise Transporter• import a CR-delimited flat text file that contains a list of email addresses• if the BlackBerry Enterprise Transporter is running in bulk mode, select a source BlackBerry Enterprise Server

Search for and select user accounts to moveYou can search for user accounts that are associated with the source BlackBerry® Domain, or with a specificBlackBerry® Enterprise Server, group, or IT policy. You can add the user accounts to the list of user accounts that youwant to move to a destination BlackBerry Domain.

Before you begin: Create or select the labels for the source BlackBerry Configuration Database and the destinationBlackBerry Configuration Database.


2. Click Find Users.

3. Perform one of the following actions:• To search for user accounts at the global level, select the BlackBerry Domain option.• To search for user accounts that are associated with a specific BlackBerry Enterprise Server, select the Server

option. In the drop-down list, click a BlackBerry Enterprise Server.• To search for user accounts that are associated with a specific group, select the Group option. In the drop-

down list, click a group.• To search for user accounts that are associated with a specific IT policy, select the IT Policy option. In the

drop-down list, click an IT policy.

4. Click Find.

5. Add the user accounts that you want to move.

6. Click Done.

After you finish: To remove a user account from the list, highlight the user account information and press Delete.

Import a file with email addressesBefore you begin:• Create or specify labels for the source BlackBerry® Configuration Database and destination BlackBerry

Configuration Database.• Create a CR-delimited flat text file that contains the email addresses of the user accounts that you want to move.

Installation and Administration Guide Selecting the user accounts to move to the destination BlackBerry Domain

43


2. Click Import Users.

3. Navigate to the file that contains the list of email addresses.

4. Click OK.

5. Click Done.

Select all user accounts that are associated with a sourceBlackBerry Enterprise ServerTo move all user accounts that are associated with a source BlackBerry® Enterprise Server simultaneously, you canturn on bulk mode.

Before you begin: Create or specify labels for the source BlackBerry Configuration Database and the destinationBlackBerry Configuration Database.

1. In the BlackBerry Enterprise Transporter, in the Step 1: User Manifest section, select the Bulk Server Modecheck box.

2. In the Step 3: Manifest Configuration section, in the Summary section, click Details.

3. In the Bulk Mode section, in the Source Server drop-down list, click the BlackBerry Enterprise Server that theuser accounts you want to move are associated with.

4. Click Done.

Add the information for a single user accountYou can add the information for a single user account without searching the source BlackBerry® ConfigurationDatabase for the information.

Before you begin: Create or specify labels for the source BlackBerry Configuration Database and the destinationBlackBerry Configuration Database.


2. In the Email column, type the email address for the user account.

3. In the DestinationServer column, type the name of the BlackBerry® Enterprise Server that you want to associatethe user account with.

4. Click Done.

Installation and Administration Guide Select all user accounts that are associated with a source BlackBerry Enterprise Server

44

Configure the default settings that apply to specific useraccountsAfter you select the user accounts that you want to move to the destination BlackBerry® Domain, you can applydifferent settings for the destination BlackBerry® Enterprise Server, group, IT policy, and software configuration tospecific user accounts that you want to move.

Before you begin:• In the destination BlackBerry Domain, create the groups, IT policies, and software configurations that you want

to apply to the user accounts.• Create or select labels for the source BlackBerry Configuration Database and the destination BlackBerry

Configuration Database.• Before you select the user accounts that you want to move to the destination BlackBerry Domain, in the Step

3: Manifest Configuration section, in the Summary section, click Details. Clear the Use current defaults for allnew entries check box.

• Select the user accounts that you want to move to the destination BlackBerry Domain.


2. In the Default Destination Assignments section, click the BlackBerry Enterprise Server, group, IT policy, andsoftware configuration that you want to apply to the user accounts.

3. Perform one of the following actions:• To apply the selected default settings to specific user accounts, select the user accounts. Click Apply to

selected.• To apply the selected default settings to all user accounts that do not have values for the default settings

specified, click Apply to blank cells.• To specify the default settings for a specific user account, configure the values for the Dest Server, Dest

Group, Dest Policy, and Dest SW Config drop-down lists for the user account.

4. If necessary, repeat steps 2 and 3 to apply different default settings to specific user accounts.

5. Click Done.

Using the BlackBerry Enterprise Transporter, you can apply software configurations and IT policies directly to useraccounts. You can also assign user accounts to groups that are associated with existing software configurations andIT policies. The BlackBerry Administration Service uses preconfigured rules that give priority to user-assigned softwareconfigurations and IT policies over the software configurations and IT policies that you assign to groups. If you wantthe group-assigned software configurations and IT policies to take precedence, remove the user-assigned softwareconfigurations and IT policies from the user accounts. For more information about reconciliation rules, see theBlackBerry Enterprise Server Administration Guide.Note: If you move user accounts to a destination BlackBerry Enterprise Server 5.0 or later, there might be a delaybefore the destination BlackBerry Enterprise Server applies the selected IT policies or group-assigned IT policies toBlackBerry devices. During this delay, the Default IT policy is applied to the devices.

Related topics

Installation and Administration Guide Configure the default settings that apply to specific user accounts

45

Configure the default settings that apply to all user accounts, 41Selecting the user accounts to move to the destination BlackBerry Domain, 43

Installation and Administration Guide Configure the default settings that apply to specific user accounts

46

Moving user accounts 10

Verify the user account informationBefore you begin the migration process, you can verify the user account information to check that the migrationprocess can move the user account. You can use this information to resolve any issues.

Before you begin: Select the user accounts that you want to move.

1. In the BlackBerry® Enterprise Transporter, in the Step 4: Preview section, click Preview.

2. In the Report window, check for warning messages.

3. If issues exist, resolve the issues.

After you finish: To stop the preview, in the Step 4: Preview section, click Abort.

Move user accountsTo stop the migration process at any time, in the Step 5: Migration section, click Abort. When you click Abort, theBlackBerry® Enterprise Transporter stops after it completes the migration process for the user accounts that it iscurrently moving.

Before you begin:• Before you use the BlackBerry Enterprise Transporter for the first time, log in to the BlackBerry Administration

Service and verify that you can create a user account, assign a BlackBerry device to the user account, and activatethe BlackBerry device.

• Validate the user account information to resolve any issues that might exist.• Verify that only one BlackBerry Enterprise Transporter instance is running against a BlackBerry Configuration

Database at a time.• If you plan to move the mailboxes that are associated with user accounts, consider moving the mailboxes before

you move the user accounts. You must not move the mailboxes at the same time as you use the BlackBerryEnterprise Transporter to move the user accounts.

• Consider moving user accounts when the associated BlackBerry devices are in a wireless coverage area.• To move the WLAN data for user accounts, verify that both the source BlackBerry Domain and the destination

BlackBerry Domain are version 4.1 SP2 or later. WLAN configurations must be the same on both the sourceBlackBerry Domain and destination BlackBerry Domain. If the WLAN configurations are not the same on bothBlackBerry Domain instances, the user accounts are moved with the WLAN settings from the source BlackBerryDomain.

• Verify that the destination BlackBerry Administration Service is running. If the destination BlackBerryAdministration Service is not running while you are moving user accounts, the default assignments for groups,IT policies, and software configurations might not be applied to the user accounts.

1. In the BlackBerry Enterprise Transporter, in the Step 3: Manifest Configuration section, perform any of thefollowing actions:

Installation and Administration Guide Moving user accounts

47

• If you want the destination BlackBerry® Enterprise Server to synchronize the organizer data for user accountsimmediately after the migration process completes, select the Trigger SlowSync check box.

If you plan to migrate a large number of users, this action might have an unexpected performance impact onyour organization's messaging server and BlackBerry Enterprise Server environment. It is a best practice touse this option when you move user accounts during low usage periods. If you do not select this option, thedestination BlackBerry Enterprise Server synchronizes the organizer data for the user accounts at a regularlyscheduled interval.

• To ignore validation warning messages, select the Ignore Warnings check box.• To move the WLAN data for user accounts, select the Migrate WLAN check box.

2. In the Step 5: Migration section, click Migrate.

3. On the Console tab, view the success message and warning messages.To copy all the success messages and warning messages to the Clipboard, on the Edit menu, click Copy Consoleto Clipboard.

After you finish: To verify that the migration process completed, search for the user accounts in the destinationBlackBerry Administration Service. Verify that the user accounts are assigned to the correct BlackBerry EnterpriseServer, group, IT policy, and software configuration.Note: If you move user accounts to a destination BlackBerry Enterprise Server 5.0 or later, there might be a delaybefore the destination BlackBerry Enterprise Server applies the selected IT policies or group-assigned IT policies toBlackBerry devices. During this delay, the Default IT policy is applied to the devices.

View the latest BlackBerry Enterprise Transporter log fileYou can view the latest BlackBerry® Enterprise Transporter log file to verify that user accounts were migrated or totroubleshoot migration issues.

In the BlackBerry Enterprise Transporter, on the Help menu, click View Log.

Installation and Administration Guide View the latest BlackBerry Enterprise Transporter log file

48

Running the BlackBerry Enterprise Transporterfrom the command prompt

11

You can preview or run a user migration using the command prompt. It is a best practice to configure the manifestfile that is required for migration using the BlackBerry® Enterprise Transporter UI. You can then reference the manifestfile when you type the commands to run the BlackBerry Enterprise Transporter from the command prompt.

Parameters for the BlackBerry Enterprise TransporterTo run the BlackBerry® Enterprise Transporter from the command prompt, open the command prompt and navigateto <drive>:/Program Files/Research in Motion/BlackBerry Resource Kit/BlackBerry Enterprise Transporter. In thecommand prompt, type enterprisetransporter and a combination of the following parameters. The parameters listedin brackets are optional.

Item Description

[/basauthtype <type>] This parameter specifies which of the following options the BlackBerry EnterpriseTransporter uses to authenticate with the BlackBerry Administration Service:• ad_auth: use Microsoft® Active Directory® authentication; you must also

specify the /basdomain parameter• bas_auth: use BlackBerry Administration 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 authentication type, by default, the tool uses BlackBerryAdministration Service authentication (bas_auth).

[/basdomain <domain>] This parameter specifies the Microsoft Active Directory domain for the BlackBerryAdministration Service.

Use this parameter when you specify ad_auth for the /basauthtype parameter.[/baspassword <password>] This parameter specifies the password that the tool uses to authenticate with the

BlackBerry Administration Service when it uses BlackBerry Administration Serviceauthentication.

Use this parameter when you specify bas_auth for the /basauthtype parameter.

If you use this parameter, you must also specify a value for the /basusernameparameter.

[/basusername <user_name>] This parameter specifies the user name that the tool uses to authenticate withthe BlackBerry Administration Service when it uses BlackBerry AdministrationService authentication.

Use this parameter when you specify bas_auth for the /basauthtype parameter.

Installation and Administration Guide Running the BlackBerry Enterprise Transporter from the command prompt

49

Item Description

If you use this parameter, you must also specify a value for the /baspasswordparameter.

/console This parameter specifies that you run the tool from the command prompt.[/dominoid<drive>:<file_path>]

This parameter specifies the path to the user.id file.

This parameter is required in a BlackBerry® Enterprise Server for IBM® Lotus®Domino® environment only.

[/dominopassword<password>]

This parameter specifies the password that the BlackBerry Enterprise Transporteruses for the user.id file.

This parameter is required in a BlackBerry Enterprise Server for IBM Lotus Dominoenvironment only.

/execute This parameter executes the user migration.[/manifestPath<drive>:<file_path>]

This parameter specifies the path to the manifest file. If you do not specify a path,the tool uses the manifest.xml file that is in the folder that the tool is installed in.

/preview This parameter previews the migration process but does not move user accounts.

Preview moving user accounts using the command promptBefore you begin: Create and configure a manifest file. You can create and configure a manifest file using the samplemanifest file that is included in the BlackBerry® Enterprise Transporter installation files, or by using the BlackBerryEnterprise Transporter user interface. It is a best practice to create and configure the manifest file using the BlackBerryEnterprise Transporter user interface.

1. On the computer that hosts the BlackBerry Enterprise Transporter, at the command prompt, navigate to<drive>:/Program Files/Research in Motion/BlackBerry Resource Kit/BlackBerry Enterprise Transporter.

2. Type enterprisetransporter /console /preview and any of the following optional parameters:• /basauthtype <type>• /basusername <user_name> (use only if you specify bas_auth for /basauthtype)• /baspassword <password> (use only if you specify bas_auth for /basauthtype)• /basdomain <domain> (use only if you specify ad_auth for /basauthtype)• /dominoid <drive>:<file_path> (use only in an IBM® Lotus® Domino® environment)• /dominopassword <password> (use only in an IBM Lotus Domino environment)• /manifestPath <drive>:<file_path>

After you finish: In a Microsoft® Exchange messaging environment, to stop the preview migration process, pressCtrl+Break. To shut down the BlackBerry Enterprise Transporter, press Ctrl+C.

Installation and Administration Guide Preview moving user accounts using the command prompt

50

Move user accounts using the command promptBefore you begin: Create and configure a manifest file. You can create and configure a manifest file using the samplemanifest file that is included in the BlackBerry® Enterprise Transporter installation files, or by using the BlackBerryEnterprise Transporter user interface. It is a best practice to create and configure the manifest file using the BlackBerryEnterprise Transporter user interface.

1. On the computer that hosts the BlackBerry® Enterprise Transporter, at the command prompt, navigate to<drive>:/Program Files/Research in Motion/BlackBerry Resource Kit/BlackBerry Enterprise Transporter.

2. Type enterprisetransporter /console /execute and any of the following optional parameters:• /basauthtype <type>• /basusername <user_name> (use only if you specify bas_auth for /basauthtype)• /baspassword <password> (use only if you specify bas_auth for /basauthtype)• /basdomain <domain> (use only if you specify ad_auth for /basauthtype)• /dominoid <drive>:<file_path> (use only in an IBM® Lotus® Domino® environment)• /dominopassword <password> (use only in an IBM Lotus Domino environment)• /manifestPath <drive>:<file_path>

After you finish: In a Microsoft® Exchange messaging environment, to abort the migration process, press Ctrl+Break. To shut down the BlackBerry Enterprise Transporter, press Ctrl+C.

To verify that the migration process completed, search for the user accounts in the destination BlackBerryAdministration Service. Verify that the user accounts are assigned to the correct BlackBerry® Enterprise Serverinstance, group, IT policy, and software configuration.

Note: If you move user accounts to a destination BlackBerry Enterprise Server 5.0 or later, there might be a delaybefore the destination BlackBerry Enterprise Server applies the selected IT policies or group-assigned IT policies toBlackBerry devices. During this delay, the Default IT policy is applied to the devices.

Installation and Administration Guide Move user accounts using the command prompt

51

Return user accounts to the source BlackBerryDomain

12

To return user accounts to the source BlackBerry Domain, you must run the migration process a second time. Youmust set the former destination BlackBerry Configuration Database as the source BlackBerry ConfigurationDatabase, and the former source BlackBerry Configuration Database as the destination BlackBerry ConfigurationDatabase.

Before you begin: Back up the source BlackBerry® Configuration Database and destination BlackBerry ConfigurationDatabase.

1. In the BlackBerry Enterprise Transporter, in the Step 2: BlackBerry Databases section, in the Source Domainsection, click Configure.

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, click Configure.

5. In the Label drop-down list, click the label for the former source BlackBerry Configuration Database.

6. Click OK.

7. In the Step 3: Manifest Configuration section, in the Summary section, click Details.

8. Change the list of user accounts to the user accounts that you want to return to the source BlackBerryConfiguration Database.

9. Click Done.

10. Validate the user account data.

11. Move the user accounts.

Installation and Administration Guide Return user accounts to the source BlackBerry Domain

52

Troubleshooting 13

Configuration errors and warnings

The BlackBerry Enterprise Transporter cannot connect to the BlackBerryAdministration ServicePossible cause

If you configured Windows® Internet Explorer® to use a proxy server by default, the BlackBerry® EnterpriseTransporter might not be able to connect to the BlackBerry Administration Service.

Possible solution

To configure the BlackBerry Enterprise Transporter to override the proxy server that you configured, in theEnterpriseTransporter.exe.config file, add the following text inside the <configuration> tags:

<system.net> <defaultProxy> <proxy usesystemdefault = "false" /> </defaultProxy></system.net>

Configuration file errorDescription

This message appears when the BlackBerry® Enterprise Transporter configuration file(EnterpriseTransporter.exe.config) contains invalid information.

Possible solutionTry performing the following actions:• Read the additional information that is displayed with the error message to determine the problem.• Use the sample configuration file located in the BlackBerry Enterprise Transporter installation files to try to

identify the issue with the configuration file that you are using.

XML Manifest Failed to LoadDescription

This message appears when the BlackBerry® Enterprise Transporter cannot load the manifest file that you specified.

Possible solutionTry performing one of the following actions:• Verify that the manifest file is in the location that you specified.• Create and configure a new manifest file.

Installation and Administration Guide Troubleshooting

53

Destination 5.0 server found but unable to find BUA installationDescription

This message appears when you try to move user accounts to a destination BlackBerry® Enterprise Server 5.0 andthe BlackBerry Enterprise Transporter cannot detect the BlackBerry Enterprise Server User Administration Tool. TheBlackBerry Enterprise Transporter uses the BlackBerry Enterprise Server User Administration Tool to assign defaultsettings for groups, IT policies, and software configurations to the user accounts that you want to move to thedestination BlackBerry Enterprise Server.

Possible solution

Install a compatible version of the BlackBerry Enterprise Server User Administration Tool on the computer that hoststhe BlackBerry Enterprise Transporter. The BlackBerry Enterprise Server User Administration Tool is not required ifthe destination BlackBerry Enterprise Server is version 5.0 SP1 or later.

One or more user accounts do not have a Destination Server setDescription

This message appears if you did not select a destination BlackBerry® Enterprise Server for one or more user accountsin the User Manifest Configuration window.

Possible solution

For more information about configuring the settings for user accounts that you want to move, see "Configure thedefault settings that apply to specific user accounts" in the BlackBerry Enterprise Transporter Installation andAdministration Guide.

Troubleshooting preview errors

ERROR: Destination contains servers older than 5.0Description

This message appears if BlackBerry® Enterprise Server version 5.0 and earlier versions are both present in thedestination BlackBerry Domain.

Possible solution

Upgrade all BlackBerry Enterprise Server instances in the destination BlackBerry Domain to version 5.0 or later andthen run the BlackBerry Enterprise Transporter.

Installation and Administration Guide Troubleshooting preview errors

54

Application error messages

Failed to initialize <source/destination> database connection

Description

This message appears when theBlackBerry® Enterprise Transporter cannot connect to the specified database, or thedatabase is not a valid BlackBerry Configuration Database.

Possible solution

Try performing the following actions:

• Verify that the connection string is correct.• Verify the database permissions.• Verify that the server that hosts the BlackBerry Configuration Database is running and that the BlackBerry

Configuration Database is online.

No users found in manifest, shutting down

Description

This message appears when the BlackBerry® Enterprise Transporter engine finds no user accounts to move.

Possible solution

Try performing one of the following actions:

• If you are running the BlackBerry Enterprise Transporter in live mode, check the manifest file to verify that oneor more user accounts are defined in the Users section.

• If you are running the BlackBerry Enterprise Transporter in bulk mode, verify the names of the database serversthat host the BlackBerry Configuration Database in the source BlackBerry Domain and the destination BlackBerryDomain, and verify that the names and server information are configured correctly in the manifest file.

Manifest Validation Error

Description

This message appears when the manifest file does not conform to the manifest.xsd schema.

Possible solution

Determine the line or element of the schema error, and correct it.


55

User validation error messages

No users have been activated on destination server - user may lose some devicefunctionality

Description

This message appears when you try to move user accounts to a destination BlackBerry® Enterprise Server that hasnever had user accounts added to it and has never had BlackBerry devices activated.

Possible solution

In the BlackBerry Administration Service for the destination BlackBerry Enterprise Server, create and activate a testuser account. Try moving user accounts to the destination BlackBerry Enterprise Server again.

Destination server does not support the current encryption scheme

Description

This message appears when the destination BlackBerry® Enterprise Server does not support the encryption schemethat is used by the source BlackBerry Enterprise Server.

Possible solution

Configure the source BlackBerry Enterprise Server and the destination BlackBerry Enterprise Server to use the sameencryption algorithm and try to move the user account again.

User not found in source

Description

This message appears when the BlackBerry® Enterprise Transporter cannot find a user record in the source BlackBerryDomain with the email address that is specified in the manifest file.

Possible solution


• Verify that the source BlackBerry Domain is correct in the manifest file.• Verify that the user account exists on one of the BlackBerry® Enterprise Server instances in the source BlackBerry

Domain.• Verify that the email address of the user account is typed correctly in the manifest file.

User already exists in destination

Description

This message appears when the BlackBerry® Enterprise Transporter finds that a user record already exists in thedestination BlackBerry Domain with the email address of the user account that is specified in the manifest file.

Possible solution


56


• Verify that the destination BlackBerry Domain is correct in the manifest file.• Verify that the email address of the user account is typed correctly in the manifest file.

SrcRoutingInfo is null or 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 BlackBerry device might not have beenupdated with the destination routing information during the migration process.

Possible solution


• Activate the user account on the source BlackBerry® Enterprise Server again and try to move the user accountto the destination BlackBerry Enterprise Server.

• Run the BlackBerry Enterprise Transporter with the Ignore warnings option selected and activate the useraccount on the destination BlackBerry Enterprise Server after the migration process completes. You do not needto delete all of the data on the device before you try to activate the user account.

The UserId cannot be preserved

Description

This message appears when the BlackBerry® Enterprise Transporter cannot preserve the user ID that the BlackBerry®Enterprise Server sends to the BlackBerry device because the user ID is already in use in the destination BlackBerryDomain. The user ID must be preserved so that the BlackBerry device can work correctly.

This message appears only if the BlackBerry Enterprise Server instances in the destination BlackBerry Domain arenot version 5.0 and later.

Possible solution

Manually remove, re-add, and reactivate the user account on the source BlackBerry Enterprise Server to generate anew user ID. Then try to migrate the user account again.

<email_address> Skipping WLAN configuration due to empty WLANBaseConfigSet:ConfigName

Description

This message appears when the BlackBerry® Enterprise Transporter does not move the WLAN information for a useraccount because the WLAN base configuration set is empty.

Possible solution


57

After the migration process completes, configure the WLAN base configuration set on the destination BlackBerry®Enterprise Server using the BlackBerry Administration Service.

<email_address> Unable to parse device version string: "Version found in database"

Description

This message appears when the BlackBerry® Enterprise Transporter cannot process the BlackBerry® Device Softwareversion that is associated with a user account in the BlackBerry Configuration Database. The BlackBerry DeviceSoftware version might not exist in the BlackBerry Configuration Database.

Possible solution

Move the user account to the destination BlackBerry® Enterprise Server with the Ignore Warnings option selected.

<email_address> Failed to load UserConfig row for user

Description

This message appears when the BlackBerry® Enterprise Transporter cannot load the user account information fromthe UserConfig table in the source BlackBerry Configuration Database.

Possible solution

To determine the cause of the issue, check the BlackBerry Enterprise Transporter log file for Microsoft® SQL Server®errors. If possible, correct the problem and try to move the user account again.

<email_address> Failed to load PIM Sync data for user

Description

This message appears when the BlackBerry® Enterprise Transporter cannot load the user account information fromthe organizer synchronization tables in the source BlackBerry Configuration Database.

Possible solution

Check the BlackBerry Enterprise Transporter log file for Microsoft® SQL Server® errors to identify which tables in theBlackBerry Configuration Database were affected. If possible, correct the problem and try to move the user accountagain.

<email_address> Incomplete SWITCH_SERVICE command data

Description

This message appears when the BlackBerry® Enterprise Transporter cannot queue a switch service command for theuser account.

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


58

• Verify that the routing information for the user account on the source and destination server is not blank ornull, and that the configuration ID for the user account on the destination server is greater than 0.

User account status: Skipped

On the Report tab, this status message appears for user accounts that were previously moved to the destinationBlackBerry® Enterprise Server.

User validation warning messages

Invalid PIN

Description

This message appears when the user account has an invalid, null, or 0 PIN, which indicates that the user account isnot active. The BlackBerry® Enterprise Transporter can move the user account, but IT administration commands donot complete, and you must activate the user account after the migration to the destination BlackBerry® EnterpriseServer instance.

Possible solution


• Activate the user account on the source BlackBerry Enterprise Server. Then retry the migration.• Run the BlackBerry Enterprise Transporter migration process with Ignore warnings selected. Then activate the

user account on the destination BlackBerry Enterprise Server instance after the migration process completes.

User status on the source BlackBerry Enterprise Server instance is not "Running"

Description

The status of the user account on the source BlackBerry® Enterprise Server instance indicates that the user accountis not currently active.

Possible solution


• Activate the user account on the source BlackBerry Enterprise Server. Then retry the migration.• Run the BlackBerry Enterprise Transporter migration process with Ignore warnings selected. Then activate the

user account on the destination BlackBerry Enterprise Server instance after the migration process completes.You do not need to delete the data on the BlackBerry device that is associated with the user account.

Troubleshooting migration errorsWhen you troubleshoot migration issues, you can review the migration job history in the BlackBerry® EnterpriseTransporter log file.

Installation and Administration Guide Troubleshooting migration errors

59

User migration failed messages

VALIDATION / FAILED

Description

This message appears when the BlackBerry® Enterprise Transporter cannot validate the user account.

Possible solution

See "User validation error messages" and "User validation warning messages" for the BlackBerry EnterpriseTransporter.

MIGRATION / FAILED

Description

This message appears when the BlackBerry® Enterprise Transporter cannot add the data for the user account to thedestination BlackBerry Configuration Database.

Possible solution


• Check the log file for the BlackBerry Enterprise Transporter for the error details.• Verify that the destination BlackBerry Configuration Database is online.• Verify that you have the required permissions to insert records into the destination BlackBerry Configuration

Database.

SWITCH_SERVICE / FAILED

Description

This message appears when the destination BlackBerry® Policy Service reports an error after it tries to send the SwitchService command to the BlackBerry device.

Possible solution

Check the log file for the BlackBerry Policy Service and the log files for the BlackBerry device to determine the causeof the error.

User migration completed with warning messages

SET_IT_POLICY / FAILED

Description


60

This message appears when the IT policy sent from the destination BlackBerry® Enterprise Server is not successfullyapplied to the BlackBerry device after the migration process completes.

Possible solution


• Manually resend the IT policy from the destination BlackBerry Enterprise Server.• If you still cannot apply the IT policy, reactivate the BlackBerry device on the destination BlackBerry Enterprise

Server. You do not need to delete the data from the BlackBerry device.• If you still cannot apply the IT policy, delete the data from the BlackBerry device. Reactivate the BlackBerry

device on the destination BlackBerry Enterprise Server.

Any other task / FAILED or NOT_STARTED

Description

This message appears if some other task failed but did not stop the migration process.

Possible solution

Check the BlackBerry® Enterprise Transporter log file for details.

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 Policycommand to the BlackBerry device, but the command does not complete. The BlackBerry device might be turnedoff, outside a wireless coverage area, or inactive.

Possible solution

Manually verify that the IT administration commands are delivered to the BlackBerry device after it is turned on,back inside a wireless coverage area, or activated.

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 tothe BlackBerry device failed or is still in progress. If you migrate the user account in this state, an IT administrationcommand that is sent from the destination BlackBerry Enterprise Server might fail.

Possible solution


61


• Wait for the source Set IT Policy command to complete, or resend the Set IT Policy command if the previouscommand failed.

• Run the BlackBerry Enterprise Transporter migration process with Ignore warnings selected, and activate theuser account on the destination server after the migration process completes if the IT administration commandfails. You do not need to delete the data on the BlackBerry device.

IT Policy might not be applied successfully to a BlackBerry device

Description

This message appears when the BlackBerry® Enterprise Transporter detects a condition where the destinationBlackBerry® Enterprise Server might not be able to apply a new IT policy to the BlackBerry device that is associatedwith a user account.

This can happen if the BlackBerry® Device Software is earlier than version 4.0.2 and the destination BlackBerryConfiguration Database does not contain the optional ITPolicyKeyMapping table.

Possible solution


• If possible, upgrade the BlackBerry Device Software to version 4.0.2.x or later.• Add the ITPolicyKeyMapping table to the destination BlackBerry Configuration Database before you try to

migrate a user account if the BlackBerry Device Software is earlier than version 4.0.2.• If the Set IT Policy command fails, run the BlackBerry Enterprise Transporter with Ignore warnings selected.

Then reactivate the user account on the destination BlackBerry Enterprise Server after the migration processcompletes. You do not need to delete the data on the BlackBerry device.

User account status: SkippedOn the Report tab, this status message appears for user accounts that were previously moved to the destinationBlackBerry® Enterprise Server.

User account status: MigrationSkippedDueToValidationFailureDescription

On the Report tab, this status message appears for user accounts that were not moved to the destination BlackBerry®Enterprise Server because the BlackBerry Enterprise Transporter could not validate the user accounts.

Possible solution

Use the information that appears on the Report tab to resolve the issue.


62

Port information for the BlackBerry EnterpriseServer Resource Kit tools

14

Port information for tools that connect to the BlackBerryConfiguration Database

Tool Connection type Default port number

BlackBerry® Application Reporting Tool TCP 1433BlackBerry Domain Administration History ReportingTool

TCP 1433

BlackBerry Enterprise Transporter TCP 1433BlackBerry IT Policy Import and Export Tool TCP 1433BlackBerry Message Receipt Confirmation Tool TCP 1433

Port information for tools that connect to the BlackBerryAdministration Service, BlackBerry Administration API, andBlackBerry Web Services

Tool Connection type Default port number

BlackBerry® Domain Search TCP 443BlackBerry Enterprise Server User Administration Tool TCP 443BlackBerry Enterprise Transporter TCP 443BlackBerry Directory Sync Tool TCP 443

Port information for BlackBerry Domain Search

Item Connection type Default port number

Incoming HTTP connections TCP 80Incoming HTTPS connections TCP 443

Installation and Administration Guide Port information for the BlackBerry Enterprise Server Resource Kit tools

63

Port information for the BlackBerry System Log Monitoringand Reporting Tool

Action Connection type Default port number

Listens for packets UDP 514Sends messages over SMTP TCP 25

Port information for the BlackBerry Message ReceiptConfirmation Tool

Action Connection type Default port number

Sends messages MAPI 125

Installation and Administration Guide Port information for the BlackBerry System Log Monitoring and Reporting Tool

64

Glossary 15AES

Advanced Encryption Standard

APIapplication programming interface

BlackBerry DomainA BlackBerry Domain consists of the BlackBerry Configuration Database with its users and any BlackBerry®Enterprise Server instances that connect to it.

BlackBerry CALA BlackBerry® Client Access License (BlackBerry CAL) limits how many users you can add to a BlackBerry®Enterprise Server.

CRcarriage return

DESData Encryption Standard

FQDNfully qualified domain name

IBM DB2 UDBIBM® DB2® Universal Database

IPInternet Protocol

IP addressAn Internet Protocol (IP) address is an identification number that each computer or mobile device uses when itsends or receives information over a network, such as the Internet. This identification number identifies thespecific computer or mobile device on the network.

SRPServer Routing Protocol

Triple DESTriple Data Encryption Standard

WLANwireless local area network

Installation and Administration Guide Glossary

65

Provide feedback 16To provide feedback on this deliverable, visit www.blackberry.com/docsfeedback.

Installation and Administration Guide Provide feedback

66

http://www.blackberry.com/docsfeedback

Legal notice 17©2011 Research In Motion Limited. All rights reserved. BlackBerry®, RIM®, Research In Motion®, and relatedtrademarks, names, and logos are the property of Research In Motion Limited and are registered and/or used in theU.S. and countries around the world.

IBM, Domino, Lotus, and Lotus Notes are trademarks of International Business Machines Corporation. Microsoft,SQL Server, Windows, and Windows Server are trademarks of Microsoft Corporation. All other trademarks are theproperty of their respective owners.

This documentation including all documentation incorporated by reference herein such as documentation providedor made available at www.blackberry.com/go/docs is provided or made accessible "AS IS" and "AS AVAILABLE" andwithout condition, endorsement, guarantee, representation, or warranty of any kind by Research In Motion Limitedand its affiliated companies ("RIM") and RIM assumes no responsibility for any typographical, technical, or otherinaccuracies, errors, or omissions in this documentation. In order to protect RIM proprietary and confidentialinformation and/or trade secrets, this documentation may describe some aspects of RIM technology in generalizedterms. 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 thisdocumentation to you in a timely manner or at all.

This documentation might contain references to third-party sources of information, hardware or software, productsor services including components and content such as content protected by copyright and/or third-party web sites(collectively the "Third Party Products and Services"). RIM does not control, and is not responsible for, any ThirdParty 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. Theinclusion of a reference to Third Party Products and Services in this documentation does not imply endorsement byRIM 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 ORWARRANTIES OF DURABILITY, FITNESS FOR A PARTICULAR PURPOSE OR USE, MERCHANTABILITY, MERCHANTABLEQUALITY, NON-INFRINGEMENT, SATISFACTORY QUALITY, OR TITLE, OR ARISING FROM A STATUTE OR CUSTOM ORA COURSE OF DEALING OR USAGE OF TRADE, OR RELATED TO THE DOCUMENTATION OR ITS USE, OR PERFORMANCEOR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICESREFERENCED HEREIN, ARE HEREBY EXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTS THAT VARY BY STATE ORPROVINCE. SOME JURISDICTIONS MAY NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES ANDCONDITIONS. TO THE EXTENT PERMITTED BY LAW, ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TO THEDOCUMENTATION TO THE EXTENT THEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE LIMITED, AREHEREBY LIMITED TO NINETY (90) DAYS FROM THE DATE YOU FIRST ACQUIRED THE DOCUMENTATION OR THE ITEMTHAT IS THE SUBJECT OF THE CLAIM.

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO EVENT SHALL RIM BELIABLE FOR ANY TYPE OF DAMAGES RELATED TO THIS DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES

Installation and Administration Guide Legal notice

67

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

REFERENCED HEREIN INCLUDING WITHOUT LIMITATION ANY OF THE FOLLOWING DAMAGES: DIRECT,CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, INDIRECT, SPECIAL, PUNITIVE, OR AGGRAVATED DAMAGES, DAMAGESFOR LOSS OF PROFITS OR REVENUES, FAILURE TO REALIZE ANY EXPECTED SAVINGS, BUSINESS INTERRUPTION, LOSSOF BUSINESS INFORMATION, LOSS OF BUSINESS OPPORTUNITY, OR CORRUPTION OR LOSS OF DATA, FAILURES TOTRANSMIT OR RECEIVE ANY DATA, PROBLEMS ASSOCIATED WITH ANY APPLICATIONS USED IN CONJUNCTION WITHRIM PRODUCTS OR SERVICES, DOWNTIME COSTS, LOSS OF THE USE OF RIM PRODUCTS OR SERVICES OR ANY PORTIONTHEREOF 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 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 OTHEROBLIGATION, DUTY, OR LIABILITY WHATSOEVER IN CONTRACT, TORT, OR OTHERWISE TO YOU INCLUDING ANYLIABILITY FOR NEGLIGENCE OR STRICT LIABILITY.

THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A) IRRESPECTIVE OF THE NATURE OF THECAUSE OF ACTION, DEMAND, OR ACTION BY YOU INCLUDING BUT NOT LIMITED TO BREACH OF CONTRACT,NEGLIGENCE, TORT, STRICT LIABILITY OR ANY OTHER LEGAL THEORY AND SHALL SURVIVE A FUNDAMENTAL BREACHOR BREACHES OR THE FAILURE OF THE ESSENTIAL PURPOSE OF THIS AGREEMENT OR OF ANY REMEDY CONTAINEDHEREIN; AND (B) TO RIM AND ITS AFFILIATED COMPANIES, THEIR SUCCESSORS, ASSIGNS, AGENTS, SUPPLIERS(INCLUDING AIRTIME SERVICE PROVIDERS), AUTHORIZED RIM DISTRIBUTORS (ALSO INCLUDING AIRTIME SERVICEPROVIDERS) AND THEIR RESPECTIVE DIRECTORS, EMPLOYEES, AND INDEPENDENT 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 ANYLIABILITY ARISING FROM OR RELATED TO THE DOCUMENTATION.

Prior to subscribing for, installing, or using any Third Party Products and Services, it is your responsibility to ensurethat your airtime service provider has agreed to support all of their features. Some airtime service providers mightnot offer Internet browsing functionality with a subscription to the BlackBerry® Internet Service. Check with yourservice provider for availability, roaming arrangements, service plans and features. Installation or use of Third PartyProducts and Services with RIM's products and services may require one or more patent, trademark, copyright, orother licenses in order to avoid infringement or violation of third party rights. You are solely responsible fordetermining whether to use Third Party Products and Services and if any third party licenses are required to do so.If required you are responsible for acquiring them. You should not install or use Third Party Products and Servicesuntil all necessary licenses have been acquired. Any Third Party Products and Services that are provided with RIM'sproducts 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 liabilitywhatsoever, in relation thereto. Your use of Third Party Products and Services shall be governed by and subject toyou agreeing to the terms of separate licenses and other agreements applicable thereto with third parties, exceptto the extent expressly 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.


68

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 ORWARRANTIES PROVIDED BY RIM FOR PORTIONS OF ANY RIM PRODUCT OR SERVICE OTHER THAN THISDOCUMENTATION.

Certain features outlined in this documentation might require additional development or Third Party Products andServices for access to corporate applications.

Research In Motion Limited295 Phillip StreetWaterloo, ON N2L 3W8Canada

Research In Motion UK Limited Centrum House 36 Station Road Egham, Surrey TW20 9LF United Kingdom

Published in Canada


69

blackberry enterprise server resource kit installation and administration guide 1322936 0127022526...

Documents

destination blackberry

moving user accounts

source blackberry domain

user validation

microsoft sql server

migration process

system requirements

installation considerations