Home

Python QTI Migration Tool

This tool has been modified to be used with the Instructure Canvas Learning Management System.

Canvas Setup Instructions

You need to have Python 3 installed in order to use the migration tool. Basically all Linux distributions come with a Python 3 interpreter these days, as well as OS X, so you shouldn't need to worry about installing it.

Running the tool also requires the lxml python library. The easiest way to install it would be to use the Python Package Index (pip), and simply run pip3 install lxml. Or you can install it with your local package manager: apt-get install python3-lxml.

This tool needs to be in the the vendor directory of your Canvas install in order for QTI importing to work. Once the package is there you need to make sure the migrate.py file is executable by the Canvas processes.

Setting up the migration tool with git:

sysadmin@appserver:~$ cd /path/to/canvas/vendor
sysadmin@appserver:/path/to/canvas/vendor$ git clone https://github.com/instructure/QTIMigrationTool.git QTIMigrationTool
sysadmin@appserver:/path/to/canvas/vendor$ cd QTIMigrationTool
sysadmin@appserver:/path/to/canvas/vendor/QTIMigrationTool$ chmod +x migrate.py

Once the tool is in the vendor directory you will need to restart (or start) the delayed jobs daemons:

sysadmin@appserver:~$ cd /path/to/canvas
sysadmin@appserver:/path/to/canvas$ script/delayed_job restart