Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

These are the instructions to get Hydrant Avalon up and running on a clean RHEL machine. Your mileage may vary for other Linux distributions.

Table of Contents
styleupper-roman
classoutline

Install

...

Avalon

Install developer tools

Install dependent packages required for dependencies to build properly.

Code Block
yum install gcc-c++ zlib-devel readline-devel openssl-devel java-1.7.0-openjdk

Install RVM, we'll use RVM to manage Ruby (http://rvm.io/) If it doesn't download right away it might ask you to download signatures.

Code Block
languagebash
curl -L https://get.rvm.io | bash -s stable --ruby

Reload shell environment using the instructions given in rvm's installation output.

Make sure ruby installed correctly

Code Block
languagebash
rvm list

Update rubygem

Code Block
languagebash
gem update --system

Install bundler for managing dependencies

Code Block
languagebash
gem install bundler

Install & setup Git

Install Git:

Code Block
yum install git
Info

The next step is for committers.

Create an account on github and set up SSH keys. Detailed For more help see the detailed instructions

Code Block
languagebash
cd ~/.ssh
ssh-keygen -t rsa -C "your_email@youremail.com"
cat id_rsa.pub #Add the output to your github account's list of keys

Install Matterhorn dependencies

First install subversion:

You'll need a couple Matterhorn dependencies installed: ffmpeg and MediaInfo.

Info

This may take a LONG time to run so have something else to keep you busy!

FFMPEG

Code Block
yum install subversion

Then download Matterhorn's dependency installation scripts:

Code Block
svn checkout http://opencast.jira.com/svn/MH/trunk/docs/scripts/3rd_party matterhorn_dependencies
cd matterhorn_dependencies

Read the README.txt file for instructions on how to run the ./menu3p installation script.

Info

This may take a LONG time to run so have something else to keep you busy!

 

...

ffmpeg

If installing ffmpeg with yum doesn't work, or you have dependency problems, you can try installing it from source.

Code Block
yum install libfaac-devel
git clone git://source.ffmpeg.org/ffmpeg.git ffmpeg
cd ffmpeg
./configure --enable-gpl --enable-libfaac --enable-libmp3lame --enable-libopencore-amrnb \
  --enable-libopencore-amrwb --enable-librtmp --enable-libtheora --enable-libvorbis \
  --enable-libvpx --enable-libx264 --enable-nonfree --enable-version3 --enable-x11grab
make

That configure statement might need to change. It worked for me, but it seems puppet has more options enabled.

If you're still having trouble, check felix/log/opencast.log and see if there are any exceptions. Also, go to felix/etc/config.properties and make sure matterhorn is pointing to the correct ffmpeg.

Mediainfo

Go to MediaInfo's website to install MediaInfo. #Someone should fill more out here.

Setup Avalon

 

Note

The next step may be slightly different depending on your operating system if you are not using RHEL6.  When running bundle install you may need to set: QMAKE=/usr/bin/qmake-qt4

Add the required dependencies so that all gems will install properly.

Code Block
yum install ruby-devel libxml2-devel libxslt libxslt-devel libcurl-devel sqlite-devel xorg-x11-server-Xvfb qt-webkit-devel

Go to your workspace, this . This command will download hydrant avalon source from github to a directoryThen run Run bundle install to install all of the necessary dependency gems.

Code Block
languagebash
git clone git@github.com:variations-on-video/hydrantavalonmediasystem/avalon.git
cd hydrantavalon

bundle install --gemfile=Gemfile.first
QMAKE=/usr/bin/qmake-qt4 bundle install

...

Code Block
languagebash
rake db:migrate
rake db:test:prepare

Install the hydra-jetty, hydrant avalon-felix, and hydrant avalon-red5 submodules.  The hydra-jetty submodule contains fedora Fedora and solr Solr and can be run managed via jettywrapper rake tasks (e.g. rake jetty:start).  The hydrantavalon-felix submodule is a VoV configured custom instance of Matterhorn and hydrant. avalon-red5 is a VoV configured custom instance of Red5 which has with Matterhorn integration.   These two servers can also be controlled with rake tasks similar to jetty.  After installing them, force them to track the master branch for their respective repositories.

Code Block
languagebash
git submodule init
git submodule update
cd jetty/ 
git fetch --tags 
git checkout 4.x 
cd ..  
cd felix/
git fetch --tags
git checkout master1.4.x
cd ..  cd red5/
git fetch --tags
git checkout master
cd .. 

...

Config avalon based upon the Configuration Files page.  Note that Matterhorn config files can be put in the felix_conf directory and copied over with the felix:config rake task.

To configure Devise and Blacklight Secret Key, in your avalon directory run the following command:

Code Block
languagebash
rake secret

Copy the output, then create and open the file config/secrets.yml. Like the other yml files, you can have separate sections for development, test and production. Here is a template:

Code Block
development:
    secret_key_base: <Paste the hash>

Start all services

Code Block
languagebash
rake jetty:config
rake hydrant:felix:config
rake avalon:services:start

Test Hydrant

Inside hydrant folder, runTo make the startup of avalon easier after a git pull, you can add these functions to your .bashrc script.

Test Avalon

From your avalon installation execute

Code Block
languagebash
rails server

Navigate to http://localhost:3000

Follow instructions for Logging in via IU CAS