Blackboard Migration Tool

Information

• This document explains how to install the import/migration tool for Sakai 2.2.

Installation

1. Get command line access to your Sakai 2.2 source directory
2. Checkout the import code from the location below into your source directory root
   Run the following SVN command in the sakai source root directory to checkout the migration code

   svn co https://source.sakaiproject.org/contrib/migration/import/trunk/import import
   

   • This will create the import directory
   • You can update this code later if needed by running svn update in the import directory
3. Update the site-manage code to use the import code
   1. Export the code changes from contrib/migration
      Run the following SVN command in the sakai source root directory to export the site-manage changes

      svn export https://source.sakaiproject.org/contrib/migration/import/trunk/site-manage/ --force
      

      • WARNING: This will overwrite some files and take them out of svn control
4. Run maven sakai from the sakai source root directory to rebuild and deploy sakai 2.2
5. startup Sakai

   Samigo dependency Unfortunately, there is a dependency in the import code on a feature of Samigo that is not available in Sakai 2.2.x. You should either install Sakai r14325, which adds the Samigo QTI service, or remove references to the Samigo dependency in the import code. This is done by deleting impl/src/java/org/sakaiproject/impl/handlers/SamigoHandler.java and removing the Samigo dependencies in impl/project.xml and pack/project.xml

Testing to see if import works

1. Login to your running Sakai instance as admin
2. Use Worksite Setup to create a new project site
   • Make sure you select all of the tools for content you are planning to import
   • At least choose Resources
3. Select the Site Info tool in the new site
4. Choose Import from File at the top
5. Browse for an export file in one of the appropriate formats
   • Make sure the export file has content that lines up with the tools in the course
6. Click Import to import the file into the course
7. Check your site tools for imported content

Uninstall

1. Get command line access to your Sakai 2.2 source directory
2. Remove the import directory from your Sakai 2.2 source directory
3. Remove the site-manage directory from your Sakai 2.2 source directory
4. Run svn update to reimport a clean version of site-manage
5. Run maven sakai from the sakai source root directory to rebuild and deploy sakai 2.2

Copyright Created by Aaron Zeckoski (c)2006 This work is licensed under a Creative Commons Attribution-ShareAlike 2.5 License