DME AdminGuide
DME AdminGuide
May 2014
Copyright
© 2014 VBrick Systems, Inc. All rights reserved.
VBrick Systems, Inc.
2121 Cooperative Way, Suite 100
Herndon, VA 20171 USA
This publication contains confidential, proprietary, and trade secret information. No part of this document may be copied,
photocopied, reproduced, translated, or reduced to any machine-readable or electronic format without prior written
permission from VBrick Systems, Inc. Information in this document is subject to change without notice and VBrick assumes
no responsibility or liability for any errors or inaccuracies. VBrick, VBrick Systems, the VBrick logo, VEMS Mystro,
StreamPlayer, and StreamPlayer Plus are trademarks or registered trademarks of VBrick Systems, Inc. in the United States
and other countries. Windows Media, SharePoint, OCS and Lync are trademarked names of Microsoft Corporation in the
United States and other countries. All other products or services mentioned in this document are identified by the
trademarks, service marks, or product names as designated by the companies who market those products. Inquiries should be
made directly to those companies. This document may also have links to third-party web pages that are beyond the control of
VBrick. The presence of such links does not imply that VBrick endorses or recommends the content of any third-party web
pages. VBrick acknowledges the use of third-party open source software and licenses in some VBrick products. This freely
available source code is posted at http://www.vbrick.com/opensource
1. Introduction
DME Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Features and Benefits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Server Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Software-Only Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Software Development Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2. Installation
Installing the Server Hardware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Unpack and Connect the Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Power On/Power Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Configuring the DME as a VOD Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Configuring the DME in VEMS v5.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Configuring the DME in VEMS Mystro v6.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
3. Getting Started
How it Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Planning and Preparation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
DME Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Streaming Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
VC Gateway. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
VOD Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
FTP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Caching (HTTP) Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Streaming Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Served VOD Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Pushed Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Pulled Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Transmuxed Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
5. System Configuration
Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Host Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
IPV4 Network Interface 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
IPv4 Network Interface 2–4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
NAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
iv Contents
Domain Name Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Network Time Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
General. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
System Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
System Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
System Reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Streaming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Caching Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Caching Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Manage Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
SSL Certificates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
SAN/iSCSI Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Activate Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
6. SAP Configuration
Announcement Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Announcements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
SAPs for Unannounced Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
7. Input Configuration
Flash/RTSP Pull . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Transport Stream In. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
MPG2TS Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
RTP Playlists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
New Media Playlist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
8. Output Configuration
Flash Push . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
RTSP Push . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Transport Stream Out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
HLS Streaming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Playlist Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
HDS Streaming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Playlist Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
RTP Relay. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
New Relay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Stream Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
9. User Configuration
Username and Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Readonly Username and Password. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
11. Logging
Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
12. Monitor
System Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
RTP Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Multi Protocol Connections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Relay Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Access History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Upgrade Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Error Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
13. Maintenance
System Maintenance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Disk Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Disk Provisioning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
14. Diagnostics
Trace Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
vi Contents
16. Detailed Use Cases
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Configuring a Multicast Relay with a Unicast Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
H.264 Encoder Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
DME Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Configuring a Multicast Relay with an Auto-Unicast Source . . . . . . . . . . . . . . . . . . . . . . . . 148
H.264 Encoder Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
DME Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Welcome
This document explains how to configure and use VBrick's Distributed Media Engine
(DME). The DME is a versatile, highly-configurable media distribution engine that moves
streaming media to and from a wide variety sources and endpoints. It can for example take a
unicast RTP stream and multicast it to thousands of local IP users, or it can transmux and
serve the same RTP stream to RTMP (Flash) users on the Internet. The information in this
document is available with the DME documentation on the VBrick website. For the latest
technical documentation for other VBrick products, go to www.vbrick.com/documentation
Note This Admin Guide is not written for casual users. It assumes readers will have a
working knowledge of network addressing, communications protocols, and
configuration concepts, as well as hands-on experience working with streaming
video products.
x Preface
Getting Help
If you can't find the information you need in this document, or from your reseller, you can
contact VBrick Support Services on the web, by e-mail, or by calling 1-203 303-0222. For
faster service, be sure to have your VBrick product serial number or support contract
number. Support Services can usually answer your technical questions in 24 business hours or
less. Note that all VBrick documentation is posted on the web. For more information about
any VBrick product, go to www.vbrick.com/documentation
Font Conventions
Arial bold is used to describe dialog boxes and menu choices, for example: Start > All
Programs > VBrick
Courier fixed-width font is used for scripts, code examples, or keyboard commands.
Courier bold fixed-width font is used for user input in scripts, code examples, or keyboard
commands.
This bold black font is used to strongly emphasize important words or phrases.
Folder names and user examples in text are displayed in this sans serif font.
User input in text is displayed in this bold sans serif font.
Italics are used in text to emphasize specific words or phrases.
Safety Precautions
There is always a danger present when using electronic equipment. Unexpected high voltages
can be present at unusual locations in defective equipment and signal distribution systems.
Become familiar with the equipment and observe the following precautions:
• Every precaution has been taken in the design of your system to ensure that it is as safe
as possible. However, safe operation depends on you.
• Always be sure your equipment is in good working order. Ensure that all points of
connection are secure to the chassis and that protective covers are in place.
• Never work alone when working in hazardous conditions. Always have another person
close by in case of an accident.
• Always refer to the manual for safe operation. If you have a question about the
application or operation call VBrick for assistance.
• Never allow your equipment to be exposed to water or high moisture environments. If
exposed to a liquid, remove power and send unit to be serviced by a qualified technician.
Environmental Goals
At VBrick, we believe that running our company with a "green" conscience is good for the
environment and good for business and that environmental awareness is an important part of
the value we deliver to our customers. We recognize our responsibilities to our customers,
partners, and employees, and also to the communities in which we live and work. We believe
that the same ethics and principles that guide our daily business decisions should be applied
to the environment as well. We design superior quality, high performance, and energy-
efficient products and are continually looking for ways to conserve energy and reduce waste.
As a company, we look for ways to be environmentally friendly in designing our products and
operating our facilities, and by choosing partners and suppliers who are committed to
sustainable development. You can help by recycling batteries and other consumables and by
xii Preface
Chapter 1
Introduction
Topics in this chapter
DME Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
DME Overview
The VBrick H.264 Distributed Media Engine (DME) simplifies delivery of high definition
video and other rich media content across multi-site enterprises and campus environments. If
properly configured, you can simultaneously input multiple streams (of different types) into
the DME and output them as the same stream types or as different stream types. For example
you can input RTP and TS (transport streams) into the DME and output those same streams
as RTMP (Flash) or HLS (for Apple iOS devices). The DME also provides video content
caching, storage, and serving to ensure that stored content is delivered from a DME as close
to the end user as possible. The Distributed Media Engine may be deployed at a central
location, to support transmuxing, or at remote locations to support distribution. It is a single
integrated platform providing media redistribution, media transformation and video-on-
demand content storage. The DME accepts multiple H.264 media streams from multiple
central sites and redistributes that content to diverse endpoints including PCs/MACs, mobile
phones and televisions/monitors. This one integrated platform optimizes WAN bandwidth
use, simplifies endpoint support and offers local storage of centrally managed content.
Applications
The H.264 Distributed Media Engine is deployed on the network edge to support endpoints
requiring RTP or RTMP (Flash) streams as well as firewall-friendly HTTP progressive
downloads. It supports enhanced scalability and performance across the VBrick suite of
applications including:
• Meeting and Event Broadcasting – Provides ubiquitous access to high quality broadcasts
and corresponding rich media content at the network edge.
• Training and Lecture Capture – Flash streaming and progressive download via HTTP
allow for distribution of content to a wide variety of clients including mobile devices.
• Television Distribution – Simplifies multicast distribution at remote buildings or
locations that might not be connected by multicast enabled WAN connections.
• Enterprise YouTube® – Local content storage reduces burden on WAN.
• Surveillance & Monitoring – Deliver more content to diverse endpoints over challenging
or far flung network environments.
• Digital Signage – Enhanced performance for greater scalability.
Protocol Description
Incoming • RTSP Announce
• RTP Over UDP (with RTCP) Unicast and Multicast
• RTP over TCP (with RTCP) Unicast Only
• RTP over UDP (SDP file delivered via FTP)
• FTP for VOD file transfer
• RTMP via RTMP Push over TCP
• Transport Stream (MPEG2TS delivery of H.264
audio and video content)
Outgoing • RTP via RTSP (stream)
• UDP, TCP Interleaved, and HTTP Tunneled
• RTP via RTSP (relay - Push)
• UDP, TCP Interleaved using Announce
• RTMP (stream and relay)
• HTTP (progressive download)
• TS (transport stream)
• HLS (Apple HTTP iPad/iPhone live streaming)
• HDS (Adobe Flash HTTP dynamic streaming)
• HTTP Caching Server
Management • HTTP/HTTPS for management
• IGMPv3
Server Models
VBrick currently supports a variety of shelf and rack-mount models. See the DME Release
Notes for a detailed description of DME models and specifications. There are no absolute
rules for sizing a multipurpose device like the DME but there are some basic guidelines that
can help you select the right model. The smaller Model 7530 (Figure 1) does not offer
redundant power supplies or redundant VOD storage so if these attributes are important, you
should consider the larger models. The Model 7530 is shelf-mount only while the larger
models are rack mount 1U and 2U servers. Users seeking significant VOD content playback
should consider one of the two larger models. The RAID arrays built into the Models 7550
and 7570 are much more powerful and better suited for frequent requests than for
concurrent VOD playback. The single drive on the Model 7530 is well suited for small to
medium offices that have occasional VOD demands.
Software-Only Version
The DME is available as a hardware/software combination in which case VBrick will deliver
the DME server hardware with the DME software already installed. You can also purchase
the DME in a VMware virtualized version in which case you must install the DME software
on your own server platform. For more about this option, and server hardware
recommendations, see the "Software-Only Version" topic in the DME Release Notes.
Compatibility
Table 2 shows DME compatibility with other VBrick products:
Technical Support
If you can't find the information you need from the documentation or your reseller, you can
contact VBrick Support Services on the web. The Support Services website has downloads,
FAQs, documentation, support guidelines, and an on-line form you can use to submit
questions. VBrick will make every effort to answer your technical questions in 24 business
hours or less.
Glossary
For best results, please take a few minutes to become familiar with the glossary terms listed
below. These technical terms are used throughout this document.
8. The DME server will boot and automatically load using the default settings. Wait 5–8
minutes for the unit to fully power up. As new hardware is attached (for example a
keyboard and mouse) the operating system will automatically find and install the drivers.
Note The DME ships with DHCP enabled and you can use VBDirectory to auto discover
any DMEs in your network. The Login topic explains how to login to the DHCP
address. The IPV4 Network Interface 1 topic explains how to set a static IP address.
To manage the DME with the VBAdmin web interface, you must have IP access to the
network where the DME is located. Then you can use the VBDirectory management
application to discover and display the name, IP address, and software revision of all VBrick
devices on your network, including DMEs. By default, the DME sends management
information about itself via multicast so a multicast-enabled network is required.
VBDirectory listens for Management Announcements from VBrick devices on the network
and is available free of charge from the Downloads page on the VBrick website. You can also
find the IP address of the DME by connecting a monitor to the blue VGA port (Models 7550
and 7570) or the DVI port (Model 7530) of the DME. The IP address will be displayed at
start-up.
• If the stream is sourced from a VBrick H.264 appliance, the URI of the stream can be
automatically provided to the Portal Server server using an external announcement. See
the "Announce Settings" topic in the VBrick H.264 Encoder Admin Guide for details.
• The URI can be added manually as a live URL. See the "URLs > Add/Modify a URL for
a Live Video Stream" topic in the Portal Server 5.x Admin Guide for details.
Getting Started
Topics in this chapter
How it Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Planning and Preparation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
DME Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Streaming Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
VBAdmin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Home Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
VBDirectory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Configuration Using Secure Shell (SSH) or a Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
How it Works
The VBrick DME is a multi-faceted platform that performs a variety of serving, reflecting,
and transmuxing, and transrating activities. In a typical application, a DME receives a unicast
stream over the WAN link (often over TCP) to effectively traverse the LAN and pass through
firewalls. The DME then streams via unicast and/or multicast to a variety of different clients
in the streaming protocol of choice for each client. To conserve bandwidth, reflectors can be
linked across the WAN to relay video streams from one remote site to multiple downstream
DME reflectors. The net effect is that a single unicast stream across the WAN can reach tens
of thousands of viewers. To improve reliability, reflectors can either pull or push streams
across the WAN using TCP. If a network outage occurs, the DMEs will automatically
reconnect and resume streaming without any user intervention. The DME is comprised of
the major components shown in Figure 12.
To reach different classes of clients (e.g. PCs, STBs, and mobile devices), a single stream of
H.264-encoded multi-bitrate (MBR) video can work in concert with reflectors to distribute
streams in the most efficient manner. Reflectors can also transmux video streams, converting
from one type of transport stream on the input to another type of transport on the output. In
transmuxing, a digital bit stream is converted from one file format or streaming protocol to
another—without changing the compression method. An example of transmuxing is when a
unicast stream is converted to multicast or when an RTP stream is converted to RTMP.
H.264 offers a variety of transport protocols to ensure the reliable delivery of video over a
variety of networks. For live broadcasts, the Real-Time Transport Protocol (RTP) is efficient,
while the Real-time Streaming Protocol (RTSP) offers the player controls (fast forward,
rewind) needed for VOD playback. Newer transport protocols like RTMP (for Flash) and
HTTP are optimized for Internet clients and mobile devices.
• How you will be delivering media to the DME. This is typically determined by how your
media is currently being created, for example as RTP, RTMP, etc.
• How your clients will be viewing content from the DME and with what players, for
example with StreamPlayer, QuickTime, etc.
• Which firewalls, virtual networks, proxies, encryption systems, etc. are in place that will
need to be traversed and/or reconfigured.
Once you have a better understanding of these issues you are ready to start considering what
type of input streams you will have (RTP or RTMP) and how will they be distributed. For
example they can be pushed to the DME, pulled from the DME, or by unannounced unicast
from the source or an announced auto-unicast to the DME. You will also know how your
clients will be viewing the content, for example as RTP, RTMP, or both, using a standalone
player, an embedded web page, or through VBrick's VEMS Portal Server. You will also know
whether or not the content needs to be relayed to another remote DME or to a CDN for
Internet Distribution. Finally, knowing how many users you have and the bandwidth
consumed by each will help to clarify how many DMEs and which models you will need to
distribute the streams. By gathering this information in advance, and reading this manual
carefully, you can help to ensure a successful deployment of the DME in your own unique
environment.
To help you understand the various options available, Configuring DME Streams on page 33
defines a number of typical use cases—not all of which will apply to you. The use cases can
help to simplify the configuration. They can help, for example to avoid deploying a simple
solution in an overly complex way. In other cases you may also choose one method for one
requirement, and have to choose a different method for a second requirement, meaning you
will have two input streams when one could just as easily be used for both.
Firewalls can also play an important role in determining which use cases are appropriate.
When no firewalls apply, a push or an auto unicast solution can be easily deployed. However
if the DME is behind a firewall, you probably cannot reach it with a push without having to
reconfigure the firewall. Similarly, you can probably pull a stream from a source into the
DME. However if the source is also behind a firewall, more network planning, such as
placing the DME in a "DMZ" (which the source can push to and the destination can pull
from) may be a better solution. If virtual IP addresses are used, you will need to know more
about the configuration of the network; and if deploying RTP streams that will travel over
UDP, your firewall may need to be configured to allow UDP data in and out.
DME Components
Streaming Servers
As shown in Figure 12, the DME has an RTP server, a Multi Protocol server, and an HTTP
server for progressive download. Each of these servers supports specific types on inputs and
outputs which are described in detail on the following pages. For example, as shown in
Figure 19 on page 34, the Multi Protocol streaming server supports multiple input methods
and multiple output methods. The streaming servers and the VOD servers are built on a
robust embedded operating system.
VC Gateway
The DME video conferencing solution builds on a simple video conference by delivering a
multi-vendor, standards-based stream that lets smartphones, tablets, PCs/Macs, and TVs
display the video conference. It provides a cost effective way to leverage existing video
conferencing investments by delivering the video conference audio and video as a stream to
other elements in the VBrick ecosystem. See VC Gateway Configuration on page 111 for
more information.
VOD Servers
The DME engine includes an RTP VOD server, a Multi Protocol VOD server, and an HTTP
Progressive Download server. All stored VOD files are added to the DME via FTP. The
VOD servers support all of the file types shown Table 3.
FTP Server
The DME has a fully functional web server that uses File Transfer Protocol to populate the
DME with files for progressive download. You can FTP to the FTP folder on the DME or to
a subfolder. When adding VOD files via FTP, you must wait for the ingestion to complete
before the stream will play in VEMS. You can view the ingestion progress on the Status page
in the VEMS client. If the ingestion is not complete, the title will display but the stream will
not play.
Note New content files that are transferred via FTP will not be available immediately for
VOD RTMP streaming until the associated seek and meta files are generated. Meta
and seek files are typically generated within a few minutes of being transferred.
Players
MPG, TS Progressive No No No No No No No No No No
(H.264, Download
Mpeg2)
MPG, TS RTSP No No No No No No No No No No
(H.264,
Mpeg2)
Pulled Streams
The Multi-protocol Streaming Server can pull live streams from an RTSP/RTP server or an
RTMP server. It can pull from various outside sources, for example from another DME, or
from a Wowza, FMS, QuickTime, or Darwin streaming server. These streams can then be
served or pushed via various protocols.
Transmuxed Streams
Transmuxing is the process whereby a digital bit stream is converted from one file format or
streaming protocol to another—without changing the compression method (as opposed to
transcoding which actually changes the compression method). The DME transmuxes streams;
it does not transcode streams. An example of transmuxing is when a unicast stream is
converted to multicast or when an RTP stream is converted to RTMP. The following table
shows the live input streams that are supported in the left column and the live output streams
that are supported in the top row.
Transrated Streams
Transrating is the process where a digital bit stream is converted from one bit rate to another-
without changing the compression. An example of transrating is when a high bit rate stream
is converted into multiple lower bit rate streams for delivery to mobile devices. Note that the
DME does not change the resolution of the source stream, although the receiving device will
generally display the stream at its preferred resolution.
RTMP Unicast Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes No
Pull
RTMP Auto- Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes No
Unicast
RTP Unicast Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes No
Push
DME Input Streams
RTP Auto- Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes No
Unicast
RTP Unicast Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes No
RTSP Pull
RTP Multicast Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes No
TS Unicast Push Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes No
TS Unicast Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes No
RTSP Pull
(3.1.1)
TS Multicast Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes No
VC SIP Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes No
VBAdmin
The VBrick DME server has an integrated management interface (VBAdmin) that lets you
manage the DME configuration from an external web browser. This allows network
managers to remotely configure and monitor the appliances from virtually any location that
has web access. The most convenient way to access the VBAdmin interface (Figure 17) is via
the VBDirectory utility. After installing VBDirectory you will see the screen shown in
Figure 18 on page 30. Locate a specific DME and simply double-click on the Name to launch
the VBAdmin Login. To optimize the functionality of this tool, set the Host Name of the
DME (on the System Configuration > Network page) to a meaningful text string during
initial configuration.
Alternatively, if you know the DME's IP address, you can access it directly from a browser.
As shown in Table 6 you can launch VBAdmin in Internet Explorer or Firefox (other
browsers are not supported by VBrick). You connect to VBAdmin by pointing to the IP
Address and Port Number (for example: http://192.168.5.5:8181 ) of the DME and logging
in with valid credentials. Note that the DME's management interface is not on Port 80. By
default the admin port for the DME is 8181. This allows Port 80 to be reserved for HTTP
downloads.
Login
The DME ships with DHCP enabled and you can use VBDirectory to auto discover the IP
addresses any DMEs in your network. The VBDirectory application (which you can install on
a local PC) is provided free of charge. It is available on the VBrick Downloads page for new
customers and is automatically installed when you perform an upgrade. Once you know the
DME's IP address, you can login by entering the server's IP address or host name, and the
management port (8181), in the address bar of your browser. When the login page is
displayed, enter a valid User Name (default = admin) and Password (default = admin) to
launch the VBAdmin management interface. A typical login URL would have the following
format:
http://172.22.2.50:8181
Note Administrators should be aware that the DME’s management interface is not on Port 80 as
is typical for most web-based admin tools. By default the admin port for the DME is
8181. This allows Port 80 to be reserved for HTTP downloads.
Log Out
To log out of the application, click Log Out in the navigation panel on the left. As a security
measure, if no keyboard activity is detected for 20 minutes, VBAdmin will automatically
timeout and display the Login page. It is highly recommended that you use the Username and
Password page in VBAdmin to change the user name and password after logging in for the
first time. The user name and password cannot exceed 20 characters.
DME Registration
Note If you have purchased a hardware DME, it will come pre-registered from the factory
and you do not have to complete the registration steps described in this section.
These steps below are for software-only DMEs only.
After accepting the EULA the registration splash page is automatically displayed with
informational data. When the following page is displayed click Next to display the DME
Registration page. You will need to register your DME with VBrick before you can run the
application.
Apply Applies the changes made on the screen to the appliance. Each
configuration page has an Apply button. You must click Apply before you
exit the page; otherwise your changes will be lost.
Revert Aborts all changes made on the screen and returns to the values that were
present prior to any changes. The Revert button restores the values that
were present prior to the last "apply."
Default Returns to the default settings for all parameters on the page. You must
still click Apply for these default settings to take effect.
Note Some changes to the configuration will initiate an automatic reset. When this happens,
wait approximately 60 seconds, then refresh the page and log back in with your user
name and password.
Help
A link to the online help system is available from the Configuration Menu on the left side of
the VBAdmin page. This help system has a powerful full-text search engine that can quickly
find the information you need. You may wish to take a few minutes to familiarize yourself
with the help system. It can save time when tying to find information about DME parameters
or options. When using VBAdmin, click on the question mark hyperlink in the upper-right
Home Page
The DME "Home" page (Figure 17) has the Configuration Menu on the left and a read-only
snapshot showing the health of the system on the right. Within the Configuration Menu, the
System Configuration pages let you access all configurable DME parameters; the Monitor
pages show important status information. The Configuration Menu also lets you log out or
get online help. The read-only snapshot fields on the right side of the home page are
explained below.
Note Be aware that the VBAdmin pages (including the home page) are not automatically
refreshed. To update the page with the latest information, use the refresh or reload
button on your browser.
Model Number Circled above in Figure 17. See Server Models on page 3 for
more about DME models.
Host Name Circled above in Figure 17. The DME Host Name is defined
on System Configuration > Network page.
Status Day, date, and time (hh:mm:ss) the server was last reset.
Current Time on Server System Time (as set on System Configuration > General page.
Up Time Aggregate up time since the last server reset.
Application Code Revision DME software code revision currently installed.
RTMP Server Version RTMP server software code revision.
OS Registration Number OS registration number.
RTP CPU Load Current processing load on RTP server.
RTMP CPU Load Current processing load on RTMP server.
Total CPU Load Total CPU load as a percentage of available resource.
Current # of Connections Total number of clients currently connected.
Current Throughput Current throughput in bits/sec.
Multi Protocol Connections Current number of input and output multi protocol
Count connections.
Multi Protocol Max Count Maximum number of multi protocol connections (configured
on System Configuration > Streaming page).
RTP Connections Count Current number of input RTP connections.
Configuration Menu
The DME Configuration Menu on the left side of the VBAdmin page provides access to all
configurable DME parameters. Use the (plus and minus) tree controls to expand or collapse
the menu. Click on any item in the menu to display the corresponding configuration page.
Note that the DME is a reflector and always sends what is received. For this reason, there are
no video or audio configuration fields on the DME pages nor do the destination pages let
you select different video and audio rates.
VBDirectory
VBDirectory is VBrick management application that discovers and displays all VBrick
devices (including DMEs) connected to your network. It shows the Name (as DME and MAC
Address), IP Address, and Model (see Table 8) for each DME on your network. VBDirectory
is an easy way to connect to the management pages for the DME or other VBrick devices.
The VBDirectory application is available on the VBrick Downloads page for new customers
and is automatically installed when you perform an upgrade. Be aware that you will need
VBDirectory v5.3 or higher to discover the DMEs on your network. Click on the Upgrade button
to launch the VBDMEDownload upgrade tool. See Software Upgrade on page 151 for more
about upgrading your software.
Configure Network Used to quickly configure your network and includes the
ability to configure for DHCP or static address and designate
an IP address, Subnet Mask, and Gateway. This is the same
ability that is included on the System Configuration >
Network screen on the DME. This is useful to set your IP
address on your DME before you begin using your appliance.
Set Hostname The DME Host Name may also be defined on System
Configuration > Network page. It will display in the banner
graphic in the top right area of all DME configuration pages
and defaults to DME <Mac_Address> which is a hardware
address unique to each node of a network. The DME
Hostname also identifies the appliance to various network
applications including DHCP and the VBDirectory
management application.
Clear DNS If the DNS entries are not reachable, the device may respond
sluggishly. Clearing the DNS entries will alleviate the
situation.
Reset to Default Settings This task resets most settings except for network settings and
passwords to their default settings. The same task may be
executed from the System Configuration > Manage
Configuration form in the DME.
Reset to Factory Default This task resets ALL settings including network and
Settings passwords to factory defaults. Use with caution. The same
task maybe be executed from the System Configuration >
Manage Configuration form in the DME.
Show Network This task will show your entire network configuration
Configuration including your IP address, Subnet Mask, Gateway, DNS1, and
DNS2 settings.
Reboot Device with Disk If the DME is shut down improperly, the disk may need to be
Check checked to verify and recover any bad sectors. Use this option
to do so.
Reboot Device Reboots the device without running a check disk.
Shutdown Device A graceful shutdown and power off that will require human
intervention to power the device back on.
Exit Exits the session.
Overview
The diagram in Figure 19 shows the most common input and output streams supported by the
DME. The DME Input Streams shown on the left in the diagram are live inputs from a
VBrick encoder or streams from another live source—these streams can be inputs to either
the RTP server or to the Multi Protocol server in the DME. The DME Output Streams on the
right may include live streams as well as stored streams from any of the three (RTP, Multi
Protocol, HTTP) onboard VOD servers. Live output streams are reflected from the RTP
server or the Multi Protocol server. For an important conceptual overview of the DME,
please read Planning and Preparation on page 15.
For both Input and Output cases the numbering reflects the general priority of the various
streams. For example, other factors being equal RTMP push in (In-1) is the preferred
method for delivering streams into the DME. The alternate mechanisms may be required,
however, based on a number of factors as follows:
1. Ability of the source to deliver a stream by a given protocol.
2. Ability of the firewalls to manage delivery of the stream via the given protocol.
3. Specific requirements of the stream. Prominent examples of these requirements are (1)
closed captioning which cannot be transported via RTMP within the VBrick ecosystem;
and (2) KLV metadata which can only be transported via Transport Stream in the VBrick
ecosystem.
Tip: Click an input or output method on the image map below (e.g. In-8 or Out-3)
to view a step-by-step description of how to configure that method.
Note The VBrick H.264 Appliance Admin Guide has complete configuration details for the
H.264 encoder. Please refer to this document when configuring the DME. This
document is included with the DME documentation on the VBrick website.
Output Streams
Out-1 > Serve (RTMP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Note If you wish to redistribute the stream using Unannounced RTP (Out-7), or using
Served RTP from the RTP Server (Out-4), or Push RTP via RTSP from the RTP
Server (out-11) an internal RTP Push (Out-10) must be configured.
• If using UDP (IN-3), the DME chooses the audio and video ports. The default DME
Auto Unicast Destination Port = 554.
• If using In-3 or In-2 and Flash Server Authentication is enabled on the DME Security
page, you will need to configure an Auto Unicast Destination Username and Password.
• This input method has the desirable characteristic that no input configuration is required
on the DME so the stream name is generated by the stream configuration parameters on
the source side. This name must be unique in the DME. derived from two encoder
parameters which must be configured to be consistent. One of these is the sdp file name.
The second name source is the incoming program name. In some cases, multiple streams
with different bit rates are to be sent to the DME. In these cases, the unique program
names are preserved using the Announce Session Name Override parameter to override
the common program name.
Note If you wish to redistribute the stream using Unannounced RTP (Out-7), Served RTP
from the RTP Server (Out-4), or Push RTP via RTSP from the RTP Server (out-11) an
internal RTP Push (Out-10) must be configured.
Server:Port fml.2D84.edgecastcdn.net
Application 202D84/fls
Note that if you wish to redistribute the stream using Unannounced RTP (Out-7) Served
RTP from the RTP Server (Out-4), or Push RTP via RTSP from the RTP Server (out-11) an
internal RTP Push (Out-10) will need to be configured
Type • RTSP – pull the RTSP stream into the DME. See In-6 < Pull
(RTSP).
• RTMP – pull the RTMP stream into the DME. See In-5 < Pull
(RTMP).
Server:Port The IP address and port number of the VBrick server. Enter a port
number only if you are not using the default RTMP port (1935) or the
default RTSP port (554).
Application Only required if you are pulling RTMP from an RTMP server such as
another DME or an FMS. See In-5 < Pull (RTMP). This string is
defined by the source.
Publishing Point This is the Resource Name on the Program Configuration > Servers
page on the encoder.
Stream Name User-friendly name displayed on the DME. Used, for example, to
simplify cryptic publishing point names coming from a CDN. This
name becomes the incoming stream name the DME uses to distribute
the stream in multiple ways.
User Name If the incoming stream requires authentication, enter the user name
and password.
live unicast stream (e.g. 172.xxx.xxx.xxx) to the DME or a live multicast stream (e.g.
239.xxx.xxx.xxx) to a multicast address. For both of these options you will need to manually fetch
the SDP file from the encoder and FTP it to the root folder (or a subfolder) on the DME. The SDP
file has information describing the stream such as profile, bit rate, addressing, and
transmission method.
Note • In order to redistribute a stream via any of the mechanisms sourced from a multi-
protocol server, an RTSP pull (In-6) must be configured between the RTP
streaming server and the multi-protocol server
• Similarly, if this input mechanism is used to source a transrating operation, the
RTSP Pull must be set up. Announcements need manual configuration if this input
mechanism is used
For live streams the publishing point is the stream name and the application is typically "live".
For stored the publishing point is the file name and the application is "vod". No explicit
configuration of this option is required.
Live
No explicit configuration of this option is required. All live streams in Multi-Protocol server
are available for serving via an appropriate URL. Generally only Transport streams
containing H.264 video are supported, but for transport streams which are brought into the
DME using a transport stream protocol and are transmitted using transport stream protocol,
any codec will be supported. This allows support of MPEG-2 video in transport stream for
this use case. There are number of possible formats for the URLs. The recommended URL
format includes "ts" in the URL path:
rtsp://<dme_ip_address:port>/ts/<stream_name>
Alternate URLs are available for backward compatibility. These URLS are not
recommended. If the stream has been provided using a TS push only (In-4) the following
URLs are acceptable:
rtsp://<dme_ip_address:port>/<stream_name>_ts
rtsp://<dme_ip_address:port>/ts/<stream_name>_ts
rtsp://<dme_ip_address:port><stream_name>?ForceTS
rtsp://<dme_ip_address:port><stream_name>_ts>?ForceTS
rtsp://<dme_ip_address:port>/ts/<stream_name>?ForceTS
rtsp://<dme_ip_address:port>/ts/<stream_name>_ts>?ForceTS
If the stream has been provided using another Input use cases, the following URLs are legal:
rtsp://<dme_ip_address:port><stream_name>?ForceTS
rtsp://<dme_ip_address:port>/ts/<stream_name>?ForceTS
Stored
ts/mpg, mov, or mp4 files can be served using unicast RTSP/TS. Only files containing H.264
content video are supported. The recommended URL format for this use case is as follows.
Alternate URLs are available but not recommended.
rtsp://<dme_ip_address:port>/vodts/<filename.extension>
If the file is a transport stream file then the following formats can be used:
rtsp://<dme_ip_address:port>/vod/<filename.extension>
rtsp://<dme_ip_address:port>/vod/<filename.extension>?ForceTS
rtsp://<dme_ip_address:port>/vodts/<filename.extension>?ForceTS
If the file is a mov or mp4 file then the following format are acceptable:
rtsp://<dme_ip_address:port>/vod/<filename.extension>?ForceTS
rtsp://<dme_ip_address:port>/vodts/<filename.extension>?ForceTS
You can serve an available stream via unicast RTSP with the resulting URL as follows
(append "_ts" to the URL path).
Since the Multi-Protocol server uses a non-standard RTSP port (default 5544), the port
number is required in the URL. There are two use cases for serving RTSP. Out-4 should be
used for optimal stream stability, but if many simultaneous users are expected, the equivalent
Out-3 is preferred. There are three possible protocols used for RTP serving: UDP; TCP
using RTSP interleaved; TCP using HTTP tunneling. Out-4 supports all three of these
options while Out-3 does not support HTTP tunneling. This difference may determine which
RTSP/RTP server to utilize.
Live
This output option requires no explicit configuration on the DME but is available for all live
content present on the Multi-Protocol server, whether brought directly into the server or
Pulled from the RTP server using an internal In-6. An example of a live publishing point is:
rtsp://<dme_ip_address:port>/<streamname>
Stored
There are two options for serving RTSP. Out-4 is used if the VOD content contains
MPEG-4 Part2 video or PCM audio. Since Out-4 is more generally applicable it is
recommended for this use case. Stored content is accessed using the filename of the content.
Examples of stored URLs are:
rtsp://<dme_ip_address:port>/filename.mov
rtsp://<dme_ip_address:port>/filename.mp4
The RTP server on the DME serves RTP files. Play the stream in StreamPlayer, QuickTime,
or VLC using a URL similar to this:
rtsp://server:port/publishing_point.sdp
Since the Multi Protocol RTP server uses an non-standard RTSP port – default 5544 – normally
the port must be explicitly included in the URL.
From a client that supports RTSP RTP streams, enter the RTSP URL, typically:
rtsp:// DME_ip_address:5544/streamname
rtsp://server:port/<publishing_point>
Normally the default port 554 is assigned to the RTSP/RTP server, so the port number is
optional in the URL. If an alternate port is assigned to the RTSP/RTP server, then the port
number must be entered. There are two use cases for serving RTSP. Out-4 should be used for
optimal stream stability, but if many simultaneous users are expected, the equivalent Out-3 is
preferred. There are three possible protocols used for RTP serving: UDP; TCP using RTSP
interleaved; TCP using HTTP tunneling. Out-4 supports all three of these options while
Out-3 does not support HTTP tunneling. This difference may affect which RTSP/RTP
server to use.
Live
Note that this output option requires no explicit configuration on the DME but is available
for all live content present on the RTP streaming server, whether brought directly into the
RTP server or Pushed from the Multi Protocol server using an internal Out-10. A live
publishing point includes the ".sdp" extension in the publishing point name so an example of
a live publishing point is:
rtsp://<dme_ip_address>/my_streamname.sdp
Stored
There are two options for serving RTSP. Out-4 must be used if the VOD content contains
MPEG-4 Part2 video or PCM audio. Stored content is accessed using the filename of the
content. Examples of stored URLs are:
rtsp://<dme_ip_address>/filename.mov
rtsp://<dme_ip_address>/filename.mp4
Note For a step-by-step procedure that explains how to configure a multicast relay in greater
detail, see Playing DME Streams on page 141.
Source Settings
Every relay has one source and one or more destinations. The source is typically the
Hostname or IP address of the DME.
Destination Settings
As noted a relay has one source but it can have multiple destinations. Use Add Destination or
Remove Destination to manage the destinations. Always click Apply to save your changes or
the changes will be lost when you exit the page.
1. The SDP file generated for input use case In-8 < Unicast/Multicast RTP will need to be
copied, renamed, and modified when relayed to another destination. Leave the original
SDP file in place. For the remaining cases, the sdp file will be automatically generated
2. Create a new Relay in System Configuration > RTP Relay Settings by clicking on new
relay.
3. Enter a relay name identifying this relay.
4. In Source Settings enter the IP address 127.0.0.1, Select Request incoming stream.
If the input is In-8, enter the original SDP filename for mount point. In other cases,
select the Target Name of the “Push RTP via RTSP”. Note that the mount point must
always have a “.sdp” file extension. For In-3 or Out-10, use the stream name. If using
Announced UDP, go to Step 7.
5. Enter the multicast or unicast address or hostname to send the stream to in Destination
Settings. Since this is not an auto-unicast relay to another DME (Step 7) or a server that
supports auto-unicast, select Unannounced UDP and enter the first port number used by
the first stream listed in the SDP file. Subsequent streams use an incremental even
number value. If this is a multicast, and needs to adhere to multicast time-to-live
restrictions, enter the value in the Multicast TTL field.
6. Enable and apply the relay and stream will start to be delivered. You will need to
distribute the new SDP file created in Step 1 for your destination for subsequent
multicast clients to use to tune into the relay. If using Unannounced UDP you are done.
7. If you are utilizing the Auto Unicast output feature select Announced UDP and enter
the user name and password if required by the destination device. If the input is
from an Unannounced Unicast/Multicast (In-8) be sure to use the new SDP name.
http://<ip_address>/subfolder/filename.flv
To play a stored non-adaptive HLS stream when no master playlist has been created:
http://<dme_ip_address>/<stream_name>/playlist.m3u8
To play a live or stored adaptive HLS stream and have the player specifically select one
stream (normally for test purposes):
http://<dme_ip_address>/<master_playlist_name>/<stream_name>/playlist.m3u8
To play a live or stored adaptive HLS stream and (typically) have the stream selected by
automatic negotiation between the player and the server:
http://<dme_ip_address>/<master_playlist_name>/playlist.m3u8
HDS
For live HDS, use the following options for a configured live stream.
To play a non-adaptive HDS stream when no master playlist is selected:
http://<dme_ip_address>/HDS/<stream_name>/manifest.f4m
To play an adaptive HDS stream and (typically) have the specific stream selected by
automatic negotiation between the player and the server:
http://<dme_ip_address>/HDS/<master_playlist_name>/manifest.f4m
For stored HDS content the content must be placed in the hdsvod directory under ftproot.
Use the following URLs for playback:
To play a non-adaptive HDS stream when no master playlist is selected:
http://<dme_ip_address>/hdsvod/<filename>.f4m
To play a stored adaptive HDS stream and (typically) have the specific stream selected by
automatic negotiation between the player and the server:
http://<dme_ip_address>/hdsvod/<filename>.f4m
Network
Configured Interface Default = Auto Detect. Use Auto Detect or manually set the bit
Speed / Duplex rate and duplex setting for network devices that do not support
auto negotiation. With Auto Detect the DME will automatically
adjust its duplex setting and speed to match the switch or hub to
which it is attached.
Detected Interface Read only. Displays the current connection speed and duplex
Speed / Duplex setting.
MAC Address The Media Access Control address is a unique identifier assigned
to the DME for network communications.
IPV6 Address Optional. Enter an IPv6 address.
IPV4 Network The DME will auto detect the number of NIC cards installed. If
Interface 2-4 more than one NIC is installed, you can use the additional card(s)
to increase bandwidth and throughput.
• Disabled – Default. You can disable the NIC if, for example,
you have bandwidth constraints imposed by your network or
service provider.
• Load Share Enabled – The NIC will load balance the resources
used by output streams.
NAT
Network address translation is the method by which private IP address are held and
referenced in a network translation table. It is common practice to hide an entire IP address
space, usually consisting of private IP addresses, behind a single IP address. To avoid
ambiguity in the handling of packets, a one-to-many NAT alters higher level information
such as TCP/UDP ports in outgoing communications and maintains a translation table so
that return packets can be handled correctly. The DME allows stream access through a direct
IP address, a Natted IP address, or both.
Primary Server IP Address This is the primary server used for DNS. Note: An invalid
IP address will adversely impact the operation of the user
interface. If the user interface pages are loading slowly,
make sure this is a valid IP address. If you are not using a
DNS server, leave this field blank.
Secondary Server IP Address This is the secondary server used for DNS.
Secondary Server IP Address Secondary host name (DME Host Name or DNS Host
Name) or IP address of valid SNTP server providing time
synchronization. A blank field indicates the server address
will be acquired via the DHCP server only if the Network
DHCP field above is checked.
Ports
RTSP Server Port Default = 554. RTSP port for VOD streams from RTP
server. Cannot be changed. Used to receive an RTP Auto
Unicast stream as input and to serve RTSP RTP clients for
output
RTMP Server Port Default = 1935. RTMP port for Flash VOD streams from
RTMP server. Allows RTP streams as input. For example a
VBrick H.264 encoder can be an RTMP input stream.
RTMPS Server Port Default = 4443. Secure Flash alternate of RTMP.
Multi-Protocol Server RTSP Default = 5544. The port number used by the
port Multi-Protocol Server to listen for announcements.
RTMP Server Announce Default = 5544. Allows for listening for auto unicast
Listener Port sessions from RTSP clients. Lets you send RTP streams to
an RTMP streaming server via Auto Unicast (for
transmuxing to Flash, HLS, or TS). Also allows TS streams
to be served via RTSP on this port.
VBAdmin Server Port Default = 8181. Specifies the listener port for HTTP
management connections as follows: http://
IPaddress:port where IPaddress = DME IP address or
hostname, and port. The port number can be moved to
another port if required as long as it does not conflict with
another existing port in the system.
Conversion Input Port Start Default = 64879. The starting port number used by the
Stream Conversion feature.
Secure VBAdmin Server Port Default = 8383. Specifies the listener port for management
and HTTPS connections. Used for HTTPS connections
when enabled on the Security configuration page. Can be
moved to another port number if required.
HTTP Server Port Default = 80. Sets the port used for progressive download
(HTTP), HLS streams, and Caching. This port can be 80 or a
safe port in the range 1025–65535. An error message will
indicate an invalid port.
HTTPS Server Port Default=443 Secure HTTP port
HTTP Streaming Default = 8080. Sets the port for HTTP tunneling via RTSP.
Tunneling Port The default is 8080 but if you are streaming HTTP directly
from a DME via the Internet, it is a common practice to
change this to 80 and to set any other service using port 80
to a different port. If you change this value you will need to
make a comparable change on the player and on the DME
configuration (i.e. HTTP Tunnel Port) in VEMS.
HTTP Caching ICP Port Default = 3131. Sets the port used to discover multiple web
caches on the local (source) DME and on remote DMEs.
A/V RTP Port Range Start Outgoing port range for RTP/RTCP reports. Default =
56000.
SIP Port SIP port used with VC Gateway. Default = 5060.
External FTP Server Default = Enabled. Disabled will prevent FTP sessions to the DME
appliance. Note that this feature must be enabled to upgrade the
appliance firmware.
External FTP Server Determines the FTP mode, standard (default) or encrypted over
Mode SSL (FTPS), in which the external FTP server will run when FTPing
files to the DME. Any changes to this setting will not reboot the
server but will restart the FTP service—ending any active FTP
transfers in progress. The options let you configure the server to use
TLS, SSLv3, or both. Transport Layer Security (TLS) and Secure
Sockets Layer (SSLv3) are cryptographic protocols that provide
communication security over the Internet. TLS and SSLv3 require
an FTP client to communicate with the FTP server in the same
protocol. Most FTPS clients will support TLS. However since there
may be legacy clients that only use SSLv3, the mode selection lets
you pick one option or both options. The client and server will then
negotiate a stateful connection and agree on various parameters to
establish a secure connection. The DME FTP server supports FTPS
(FTP over SSL); it does not support other secure FTP connections.
This FTPS server supports only explicit FTPS.
• Standard FTP – standard File Transfer Protocol. Not encrypted.
• FTPS TLS Forced – forces the client and server to communicate
via TLS.
• FTPS SSLv3 Forced – forces the client and server to
communicate via SSL.
FTP TLS or SSLv3 Forced – forces the client and server to
communicate via TLS or SSL.
SSH Shell Default = Enabled. SSH Secure Shell access may be used by VBrick
Support Services. Do not use except as directed.
RTMP Server Default = Enabled. Enable the RTMP server for Flash streaming.
RTMPS Server Default = Disabled. Enable the RTMP server for secure Flash
streaming. Note that if RTMPS is used, the DME must be identified
to the player via a FQDN (Fully Qualified Domain Name)
RTMP Announce Default = Enabled.
Receiver
HTTP Server Default = Enabled. Enable the HTTP server.
Flash Server Default = Enabled. If checked, a Flash server can send streams to
Authentication the DME without authentication being required.
External VBAdmin VBAdmin cannot be completely disabled: select HTTP or HTTPS.
Default = HTTP.
• HTTP – VBAdmin is enabled via HTTP.
• HTTPS Only – VBAdmin is encrypted and secured using
HTTPS.
Cache Manager Default = Disabled. For debugging only.
Utility
External VBAdmin Specifies how an external administrator will connect to the DME.
Choices are HTTP or HTTPS for a secure connection
General
Login
System Login Message This customized message (max = 256 chars) will be displayed on
the Login page.
System Login If default is unchecked a custom Logo can be uploaded.
Banner(200x45px)
System Time
Date Time Sets system date and time in mm/dd/yyyy hh:mm format. The
appliance will reset when you click Set Time.
Time Zone Select from list: (GMT-12) Eniwetok – (GMT +12) Auckland.
Daylight Saving Time U.S. only. Check this box and the appliance will automatically
adjust for Daylight Savings Time. This is particularly useful when
monitoring the System Logs.
System Reset
Reset Resets (i.e. reboots) the appliance. A reset does not change, save,
or reset any configuration parameters.
Streaming
This page is used to set various configuration constraints. Be aware that it is possible to
overload the DME. That is you can configure the maximum number of RTP connections
(and the maximum throughput) in such a way that performance will be seriously degraded. If
this happens all clients will be affected and some connections may actually be rejected.
Guidelines for choosing the number of connections depend on the model number (shown on
the System Configuration > General page) of your DME. For best results, use the
recommendations shown below.
Max. Number of RTP Range: 0–1000. Select this value based on number of expected
Connections connections. When selecting the number of connections, the total
expected bandwidth of the streams should not exceed
recommendations. The recommendations shown here for each
model are for total throughput (input and output) in megabits per
second:
• DME Model BPS 7530 - Do not exceed 100 Mbps.
• Hardware Part # 8000-0222-0x00
• Software Part # 7500-0250-0x00
• DME Model XPS 7550 - Do not exceed 500 Mbps.
• Hardware Part # 8000-0223-0x00
• Software Part # 7500-0251-0x00
• DME Model HPS 7570 - Do not exceed 3000 Mbps.
• Hardware Part # 8000-0224-0x00
• Software Part # 750-0252-0x00
Max. Number of Multi Shows the maximum number of allowed connections. Default =
Protocol Connections 500.
RTP Server Max. Set maximum allowed throughput in mbit/sec or kbits/sec. See
Throughput recommendations above.
Multi Server Max. Maximum amount of bandwidth used by streaming clients for
Throughput flash streams. This number is capped by the appropriate DME
license, but can be set lower to limit the actual max bandwidth
used.
Caching
HTTP Caching of content allows a particular piece of HTTP content to be retrieved once
from a remote source on request of a viewer and then delivered locally to any subsequent
viewers. This scheme offers the benefit of reducing the bandwidth required to deliver content
requested by multiple viewers across WAN links. The DME can cache http content whether
stored internally by the DME or externally by another DME or other HTTP source. This
caching is limited to relatively small files not the large files typically delivered via progressive
download. A primary use of the caching is to deliver video from the family of http adaptive
streaming protocols - HLS, HDS, Smooth Streaming, and DASH. Currently the DME is
capable (on its own) of generating only HLS and HDS (see the specific discussion of content
sourcing elsewhere in his manual) so content utilizing these protocols is often sourced from
an external source
Caching Overview
The goal of configuring the caches on each DME in a network is to allow a client in any
subnet (i.e. a "zone" in the VEMS context) to access content hosted by an HTTP server
elsewhere in the network. Although, a major focus of the feature is to allow access to HLS or
HDS content created in another DME, the mechanism is generally the same for all HTTP
accessed content. This is accomplished by creating a configuration of parents and alternate
sources (i.e. siblings) on each DME. Then a client is directed to a DME located in the same
zone by providing the URL of the local DME. It is not uncommon to have different sources
for different types of HTTP content. Given that the most common and efficient way to
configure the caching network is to configure parent relationships, the configuration allows
different parent configuration for each major type of HTTP content.
As shown on the System Configuration > Caching Settings page, each DME configuration
consists of parents for each of a number of types of HTTP content, one Default Parent, and
multiple Alternate Sources. When the DME receives a request for HTTP content it will first
determine if the content is cached locally. It will then try to find the content by (1) seeing if it
is being produced locally; (2) checking with the alternate sources; and (3) trying to get it from
a Parent. Content Specific Parents are checked before the Default Parent. Each parent may
follow the same process trying to locate the content. Once the content is found, it is
delivered to the requesting client through the discovery path. Each DME in the path will also
cache the content to allow provide more efficient delivery to other requestors. For many
simple caching matrices, configuring the Default Parent is all that is required. Note that
HLS/HDS/Smooth Streaming/DASH playlists are never cached since in the case of a live
events, the playlists are constantly updated.
Figure 27 shows a sample network diagram of multiple DMEs with one DME in each zone.
In general, the goal is (1) to allow any DME to be a source of appropriate HTTP content, and
(2) to allow clients in any subnet to access appropriate HTTP created in any other DME.
Caching Configuration
When configuring a DME, the first step is to designate one Content Specific Parent for each
content type. Also identify a Default Parent for the DME for content not explicitly handled
by one of the other parents. In the following example for simplicity, we have only a Default
Parent for each DME - no Content Specific Parents. When Content Specific Parents are
present, separate caching matrices exist for each content type.
In order to minimize the amount of required information, the master parent (DME A in the
diagram above) should be at the "center" of the caching mesh, although you can actually
designate any DME as the master. Each DME should designate as its parent the DME most
efficiently on the path to the master parent. The master parent should designate all other
In another example, suppose a client co-located with DME E in Figure 26 wants to access an
HLS stream initiated on DME G. Since this configuration defines DME A as the Master
Parent, the ultimate path for content delivery would be as follows (with asterisks showing
where caching occurs):
DME G* > DME E > DME D > DME A* > DME D* > DME E*
Note that if DME G was designated as an alternate source for DME E, the path would
simply be: DME G* > DME E*. Although this example designates a DME as master parent
(as often happens if the content to be cached is HLS or HDS where content is not sourced
from a DME, e.g. Smooth Streaming), the master parent will likely be an HTTP server. In the
VBrick ecosystem, a VBrick H.264 encoder can generate a Smooth Stream to a Microsoft IIS
server that can then deliver it to multiple Silverlight clients or to DME caching engines. Since
IIS servers do not utilize the same caching protocols as the DME, an IIS server cannot be
used as an alternate source.
Display Select number of sources (20, 50, or 200) and the number of
available entries in the Alternate Sources table will be adjusted to
match.
Mystro Server Default A DME has one Default parent. When the DME receives a request
Parent for content, this is the final place it looks after failing to discover
the content locally, at an alternate source, or being directed to a
content specific parent. The syntax is: <ip_address>:port
Note: The specified port number overrides the displayed port
number. See Ports on page 64 for more information.
Force HTTPS: Secure SSL communication can be enforced between a DME and
any of its parents (selected individually). A DME can also
communicate securely with alternate sources (siblings) on an all or
nothing basis.
Manage Configuration
Use this page to manage the DME configuration. It lets you set the defaults or reset to the
factory defaults. It also lets you save the configuration to an xml file or restore the
configuration from a previously saved xml file.
Note Be aware that when you change the user name and password for the server (See
Username and Password on page 107) you are changing the FTP user name and
password as well. However, when restoring previously saved settings, the FTP
username and password will not be the same as the system user name and password.
For best results you will need to login again and change the user name and password
to match the FTP username and password. (To keep the same username and password,
change the username and password to something different, and then change it back
again to the current username and password.)
Set Defaults Reset most settings except for Network Settings, and passwords to
the factory defaults.
Set Factory Defaults Reset all settings including Network Settings and passwords to the
factory defaults.
Save Configuration Save all configuration settings that can be restored at a later time.
This action will (1) save all settings in a system location (i.e. a
"snapshot point") and (2) prompt you to save a physical file that
can be restored at a later time.
Restore Configuration • Restore from a file – Restore a previously saved configuration
settings file. Note that this operation will not restore the FTP
user name and password. After a "restore configuration" you
will need to manually change this (if desired) using the
Username and Password page. Typically you would change the
user name and password to something and then change it back
to the desired user name/password after a restore.
• Restore from a snapshot point – Restores from the snapshot
point created with a "Save Configuration." Note: This option
only works if there is a previously saved snapshot created with a
"Save Configuration."
SSL Certificates
When using SSL, a server certificate is required for secure communications. DME Supports
two types of SSL security certificates: Self-Signed and Authority Generated (e.g. Verisign). If
an organization elects to use a certificate from an authority, the necessary information is
entered here. Organizational requirements determine which to use. Both are supported by
Generate Certificate The information in the previous fields is used to generate the
Request request.
Certificate Authority Generated Certificate is entered into this text field.
Install Certificate Install the certificate for SSL use.
SAN/iSCSI Setup
This page is used to set the parameters for accessing content over a Storage Area Network.
Device Enables the DME for SAN use. Disabling will remove the SAN
device and restart the DME. Enabling the device will discover the
device and provision the disk using the folder name specified below.
Username/Password SAN access rights may require use of a user name and password.
Device IP Address Where the SAN is found on the network.
Virtual Folder Name The name given to the SAN disk as a mapped folder. "iSCSI" is
recommended and becomes the folder name in the default FTP
path. Be sure the name you choose is not already in use.
Format Destination • Do Not Format – Default.
• Force Format – When used in conjunction with enabling the
device, this option will delete all content on the disk. If the disk
was previously provisioned, you may not want to format the disk
again.
Discovered Device Read-only. If the SAN is found the device identification will be
provided automatically.
Status Read-only. Displays the disk size, or "unknown" if no SAN is
discovered.
Announcement Types
Management SAP
Management SAPs provide the ability for a DME to announce its existence to interested
programs/devices on a network. The major clients for these announcements are:
Announce SAP
Announce SAPs are used by a DME to announce the existence of live streams. The major
clients for these announcements are:
• StreamPlayer – This application provides an easy way for a PC to view video transmitted
by DMEs. It can be useful as a test device for VEMS Mystro users, or as a standalone
player for much of the content distributed by the DME.
• VEMS Mystro – VBrick's portal product uses the announcements to recognize the
existence of video streams from DMEs. Streams appear on the Mystro interface without
manually configuring URLs of the sourced video.
Management SAP
Transmit Enable Check to enable transmit for management SAPs. Default =
Enabled.
Group Name Optional. This parameter defines the Group Name. It is
included in the Management SAPs used by VBDirectory. It is
used for organizing VBrick devices into groups to simplify use
of VBDirectory.
Unit Number Optional. The appliance unit number (range 0–2147483647) is
used to identify each DME in a group.
Retransmit Time Defines the Management SAP Retransmit Time.
Time To Live For Unicast, the number of hops (between routers) for which
an IP packet is valid in the network. For multicast the
distribution scope of the SAP.
Differentiated Services The six bit Differentiated Services Code Point (DSCP) field in
the header of IP packets for packet classification purposes.
DSCP replaces the three bit Type of Service byte of the IP
header.
IP Address Defines the Destination IP Address for Management SAPs.
Port Defines the Destination Port for Management SAPs.
Announce SAP
Announce Enable Enables configuration of the Announcement.
Send SAP for Internal IP Destination IP address of the Multicast Announcement for
Stream Announcements. Most commonly for multicast, but can
be unicast for direct transmission to, for example, a VEMS
Mystro server.
Send SAP for NAT'ed IP Send a SAP for the natted IP address configured on the System
Configuration > Network page.
IP Address Actual IP address of the SAP announcement.
Port Announcement Destination Port.
Transmit Interval How often the Announcement is transmitted in seconds.
Time to Live For unicast, the number of hops (between routers) for which an
IP packet is valid in the network. For multicast, the distribution
scope of the SAP.
Differentiated Services 8-bit value that instructs (capable) routers on how to handle a
packet. These are generally quality of service items. This is
typically set to all zeros.
Author Optional author information
Copyright Optional copyright information
Input Configuration
Topics in this chapter
Flash/RTSP Pull . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Transport Stream In. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
RTP Playlists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Flash/RTSP Pull
Use this page to configure streams that will be pulled into the RTMP Multi-protocol server
on the DME. Both RTMP and RTPS streams are configured on this page. As shown below
the number of supported streams depends on the DME hardware you purchased. See table
below for the number of configurable input streams.
Transport Stream In
Use this page to configure streams pushed via unicast or multicast to the Multi-Protocol server using
transport stream. The number of streams supported depends on the model of the DME.
MPG2TS Streams
The DME can accept a live unicast or multicast MPEG2TS (with an MP2 or MP4 H264
payload) and deliver it from the DME as unicast or multicast. (A live MPEG2TS is typically
pushed from a a VB6000/7000/9000 VBrick MPEG-2/H.264 encoder or another DME.)
For H264 content wrapped in an MPEG2TS, the stream can also be transmuxed and
delivered as Flash, HLS, RTP, or HDS. For MPEG-2 content, there is no transmuxing. In
order to identify an incoming Transport Stream with MPEG-2 content (so that it can be
"passed through" without further parsing), the incoming stream name must be prepended
with "mp2:" For example when configuring a Transport Stream In (with MPEG-2 content) the
Stream Name must be: mp2:streamname. Similarly you must use the same Stream Name
(prepended with mp2:) when configuring the stream for Transport Stream Out . Using this
stream as input for HLS or other conversions will not work. Passthrough Transport Streams
preserve KLV data when being delivered through the DME.
RTP Playlists
RTP Playlists make it possible to send stored .mp4 (Part 2 or Part 10) VOD files as live
streams. They can consist of a single file or multiple files can be reordered and concatenated
into a single playlist. They can be weighted and played in differing modes: for example they
can be looped or played sequentially. You can then use a playlist to create a multicast relay
using the .sdp file, i.e. the Mount Point . For more about this scenario, see Out-7 > Relay
(Unicast/Multicast) on page 52. To launch a playlist, you can use it in an RTSP URL by
specifying the .sdp file name or you can use it to create an RTP Relay.
Available Playlists
The playlist is playing.
Output Configuration
Topics in this chapter
Flash Push . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
RTSP Push . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Transport Stream Out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
HLS Streaming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
HDS Streaming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
RTP Relay. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Stream Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Flash Push
Use this page to configure streams that will be pushed to a destination device using RTMP.
Possible destinations for Flash push include a Flash server or a CDN (content delivery
network) like Akamai or EdgeCast. This is the preferred protocol for sending streams to
another DME. As shown below the number of supported streams depends on the DME
hardware you purchased. Note that some fields marked with a trailing (o): these (o)ptional
fields may be required at the destination device, for example by a Wowza or other Flash
server. See table below for the number of configurable output streams.
RTSP Push
Use this page to configure streams that will be pushed to a destination device using Auto
Unicast RTP. Possible destinations include servers such as Darwin, Wowza, another DME or
a CDN. The number of configurable streams is dependent on the model of the DME.
Stream Name Name identified on the Multi Protocol input for this stream.
Stream Name The input stream name you will be sending out as a transport stream.
Note: For MPEG-2 content, the Stream Name must be prepended
with "mp2:" See MPG2TS Streams on page 85 for more information.
Multicast/ If multicast output, the multicast address of the output stream, If
Destination IP/ unicast, the destination IP address.
Address
Port The port number you will be sending the stream to.
Announce Name (optional) If multicast, the program name to be included in the SAP
for this stream. If not filled in, Stream Name is used.
Enable Enable or disable the output transport stream.
Status Disabled | Waiting for Stream | Streaming
Bandwidth Override Master Playlists for multiple bit rate streams require the bandwidth
of each individual stream to be included in the Master Playlist. For
example, if the stream is sourced from a VBrick H.264 encoder, the
DME will detect the bandwidth associated with each multiple bit
rate stream. For non-VBrick encoders, enter the bandwidth value (in
Kbps) associated with the stream. In general, use this field only if
the encoder does not supply a bandwidth value. Be aware that if
used, this value will override the encoder–supplied value.
Type The number of video segments in a playlist is defined by the Playlist
Length. This field determines how the DME will handle the
generated segments:
• Rolling – the playlist will have a fixed length regardless of the
number of HLS segments generated. Segments will be added or
deleted to maintain a fixed playlist length.
• Appending – the Playlist Length is ignored and the DME creates
a continuously growing playlist. The maximum playlist duration
is seven days.
Note 1: Multiple appending playlists may use a large amount of
disk space unnecessarily. Use this option only if you will need to
return to the beginning of the playlist.
Note 2: The entire playlist will be deleted if you "disable" HLS
generation (on the HLS Streaming page). When the stream is
active, the playlists and associated segments can be extracted via
FTP.
Playlist Length The number of segments to include in a playlist. Default = 10. This
value is used to enable scroll back in the client player. You can scroll
back up to the number of segments specified here. Be aware that this
function uses disk space for segments that may never be viewed.
Minimum Segment The number of seconds for which a media segment is created.
Length Range 1–60. Default = 8. By increasing this number you will
increase the initial time it takes to play the HLS stream. Since a
separate HTTP access is required for each segment,
Performance is optimized by keeping this number larger. Since a
separate HTTP access is required for each segment, performance
is improved by keeping this number larger. For best results, this
number should always be a multiple of the IDR Frame Interval on
the encoder. For example, if the IDR Frame Interval is 4, this value
should be 8, 12, 16.
Enable Enable or disable the stream.
Status Disabled | Waiting | Active.
Playlist Conventions
When generating HLS streams it is important to understand the conventions used for
creating playlists so they can be played via an HTTP URL.
HDS Streaming
HDS (Adobe MPEG-4 based HTTP adaptive file streaming protocol) is an HTTP-based
media streaming protocol implemented by Adobe. It works by breaking the overall stream
into a sequence of small HTTP-based downloads, each download loading one short chunk of
a video stream. As the stream is played, the client can select from a number of different
alternate streams containing the same material encoded at a variety of data rates, allowing the
streaming session to adapt to the available data rate. At the start of the streaming session, it
downloads an extended f4m playlist containing the metadata for the various substreams
which are available. Since its requests use only standard HTTP transactions, HDS is capable
of traversing any firewall or proxy server that allows standard HTTP traffic, unlike UDP-
based protocols such as RTP.
Playlist Conventions
When generating HLS streams it is important to understand the conventions used for
creating playlists so they can be played via an HTTP URL.
RTP Relay
Use this page to configure or edit relays. A streaming RTP relay forwards an RTP stream
from a source to either a multicast or multiple unicast destinations. One of the primary
functions of a relay is to minimize the usage of network bandwidth across limited bandwidth
WAN links by receiving an single incoming stream and outputting either a multicast stream
or serving multiple unicast streams. Relays can also be used to distribute the load across
multiple servers. The incoming stream can be provided to multiple destination servers and
then redistributed to clients. Possible destination servers, include QuickTime, Darwin, or
another DME. There are a number of methods for receiving an incoming stream. The
most common is to receive an incoming stream into the Multi Protocol Server and then
push the stream to the RTP Server (Out-10). It is also possible to receive a Push directly
into the RTP server (In-3) or to receive an unannounced unicast or multicast. In this
scenario you will need to manually place the multicast/unicast .sdp file from the source on
the destination server.
Another important use case for providing input to the RTP server is from the VC Gateway.
This input does not require explicit configuration. In addition to the output options for
delivering multicast or unicast streams via Push mechanisms, streams are available via the
RTPSP/RTP server without any explicit configuration. When clients open an RTSP stream
to the .sdp file from a server, they will receive a reflected unicast of the incoming stream.
This method can be used to distribute the stream to either client players or to multiple
destination servers.
Note If a stream which is present on the RTP server is to be used as source for any output
from the Multi Protocol serer, an RTSP/RTP Pull (In-6) must configured on the Multi
Protocol server. For more about configuring this scenario, see Out-7 > Relay
(Unicast/Multicast) on page 52.
New Relay
Source Settings
These settings describe the source of the stream to be relayed. It can be sourced internally
from the DME (127.0.0.1); it can be fetched from elsewhere; or you can wait for it to be
announced. The dominant use case is to source the stream internally from the DME.
Destination Settings
Stream Conversion
Use this page to configure input/output stream type conversion. The most common use of
the converted streams is to convert a high rate stream into multiple lower rate streams for
delivery via one of the HTTP adaptive protocols (HDS or HLS). The conversion process
does not modify the resolution of the incoming stream—the end devices will usually
efficiently scale the incoming video to fit the screen. The conversion changes the bit rate, and
in some cases, will modify the frame rate.
Note If you purchased the Stream Conversion feature, the license for this feature must be
activated before the Stream Conversion option is shown in the DME's Configuration
Menu. For more information see Activate Feature on page 78.
The stream conversion function is part of the Multi Protocol server. This means that the
source stream must be present in the Multi Protocol Server and the output stream is available
to the Multi Protocol server. If the input stream is sourced from the RTP server (In-3 or
In-8) or from the VC Gateway, then it will need to be pulled into the Multi Protocol server by
an internal RTSP/RTP pull (In-6). The output parameters for the various available
conversion templates are shown below: The number of conversions configurable is limited
according to model number of the DME as shown in Table 13.
Stream Name Name of the preconfigured source stream selected from the dropdown
list
Conversion Type Sets the video, audio, and resolution parameters for the output stream.
Framerate is the framerate of the source input stream. See Table 12 for
parameter details.
Converted Output The stream name for the converted output stream. This is used as an
Stream Name input Stream name when defining how the converted stream is to be
used as an Output.
Notes • The actual number of supportable conversions depends on the hardware deployed.
This is a particularly important consideration when using a virtual machine
versions of the DME. Each conversion takes a minimum of one core. Further if
the bit rate of the output stream exceeds 500K an additional core is required. If the
bit rate exceeds 1Mbps, then two additional cores are needed.
• In order to play converted streams, some PCs may need to have the Catalyst
Control Center (for the video card) installed and the option "Enforce Smooth
Video Playback" disabled.
User Configuration
Topics in this chapter
Username and Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Stream Input Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Note Be aware that when you change the user name and password for the server you are
changing the FTP user name and password as well. See the Note on page 74 for more
information.
Note Be aware that you must know the current Administrator User Name and Password to
change the Readonly password. Further, while you may change the password for the
Readonly account, the User Name will always be the default, readonly, as referenced
above.
Current Stream Input Read only. Default = broadcast |broadcast (user name/
Authentication User password).
Name
New User Name Enter new announce user name.
New Password Enter new announce password.
Re-enter New Password Re-enter new password and be sure to click Change Password .
VC Gateway Configuration
Topics in this chapter
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Incoming Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Outgoing Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Overview
Video conferencing enables people at different locations to see and hear each other, and to
share access to documents, slides, and desktop applications. Each site typically has a video
camera, a display device, as well as a microphone and speakers. The DME video conferencing
solution builds on a simple video conference by delivering a multi-vendor, standards-based
stream that lets smartphones, tablets, PCs/Macs, and TVs display the video conference. It
provides a cost effective way to leverage existing video conferencing investments by
delivering the video conference audio and video as a stream to other elements in the VBrick
ecosystem. The stream can be centrally managed and delivered to thousands of users across
multiple sites. It can also be recorded for subsequent on-demand viewing.
Note If you purchased the Video Conferencing feature, the license for this feature must be
activated before the VC Gateway Configuration option is shown in the DME's
Configuration Menu. For more information see Activate Feature on page 78.
Vendor Compatibility
The VC Gateway is a standards-based solution. It integrates with video conference
infrastructure using SIP (RFC 3264) and H.264. The products shown in Table 14 have been
tested successfully at VBrick. Many of the listed vendors make similar products within the
same families that share the same software and operating parameters and it is expected that
these devices will interoperate successfully as well. However, there are always variations in
software releases and interoperability cannot be guaranteed without testing your specific
product. In short a trial is always recommended. Other vendors and other products may also
work with the VC Gateway but have not been tested.
Table 14. Supported Videoconferencing Vendors
Vendor Product
Avaya 1X Communicator, Avaya Flare, Avaya 1020, Avaya 1050
Cisco Tandberg C20
CounterPath Bria 3.3.1
LifeSize Express 220, Team 220
Polycom HDX 8000 HD, iPad
Note The DME can receive a G.711 audio stream from the VC Gateway via a connected call
and will convert the audio to AAC which can then be streamed out of the DME via
RTP and other delivery methods. Without a VC Gateway the DME cannot pull
directly from a source that has G.711 audio. The video input through the VC Gateway
must be H.264.
• Live Video – Provided SAPs are enabled for the outgoing streams, DME streams
sourced from the VC Gateway are automatically discovered and displayed in VEMS.
• Stored Video – The VC Gateway can be configured to automatically record and ingest
streams into VEMS Mystro 6.x only using the VC Gateway "record" feature. These
streams will be displayed on the Stored Video pages.
Note If you exceed the permitted number of recordings, allowed by VEMS Mystro, the
recording(s) will fail and an application error will be shown on the VEMS
Dashboard—not in the DME.
Incoming Lines
The DME can be invited into a video call by an individual video conference camera and
codec or by a multipoint control unit (MCU). When the remote video conferencing system
will be initiating a call to the DME, the VC Gateway is configured using the Incoming Lines
pages. The Incoming Lines page shows the line table. This table shows the current state of all
available incoming lines.
Note As a best practice when using the VC Gateway for incoming audio-only calls, define
one or more lines for audio-only usage. To subsequently use those lines for incoming
audio/video calls you must restart the Streaming Server Service on the System
Maintenance page.
Line Name The SIP Line name is used as Stream name elsewhere in the system
Page Refresh Interval Select a refresh interval from the dropdown or Never (not
recommended).
Line Number Click once to select and edit any color-coded line (1–n).
New line (grey)
Connected line (green)
Not connected line (red)
Line Name User-configured line name. Default = IncomingLine<n>
Line Identity The DME line name and IP address in the format shown. This is
the identifier the remote videoconferencing unit will use to call
into the DME: sip:<line_name>@<dme_ip_address>
Should Register The session will be registered with a SIP registration server if
present. Default = Enabled.
Registrar Address Optional field to add the IP address of a registrar if one is
required.
Line Authentication Id Line Authentication Id for configured SIP registration server.
Note The Incoming and Outgoing Details pages have an OK button (in addition to Apply,
Revert, and Default). Use the OK button to save changes and exit back to the previous
page. Use the Apply button to save changes without leaving the Details page. This
makes it easy to edit a different line without leaving the Details page.
Configure Multicast Check this box to enable and display the relay configuration
RTP Relay options. Default = disabled.
Relay Name Enter a unique name for the relay.
Base Port Use this parameter when pushing the stream to another DME.
The base port will be incremented by 2 for each RTP stream. Use
numbers that are not already being used for the entire SDP
sequence set.
Out SDP File Enter a name for the auto-generated .sdp file.
Multicast TTL Specify the number of routers the multicast stream will pass
through before it stops propagating over the network. Range = 1–
255.
Outgoing Lines
The DME can also initiate a call into a videoconference. When the DME initiates a call to the
remote video conferencing system, the VC Gateway is configured using the Outgoing Lines
pages. The Outgoing Lines page shows the line table. This table shows the current state of all
available outgoing lines.
Page Refresh Interval Select a refresh interval from the dropdown or Never (not
recommended).
Line Name User-configured line name. Default = OutgoingLine<n>
State Displays various descriptive messages indicating the current "state"
of the line. The first connected line will display as connected ;
additional connected lines will display as bridged .
Edit Edit | New. Click to create a new line or to edit an existing line.
Proxy Address Optional field to list the IP address of a proxy server if one is
required.
Call Line Automatically initiates a call when you check the box and click OK
or Apply.
Defaults
Use this page to set SIP defaults for many of the parameters on the incoming and outgoing
line detail pages. Note that any changes you make on this page do not affect existing lines.
Changes made on this page will apply only to "new" incoming or outgoing lines.
Logging
Topics in this chapter
Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Logging
The Error Log on the Monitor > Error Log page displays DME status messages as well as
errors. The Access History on the Monitor > Access History page shows files that have been
accessed since the last reset. This page enables or disables logging and sets overwrite rules.
Monitor
Topics in this chapter
System Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
RTP Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Multi Protocol Connections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Relay Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Access History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Upgrade Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Error Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
System Usage
Page Refresh Interval Select the desired page refresh interval from the dropdown.
RTP CPU Load Shows the CPU load on the RTP server.
RTMP CPU Load Shows the CPU load on the RTMP server.
Total CPU Load Shows the CPU load on both the RTP and RTMP servers.
Disk Usage System Total megabytes used and available for DME system resources.
RTP Connections
This page shows all RTP users currently connected to the DME. Click on the column header
to sort the entries up or down.
Display entries From the dropdown, select the number of entries you wish to
display on the page.
Page Refresh Interval Select the desired page refresh interval from the dropdown.
Connected Users The DME displays the following information for each connected
user. Click on the header field to sort ascending or descending.
• Type – indicates a stream is present.
• IP Address – user IP address.
• Bit Rate – stream bit rate in Kbps.
• Bytes Sent – total bytes sent.
• % Packet Loss – percentage packet loss.
• Time Connected – total time connected.
• Connected To – target IP address.
Display entries From the dropdown, select the number of entries you wish to
display on the page.
Page Refresh Interval From the dropdown, select the desired page refresh interval.
Connected RTMP The DME displays the following information for each connected
Streams stream. Click on the header field to sort ascending or descending.
• Type – indicates a stream is present.
• Stream Type – the following strings are displayed only when
data is being streamed. "Active" denotes an inbound stream (i.e.
one being generated); "Streaming" denotes an outbound stream.
– In RTMP Active
– In RTP Active
– In TS Active
– Out RTMP Streaming | blank
– Out RTP Streaming | blank
– Out TS Streaming | blank
– Out HLS Active | blank
– Out HDS Active | blank
• IP Address – IP address of connected user.
• Port – port to which user is connected.
• Session ID – unique session ID for connection.
• Packets Sent – number of packets sent.
• Packets Lost – number of packets lost.
• Time Connected – total time of connection.
• Connected To – target IP address.
Relay Status
This page shows the status of all defined relays. Click on the column header to sort the
entries up or down
Access History
This page shows the file names that have been requested by all users since the last DME
reset. It is enabled and rolls over (i.e. overwrites the information) as configured on the
Logging page.
Files Requested File names requested since the last DME reset.
Requests Number of times the individual file was requested.
Upgrade Log
This log shows a history of all DME upgrade activity. Any .rpm upgrades will be reported on
this page as successful, incorrectly signed, or failed. These results are explained in more detail
below. For an explanation of how to upgrade your DME, see Software Upgrade on page 151.
Error Log
The Error Log shows status messages as well as errors. It is enabled and rolls over (i.e.
overwrites the file) as configured on the Logging page. To reset the Error Log manually,
scroll to the bottom of the page (if necessary) and click Reset Error Log. If problems occur,
you can copy and paste the error text from this page and send to VBrick Support Services via
email. You may also be asked to fetch other log files available in DME root via FTP.
System Maintenance
Note After a power failure the DME may go into read-only mode and FTB will be disabled.
As a best practice, always run Reset with Check Disk after a power failure.
Reset with Check Disk Performs a System Reset (see below) and runs a check disk at
startup. Use this option if the system was powered off
unexpectedly. Be aware that, depending on the amount of content
on the hard drive, a check disk can be time consuming.
Shutdown Performs graceful shutdown and removes power. Toggle the power
switch on the server to restart.
Reset Resets (i.e. reboots) the appliance. A reset does not change, save,
or reset any configuration parameters.
Note: RTP UDP Auto Unicast connections from a VBrick encoder
are not restored after a System Reset. To restore the connection,
disable and then enable the RTP transmitter on the encoder.
Disk Status
This page shows the size and status of Existing Disks (i.e. those disks that were present
originally or were added using the "provisioning" process) and of New Disks Found which
have not yet been provisioned.
Disk Provisioning
This topic explains how to provision a new disk in a virtual environment. DME Release 3.1.5
or higher lets you add a new disk to your VMWare virtual environment in order to extend the
current content area available in the DME. The default partition for each new disk is 250 GB.
You can add more disks to the provisioned set by adding more virtual disks and repeating the
process explained below. The number of disks you can add is limited only by the resources of
your server machine.
Notes • Be aware that disk provisioning is irreversible. Once you have added a new
virtualized disk, it cannot be removed.
• Always create a VMWare "snapshot" before you begin so that you can revert to
you original configuration if anything goes wrong.
• Provisioning a disk is not the same as adding an iSCSI disk to the DME. If you
are adding an iSCSI disk see SAN/iSCSI Setup on page 77.
8. When the provisioning is complete, the DME will reboot, the streaming services will
restart, and the Maintenance > Disk Status page will show the new disk as active and
available for use.
9. Go to the Monitor > System Usage and the Disk Usage Content field will show exactly
how much space is in use and available for use.
Diagnostics
Topics in this chapter
Trace Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
Trace Capture
The Trace Capture utility creates a TCP dump of network traffic that can be used by VBrick
Support Services when troubleshooting VC Gateway issues. It captures packets based on the
criteria you select and can subsequently be viewed in Wireshark or a similar application. As
explained below, you run the utility, retrieve the capture file, and send to it VBrick.
Page Refresh Interval Choose how often to refresh the information on the page.
Interface to capture • eth0 – this is the same as bond0 if load sharing is enabled on the
from IPv4 network interface.
• bond0 – captures a trace across all network interfaces that are
enabled.
• any – captures a trace for both external and internal interfaces
(bond0 and lo).
• lo – captures a trace of the local host interface (127.0.0.1) only.
Capture file size Specify the size (default = 50 MB) of the capture file. The capture
will terminate when file size reaches this value.
Status Displays Capturing while a trace capture is in progress or blank
when finished or idle.
Start | Stop Capture Start or stop the capture process.
Overview
DME input and/or output streams can be configured to play on desktops (with a variety of
players), set top boxes, and mobile devices at different locations and in a variety of different
physical configurations. The DME supports live RTP, Transport Stream, RTMP (Flash), HLS,
and HDS streams. It also functions as a progressive download server for .wmv and other files.
Stored VOD files are supported by the onboard RTP and Multi-Protocol VOD servers and
added to the DME via FTP. To play these streams you will need a corresponding player.
Often these players are available either as Standalone players or embedded into a web
page.
When using the Multi-Protocol server, the port does need to be identified. The publishing
point is the stream name so, an example URL would be:
rtsp://<dme_ip_address:5544>/vbStream1S1
Regardless of the server used, playing stored content uses an RTSP URL pointing to the file
in the this format:
rtsp://<dme_ip_address:port>/<filename>
The RTP server can play files containing a variety of codecs, though it is recommended only
for stored content. Again, the port does not need identification unless it has been changed
from the default 554. An example URL would be:
rtsp://<dme_ip_address>/myfile.mov
In QuickTime or VLC you open the player and point to the .sdp file. In StreamPlayer you
must enter the complete path to the file in the IP Address field and then click Play.
To play live adaptive HLS streams you will use a URL similar to the following:
http://<dme_ip_address>/<masterplaylistname>/ playlist.m3u8
To play stored non-adaptive HLS streams you will use a URL similar to the following:
http://<dme_ip_address>/<stream_name>/ playlist.m3u8
To play stored adaptive HLS streams you will use a URL similar to the following:
http://<dme_ip_address>/<masterplaylistname>/ playlist.m3u8
Alternatively you can play a transport stream via a "served unicast." You will need a player,
like VLC or StreamPlayer, that supports delivery of transport stream via RTSP. The
recommended RTSP URL for live playback is:
rtsp://<source_dme_ip_address:port>/ts/<stream_name>
The port is required even if not changed from the default (5544). If necessary see Out-2 >
Serve TS via RTSP on page 47 for alternative URLs.
To play stored streams from a DME on a Flash client using RTMP you will use a URL
similar to the following:
rtmp://<dme_ip_address>/vod/<filename>
A port number is not required, unless the default port (1935) has been changed.
To play stored streams from a DME on a Flash client using RTMPS you will use a URL
similar to the following. Note the port number is required:
rtmp://<dme_ip_address:port>/vod/<filename>
HDS streams can be played directly from the source DME or a local DME via caching. Use
the local DME name if it is configured to cache from the source.
To play live non-adaptive HDS streams on a Flash client you will use a URL similar to the
following:
http://<dme_ip_address>/HDS/<stream_name>/manifest.f4m
To play live adaptive HDS streams on a Flash client you will use a URL similar to the
following:
http://<dme_ip_address>/HDS/<masterplaylistname>/manifest.f4m
Overview
These use cases describe all of the steps you will need to perform in order to create a
Multicast RTP Relay. The first example explains how to configure for unicast source; the
second example explains how to configure for an auto unicast source. These use cases
provide a complete example of the types of things you will need to do to use the DME
effectively. The VBrick Distributed Media Engine contains a fully featured RTP server which
lets you create an Multicast RTP Relay stream. The relay can be streamed from a unicast
source or from an auto unicast source on a VBrick (7000/9000 Series) H.264 encoder. Both
of these scenarios are explained in detail on the following pages. For more information about
encoder settings and parameters, see the VBrick H.264 Encoder Admin Guide.
Note The multicast relay configuration explained here corresponds to the output stream
described in Out-7 > Relay (Unicast/Multicast) on page 52. The key difference is that
this topic explains how to configure a multicast relay in much greater detail.
DME Setup
1. Configure a new Relay:
2. Play the Multicast Relay using QuickTime with a URL in the following format. If desired,
a URL can be added to the VBrick's external Announce Settings on the Program
Configuration > Transmitters page.
http://<dme_ip_Address>/<testmulti2.sdp>
Other Tasks
Topics in this chapter
Software Upgrade. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Installing Security Updates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Managing Disk Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Backup and Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Software Upgrade
You can upgrade the DME software using VBrick's VBDirectory management application
and the VBDMEDownload upgrade tool. You can launch the upgrade tool from the Start menu
(go to Start > All Programs > VBrick > VBDMEDownload) or from VBDirectory. For
details that explain how to use the tool, see the DME Release Notes. To view the history of all
previous upgrade activity, see the Upgrade Log on page 131.
This topic explains how to configure various VBrick devices to stream to and from the DME.
For more information about these products, see the corresponding VBrick documentation.
All VBrick documentation is posted on the web at www.vbrick.com/documentation. Note
that the examples in this topic refer to the following drawing.
Playback Examples
TS vbricksys://<multicast_ipaddress>:port
RTP http://<dme_ipaddress>/<multicast_sdp_file.sdp
Multicast
VBOSS
Example 1
To send a stream from VBrick Encoder > VBOSS > DME > Flash client:
1. Configure an RTMP Transmit from encoder to VBOSS URL.
2. In the DME, configure E to L (to pull the VBOSS URL).
3. Distribute as Flash: vbrtsp://<dme_ipaddress>/live/<stream_name>
Example 2
To send a stream from VBrick Encoder > DME > VBOSS:
1. Configure an RTP Auto Unicast (In-2 ) from encoder to DME.
2. Configure RTMP Push ( Out-9) to the VBOSS publishing point.
Playback Examples
iOS http://<dme_ip_address>/HLS/<stream_name>/playlist.m3u8
Note When entering metadata (e.g. Session Info, Origin E-Mail, etc.) be sure to remove any
leading spaces.
iOS http://<dme_ip_address>/HLS/<stream_name>/playlist.m3u8
5. When done click OK and Finish and the H.264 for Flash option will be added to the
menu as a selectable output option.
Outputs
Note When entering metadata (e.g. Session Info, Origin E-Mail, etc.) you may need to
backspace to the beginning of the field to remove any leading spaces.
4. Publish the .sdp file (via FTP) to the root folder on the DME using FTP. After you FTP
the file, there will be a live RTP stream in the DME that can be served in a variety of
ways (see Figure 37). For example you can reflect the stream as a multicast relay or auto-
unicast it to another DME. See Configuring DME Streams on page 33 for more
information.
Playback Examples
iOS http://<dme_ip_address>/HLS/<stream_name>/playlist.m3u8
RTMP
Desired Result Use the stream to create a HLS and multicast RTP output
Solution • RMD and HLS: In-1 to Out-6
• RMS and HLS: in-2 to Out-6
• RMD to Multicast: In-1 to Out-10 to Out-7
• RMS to Multicast: In-2 to Out-10 to Out-7
Desired Result Use the RTMP stream to generate unicast flash streams, and convert it to
RTP to be able to multicast it as well.
Solution • Unicast Flash: n-5 to Out-3
• Multicast RTP: In-5 to Out-10 to Out-7
RTP
Desired Result Send announced and unannounced RTP streams from an encoder to the
DME and give it a name in the DME.
Solution • Unannounced: In-8
• Announced: In-5 to Out-10 to Out-7
Desired Result Use the received RTP stream to create a multicast to a multicast address to
play in an enterprise stream player.
Solution • Unannounced: In-8 to Out-7
• Announced: In-2 to Out-10 to Out-7 (preferred) or In-3 to Out-7
Desired Result Use the received RTP stream to create a flash stream to play in a Flash
player via unicast
Solution • Unannounced: In-8 to In-6 to Out-1
• Announced In-2 to Out-1 (Preferred) or In-3 to In-6 to Out-1
Desired Result Use the created Flash stream to generate a HLS stream so that the stream
can be played on an iPad via unicast.
Solution • Unannounced: In-8 to In-6 to Out-6
• Announced: In-2 to Out-6 (Preferred) or In-3 to In-6 to Out-6
Transport Stream
Desired Result Send an unannounced Transport stream from an encoder with KLV data
to DME and give it a name.
Solution In-4
Desired Result Use the name TS stream to send out to 3 other TS destination via RTSP.
Solution In-4 to Out-2
Desired Result Use the same TS stream to multicast to a single multicast address.
Solution In-4 to Out-5 ( T S ) or In-4 to Out-10 to Out-7 (RTP)
Desired Result Use the same TS stream to play via Flash player.
Solution In-4 to Out1
Desired Result Use the same TS stream to create a HLS stream to be played on an
iPhone/iPod touch.
Solution In-4 to Out-6
HLS
Desired Result Generate a HLS stream from any source and have a second DME be able
to deliver the stream to its HLS clients (vice versa).
Solution 1. Generate a HLS stream: Either (In-3 or In-8) to In-6 to Out-6 or (In-2 , In-6 ,
In-5 , In-1 , In-4 , or In-7 ) to Out-6
2. Do so on both DMEs, make sure HLS names are different from each
other
3. Modify Caching Alternative Source on DME 1 to have IP address of
DME 2.
4. Modify Caching Alternative Source on DME 2 to have IP address of
DME 1.
5. The URL for both streams available in both DMEs:
http://IPofDME1/HLS/stream1/playlist.m3u8
http://IPofDME1/HLS/stream2/playlist.m3u8
http://IPofDME2/HLS/stream1/playlist.m3u8
http://IPofDME2/HLS/stream3/playlist.m3u8
Desired Result Generate three different streams, coming in three separate ways, from the
same source, into a DME to create a master playlist with three streams in
reverse bitrate order so that all of them can be played on an iPad. You
should use the ideal setting for the best video/audio playable on an iPad.
Solution 1. Use same source type from encoder, not three different types.
2. Select either RTP out as IN-2 ; RTMP out as In-1 ; or TS out as In-4 .
3. Use Announce Session Override in encoder to name streams
Rate1High, Rate2Mid, Rate3Low if using In-2 or In-1 as input.
4. Use the names above in the DME if using In-4 as input.
5. Add each stream for HLS generation (Out-6 ).
6. Use the same name for master playlist name (e.g. dmeconfig) to make
them part of an adaptive set
Adaptive URL: http://<dme_ipaddr>/dmeconfig/playlist.m3u8