background image

Copyright © 2007

–2015 Wowza Media Systems™, LLC. All rights reserved. 

Wowza nDVR: 

User's Guide 

Version: 4 

http://www.wowza.com

Summary of Contents for nDVR

Page 1: ...Wowza nDVR User s Guide ...

Page 2: ...Copyright 2007 2015 Wowza Media Systems LLC All rights reserved Wowza nDVR User s Guide Version 4 http www wowza com ...

Page 3: ...ot responsible for and accepts no liability related to Third Party Software Please ensure that any and all use of Wowza software and third party software is properly licensed Wowza Trademarks Wowza Wowza Streaming Cloud Wowza Streaming Engine along with other trademarks logos trade dress and other proprietary colors and markings are each trademarks or registered trademarks of Wowza in the United S...

Page 4: ...t update for Wowza Streaming Engine 4 1 software 09 16 2014 Updated licensing information for Wowza Streaming Engine 4 1 1 software 02 18 2015 Document update for Wowza Streaming Engine 4 1 2 software 03 03 2015 Doc v4 2 Document update for Wowza Streaming Engine 4 2 software 06 10 2015 Doc v4 3 Document update for Wowza Streaming Engine 4 3 software 10 06 2015 Updated licensing information for Wo...

Page 5: ...sing requirements for Wowza nDVR 7 Features 9 Video and audio codecs 9 Protocols and players 10 Recorded file location 10 m4fa and m4fv files 12 Manifest files 13 Recording playback 13 Adaptive bitrate delivery 14 Integrating Wowza Transcoder and Wowza nDVR 14 Extending Wowza nDVR 15 Configuration in Wowza Streaming Engine Manager 16 Configuration notes 22 ...

Page 6: ...streams Setup for client playback of recorded streams is similar to playback of live streams from a Wowza Streaming Engine server For the most up to date information tutorials and tips see the Articles tab of the Articles and Forums webpage This document is meant to help you specifically with Wowza nDVR The Wowza Streaming Engine User s Guide contains comprehensive information about Wowza Streamin...

Page 7: ...ey will have either an EPBP4 or EPBU4 prefix depending on date of purchase and is for use with one Streaming Engine instance and the integrated nDVR technology For details see Wowza Streaming Engine Perpetual Pro Edition pricing information The Monthly Subscription Pro Edition license is best for variable demand You can install as many instances of the Streaming Engine software as needed using the...

Page 8: ...etup in the contents panel 2 On the Server Setup page click Edit 3 In the License Keys box enter your license key for the Wowza Streaming Engine software If you need to enter multiple license keys for example for the media server software and for nDVR enter each license key on a separate line 4 Click Save and then click Restart Now at the top of the Server Setup page when prompted to apply the cha...

Page 9: ...ly streams Audio AAC MP3 Audio only streams By default Wowza nDVR records the source stream as ingested provided that it s a supported codec format The audio and video streams are passed through to the resultant recorded stream Wowza nDVR accommodates different workflows and gives you the flexibility to record the video only or the audio only portion of your source stream It s a common mistake to ...

Page 10: ...crosoft Smooth Streaming Smooth This means newly encoded streams can be played on many popular media players such as Adobe Flash Player Microsoft Silverlight player Apple iPhone iPad and iPod touch and Apple QuickTime player version 10 or greater Android smartphones and tablets IPTV OTT set top boxes and other players and devices Wowza nDVR doesn t support HTTP playback of recorded streams using t...

Page 11: ...re nDVR writes to is install dir dvr app name _definst_ streamName n For example if the application name is live and the stream name is myStream with the default settings the new directory will be located at install dir dvr live _definst_ myStream 0 Directory structure The directory naming convention is HHHH_MM_SS where H hours M minutes and S seconds By default Wowza nDVR creates a new directory ...

Page 12: ...itional millisecond value represented by mmm HH_MM_SS_mmm m4fa and m4fv files Wowza nDVR creates m4fa audio and m4fv video files which are based on the MPEG 4 multimedia container format Together these files represent a chunk of recorded audio and video content that s used for playback of your recorded stream You can t play these files directly However they are required and referenced when you pla...

Page 13: ...fv files and contains information about each recorded audio and video chunk The file name corresponds to the directory s hours minutes and seconds description Recording playback Example players are provided for playback of recorded files in Wowza Streaming Engine Manager and the install dir examples LiveDVRStreaming folder in the Wowza Streaming Engine software installation If the application name...

Page 14: ...DVR To play using Microsoft Smooth Streaming http wowza ip address 1935 live smil myStream smil manifest DVR For more information about how to create SMIL files see How to do adaptive bitrate streaming Integrating Wowza Transcoder and Wowza nDVR Wowza Transcoder and Wowza nDVR can work together to transrate transcode and record a live stream at the same time This can be set up with one application...

Page 15: ... Streaming Engine software Because of this the Wowza Streaming Engine software can be extended by writing custom Java classes that are dynamically loaded at runtime The server includes a rich API to interact with and control the streaming and recording process For the most up to date information tutorials and tips see the Articles tab of the Articles and Forums webpage ...

Page 16: ... This chapter assumes that you re familiar with the Wowza Streaming Engine software For more information about how to configure a Wowza Streaming Engine instance see the Wowza Streaming Engine User s Guide This section provides the basic steps for using Wowza Streaming Engine Manager to set up an application for live streaming and with DVR capability 1 In Wowza Streaming Engine Manager click the A...

Page 17: ... the New Application dialog box enter a name such as dvr and then click Add 4 Expand the dvr application in the contents panel click nDVR and then click Enable nDVR Note The Wowza Streaming Engine media server software must be properly licensed to enable nDVR For details see Licensing requirements for Wowza nDVR ...

Page 18: ... O W Z A N D V R 4 U S E R S G U I D E Copyright 2007 2015 Wowza Media Systems LLC All rights reserved 18 5 Click Restart Now to apply the changes 6 The Status field will show that Wowza nDVR is enabled ...

Page 19: ...e C myDvr or an environment variable for example com wowza wms context VHostConfigHome The following environment variables are supported com wowza wms AppHome Application home directory com wowza wms ConfigHome Configuration home directory com wowza wms context VHost Virtual host name com wowza wms context VHostConfigHome Virtual host config directory com wowza wms context Application Application ...

Page 20: ...recording on startup to automatically begin recording a live stream that s published to the application for DVR when the application starts Archive Method These options specify how nDVR handles recording a new stream that s published to the application with the same stream name This often happens if the current live stream is disrupted when encoders restart The Append option is the best option to ...

Page 21: ...at point forward The duration window is a floating window that always ends at the current live point Recorded data that falls outside this window is purged from the DVR store Note You can record up to 30 hours of material for DVR playback however you may encounter performance and playback issues if you make longer durations of material available for playback For best practices guidance see Recordi...

Page 22: ...If the alignment problem can t be fixed at the source or encoder you can use the dvrPacketSortTime property to add a packet sorter before the audio and video packets get to nDVR Note that this property adds additional latency equal to its value For more information about this and other properties see How to do advanced configuration for Wowza nDVR Configure live stream repeater origin edge Wowza n...

Reviews: