-
Notifications
You must be signed in to change notification settings - Fork 14
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
48 changed files
with
295 additions
and
295 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,2 @@ | ||
recursive-include tutorvision/patches * | ||
recursive-include tutorvision/templates * | ||
recursive-include tutorcairn/patches * | ||
recursive-include tutorcairn/templates * |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,4 +1,4 @@ | ||
Tutor Vision: scalable, real-time analytics for Open edX | ||
Tutor Cairn: scalable, real-time analytics for Open edX | ||
======================================================== | ||
|
||
TODO: Sweet readme | ||
|
@@ -8,74 +8,74 @@ Installation | |
|
||
:: | ||
|
||
tutor license install tutor-vision | ||
tutor license install tutor-cairn | ||
|
||
Usage | ||
----- | ||
|
||
:: | ||
|
||
tutor plugins enable vision | ||
tutor plugins enable cairn | ||
tutor local quickstart | ||
|
||
Create an admin user to access the frontend:: | ||
|
||
# You will be prompted for a new password | ||
tutor local run vision-superset superset fab create-admin --username yourusername --email [email protected] | ||
tutor local run cairn-superset superset fab create-admin --username yourusername --email [email protected] | ||
|
||
You can then access the frontend with the user credentials you just created. Open http(s)://vision.<YOUR_LMS_HOST> in your browser. When running locally, this will be http://vision.local.overhang.io. The admin user will automatically be granted access to the "openedx" database in Superset and will be able to query all tables. | ||
You can then access the frontend with the user credentials you just created. Open http(s)://data.<YOUR_LMS_HOST> in your browser. When running locally, this will be http://data.local.overhang.io. The admin user will automatically be granted access to the "openedx" database in Superset and will be able to query all tables. | ||
|
||
Management | ||
---------- | ||
|
||
Most of your users should probably not have access to all data from all courses. To restrict a given user to one or more courses or organizations, select the course IDs and/or organization IDS to which the user should have access and create a user with limited access to the datalake:: | ||
|
||
tutor local run vision-clickhouse vision createuser --course-id='course-v1:edX+DemoX+Demo_Course' --org-id='edX' yourusername | ||
tutor local run cairn-clickhouse cairn createuser --course-id='course-v1:edX+DemoX+Demo_Course' --org-id='edX' yourusername | ||
|
||
Then, create the corresponding user on the frontend:: | ||
|
||
tutor local run vision-superset vision createuser yourusername [email protected] | ||
tutor local run cairn-superset cairn createuser yourusername [email protected] | ||
|
||
Your frontend user will automatically be associated to the datalake database you created, provided they share the same name. | ||
|
||
Vision comes with a convenient pre-built dashboard that you can add to any user account:: | ||
Cairn comes with a convenient pre-built dashboard that you can add to any user account:: | ||
|
||
tutor local run vision-superset vision bootstrap-dashboards yourusername /app/bootstrap/courseoverview.json | ||
tutor local run cairn-superset cairn bootstrap-dashboards yourusername /app/bootstrap/courseoverview.json | ||
|
||
Course block IDs and names are loaded from the Open edX modulestore into the datalake. After making changes to your course, you might want to refresh the course structure stored in the datalake. To do so, run:: | ||
|
||
tutor local init --limit=vision | ||
tutor local init --limit=cairn | ||
|
||
Or, if you want to avoid running the full plugin initialization:: | ||
|
||
tutor local run \ | ||
-v $(tutor config printroot)/env/plugins/vision/apps/openedx/scripts/:/openedx/scripts \ | ||
-v $(tutor config printroot)/env/plugins/vision/apps/clickhouse/auth.json:/openedx/clickhouse-auth.json \ | ||
-v $(tutor config printroot)/env/plugins/cairn/apps/openedx/scripts/:/openedx/scripts \ | ||
-v $(tutor config printroot)/env/plugins/cairn/apps/clickhouse/auth.json:/openedx/clickhouse-auth.json \ | ||
lms python /openedx/scripts/importcoursedata.py | ||
|
||
When running on Kubernetes instead of locally, most commands above can be re-written with `tutor k8s exec service "command"` instead of `tutor local run service command`. For instance:: | ||
|
||
# Privileved user creation | ||
tutor k8s exec vision-superset "superset fab create-admin --username yourusername --email [email protected]" | ||
tutor k8s exec cairn-superset "superset fab create-admin --username yourusername --email [email protected]" | ||
# Unprivileged user creation | ||
tutor k8s exec vision-clickhouse "vision createuser --course-id='course-v1:edX+DemoX+Demo_Course' --org-id='edX' yourusername" | ||
tutor k8s exec vision-superset "vision createuser yourusername [email protected]" | ||
tutor k8s exec cairn-clickhouse "cairn createuser --course-id='course-v1:edX+DemoX+Demo_Course' --org-id='edX' yourusername" | ||
tutor k8s exec cairn-superset "cairn createuser yourusername [email protected]" | ||
|
||
Development | ||
----------- | ||
|
||
|
||
To reload Vector configuration after changes to vector.toml, run:: | ||
|
||
tutor config save && tutor local exec vision-vector sh -c "kill -s HUP 1" | ||
tutor config save && tutor local exec cairn-vector sh -c "kill -s HUP 1" | ||
|
||
To explore the clickhouse database as root, run:: | ||
|
||
tutor local run vision-clickhouse vision client | ||
tutor local run cairn-clickhouse cairn client | ||
|
||
To launch a Python shell in Superset, run:: | ||
|
||
tutor local run vision-superset superset shell | ||
tutor local run cairn-superset superset shell | ||
|
||
|
||
License | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
File renamed without changes.
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
# Cairn | ||
{{ CAIRN_HOST }}{% if not ENABLE_HTTPS %}:80{% endif %} { | ||
reverse_proxy nginx:80 | ||
} |
Oops, something went wrong.