Page tree

Versions Compared

Key

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

This document is a work in progress. It is incomplete and untested.

Info

This documentation is for Release 5.x, 4.x and 3.0x.0.

 

These instructions provide a recipe for configuring Avalon to use Adobe Media Server (AMS) for content streaming.

In the code blocks below {ams host} = Adobe Media Server and {avalon host} = Avalon Server.

 

Note

Adobe Media Server 5 Standard can be downloaded from http://www.adobe.com/products/adobe-media-server-standard.html. A serial number is not required for development and testing purposes.

This example uses the default AMS installation location ( /opt/adobe/ams ) and assumes that the Apache server used is the one installed with AMS. If a separate Apache is used make changes accordingly.

...

Code Block
languagebash
titleConfiguring AMS
# Do all the following as root
su -

# 1. Download the Avalon configuration for AMS
wget -O avalon-vod.zip https://github.com/avalonmediasystem/avalon-vod/archive/master.zip
unzip avalon-vod.zip
cd avalon-vod-master

# 2 Copy avalon.conf into place
cp apache/avalon_rewrite.conf /opt/adobe/ams/Apache2.2/conf

# 3. Add Avalon configuration to AMS's Apache configuration
echo "Include conf/avalon_rewrite.conf" >> /opt/adobe/ams/Apache2.2/conf/httpd.conf

# 4. Copy avalon_auth into place and make executable
cp apache/avalon_auth /opt/adobe/ams/Apache2.2/bin
chmod 744 /opt/adobe/ams/Apache2.2/binavalon_auth

# 5. Add Avalon substitution variables to the AMS configuration (EDIT THESE AS NEEDED). 
#    AVALON.STREAM_PATH must be the same as configured for Matterhorn below. 
#    Both servers must be able to reach these directories through their respective file systems.
echo "AVALON.STREAM_PATH = /opt/adobe/ams/webroot/avalon" >> /opt/adobe/ams/conf/ams.ini
echo "AVALON.AUTH_URL = http://{avalon host}/authorize" >> /opt/adobe/ams/conf/ams.ini

...

Inspect the following assignments in config.properties and change as needed for your environementenvironment.

Code Block
languagenone
title/usr/local/matterhorn/etc/config.properties
org.opencastproject.server.url=http://{ams host}:18080
.
.
org.opencastproject.streaming.url=rtmp://{ams host}/avalon
org.opencastproject.hls.url=http://{ams host}/streamsavalon
org.opencastproject.streaming.directory=/var/opt/adobe/ams/webroot/avalon/rtmp_streams
org.opencastproject.hls.directory=/var/opt/adobe/ams/webroot/avalon/hls_streams
.
.
org.avalonmediasystem.avalon.url=http://{avalon host}/

...

Inspect the following assignments in avalon.yml and change as needed for your environementenvironment.

Code Block
languagenone
title/var/www/avalon/shared/avalon.yml
 streaming:
   url_handler: :adobe # or :generic 
   rtmp_base: rtmp://{ams host}/avalon/
   http_base: http://{ams host}/avalon/
   stream_token_ttl: 20 #minutes
Code Blockinfo
languagebash
titleNotes for .OVA installsInstall
# 1. Start-up host
configuration (
 configuration 
#    /etc/rc.d/init.d/avalon_host_config
)
 must be edited so above changes to avalon.yml are not overwritten on reboot.

Red5 must be shutdown and the startup service disabled:



# 2. Red5 must be shutdown and the startup service disabled:
cd /usr/local/red5


./red5-shutdown.sh


chkconfig red5 off

AMS must be started and set to autostart:



# 3. Depending on how AMS was installed, it might need to be started and set to start on boot:
cd /opt/adobe/ams


./server start


echo /opt/adobe/ams/server start
 
 >>
 
 /etc/rc.local


Info
titleRunning Avalon on port other than 80

By default, AMS and Avalon are both configured to listen on port 80. So if you wish to run both on the same host, it might be necessary to configure one of them to listen on a different port. To configure Avalon to listen on a different port, changes in several files are necessary:

/etc/httpd/conf/httpd.conf
/etc/httpd/conf.d/10-avalon.conf
/var/www/avalon/shared/avalon.yml
/etc/rc.d/init.d/avalon_host_config

And don't forget to open the port. The preferred method is to create a shell script that will do the work for you. Here is an example script that you should look through and customize as needed: avalon-iptables-config.sh