LARM-CHAOS-platform
Child pages
  • SB Content Resolver Plugin
Skip to end of metadata
Go to start of metadata

SB Content Resolver Plugin

Description

This module translates Streams with DOMS UUID's into file names in the content directory.

Prerequisites

Tested on Wowza 4.0.3

Configuration

Configuring Wowza

Configuration is done in the file 'conf/chaos/Application.xml' relative to the VHost path of the plugin (see Installation).
The file is based on 'examples/SimpleVideoStreaming/conf/vod/Application.xml' from the Wowza system directory. It must be updated with the following step:

Add the DOMS streaming module

[...]
<Modules>
    [...]
    <Module>
        <Name>Chaos_Content_Resolver</Name>
        <Description>Statsbiblioteket Chaos content resolver module</Description>
        <Class>dk.statsbiblioteket.medieplatform.wowza.plugin.ContentResolverModule</Class>
    </Module>
</Modules>
[...]

Configuring plugin

Configuration is read from the file 'conf/chaos/wowza-modules.properties' relative to the VHost path of the plugin (see Installation)

The following keys are used:

# Number of characters to use for splitting content into directories. Example: if this is 2, the file
# "hello.txt" will be in the path "h/e/hello.txt
characterDirs=4
# Pattern used for turning the content id into a file name. %s is replaced with the content id.
filenameRegexPattern=%s\\.(flv|mp3)
# Type used by ticket checker and content resolver for identifying content
presentationType=Stream

Configuring logging

Logging is done at VHost level. Edit the file 'conf/log4j.properties' relative to the VHost path of the plugin (see Installation) to set the desired log levels.

Installation

Assuming a Wowza server installed in $WOWZADIR configured with a toplevel directory for a VHost called $VHOSTDIR, the following is needed:

Add the distributed JAR files to $VHOSTDIR/applications/lib
Create the directory $VHOSTDIR/conf/chaos
Place the configuration file in $VHOSTDIR/conf/chaos/chaos-streaming-server-plugin.properties
Place the application file in $VHOSTDIR/conf/chaos/Application.xml
Create the directory $VHOSTDIR/applications/chaos

(To use an external VHost dir, follow the instructions from http://www.wowza.com/resources/WowzaStreamingEngine_UsersGuide.pdf section "Virtual Hosting")

Testing

In a browser, open the URL

file:///usr/local/WowzaStreamingEngine/examples/VideoOnDemandStreaming/FlashRTMPPlayer/player.html

(replace /usr/local/WowzaStreamingEngine with $WOWZADIR)

At server, type
rtmp://localhost/chaos
At stream, type mp3:uuid:<doms-uuid>.mp3

Assuming that file for that uuid is available in the content directory of the VHost, the file should now start playing.

  • No labels