Upgrading Opencast from 19.x to 20.x

This guide describes how to upgrade Opencast 19.x to 20.x. In case you need to upgrade older versions of Opencast, please refer to the documentation of those versions first.

1. Read the release notes
2. Stop your current Opencast instance
3. Replace Opencast with the new version
4. Review the configuration changes and adjust your configuration accordingly
5. Upgrade the database using the upgrade script (if needed)
6. Start Opencast
7. Rebuild the index (if needed)

Configuration Changes

Check for changes in the configuration and apply those relevant to your setup to your files. You can use the following command to list all changes:

git diff origin/r/19.x origin/r/20.x -- etc/

The most important changes are:

• Paella 8 is now the default Paella version. Paella 7 is scheduled for removal in Opencast 21. [#7214]
• The circular dependency between index and list providers has been eliminated. The configuration for the ACL additional actions list provider has been moved to the organization configuration. #7128
• JMX beans appear to be unused, and there are performance concerns surrounding JMX statistics. Therefore, they have been removed to simplify our code. [#7317]
• Disable service states by default. These tended to cause more issues in modern systems. Functionality is still present, just disabled by default. [#7450]
• The configuration option "heartbeat.interval" was removed from etc/org.opencastproject.serviceregistry.impl.JobDispatcher.cfg Furthermore, only dispatching nodes will have a heartbeat from now on. [#7311]
• All capture agent inputs are now preselected when scheduling a new event in the Admin UI [Admin Interface #1566]
• Whether you were uploading or scheduling a new event in the Admin UI, the "Create Event" modal would always offer you workflows tagged with either "upload" or "schedule". Now if you are uploading, you only get workflows tagged with "upload". And if you are scheduling, you only get workflows tagged with "schedule". [Admin Interface #1567]
• A new config option to filter available roles in the Admin UI access policy dropdowns was added. Allows you to effectively remove catgories of roles (like ROLE_GROUP) from the dropdowns to make them more usable. [Admin Interface #1561] [#7541]
• The editor thumbnail view has been improved. [Editor #1663]

Database Upgrade

A database upgrade for 20.x is not required if upgrading from an 19.x system. Upgrading from a version prior to 19.x may require a database upgrade, follow the corresponding upgrade guides for details.

Index Rebuild

An index rebuild for 20.x is not required if upgrading from an 19.x system. Upgrading from a version prior to 19.x may require an index rebuild, follow the corresponding upgrade guides for details.