Skip to content

Latest commit

 

History

History
143 lines (113 loc) · 13.8 KB

dev_op_release_notes.rst

File metadata and controls

143 lines (113 loc) · 13.8 KB

Open edX Sumac Developer & Operator Release Notes

These are the developer & operator release notes for the Sumac release, the 19th community release of the Open edX Platform, spanning changes from May 10, 2024 to November 5th, 2024. You can also review details about :doc:`../index` or learn more about the Open edX Platform.

To view the end-user facing docs, see the :doc:`feature_release_notes`.

Breaking Changes

No breaking changes in Sumac.

No breaking changes in Sumac.

User Facing Experiences

See the :doc:`feature_release_notes` for more detail on user-facing changes in this release.

Administrators & Operators

  • Most search functionality included in the core platform now supports Meilisearch as an alternative to Elasticsearch. For instances deployed using Tutor, only Meilisearch is supported, and Tutor will automatically provision Meilisearch and create the indexes during the upgrade.
    • Two recent features, Studio Course Search and the new Content Libraries (beta), require Meilisearch and will be hidden from the UI if Meilisearch is not available. (For the Content Libraries beta, this affects only the UI - developers can still use the APIs without Meilisearch.)
    • The new Content Libraries (beta) can be hidden entirely in Sumac by setting the waffle flag contentstore.new_studio_mfe.disable_new_libraries to "Yes". This option will be removed in Teak.
    • After upgrading, if you wish to use the new Content Libraries (beta) or Studio Course Search features, you will need to run manage.py cms reindex_studio --experimental --incremental to populate the new Studio Search index with your existing content (courseware/libraries). Studio search results will be incomplete until this command has finished.
    • A new media storage setting is required for new Content Libraries. This should be specified as OPENEDX_LEARNING['MEDIA']. Tutor will provide this setting automatically, and can be used as an example for those who are running different infrastructure. For those not running Tutor, please ensure that the file storage location is not publicly accessible.
  • Course assets are now served by a view rather than a middleware
    • Background: The LMS/CMS previously handled course asset requests (asset-v1: andc4x URLs) via a middleware called StaticContentServer. This middleware has been converted to a view.
    • Action: If your deployment has a custom MIDDLEWARE list in Django, you will need to remove this item at the time of upgrade to Sumac. Otherwise, no action is needed.
  • Ubuntu 22.04 Related Operators Note
    • PR
    • In newer versions of ubuntu the MD4 hashing algorithm is disabled by default. To enable it the openssl config needs to be updated in a manner similar to what's being done here. Alternatively, you can set the FEATURES['ENABLE_BLAKE2B_HASHING'] setting to True which will switch to a newer hashing algorithm where MD4 was previously used.
      Because this hashing is being used as a part of the edx-platform caching mechanism, this will effectively clear the cache for the items that use this hash. The will impact any items where the cache key might have been too big to store in memcache so it's hard to predict exactly which items will be impacted.
  • Added override options to commerce related CTA URLs in edx-platform
    • Background: Extension points have been added have been added to commerce app in: PR1, PR2 so Open edX community members who wants to extend the commerce functionality can do so without explicitly adding code into edx-platform codebase. For more information into extension points see Pluggable override section in Extension Points.
    • Additional Considerations: Commerce app itself is slated for deprecation. See the associated DEPR ticket.

  • courseware.enable_navigation_sidebar is now enabled by default. It was disabled by default in Redwood.

  • New Forums Implementation (migration from Ruby to Python forums backend)

New And Updated Settings and Toggles

Removed Settings and Toggles

COURSEGRAPH_DUMP_COURSE_ON_PUBLISH FEATURESENABLE_LIBRARY_AUTHORING_MICROFRONTEND FEATURESENABLE_V2_CERT_DISPLAY_SETTINGS commerce.transition_to_coordinator.checkout commerce.transition_to_coordinator.refund contentstore.library_authoring_mfe discussions.enable_reported_content_notifications learner_dashboard.enable_b2c_subscriptions notifications.enable_coursewide_notifications notifications.enable_notifications_filters notifications.enable_ora_staff_notifications notifications.show_notifications_tray studio.enable_course_update_notifications BLOCKSTORE_BUNDLE_CACHE_TIMEOUT BUNDLE_ASSET_STORAGE_SETTINGS BUNDLE_ASSET_URL_STORAGE_KEY BUNDLE_ASSET_URL_STORAGE_SECRET BLOCKSTORE_BUNDLE_CACHE_TIMEOUT COURSEGRAPH_CONNECTION COURSEGRAPH_JOB_QUEUE

Other Operator Changes

Deprecations & Removals

Developer Experience

  • With the launch of the new Content Libraries feature, many new or updated APIs are now ready for developers to start using (though some are in beta and may change). This includes the entire Learning Core API (Components, Contents, Publishing, Collections), Content Tagging API, Content Libraries API, and Learning Core XBlock API. Most of these APIs (other than tagging) are only useful in content libraries at the moment, but when courseware is eventually moved to Learning Core as well, the Learning Core APIs will be recommended way to work with all learning content in the platform, and the modulestore APIs will be deprecated.

Researcher & Data Experiences

Upgrading Aspects to v1.3.1 will get you the latest Aspects functionality with Sumac. See the upgrade instructions here.

Known Issues