Page tree
Skip to end of metadata
Go to start of metadata

This documentation is for Release 5.x, 4.x and 3.x.

 

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.

 

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.

Configuration changes within AMS:

Configuring 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
chmod 744 /opt/adobe/ams/avalon_auth

# 5. Add Avalon substitution variables to the AMS configuration. 
#    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

Setup the AMS Avalon application

Configure AMS Avalon application
# 1. Copy Application.xml and main.asc into AMS Avalon application
mkdir /opt/adobe/ams/applications/avalon
cp adobe/Application.xml /opt/adobe/ams/applications/avalon/
cp adobe/main.asc /opt/adobe/ams/applications/avalon/

Configure Matterhorn

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

/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}/avalon
org.opencastproject.streaming.directory=/opt/adobe/ams/webroot/avalon
org.opencastproject.hls.directory=/opt/adobe/ams/webroot/avalon
.
.
org.avalonmediasystem.avalon.url=http://{avalon host}/

Configure Avalon

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

/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
Notes for .OVA Install
# 1. Start-up host configuration 
#    /etc/rc.d/init.d/avalon_host_config must be edited so above changes to avalon.yml are not overwritten on reboot.

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

# 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


Running 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

 

 

  • No labels