Skip to main content
Blackboard Help

Step 3: Import CE 4 User Data Into Blackboard Learn

All users from CE 4 must added to the Blackboard Learn user database. This process is completed using the LMSImport command and the snapshot.xml file resulting from Step 2: Export All Data From CE 4.

Importing user data into Blackboard Learn from an existing system preserves user account data such as login ID, role, and so on, but user-related data such as passwords, quiz attempts, course membership information, group enrollment, and so on will not be included. For specific information about lost and retained data, refer to Understanding the Changes in Release 9.1.

This procedure will create new users in Blackboard Learn, but it will not update any existing user information. In other words, if a user with the same user_id already exists in Blackboard Learn, the user will not be updated or merged. Depending on the switches used with the import command, Blackboard Learn can add a prefix or suffix the user_id to distinguish between the two.

Enterprise Edition clients only: Before you begin, make sure that you have created a data source key for the user data being imported.

Complete this procedure using the command line of the Blackboard Learn server.

  1. Log in to the Blackboard Learn server with system administrator privileges.
  2. Create a directory for your migration data using the following command.


    mkdir /tmp/migrateFromCE


    mkdir c:\temp\migrateFromCE

  3. Copy the snapshot.xml file from the migrateToLearn directory on the CE 4 server to the migrateFromCE directory on the Blackboard Learn server.
  4. Navigate to the admin directory using the following command.


    cd /Learn_home/blackboard/tools/admin


    cd \Learn_home\blackboard\tools\admin

  5. Import the user data from the snapshot.xml file using the LMSImport command and the appropriate switches. To learn more about the available switches, see LMSImport Switches for CE 4.

    Parameters shown in brackets ([ ]) are optional.

    Use only one --conflict resolution switch in the command.


    ./ --file=/tmp/migrateFromCE/snapshot.xml
    --ds=data source key --no_courses --no_enrollments [--conflict_prefix prefix] [--conflict_suffix suffix] [--always]

    For example:

    ./ --file=/tmp/migrateFromCE/snapshot.xml
    --ds=CE_FALL_2009 --no_courses --no_enrollments --conflict_prefix CE_ --always


    LMSImport.cmd --file=c:\temp\migrateFromCE\snapshot.xml --ds=data source key --no_courses --no_enrollments [--conflict_prefix prefix] [--conflict_suffix suffix] [--always]

    For example:

    LMSImport.cmd --file=c:\temp\migrateFromCE\snapshot.xml --ds=CE_FALL_2009 --no_courses --no_enrollments --conflict_prefix CE_ --always

    A running count of the records processed displays. The bb-services-log-integration-jdbc.txt log file is created and stored in the Learn_home/blackboard/logs/snapshot directory on the Blackboard Learn server for users that fail to import.