Exporting a course creates a ZIP file of the course content called a course package. You can import course packages back into Blackboard Learn to create a new course with the same content. Exporting a course includes only the course content. The export does not include any user interactions such as blog posts or grades.

Archiving a course creates ZIP file of the course content and user interactions called an archive package. You can restore archive packages, but they are not intended for teaching the course again as all user interactions are restored as well. Store archive packages in a secure location.

Do not unzip or extract a course or archive package. Do not remove files from the package or try to import a file contained with the package. You can only import or restore the course if the package is intact. Editing the ZIP file and then importing or restoring the package results in unstable and unpredictable behavior in the course.

You can import course or archive packages from older versions of Blackboard Learn into the current version. However, you can't import packages exported from newer versions into older versions.

Required user permissions

To include course files in a course package when exporting or archiving a course, a user creating the package must have manage permission on the course folder.

To add course files from a course package to a destination folder when importing or restoring a course, a user performing the operation must have manage permission on the course folder.

If your institution has access to content management, users with read permission can include links to course files during an import/export or archive/restore operation. Users with manage permission can include links to course files and copies of the course files themselves.

If a user importing or restoring a course does not have manage permission, some of the package contents might not upload successfully.

Links to files that are not included when the package is created will not work when the package is imported or restored. For example, if a course area links to a test but the package does not include tests, surveys, and pools, the link to the test will not work in the new course.

All course users have read permission on the course files included in the package. Users with the following roles have manage permission:

Content type availability

Prior to Blackboard Learn 9.1 SP 4, only available items were included in a course package when exporting or archiving a course. When importing a course package from a pre-SP 4 environment, items that were unavailable may now be available because the package does not contain the unavailable items. Blackboard Learn can't differentiate between unavailable course tools omitted during export and any new items that were not present in the older version and are set to available by default. In versions since 9.1 SP 4, the exact settings made at the course level, both available and unavailable, are tracked and maintained in the export package.

Archive a course

Archive packages have the following file naming structure:

ArchiveFile_Course_ID_date/time_stamp.zip

The Blackboard Learn packaging format follows the IMS Content Packaging Specification, with extensions to support content types that are specific to Blackboard Learn. To learn more about exporting courses in Common Cartridge format, see Common Cartridge Course Packages.

On the Administrator Panel in the Courses section, select Courses.

Point to Backup Actions and select Archive Course.

In the Source Course ID box, type a valid course ID. If you do not know the exact course ID, select Browse to search for the course. To learn more, see Search for Courses.

To Include the Grade Center History, select the check box following the course ID. Selecting this option increases file size and processing time.

In the File Attachments section, choose whether to include only the links to course files or to include the links and copies of the course files content.

If you select Copy links and include copies of the content, select Calculate Size to ensure that the package size does not exceed the displayed Allowed package size. To remove files and folders from the package, select Manage Package Contents.

Selecting Submit. Blackboard Learn creates the archive package and sends an email to your Blackboard Learn account. This email contains a link to the log file contents of the package and confirms that the archive package is ready.

Go to your Blackboard Learn email account and verify that you have received the confirmation email.

On the Administrator Panel in the Courses section, select Courses.

Search for the course you archived.

Open the course's menu and select Export/Archive. The Export/Archive page lists all export or archive packages for this course that have not been deleted from Blackboard Learn, even if you have already downloaded the package. The file names include the date and time the package was created.

Open a ZIP file's menu and select Open.

In the Opening File dialog, select Save File and select OK to download the archive package to your computer.

Course cartridge information is included in the archive and can be restored, but SafeAssign assignments aren't included and can't be restored. To learn more, see SafeAssign.

The method for archiving cross-listed courses is to archive the parent course. Only parent courses have content, and archiving the parent course includes the child courses. There is no need to archive a child course as it only contains enrollments.

Disabled enrollments and enrollments for user IDs that are disabled, are not included in Archive packages. Unavailable enrollments or users are included.

Export a course

The Blackboard Learn packaging format follows the IMS Content Packaging Specification, with extensions to support content types that are specific to Blackboard Learn. To learn more about exporting courses in Common Cartridge format, see Creating Common Cartridge Course Packages.

