Telvue Akamai Push Plugin
The Telvue Akamai push plugin allows for an incoming Wowza stream to be pushed to Akamai via RTMP. The plugin supports multiple stream applications, as well as multiple streams per application. All of the specifics are set up through configuration files.
This plugin requires the Wowza SDK and the PushPublish plugin library
How to set up
First the code must be compiled and added to a .jar file. That jar file is then copied into the lib directory of the WowzaMediaServer folder for your version of Wowza. After this a folder for each Application stream must be created in the conf directory inside of the main Wowza directory. For example, if you had an application called MyLiveStream, and Wowza was installed at
/usr/local/WowzaMediaServer/ then you would create the directory
/usr/local/WowzaMediaServer/conf/MyLiveStream/. Inside of this directory you need an Application.xml file. A Sample Application.xml has been made available. The key part to note is the modules tag. Inside of this must be the module for the TelvueAkamaiPushPlugin
<Module> <Name>TelvueAkamiPushPlugin</Name> <Description>TelvueAkamiPushPlugin</Description> <Class>com.telvue.wowza.TelvueAkamiPushPlugin</Class> </Module>
This module entry is what allows the plugin to work with the incoming application stream.
The plugin was designed to be as generic as possible using configuration files to determine where to push the incoming streams to.
Configuration file layout
The layout of the configuration file is very simple. There are 6 key:value pairs that must be included.
AkamaiUsername:username AkamaiPassword:password AkamaiHostName:p.epxxxx.i.akamaientrypoint.net AkamaiDstApplicationName:EntryPoint AkamaiDstStreamName:Stream-Name@xxxx AkamaiPort:1935
Optional Configuration Settings
These settings are the Wowza recommended settings by default, but are configurable.
DebugLogging:true SendStreamCloseCommands:true SendReleaseStream:true SendFcPublish:true AdaptiveStreaming:false
All pairs are separated by a single ":" character, and reside on their own lines. All configuration files must be named after their stream names, and have the extension ".cnfg". So if there is a stream called MyStream, the configuration file would be "MyStream.cnfg"
Configuration directory layout
The configuration files are placed into a root directory called pushConfigFiles. This directory will hold folders for each of the applications being streamed into Wowza (Just like the conf directory). If Wowza is installed at
/usr/local/WowzaMediaServer/ then the config file directory is
/usr/local/WowzaMediaServer/pushConfigFiles/ If there is an application called MyLiveStream, and it has 3 streams live1, live2, and live3. Then the directory structure is
/usr/local/WowzaMediaServer/pushConfigFiles/MyLiveStream/ and in this directory are 3 files
live3.cnfg. Each file has the 6 key:value pairs shown above.
Changing the base directory
It is possible (and necessary if you are not running wowza from /usr/local on a Linux box) to change where the plugin looks for the configuration files. Simply modify line 19 of the TelvueAkamiPushPlugin to the location of the pushConfigFiles directory on your server. Just remember to follow the layout within the pushConfigFiles directory and it will work.