bigbluebutton-Github/bbb-lti
2013-06-07 16:07:40 -04:00
..
grails-app Fixed a bug on full name composition 2013-06-07 16:07:40 -04:00
src/java bbb-lti updated in preparation for the 0.81-beta1 release 2013-04-19 17:52:46 -04:00
test/unit bbb-lti 0.1: Added functionality for passing IMS Global Certification test 2012-10-24 16:04:40 -04:00
web-app bbb-lti updated in preparation for the 0.81-beta1 release 2013-04-19 17:52:46 -04:00
.classpath bbb-lti 0.1: BigBlueButton LTI interface, Initial commit 2012-10-11 11:52:41 -04:00
application.properties bbb-lti(v0.1.1): Added extended mode to support voicebridge, record and duration parameters 2013-01-23 17:46:31 -05:00
build.xml Updates to build.xml to get lti to build under script 2012-10-28 15:25:17 -04:00
ivy.xml bbb-lti 0.1: BigBlueButton LTI interface, Initial commit 2012-10-11 11:52:41 -04:00
ivysettings.xml bbb-lti 0.1: BigBlueButton LTI interface, Initial commit 2012-10-11 11:52:41 -04:00
lti-test.launch bbb-lti 0.1: BigBlueButton LTI interface, Initial commit 2012-10-11 11:52:41 -04:00
lti.launch bbb-lti 0.1: BigBlueButton LTI interface, Initial commit 2012-10-11 11:52:41 -04:00
lti.nginx Added nginx configuration for LTI 2012-10-28 21:54:15 -04:00
lti.tmproj bbb-lti 0.1: BigBlueButton LTI interface, Initial commit 2012-10-11 11:52:41 -04:00
README.rst Update bbb-lti README to note trailing slash issue 2013-02-25 19:14:35 -05:00

#
# BigBlueButton open source conferencing system - http://www.bigbluebutton.org/
#
# Copyright (c) 2012 BigBlueButton Inc. and by respective authors (see below).
#
# This program is free software; you can redistribute it and/or modify it under the
# terms of the GNU Lesser General Public License as published by the Free Software
# Foundation; either version 3.0 of the License, or (at your option) any later
# version.
#
# BigBlueButton is distributed in the hope that it will be useful, but WITHOUT ANY
# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
# PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public License along
# with BigBlueButton; if not, see <http://www.gnu.org/licenses/>.
#

BigBlueButton LTI Integration
=============================
BigBlueButton is an open source web conferencing system that enables universities and colleges to deliver a high-quality learning experience to remote students.  

These instructions describe how to install the BBB-LTI Plugin into a BigBlueButton server.

With this plugin you can
    - Enable a BigBlueButton server to be a LTI provider 
    - With a LMS acting as a consumer, allow users to create and join meetings using LMS external tools

Development
=============
bbb-lti is a grails project that can be compiled using the bbb-web components installed in any BigBlueButton development environment.
    
To generate the war file
    grails clean
    grails war

Deployment
=============
Place the war file into the tomcat webapps directory and restart tomcat
        
    sudo cp lti-0.1.war /var/lib/tomcat6/webapps/lti.war
       
Configure the properties
        
    sudo vi /var/lib/tomcat6/webapps/lti/WEB-INF/classes/lti.properties

Edit the URL and Salt of the BigBlueButton server you are going to connect to (NOTE: Remove any trailing slashes from the URL!)
    
    bigbluebuttonURL=http://yourbigbluebuttonserver.com/bigbluebutton
    
    bigbluebuttonSalt=yoursalt
        
Edit the LTI basic information
    
    ltiEndPoint=http://yourbigbluebuttonserver.com/lti/tool.xml
        
    ltiConsumers=demo:welcome,consumer1:secret1
    
Restart tomcat
        
    sudo service tomcat6 restart
        
When running on the BigBlueButton server, create the map to this new application on nginx
    
    

How to use the service
======================
You need:

    1.  A server running any LMS which is a LTI consumer compliant 
    2.  A BigBlueButton 0.8 server running on a separate server (not on the same server as your LMS)
    3.  A server running the plugin (It can be your bigbluebutton server or any other java application server)

Add a new external tool
    In the LMS create a new external tool using the parameters added in the configuration file
    Ej.
    Consumer Key: demo
    Shared Secret: welcome
    URL: http://yourbigbluebuttonserver.com/lti/tool.xml
    
The BigBlueButton roles are assigned according to the roles in the LMS.

MODERATOR
    -Faculty
    -urn:lti:instrole:ims/lis/Faculty
    -Instructor
    -urn:lti:instrole:ims/lis/Instructor
    -Mentor
    -urn:lti:instrole:ims/lis/Mentor
    -Administrator
    -urn:lti:instrole:ims/lis/Administrator
    
ATTENDEE
    -Student    
    -urn:lti:instrole:ims/lis/Student
    -Member
    -urn:lti:instrole:ims/lis/Member
    -Learner
    -urn:lti:instrole:ims/lis/Learner
    -Staff
    -urn:lti:instrole:ims/lis/Staff
    -Alumni
    -urn:lti:instrole:ims/lis/Alumni
    -ProspectiveStudent
    -urn:lti:instrole:ims/lis/ProspectiveStudent
    -Guest
    -urn:lti:instrole:ims/lis/Guest
    -Other
    -urn:lti:instrole:ims/lis/Other
    -Observer
    -urn:lti:instrole:ims/lis/Observer
    -None
    -urn:lti:instrole:ims/lis/None