Install from Repository (Red Hat Enterprise Linux 7.x, CentOS 7.x, Scientific Linux 7.x)
This guide is for EL7 only. There is a separate CentOS 8 and Red Hat Enterprise Linux 8 guide.
This guide is based on an RPM software repository available for Red Hat-based Linux distributions provided by Osnabrück University. This repository provides preconfigured Opencast installations and all necessary 3rd-party-tools.
Note that it may take some time (usually about two weeks after a new release is out) before the RPMs are available. Watch for announcements on the users list or just check which versions are available in the repository.
- CentOS 7.x (x86_64)
- Red Hat Enterprise Linux 7.x (x86_64)
- Scientific Linux 7.x (x86_64)
Other architectures like i386, i686, arm, … are not supported.
First you have to install the necessary repositories:
yum install -y https://pkg.opencast.org/rpms/release/el/7/oc-09/noarch/opencast-repository-9-1.el7.noarch.rpm
It might take some time after the release of a new Opencast version before the RPMs are moved to the stable repository.
Until then, you can use
/etc/yum.repos.d/opencast-testing.repo instead to get the latest version.
Note that the testing repository is an additional repository and still requires the stable repository to be active.
You can check if the repositories were successfully enabled using:
yum repolist enabled
For a basic all-in-one installation just run:
yum install opencast-allinone
This will install the default distribution of Opencast and all its dependencies. For more options, see the advanced installation section below.
Install Apache ActiveMQ
The Apache ActiveMQ message broker is required by Opencast. It can be run on the same machine as Opencast. Install ActiveMQ by running:
yum install activemq-dist
A prepared configuration file for ActiveMQ comes with Opencast. It should suffice for an all-in-one installation and can be copied to replace the default configuration:
cp /usr/share/opencast/docs/scripts/activemq/activemq.xml /etc/activemq/activemq.xml
Then start and enable ActiveMQ by running:
systemctl start activemq systemctl enable activemq
More information about how to properly set up ActiveMQ for Opencast, cluster installations in particular, can be found in the message broker configuration documentation.
Opencast uses Elasticsearch as a search index and a cache for quick access to some data from user interfaces. Make sure to install it on the node which also serves the admin interface.
yum install elasticsearch-oss
Opencast automatically configures the search index once it is connected. The default configuration will work for a local Elasticsearch with no modifications. Just make sure to start and enable the service:
systemctl start elasticsearch systemctl enable elasticsearch
Make sure to set your hostname, login information and other configuration details by following the
Finally, start and enable Opencast by running:
systemctl start opencast.service systemctl enable opencast.service
The basic installation will give you an all-in-one Opencast distribution on a single server. For production, most users prefer deploying Opencast as a cluster, which allows for a better workload distribution. You can list all available Opencast packages/distributions with:
yum search opencast
This will list all available Opencast distributions in the form
Some commonly used distributions are:
Packages will automatically upgrade to the latest minor version in a release series when running
They do not automatically upgrade the latest major version.
This is intentional since additional migration steps might be required.
For example, if you install Opencast 9.1, you get the latest 9.x release, but no 10 release.
These instructions will upgrade Opencast to a new version which may be incompatible with older versions. Thus, a rollback might not be possible. If you are performing this on a production system, please ensure you have valid backups prior to taking the next steps.
For an RPM-based upgrade, first, stop Opencast:
systemctl stop opencast.service
Then, replace the repository
rm -f /etc/yum.repos.d/opencast*.repo* || : yum install -y https://pkg.opencast.org/rpms/release/el/7/oc-09/noarch/opencast-repository-9-1.el7.noarch.rpm
Upgrade to the new Opencast package by running:
yum install opencast-<distribution>
At this point you must follow the relevant upgrade instructions, prior to starting Opencast again.
To uninstall Opencast, you can run:
yum remove opencast
This will not touch your created media files or modified configuration files. If you want to remove them as well, you have to do that by yourself.
# Remove media files (default location) rm -rf /srv/opencast # Remove local db, search indexes and working files rm -rf /var/lib/opencast # Remove configuration files rm -rf /etc/opencast # Remove logs rm -rf /var/log/opencast
If you try to install Opencast but yum is complaining about missing dependencies, please check if the epel repository is
really activated on your system. Some distributions come with epel preinstalled but disabled. The installation of the
epel-release package will not fix this. You can check what repositories are installed and enabled by executing
yum repolist enabled which should give you a list with epel, opencast and opencast-noarch in it. To enable a
repository, edit the configuration file in