All users from the CE 8 institution 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 8.
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, section 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.
Note: Enterprise Edition clients only: Before you begin, make sure that you have created a data source key for the user data being imported. To learn more, see Data Source Keys.
Complete this procedure using the command line of the Blackboard Learn server.
- Log in to the Blackboard Learn server with system administrator privileges.
- Create a directory for your migration data using the following command.
- Copy the snapshot.xml file from the migrateToLearn directory on the CE 8 server to the migrateFromCE directory on the Blackboard Learn server.
- Navigate to the admin directory using the following command.
cd /Learn directory/blackboard/tools/admin
cd \Learn directory\blackboard\tools\admin
- 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 8.
Note: Parameters shown in brackets ([ ]) are optional.
Use only one --conflict resolution switch in the command.
./LMSImport.sh --file=/tmp/migrateFromCE/snapshot.xml --ds=data source key --no_courses --no_enrollments [--conflict_prefix prefix] [--conflict_suffix suffix] [--always]
./LMSImport.sh --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]
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.