Frequently Asked Questions
How can I get a translation of the Open edX platform into a different spoken language
We are using Transifex as our translation platform. We have a number of translations in progress now. Please go to our Transifex page at: https://www.transifex.com/projects/p/edx-platform/
I haven't received the email to activate my newly created account
When running with the development environment settings, registration emails are not sent out. However, the URL with their activation key is logged to the console. Just copy it from there and paste it into the browser.
How do I upgrade to a newer version
You can reuse the same playbook which you used for installation. Just put use the deploy tag with "--tags deploy".
How do I specify the image for my course?
Using Studio, upload an image named images_course_image.jpg
How do I restrict who can create new courses?
How to make the site accessible to external devices?
Modify the server deployment commands to include the IP address, like this:
rake cms[dev,0.0.0.0:8001] and
0.0.0.0:80 is a shortcut meaning "bind to all IP addresses this computer supports". 127.0.0.1:80 makes it bind only to the "lo" or "loopback" interface. If you have just one NIC with just one IP address, you could bind to it explicitly with, say, "192.168.1.1:80" (if 192.168.1.1 was your IP address), or you could list all the IPs your computer responds to, but 0.0.0.0:80 is a shortcut for that.
How can I change a setting?
For devstack, the simplest way is to create a private.py in cms/envs or lms/envs, settings there will override others.
How can I change my platform name or site image?
Why use three different databases (MySQL, SQLite & MongoDB) rather than a single one?
'Courseware content' is stored in MongoDB and user-data (e.g. user tables, user state, authN, authZ, etc.) are stored in a relational database. For localdev environments, SQLite is used for the relational database to keep dependencies simple, for production environments mysql is used as the relational database. So there's actually really just two rather than three, from that perspective.
In the history of edX, the use of MongoDB as a contentstore is relatively new (previous architectures used XML-based files from the filesystem) and it seemed like a good match since courseware are well modeled as flexible JSON documents. The use of relational datastores for user-data predated the transition of the contentstores and we did not migrate those databases to a NoSQL platform.
Are the CMS and LMS supposed to use the same database or separate ones when in production?
CMS and LMS should share the same databases (mysql/RDS for user-data and MongoDB for courseware content and discussion forums) for any deployments. SSO is accomplished by both Django Apps using shared cookies (e.g. *.edx.org, in our case) as well as the same Session database. So if your deployment is on *.example.org, then the cookie domain should be set to .example.org, where the LMS is on www.example.org and the CMS is on studio.example.org.
With django-admin syncdb and migrate - is that run both in LMS and CMS or is it sufficient to run once?
Yes, there are no new CMS specific tables in Django, so you should just have to run it once.
Why doesn't the preview button work in Studio
You need to put the server name in the PREVIEW_LMS_BASE variable, found in the cms.env.json and lms.env.json files.