Install from Source (Mac OS X)
These instructions outline how to install an all in one Opencast system on the Mac OS X operating system. Tested on OS X 10.9 Mavericks.
The installation on Mac OS X is not officially supported. Use this at your own risk.
Open a Terminal and switch to the directory, in which the Opencast installation should be placed, e.g.
~/develop/ or whatever you prefer.
Get Opencast source
You can get the Opencast source code by either downloading a tarball of the source code or by cloning the Git repository. The latter option is more flexible, it is easier to upgrade and in general preferred for developers. The prior option, the tarball download, needs less tools and you don't have to download nearly as much as with Git.
Cloning the Git repository:
git clone https://bitbucket.org/opencast-community/matterhorn.git cd matterhorn git tag <- List all available versions git checkout TAG <- Switch to desired version
Using the tarball:
Select the tarball for the version you want to install from the BitBucket downloads section under the "Tags" tab and download it directly from there or with the curl command specified below.
# Download desired tarball, replace [...] with the desired version curl -O https://bitbucket.org/opencast-community/matterhorn/get/[...].tar.gz tar xf [...].tar.gz
Please make sure to install the following dependencies.
Xcode jdk 7 or jdk 8 (recommended) ffmpeg >= 2.8 maven >= 3.1
Required (not necessarily on the same machine):
ActiveMQ >= 5.10 (older versions untested)
Required for text extraction:
tesseract >= 3
Required for hunspell based text filtering:
hunspell >= 1.2.8
Required for audio normalization:
sox >= 14.4 (with MP3, FLAC and OGG support)
You can download Xcode in the Mac App Store. JDK 8 for OS X is available from Oracle.
Homebrew is a package manager for OS X. For installation instruction see their website.
brew install maven brew install ffmpeg brew install apache-activemq brew install tesseract brew install hunspell brew install sox --with-lame --with-flac --with-libvorbis
Using pre-built binaries
Pre-built versions of most dependencies can be downloaded from the respective project website:
Switch to the opencast folder. If you downloaded the tarball, this is the folder you just unpacked (called something like
opencast-community-matterhorn-[...]). If you chose to download via git, use
cd matterhorn. You can proceed by building opencast (depending on the folder permissions, you might need to start the command with
mvn clean install
Please be patient, as building Opencast for the first time will take quite long.
Please follow the steps of the Basic Configuration guide. It will help you to set your host name, login information, etc. Be aware that the config files now reside in the build folders for the desired distribution. For the allinone distribution, this would be
/your/path/to/opencast/build/opencast-dist-allinone-[...]/etc/, again with
[...] representing the selected version.
As specified in the guide, make sure you replace the default ActiveMQ configuration with the one provided in
docs/scripts/activemq/activemq.xml. If you installed ActiveMQ using homebrew, you can find the installation path with
brew info activemq.
Make sure you have ActiveMQ running (unless you're running it on a different machine). Then you can start Opencast using the start-opencast script:
activemq start cd /your/path/to/opencast/ cd build/opencast-dist-allinone-[...] ./bin/start-opencast