Skip to main content
pdf?stylesheet=default
Blackboard Help

Data Source Keys

When using Blackboard Learn - Enterprise Edition, all data that is moved to the Blackboard Learn database can be tagged with a data source identifier, called a data source key, so that the dataset can be managed using the snapshot/bin tool. For example, you may choose to identify all Fall 2009 records imported from CE 4 using the data source key “CE_FALL_2009” and all Spring 2010 records using the data source key “CE_SPRING_2010.”

How to Check for Existing Data Source Keys

Administrators can check for the existence of a data source key using the command line of the Blackboard Learn server.

  1. Log in to the Blackboard Learn server with system administrator privileges.
  2. Navigate to the snapshot\bin directory using the following command:

    UNIX:

    cd /usr/local/blackboard/apps/snapshot/bin

    Windows:

    cd \blackboard\apps\snapshot\bin

  3. List all existing data source keys using the following command.
  4. UNIX:

    ./dsm.sh –f LIST

    Windows:

    dsm.cmd –f LIST

How to Create a Data Source Key

Administrators can create a new data source key using the command line of the Blackboard Learn server. Data source keys are created using the Data Source Management Tool.

  1. Log in to the Blackboard Learn server with system administrator privileges.
  2. Navigate to the snapshot\bin directory using the following command.

    UNIX:

    cd /usr/local/blackboard/apps/snapshot/bin

    Windows:

    cd c:\blackboard\apps\snapshot\bin

  3. Create the new data source key using the following command.

    The data source key can contain only letters, numbers, and underscores.
    The data source key cannot contain spaces.

    UNIX:

    ./dsm.sh –f CREATE –b data source key -d "description"

    For example:

    ./dsm.sh –f CREATE –b CE_FALL_2009 –d "All Fall 2009 Sections from CE migration to Learn"

    Windows:

    dsm.cmd –f CREATE –b data source key -d "description"

    For example:

    dsm.cmd –f CREATE –b CE_FALL_2009 –d "All Fall 2009 Sections from CE migration to Learn"