On the Administrator Panel in the Courses section, select Courses.

Point to Backup Actions and select Export Course.

In the Source Course ID box, type a valid course ID. If you do not know the exact course ID, select Browse to search for the course. To learn more, see Searching for Courses.

Select Submit.

On the Export Course page, choose whether to include only the links to course files or to include the links and copies of the course files content.
If you select Copy links and include copies of the content, select Calculate Size to ensure that the package size does not exceed the displayed Allowed package size. To remove files and folders from the package, select Manage Package Contents.

In the Select Course Materials section, select the check boxes for each course area and tool to export. To learn more about what is included with each item, see Creating Courses.

Select Submit.

About restoring courses

Restoring a course uploads the archive package into Blackboard Learn in the same state that it was in at the time it was archived. Archive packages include course content (including all course cartridges if your institution has access to community engagement), user data, and user interactions.

When a course is restored, the settings and options specified in the archive package replace the default settings and Course Menu options that are in effect for new courses.

Course packages created in earlier versions of Blackboard Learn may not be supported. Check the Release Notes for the release that you are working in for a list of supported versions.

Size limit for restoring a course

The default size limit for content uploaded though the user interface is 2.5 GB. When attempting to upload files larger than 2.5 GB using the interface, users will receive an error. This limit does not apply to web folder or shared location (WebDAV) uploads.

To upload larger files, administrators can upload the files using the command line or they can increase the Tomcat default size setting.

To increase the maximum upload limit, open config/bb-config.properties and modify the upload limit parameter. The file size upload limit is tied to Tomcat and is not encountered with WebDAV uploads. Because the setting is tied to Tomcat, the services must be restarted for the change to take effect.

You can also increase the maximum upload package size from the System Admin panel. Select Course Settings > Default Course Size Limits and type a new size or select Unlimited.

Restoring user records

When performing a restore, Blackboard Learn checks to see if users are in the system by validating their usernames against email addresses.

If a username exists with a different email address than the one included in the archive package, Blackboard Learn creates a new user account. The new account has the same username with a sequence number appended.

If the username exists with the same email address, Blackboard Learn does not create a new user.

If a user account exists, but the account is disabled, Blackboard Learn creates a new user account. To avoid another user being created on the system the original user account must able be enabled.

Example: An archive package is uploaded with an account that has the username bb_user. The restore process looks for users with this username in Blackboard Learn. If bb_user exists in the system, the process compares the email addresses. If the email addresses match, the process creates a new enrollment record in course_users with the existing user (bb_user). If the email addresses are different, the process creates a new user (bb_user1).

As a security precaution, any users that are added during a restore are created with only their primary system roles. Secondary system roles are not included.

To include Content Collection files in the restore, select Select Folder. Select Browse to navigate to the folder. Blackboard Learn creates a sub-folder and copies the Content Collection files into it.

Select Submit.

View export and archive logs

Open the course's menu and select Export/Archive. The Export/Archive Course page lists all export or archive packages for this course that have not been deleted from Blackboard Learn, even if you have already downloaded the package. The file names include the date and time the package was created.

Open a ZIP file's menu.

To view the package creation date and time and the status, select View Basic Log.

To view the package creation date and time, status, and a list of course materials included in the package, select View Detailed Log.

Export, archive, and restore courses in batch

Blackboard Learn includes the batch_ImportExport tool for handling the import/export and archive/restore of a number of courses at once as well as the import/restore of files that exceed the default maximum upload limit.

This tool processes batch files that include the course ID and the full path to the ZIP package.

Default maximum upload limit

The default size limit for content uploaded though the user interface is 2.5 GB. When attempting to upload files larger than 2.5 GB using the interface, users will receive an error. This limit does not apply to web folder or shared location (WebDAV) uploads.

To upload larger files, administrators can upload the files using the command line or they can increase the Tomcat default size setting.

