Connecting LMS To A Remote Gradebook

This guide outlines the steps necessary to configure LMS to communicate with a remote gradebook.

1. Make the following edits to your lms.env.json file (typically found in the /edx/app/edxapp directory)
   1. Add "ENABLE_INSTRUCTOR_REMOTE_GRADEBOOK_CONTROLS": true to FEATURES .
   2. Add this value at the top level (i.e.: not in FEATURES):

      "REMOTE_GRADEBOOK": {
          "URL": "https://lmodproxyqa.odl.mit.edu/edx_grades",
          "DEFAULT_NAME": "STELLAR:/project/mitxdemosite"
      }
      

      lmodproxyqa.odl.mit.edu is a live remote gradebook that we use for testing. It also has a web app, so you can navigate to it directly and browse the remote gradebook data.
2. Add REMOTE_GRADEBOOK_USER and REMOTE_GRADEBOOK_PASSWORD keys at the top level in lms.auth.json. Contact ODL devops or another developer to get the correct values for those two keys.
3. Make sure your user is staff for your test course, then navigate to the "Remote Gradebook" tab in the instructor dashboard (example: http://localhost:8000/courses/course-v1:edX+DemoX+Demo_Course/instructor#view-remote_gradebook). The "Section name:" dropdown is populated with existing remote gradebook sections upon page load, so if you eventually see some options loaded in there, you know that LMS is successfully communicating with the remote gradebook.