Home

Generate Canvas course using OpenDSA-LTI web interface.

1. If you don't have OpenDSA-DevStack installed, follow the instructions here for setup. If you already have it installed, follow the instructions here to get it up to date.
2. After you are done you should have OpenDSA-LTI server running. Go to https://192.168.33.10:9292 to make sure your application is up and running.
3. Open a new terminal and do the following to process background jobs:
   • cd ~/OpenDSA-DevStack
   • vagrant ssh
   • cd /vagrant/OpenDSA-LTI
   • rake jobs:work
4. Login to the application with admin account (admin@codeworkout.org, pass: 'adminadmin').
5. Click Upload Books in the navigation bar, then click Choose File. Navigate to OpenDSA-DevStack/OpenDSA-LTI and choose test_CS3.json. Click Submit File.
6. Go to https://canvas.instructure.com/ and create a course and give it OpenDSA-LTI name. Copy the course ID from the URL, you will use it later.
7. Go to admin area, select Course Offerings under University-oriented menu. There are six course offerings in three semesters, Spring-2016 (1/1-5/31), Summer-I (6/1-7/15), and Summer-II (7/16-8/15). Select the correct course offering based on your current time and link it to Canvas instance. Also modify LMS COURSE CODE to be 'OpenDSA-LTI' and LMS COURSE NUM to the course ID you copied in point #6.
8. Under ODSA Books menu select Inst Book to link the book you have just uploaded to the course offering.
9. Under LMS config menu go to Lms Access to give instructor Ima Teacher access to the Canvas instance.
10. Log out and log in again using instructor account (example-1@railstutorial.org, pass: 'hokiehokie'. This is Ima Teacher account) and update the access token through LMS Access view. First click on the instructor email address in the navigation bar, then hit Update Access Token. If you don't have Canvas access token follow the instructions here.
11. From the application main page click Course button and navigate to the course offering view. Under OpenDSA tab you will find the book linked to that offering. You can click Configure Book button to go to book configuration view which will allow instructor to add/remove book modules and chapters. It also allows Instructor to define exercises points and due dates. Compile Book button should generate the book html files on the server file system and generate course on the linked Canvas instance as well. Click Compile Book button and you should see the progress bar moving forward while the course is being generated in Canvas.
12. At this point the book is generated in Canvas and linked to a compiled book on the server file system. But Since we don't have the book compilation step automated yet, you should compile the book manually. I've updated the Makefile for CS3 book to compile it in the right folder. So you need to open a new terminal and do the following:
    • cd ~/OpenDSA-DevStack
    • vagrant ssh
    • cd /vagrant/OpenDSA
    • make pull
    • make CS3
13. Once the compilation step is done, go to Canvas and open course modules you should find the book pushed and published.