Put stuff here that we have to remember when we start packaging up for Koa. Especially important is information that system installers or operators will need to know. Please include your name when you add an item, so that we can get back to you with questions.
The Koa release timeline is date-based rather than feature-based:
Sep 28, 2020 : community testing of the master branches, on a best effort basis.
Nov 9, 2020 : creation of the open-release/koa.master branch and the open-release/koa.alpha1 tag. New code on master after this date will not be part of Koa; only fixes will be cherry-picked to the open-release/koa.master branch.
Dec 9, 2020 : Koa release.
Installation and Operations
MySQL 5.6 → 5.7 upgrade
TODO: coordinate with @Natalia Berdnikov to produce upgrade notes for Juniper users.
Upgrading a MySQL docker container
As described in the official instructions, upgrading an existing MySQL 5.6 docker container is as simple as running:
docker exec mysql bash -e -c "mysql_upgrade -u root -p"
Elasticsearch 1.5.2 → 7.0 upgrade
This upgrade was canceled and Koa will still be running Elasticsearch 1.5.2. The upgrade to Elasticsearch 7.8 is scheduled for Lilac.
@Felipe Espinozawrote a convenient script to dump the versions of the various services from the native installation: version.py
This change mostly affects the location of imports other than the LMS/CMS constants (moved from openedx/core/djangoapps/plugins or openedx/core/lib/plugins to edx_django_utils/plugins).
LinkedIn Add to Profile Configuration (and Site Configurations)
The LinkedIn Add to Profile API for certificates was updated and as a result, we were able to make some updates to our logic surrounding this functionality. The change that requires updating on your part is updating your LinkedinAddToProfileConfiguration company_identifierfield (if you have that configuration defined). If you instead use Site Configurations to manage yourSOCIAL_SHARING_SETTINGS, then you will want to update the LINKEDIN_COMPANY_ID.
The value will be going from a value that looks like 0_0dPSPyS070e0HsE9HNz_13_d11_ to an integer, such as 1337.
This change will allow for the Add to Profile for certificates to autofill the form and if your Company Identifier is defined, it will link to your LinkedIn page.
As a part of DEPR-43 work, a migration was added that will drop all tables related to shoppingcart.
To disable forum digest features, you now just need to set the Django Setting FEATURES['ENABLE_FORUM_DAILY_DIGEST'] to False.
You used to also need to set the waffle flag edx_discussions.enable_forum_daily_digest to False, but that has been replaced with the Django Setting and the waffle flag has been removed in this PR. @Robert Raposa
The COURSE_OUTLINE_PAGE_FLAG and UNIFIED_COURSE_TAB_FLAG feature flags have been deprecated (see PR and deprecation ticket DEPR-108). They were replaced by their negative equivalent: DISABLE_COURSE_OUTLINE_PAGE_FLAG and DISABLE_UNIFIED_COURSE_TAB_FLAG which default to False. Thus, if you manually set the older flags (which defaulted to True) to False, you should set the new flags to True.
The symlinks in /edx/bin to python, pip, and django-admin.py for each service were removed, as a new version of virtualenv used to create the virtual environments prevents such links from working correctly (in exchange for reliably creating working environments even if the newest releases of pip and setuptools have some problems, among other optimizations and fixes). Any scripts that currently call links such as “/edx/bin/python.edxapp” should be updated to instead call the binaries targeted by such links (in the previous example, “/edx/app/edxapp/venvs/edxapp/bin/python”). The PR that removed them has some additional background notes.