Kaltura Video Building Block for Blackboard Learn Installation and Upgrade Guide

This guide describes how to deploy and configure the Kaltura Video Building Block for Blackboard and is intended for Blackboard administrators.

[/collapsed]

[collapsed title="Kaltura Video Building Block for Blackboard Learn Installation Requirements"]

Kaltura Video Building Block for Blackboard Learn Installation Requirements

The Kaltura Video Building Block for Blackboard Learn adds several modules and course tools to your Blackboard Learn environment.

[/collapsed]

[collapsed title="Prerequisites"]

Prerequisites

• A Kaltura account:
  • Partner id (“pid”), e.g., 12345678
  • Admin secret, e.g., f79359d3227f45be73c181489888afc5
• A Kaltura Application Framework instance URL, for example, 12345678.kaf.kaltura.com
• A Blackboard "Community Engagement Edition" License is required to upgrade/install Kaltura's KAF based building block.
• The latest Kaltura Building Block installation file (*.war file) is available here for both SaaS & managed/locally hosted.

To obtain a KAF instance URL or the installation file, please contact your Kaltura representative.

[/collapsed]

[collapsed title="Installation"]

Installation

Please refer to the Blackboard Website on how to configure an external tool on your Blackboard Learn environment.

[/collapsed]

[collapsed title="Building Block Configuration"]

Building Block Configuration

After you upload the Kaltura Video Building Block for Blackboard Learn, set up the system settings.

To set up the system settings for the Kaltura Video Building Block

1. Log in to Blackboard Learn as System Administrator.
2. Go to "System Admin > Building Blocks > Installed Tools > Kaltura Integration > Settings"
   The Kaltura Configuration page is displayed.
   
   

 In the Kaltura configuration page you:

1. Configure the Kaltura Server Connection>. This step is mandatory when installing or upgrading the Kaltura Video Building Block.
2. Configure the common settings of the Kaltura Building Block.
3. Configure the LTI Role Mapping of the Kaltura Building with the Blackboard KAF instance
4. FAQs about Tables
5. After you complete these tasks, perform the Post Installation and Migration Tasks.

Setting up a Connection to the Kaltura Server

For the first installation or upgrade of the Kaltura Video Building Block for Blackboard Learn, you will need to provide initial configuration settings to connect the Building Block with the KAF endpoint. Failing to do so prevents the Kaltura Building Block from working.

To configure the connection to the Kaltura server (KAF)

1. In the Kaltura Configuration page, click on Kaltura Server Connection Configuration.
   The Configure Kaltura page opens.
2. Enter the URL to your KAF instance under End Point.

   If the Blackboard instance is configured on HTTPS we recommend that the KAF instance be HTTPS as well.

3. Enter the admin secret of your Kaltura account under Admin Secret.
4. If debug logs are required, check Enable debug logging.
5. Click Submit.

Setting up Common Building Block Configuration

With the move to KAF, the majority of the Kaltura Building Block configuration is available in the KAF Admin Console. Please refer to the Kaltura Video Building Block 5 for Blackboard Learn 9.x Setup Guide for configuration details.

To configure common settings of the Kaltura Video Building Block

1. In the Kaltura Configuration page, click on Kaltura Video Building Block Configuration.
   The Configure Kaltura page opens.
   
2. Check Show deep link url to enable deep link url for content embed via a Kaltura Mashup item.
3. Under Institution playlist embed code, paste the embed code of the playlist to be displayed in the New On Campus module on the Institution page.
   Note: To add the New On Campus to the My Institution page, go to My Institution > Add Module and add the New on Campus module to your institution's homepage.
4. Check “Don’t copy students’ media from the Course Gallery when copying course”, to prevent students’ content from being copied when copying a course in Blackboard Learn.
5. Check Use unsecure connection when copying courses to copy a course over on HTTP even if the end point is configured on HTTPS. 
6. Click Submit.

Setting up Role Mapping

Role mapping configuration is described in detail in the Kaltura Video Building Block 5 for Blackboard Learn 9.x Setup Guide and is critical for properly setting up the integration.

FAQ About Tables

Q: Does the Building Block for Blackboard Learn integration create and maintain local data (tables, etc.)?

A: Only the configuration is stored locally by using Learn's internal infrastructure where blocks can store their configuration.

Q: Does the Building Block for Blackboard Learn integration alter tables as part of normal operation?

A: No.

[/collapsed]

[collapsed title="Migrating from Earlier Versions of Kaltura Video Building Block"]

Migrating from Earlier Versions of Kaltura Video Building Block

Kaltura recommends using the latest version of the Kaltura Video Building Block. To migrate from Kaltura Video Building Block version before 4.18 or below, please contact your Account Manager or Project Manager.

[/collapsed]

[collapsed title="Migrating from Kaltura Video Building Block Version 4 to 5"]

Migrating from Kaltura Video Building Block Version 4 to 5

Kaltura Video Building Block versions 5 uses a different data structure than previous versions. The change allows for several advanced capabilities. To preserve Kaltura-related properties of previous videos, run a one-time migration process from version 4 to version 5.

To migrate from version 4 to version 5

1. Login as administrator and go to System Admin>Building Blocks>Installed Tools> and select Kaltura Integration.
2. Click the right arrow and select Uninstall from the drop down.
3. Delete the current (previous) Building Block.
4. Select Upload Building Blocks.
5. Browse to the new Building Block Package location and click Submit to upload the new Building Block and activate it.
   The new Kaltura Building Block (with the new build number) is displayed in the System Admin tab > Kaltura Integration.
6. Click the Right arrow near Kaltura Integration and select ‘Settings’.
   The Kaltura Configuration window is displayed.
7. Select Kaltura Server Connection Configuration.
8. Enter the End Point URL (must be HTTPS) and the Admin Secret. The Admin Secret is found in the KMC > Integration Settings, and click Submit.
9. Press ‘Migrate older Kaltura videos to the new data structure’ link.

Wait until the process finishes (there will be a confirmation message indicating the migration completed successfully and the amount of courses that were migrated). Depending on the amount of courses that used Kaltura and the amount of videos, the migration process may take up to a couple of hours.

[/collapsed]

[collapsed title="Post Installation and Migration Tasks"]

Post Installation and Migration Tasks

Before you use the Kaltura Video Building Block for Blackboard Learn, you must be certain that the Kaltura Integration Tools are set.

To enable the Kaltura Integration Tool

1. Go to the System Admin tab > Tools
2. Search for Kaltura Integration.
3. Be certain that all of the system tools are turned ON. In the Kaltura Integration section.