To increase the maximum upload limit, open config/bb-config.properties and modify the upload limit parameter. The file size upload limit is tied to Tomcat and is not encountered with WebDAV uploads. Because the setting is tied to Tomcat, the services must be restarted for the change to take effect.

You can also increase the maximum upload package size from the System Admin panel. Select Course Settings > Default Course Size Limits and type a new size or select Unlimited.

Create the batch file for export/archive and import/restore

A batch file used with the batch_ImportExport tool only has two values in each row: the course ID and the full path to the ZIP package.

When running an export or archive action, Blackboard Learn creates a ZIP package using the specified path and file name.

When running an import or restore action, the specified path and file name point to the ZIP package associated with the destination course ID.

The following are examples of the contents of a batch file for use with the batch_ImportExport tool. Save batch files as text (TXT) files.

Example: Export and Archive Batch Files

Export and archive batch files require only the path to the directory where each package will be stored. Do not include a package name. Adding a package name results in an error.

There are three optional boolean flags to specify the package options.

Option 1: Specify true or false to indicate whether to archive/export course files found under the course's home directory. If no value is specified, default is true.

Option 2: Specify true or false to indicate whether to archive/export grade history. If no value is specified, default is false.

Option 3: Specify true or false to indicate whether to archive/export course files found outside the course's home directory. If no value is specified, default is false.

The exact path to the Blackboard directory may be different depending on where Blackboard Learn was installed.

Paths to Blackboard Directory

Argument

Description

path_to_file

Provide the full path to the batch file.

delimiter

Provide one of the following values:

1: Identifies comma (,) as the delimiter.

2: Identifies semicolon (;) as the delimiter.

3: Identifies TAB as the delimiter.

operation

Provide one of the following case-sensitive values to indicate the operation being performed:

import

export

restore

archive

virtual_hostname

The name of the virtual installation that the tool will run against. If there are no virtual installations, or if this argument is not given, the tool will run against the default virtual installation.

cartridge_version

Use this variable when you want to make Common Cartridge exports. This flag is optional and can be left off entirely if you're creating normal Blackboard exports. This flag is only valid when Export is used for the operation command. If this option is not provided, the operation handles the package as the Learn package. Supported common cartridge versions are 1.0, 1.1 and 1.2.

An optional true/false parameter in the fourth column of the feed file is available for batch_ImportExport operations. It is only used in archive actions and controls whether the Grade Center history will be included in the package.

Customize the JVM heap size for the batch_ImportExport tool

Open the batch_ImportExport.bat or batch_ImportExport.sh file for editing.

Add an $OPTS or %OPTS parameter to include the customized JVM heap size. The syntax is shown below. The following example uses a JVM Heap size of 6 GB, and should be changed to meet the requirements of your institution.

Windows Syntax:

OPTS="%OPTS -Xmx6g"

UNIX Syntax:

OPTS="$OPTS -Xmx6g"

Supported paths for importing and restoring courses

The following table identifies the supported paths for importing or restoring a course that was exported or archived from older learning management systems. Certified paths are fully tested and supported by Blackboard. Compatible paths are not fully tested but should function correctly based on past performance.

Paths for importing and restoring courses are not backward compatible. Courses may be imported or restored to a newer version, but courses from a newer version may not be imported or restored to an earlier version.

Supported Paths for Importing and Restoring Courses

Source

Support

Blackboard Learn Release 9.1

Certified

Blackboard Learn Release 9.0

Certified

Blackboard Academic Suite Release 8

Certified

Blackboard Academic Suite Release 7

Certified

Blackboard Academic Suite Release 6

Certified

Blackboard ML

Certified

Blackboard 5.5*

Certified

Blackboard 5.0*

Compatible

CourseInfo 4

Not Supported

Blackboard Vista and CE 8.0.5 or higher

Certified

Blackboard Campus Edition 4.1.7

Certified

ANGEL LMS 7.3

Not Supported

ANGEL LMS 7.4

Certified

ANGEL LMS 8.0

Certified

*Blackboard 5 and Blackboard 5.5 did not include an archive and restore function. Courses from these releases may be imported but courses cannot be restored with user data and interactions intact.