Envivio 4Sight Service manual

4Sight
Administrator Guide
Version 5.0 rev.4
May 17, 2006
P/N 01000002

© 2005-2006 Envivio Inc. All rights reserved.
4Sight Administrator Guide 5.0
This manual and the software described in it are furnished under license and may be used or copied only
in accordance with the terms of such license. The content of this manual is provided for information only.
It is subject to change without notice and should not be construed as a commitment by Envivio Inc.
Envivio Inc. assumes no responsibility or liability for any errors or inaccuracies that may appear in this
book.
Except as permitted by such license, no part of this publication may be reproduced, stored in a retrieval
system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise,
without the prior written permission of Envivio.com Inc. Please remember that existing media that you
may want to include in your project may be protected under copyright law. Incorporating such material
into your new work could violate the rights of the copyright owner. Please be sure to obtain any required
permissions from the copyright owner.
Envivio and the Envivio logo are registered trademarks of Envivio Inc. EnvivioTV, 4Caster, 4Coder,
4Manager, 4Sight, Mindshare and 4View are trademarks of Envivio Inc.
Microsoft, Windows, Windows 2000 Pro, Windows 2000 Server, Windows 2000 Advanced Server, and
Windows Server 2003 are registered trademarks of Microsoft Corporation in the U.S and/or other
countries. Apple, Macintosh, Power Macintosh, QuickTime, and TrueType are trademarks of Apple
Computer, Inc. registered in the U.S. and other countries. QuickTime and the QuickTime logo are
trademarks used under license. Helvetica and Times are trademarks of Linotype-Hell AG and/or its
subsidiaries. Pentium is a registered trademark of Intel Corporation. Flash is a trademark of Macromedia,
Inc. Sun is a trademark or registered trademark of Sun Microsystems, Inc. in the United States and other
countries. Linux is a registered trademark of Linus Torvalds. Red Hat is a registered trademark of Red Hat,
Inc. All other trademarks are the property of their respective owners.
Protected by U.S. Patents [patents pending]. Envivio Incorporated, 400 Oyster Point Blvd., Suite 325,
South San Francisco, California 94080 USA.
Notice to U.S. government end users. The software and documentation are “commercial items,” as that
term is defined at 48 C.F.R. §2.101, consisting of “commercial computer software” and “commercial
computer software documentation,” as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202, as
applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §§227.7202-1 through 227.7202-4, as applicable,
the commercial computer software and commercial computer software documentation are being
licensed to U.S. government end users (A) only as commercial items and (B) with only those rights as are
granted to all other end users pursuant to the terms and conditions set forth in the Envivio Incorporated
standard commercial agreement for this software. Unpublished rights are reserved under the copyright
laws of the United States.

