Child pages
  • MCM Statistics Plugin
Skip to end of metadata
Go to start of metadata

(warning) THIS MODULE IS DEPRECATED

MCM Statistics Plugin

Description

This plugin monitors the actions on streams, and logs them in MCM.

Prerequisites

Requires Wowza 4.0.3
Requires MCM 1.

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 Statistics module

[...]
<Modules>
    [...]
    <Module>
        <Name>Chaos-MCM-Logging</Name>
        <Description>Statsbiblioteket Chaos logging MCM module</Description>
        <Class>dk.statsbiblioteket.chaos.wowza.plugin.statistic.StatisticLoggingMCMModuleBase</Class>
    </Module>
</Modules>
[...]

Configuring plugin

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

The following keys are used:

GeneralMCMServerURL=http://localhost:9998/RESTfulLarmMCMMock/PortalService.svc
StatisticsLoggingMCMStatisticsMethodCreateStatSession=Session_Start
StatisticsLoggingMCMValueClientSettingID=1
StatisticsLoggingMCMValueRepositoryID=6
StatisticsLoggingMCMStatisticsMethodCreateStatObjectSession=StatsObject_SetStats
StatisticsLoggingMCMValueObjectTypeID=11
StatisticsLoggingMCMValueChannelTypeID=3
StatisticsLoggingMCMValueChannelIdentifier=20000
StatisticsLoggingMCMValueObjectTitle=
StatisticsLoggingMCMValueEventTypeID=13
StatisticsLoggingMCMValueObjectCollectionID=10
StatisticsLoggingMCMStatisticsMethodCreateDurationSession=DurationSession_Create

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?ObjectID=XXX&SessionID=YYY
For XXX use an object ID from MCM.
For YYY use a valid session ID from MCM.

At stream, type the filename of the object with ObjectID XXX

Assuming that file is available in the content directory of the VHost, the file should now start playing. Try pausing and seeking.

The events should now be recorded in the MCM statistics log.

TODO: Alternatively use mockup MCM implementation for testing.

  • No labels