Acknowledgments
Envivio Incorporated acknowledges use of software from the following sources and includes their
copyright notices and required statements. here.
This software is based in part on the code of the Darwin Streaming Server (for which the source code is
available under the terms of the Apple Public Source License Version 1.2 at
http://www.opensource.apple.com/projects/streaming/).
The modifications applied to the original code are available at: http://www.envivio.tv/downloads/qtss.

v
Contents
Chapter 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
VOD functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Networking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Monitoring and administration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Error Resilience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Supported standards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Envivio Professional Services and Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Chapter 2 WebAdmin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Restricting access to the WebAdmin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Using the WebAdmin configuration file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Using the WebAdmin user interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Changing the WebAdmin default user name and password . . . . . . . . . . . 20
Chapter 3 Video Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
Setting up Movie folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Using 4Sight as a reflector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Basic setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Configuration examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Using 4Sight as a relay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Basic setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Configuration examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

vi 4sight Administrator Guide
Contents
Relay a UDP stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Relay an RTSP requested stream. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Relay an SAP announced stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Connection to the output stream using an SDP file . . . . . . . . . . . . . . . . . . . 36
Connection to the output stream using SAP . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Status of the configured relays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Stream Switching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Basic setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Configuration example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Connection to the output stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Status of the configured switchers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Chapter 4 Playlist Broadcaster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Basic setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Setting up a playlist using the WebAdmin . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Restrictions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Chapter 5 Load Balancer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Basic setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Adding a slave server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Deleting a slave server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Chapter 6 Authentication and Authorization . . . . . . . . . . . . . . . . . .55
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Basic Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
User, Group, and Access files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
User file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Group file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

4sight Administrator Guide vii
Contents
Access file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
The qtpasswd utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Configuration example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Chapter 7 External authorization module . . . . . . . . . . . . . . . . . . . . .65
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Installing the authorization module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Basic example of external authorization module . . . . . . . . . . . . . . . . . . . . . . . . . 68
Chapter 8 SNMP monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
Using SNMP monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Monitoring 4Sight using MG-SOFT MIB Browser. . . . . . . . . . . . . . . . . . . . . . . . . . 71
Enabling SNMP trap reception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Appendix A How-To. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79
How to update an SDP file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
How to link to a streamable content in a web page. . . . . . . . . . . . . . . . . . . . . . . 81
How to embed a streamable content in a web page. . . . . . . . . . . . . . . . . . . . . . 82
What is a hint track . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Can I use multicast over Internet? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Appendix B The Video Server configuration file parameters . . . . . .85
General parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Thinning parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
More general parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Reliable UDP parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
RTSP debugging parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Specific parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Reflector module parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Access Log module parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Error Log modules parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

viii 4sight Administrator Guide
Contents
Access module parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
WebAdmin parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
File module parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Flow control module parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Multiple movie folders parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Relay parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Switcher parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Licensing module parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Load balancing module parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
External authentication parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Recorder module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Appendix C The Playlist Broadcaster configuration file . . . . . . . . . . .99
Appendix D The Web Admin configuration file . . . . . . . . . . . . . . . . . .103
Appendix E Video Server access log file . . . . . . . . . . . . . . . . . . . . . . . .105
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115

Chapter 1
Introduction

12 Chapter 1
Introduction
Version 5.0
Overview
The 4Sight Video Server from Envivio provides MPEG-4 and H.264
streaming capabilities for small, medium and large scale enterprise,
broadband and broadcast deployments. It has been designed and
optimized to meet the needs of professional video distribution
applications.
Broadcasters and cable operators can use the 4Sight Video Server to
manage and distribute interactive multimedia content through IP
networks to EnvivioTV or any other MPEG-4 compliant player
VOD functions
The 4Sight Video Server can stream any MPEG-4 file that conforms to
the ISO standard, whether the file is generated by the Envivio 4Coder or
some other MPEG-4 encoding tool.
Both Advanced Video Coding (AVC/H.264) and Advanced Simple
Profile (ASP) are supported.
Files need to be hinted before being served by the 4Sight Video Server.
The 4Sight Video Server supports trick play features (fast forward, fast
backward) on all MPEG-4 content. The rendering of content played in
fast forward or fast backward depends on the way the content is encoded
(more specifically on the key frame frequency).
Networking
The 4Sight Video Server sends media to the network using the IETF
defined suite of protocols based on IP for real-time streaming, and
supports HTTP tunnelling to support firewall configurations. It also uses

4Sight 13
Administrator Guide
Version 5.0
the associated IETF recommendations dedicated to MPEG-4 transport
over IP.
Monitoring and administration
Monitoring of the 4Sight Video Server can be done while it is online using
either the 4Sight WebAdmin which is a web-based interface or using
SNMP.
When the 4Sight Video Server is offline, monitoring can be done using
the log files.
Performance
In streaming, 4Sight can support up to 400 simultaneous users, at
1.5 Mbps.
Error Resilience
4Sight offers error resilience so that EnvivioTV can receive content
smoothly under severe network packet loss conditions (up to 2% packet
loss rate).
Both 4Sight and EnvivioTV provide a rebuffering management policy
that improves the user experience when traffic is congested.
Supported standards
The following protocols and standards are implemented in the 4Sight
Video Server:
•RTSP (Real Time Streaming Protocol), IETF RFC 2326
•SDP (Session Description Protocol), IETF RFC 2327

14 Chapter 1
Introduction
Version 5.0
•UDP (User Datagram Protocol), IETF RFC 769
•TCP (Transmission Control Protocol), IETF RFC 793
•IP (Internet Protocol), IETF RFC 791
•RTP (Transport Protocol for Real-Time Applications), IETF RFC
3550
•SAP (Session Announcement Protocol), IETF RFC 2974
•IGMP v2 (Internet Group Management Protocol), IETF RFC 2236
•SNMP (Simple Network Management Protocol), IETF RFC 1157

4Sight 15
Administrator Guide
Version 5.0
Envivio Professional Services and Support
You may contact us for specific projects requiring customized options or
specific development, available through our service organization. For
contact information, see the Envivio website at
http://www.envivio.com.
If you have support questions, contact Envivio Customer Services.

16 Chapter 1
Introduction
Version 5.0

Chapter 2
WebAdmin

18 Chapter 2
WebAdmin
Version 5.0
Overview
4Sight WebAdmin is a web based administration tool that allows the
administrator to monitor and configure the 4Sight Streaming Server.
Using this tool, you can setup and monitor relays, switcher and playlists.
You can also setup movie folders, authorization and streaming ports.
In order to connect to this administration tool, you can either:

4Sight 19
Administrator Guide
Version 5.0
Restricting access to the WebAdmin
Using the WebAdmin configuration file
To restrict access to the WebAdmin, you can use the two keywords, allow
or deny, in your streamingadminserver.conf.
For example, at the end of the file, add the following:
allow=192.168.105.187 127.0.0.1
deny=192.168.105.113
This allows access to the WebAdmin from local host and
192.168.105.187 and explicitly denies it from 192.168.105.113.
Using the WebAdmin user interface
You can restrict access to the WebAdmin by using a login screen. The user
will have to provide a user name and password to connect to the
WebAdmin.
1. Using a web browser, connect to the WebAdmin (see “WebAdmin” on
page 17).
2. Click on the Server Configuration>General Settings menu item.
3. Select the Authentication for the web admin check box to restrict access
to the WebAdmin, then click the Save changes button. You will be
disconnected from theWebAdmin.

20 Chapter 2
WebAdmin
Version 5.0
4. Reconnect to the WebAdmin using the default user name (admin) and
password (admin).
Changing the WebAdmin default user name and password
5. Using a web browser, connect to the WebAdmin: (see “WebAdmin”
on page 17).
6. Select the Server Configuration>General Settings menu item.
7. Click the Change Admin Username/Password... link. The following
page should be displayed:

4Sight 21
Administrator Guide
Version 5.0
8. Fill the different fields, then click the Change password button. You
will be disconnected from the WebAdmin.
9. Reconnect to the WebAdmin using the new user name and password.

22 Chapter 2
WebAdmin
Version 5.0