Envivio 4Sight Guia do Utilizador

4SightAdministrator GuideSoftware EditionVersion 3.1 rev.0December 7, 20044SI310ADM-SE-041207 -00

x 4sight Administrator GuideContents Versi o n 3 . 1Appendix B Configuration examples . . . . . . . . . . . . . . . . . . . . . . . . . .121Overview.

100 Chapter 10Authentication and Authorization Versi o n 3 . 18. Fill the different fields, then click Change password button. You will be disconnect

4Sight 101Administrator GuideVersi o n 3 . 1 TroubleshootingAccess file • Parameter names and values are case sensitive. Respect the case for the fo

102 Chapter 10Authentication and Authorization Versi o n 3 . 1

Version 3.1Chapter 11External authorization module

104 Chapter 11External authorization module Version 3.1OverviewThe Authorization module allows you to develop your own access control for the movies s

4Sight 105Administrator GuideVersion 3.1 Installing the authorization moduleThis document explains how to install the external authorization module.

106 Chapter 11External authorization module Version 3.1Basic example of external authorization moduleAuthModuleTestLib.hextern "C"{ bool ES

Versi o n 3 . 1Appendix ADescription of the configuration file parameters

108 Versi o n 3 . 1General parametersThis chapter provides an overview of the different parameters for the Streaming Server. You can modify them to f

4Sight 109Administrator GuideVersi o n 3 . 1 min_tcp_buffer_sizeMinimum size the send buffer can be set to.error_loggingEither "true" or &

Versi o n 3 . 1Chapter 1Introduction4Sight streams MPEG-4 media over IP networks. MPEG-4 is a standard that defines how to encode and compose media e

110 Versi o n 3 . 1safe_play_durationIf the server discovers it is serving more than its allowed maximum bandwidth (using the average bandwidth compu

4Sight 111Administrator GuideVersi o n 3 . 1 Thinning parametersThe following preferences configure the server thinning algorithm. They are all in m

112 Versi o n 3 . 1More general parametersKeyword Valueappend_source_addr_in_transportIf this is true, the server will add its source address to its

4Sight 113Administrator GuideVersi o n 3 . 1 Reliable UDP parametersKeyword Valuemax_retransmit_delayMaximum interval between when a retransmit is s

114 Versi o n 3 . 1RTSP debugging parametersLCD panelreliable_udp_dirsIf reliable UDP is enabled, specify the directories in which it is enabled. Dir

4Sight 115Administrator GuideVersi o n 3 . 1 Specific parameters These parameters are module-specific.Reflector parametersKeyword Valueenable_broadc

116 Versi o n 3 . 1Access log file parametersAccess module parametersuse_one_SSRC_per_streamOnly reflect packets from a single SSRC. Setting this val

4Sight 117Administrator GuideVersi o n 3 . 1 WebAdmin parametersmodAccess_groupsfilepathThe default path and file name for the Access module group l

118 Versi o n 3 . 1File module parametersKeyword Valuesdp_urlThis URL will be included in the dynamically generated SDP returned to the client. Typic

4Sight 119Administrator GuideVersi o n 3 . 1 Flow control module parametersMultiple movie folders parametersRelay parametersKeyword Valueloss_thin_t

12 Chapter 1Introduction Versi o n 3 . 1User Guide structureThis document is divided as follows:- Chapter 2 introduces the main features of 4Sight a

120 Versi o n 3 . 1Switcher parametersLicensing module parametersLoad balancing module parametersExternal authentication parametersKeyword Valueswitc

Versi o n 3 . 1Appendix BConfiguration examples

122 Versi o n 3 . 1OverviewThe purpose of this appendix is to show different streaming solutions based primarily on Envivio 4Caster and 4Sight. The c

4Sight 123Administrator GuideVersi o n 3 . 1 Configuration examplesExample #1This is a basic configuration using 4Sight as a reflector to stream (or

124 Versi o n 3 . 1A relay toward several 4sight servers will then be:Figure 3. Multiple relay4Casterunicast ormulticastRelay4SightReflectorunicast4S

4Sight 125Administrator GuideVersi o n 3 . 1 Example #3This example is a more complex configuration built on top of the former configuration example

126 Versi o n 3 . 1

Versi o n 3 . 1Appendix CStreaming Server access log file

128 Versi o n 3 . 1Field Name W3C orCustomExample valuec-ip IP address of client W3C 157.100.200.300date Date of the access W3C 11/16/1998time Ti

4Sight 129Administrator GuideVersi o n 3 . 1 c-osos Custom Windows [Windows, Windows NT, Unix-[flavor], Mac-[flavor]]c-osversionos version Custom

4Sight 13Administrator GuideVersi o n 3 . 1 Envivio Professional Services and SupportYou may contact us for specific projects requiring customized o

130 Versi o n 3 . 1c-pkts-recovered-resentCustom 5 [this refers to packets recovered via UDP retransmission]c-buffercount Custom 1c-totalbuffertime s

4Sight 131Administrator GuideVersi o n 3 . 1 GlossaryADSLAsymmetric Digital Subscriber Line.bandwidthBandwidth has many meanings, depending on conte

132 GlossaryVersi o n 3 . 1codecThe software that encodes and decodes a file. The word is a shortened form of coder-decoder or compression-decompress

4Sight 133Administrator GuideVersi o n 3 . 1 ISO International Standards Organization.kbps Kilobits per second.key frameA frame that fully refreshes

134 GlossaryVersi o n 3 . 1broadcasters the tools to deliver multimedia presentations over the Web.Real-timeRapid transmission and processing of even

4Sight 135Administrator GuideVersi o n 3 . 1 SmootherA process that modifies the send times of media packets to fit the transmission channel and mak

136 GlossaryVersi o n 3 . 1UnicastUnicast is communication between a single sender and a single receiver over a network.URLUniform Resource Locator.

137Versi o n 3 . 1IndexNumerics4Caster 20, 23, 40, 81, 82, 1224Coder 164Manager 76Aaccess file 94, 101access log 116file 116Access moduleaccess file

138 Index Versi o n 3 . 1error logging 109error messagesdebugging 114error resilience 18extensionCONFIG 59LIC 28, 30M4E 133PLAYLIST 59Ffast backwards

Administrator Guide 139Versi o n 3 . 1live stream 123live track 20logasserts 109client DNS 128client IP address 128debug messages 109fatal errors 109

14 Chapter 1Introduction Versi o n 3 . 1

140 Index Versi o n 3 . 1for client connection 108Qqtaccess 90, 91, 97qtgroups 90, 93qtpasswd 31, 63, 90, 91, 93, 96, 101qtusers 90, 93QuickTime 24Rr

Administrator Guide 141Versi o n 3 . 1specific network interface card 48, 78SSRC 116static port 115statisticsbandwidth 110stopservice 51stream 19band

142 Index Versi o n 3 . 1

Version 3.1Chapter 2Overview

16 Chapter 2Overview Version 3.1Specifications4Sight is an MPEG-4 compliant server that broadcasters and cable operators can use to manage and distrib

4Sight 17Administrator GuideVersion 3.1 4Sight supports trick play (fast forward and fast backward) based on the RTSP RFC 2326 by using play command

18 Chapter 2Overview Version 3.1Error Resilience4Sight offers error resilience so that EnvivioTVTM can receive content smoothly under severe network p

4Sight 19Administrator GuideVersion 3.1 ConceptsStreaming overviewThe streaming process includes two parts: a client and a server. The server sends a

© 2004 Envivio Inc. All rights reserved.4Sight Administrator Guide 3.1This manual and the software described in it are furnished under license and ma

20 Chapter 2Overview Version 3.1Streaming sessionA streaming session is a set of streams (such as video, audio or BIFS for MPEG-4) that is sent from a

4Sight 21Administrator GuideVersion 3.1 Figure 1. Unicast streamingMulticast streamingMulticast streaming means communication between one sender and

22 Chapter 2Overview Version 3.1NOTE Since multicast is one of the packet types in Internet Protocol Version 6 (IPv6), it will work on a LAN if multic

4Sight 23Administrator GuideVersion 3.1 Relay4Sight acts as a relay server when it accepts a stream from a source (a broadcaster or another streaming

24 Chapter 2Overview Version 3.1During the preparation of the MPEG-4 file for streaming, one hint track is added to the MPEG-4 file for each track who

Versi o n 3 . 1Chapter 3Installation

26 Chapter 3Installation Versi o n 3 . 1System RequirementsThe minimal machine configuration to run 4Sight is the following:• Windows® 2000/2003 adva

Envivio Streaming Server 27Administrator GuideVersi o n 3 . 1 Installation of 4Sight4Sight is available on Windows and Linux. Both versions are prov

28 Chapter 3Installation Versi o n 3 . 13. This creates a registration file that you have to save on your disk before mailing it to your sales contac

Envivio Streaming Server 29Administrator GuideVersi o n 3 . 1 Configuration6. You will have to choose an administration port, by default port 554 is

AcknowledgmentsEnvivio Incorporated acknowledges use of software from the following sources and includes their copyright notices and required stateme

30 Chapter 3Installation Versi o n 3 . 1Installation on Linux1. To install 4Sight on Linux, enter the following command:rpm -ivh 4SightSE-XXX.i386.rp

Envivio Streaming Server 31Administrator GuideVersi o n 3 . 1 The following executables will be installed in /usr/Envivio/4Sight/sbin:• 4Sight: 4Sig

32 Chapter 3Installation Versi o n 3 . 1Installing the Envivio Linux KernelEnvivio has developed a specific Linux kernel patch to fix some Linux kern

Version 3.1Chapter 4Quick start

34 Chapter 4Quick start Version 3.1OverviewThis section describes step by step instructions for using 4Sight.Starting 4Sight1. Put the MPEG-4 movie fi

Envivio Streaming Server 35Administrator GuideVersion 3.1 Stopping 4SightUnder Windows, • if you have installed 4Sight as a service, go to “Chapter5

36 Chapter 4Quick start Version 3.1

Version 3.1Chapter 5Streaming Server

38 Chapter 5Streaming Server Version 3.1Setting up Movie FoldersTo serve on-demand MPEG-4 files stored on your server, 4Sight needs to know where your

4Sight 39Administrator GuideVersion 3.1 5. Click the Saves Changes button to add this new folder.

40 Chapter 5Streaming Server Version 3.1Using 4Sight as a reflectorMost routers on the Internet cannot properly interpret multicast information as the

4Sight 41Administrator GuideVersion 3.1 Figure 1. ReflectingPlaylistBroadcasterUnicastEnvivio 4SightMulticastRouterRouterRouterRouterEnvivioTV / 4Vi

42 Chapter 5Streaming Server Version 3.1Using 4Sight as a relay4Sight acts as a relay server when it accepts a stream from a source (a broadcaster or

4Sight 43Administrator GuideVersion 3.1 Setting up a relay using the WebAdmin1. Using a web browser, connect to the WebAdmin (see “WebAdmin” on page

44 Chapter 5Streaming Server Version 3.14. Your relay will then be listed in the relay list, followed by its status that can be either Enabled or Disa

4Sight 45Administrator GuideVersion 3.1 4. Provide the information about the destination (you can add more destinations if needed). Then click the Sa

46 Chapter 5Streaming Server Version 3.1Relay an announced streamIf you are using a broadcaster that supports RTSP announces (such as the Playlist Bro

4Sight 47Administrator GuideVersion 3.1 Relay a requested streamThis configuration is for the scenario where you have a server configured and running

48 Chapter 5Streaming Server Version 3.1Relay a UDP stream using a specific network interface cardYou can define the network interface card that you w

4Sight 49Administrator GuideVersion 3.1 Status of the configured relaysOnce everything is configured, you can check that the stream is effectively re

v Version 3.1 ContentsChapter 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11User Guide structure. . . .

50 Chapter 5Streaming Server Version 3.1Running 4Sight as a service NOTE This feature is available only on Windows.Installing 4Sight as a serviceDurin

4Sight 51Administrator GuideVersion 3.1 Starting, stopping and removing the 4Sight serviceTo start the 4Sight service, go to the Start/Settings/Contr

52 Chapter 5Streaming Server Version 3.1Embedding streamable content in a web pageYou can display an MPEG-4 streamed file directly into an HTML page.T

Version 3.1Chapter 6Playlist Broadcaster

54 Chapter 6Playlist Broadcaster Version 3.1OverviewThe Playlist Broadcaster is a tool for broadcasting a set of movies. This section describes how to

4Sight 55Administrator GuideVersion 3.1 Basic setupThere are two ways to set up a playlist and broadcast it using the Playlist Broadcaster:• using th

56 Chapter 6Playlist Broadcaster Version 3.1Setting up a playlist using the WebAdminUsing a web browser, connect to the WebAdmin (see “WebAdmin” on pa

4Sight 57Administrator GuideVersion 3.1 Fill in the different fields you need to set up your playlist and then click on the Save Changes button.Examp

58 Chapter 6Playlist Broadcaster Version 3.1Your playlist will then appear in the list of available playlists.You can then start and stop it directly

4Sight 59Administrator GuideVersion 3.1 Setting up a playlist using the command line interfaceYou can also use the Playlist Broadcaster as a command

vi 4sight Administrator GuideContents Versi o n 3 . 1Uninstallation under Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

60 Chapter 6Playlist Broadcaster Version 3.1The config file will contain the following set of parameters:playlist_file /usr/Envivio/4Sight/Movies/ myP

4Sight 61Administrator GuideVersion 3.1 Common scenarios: Broadcasting a playlistSingle server configurationIf you have 4Sight and Playlist Broadcast

62 Chapter 6Playlist Broadcaster Version 3.1Multiple servers: Unicast configurationYou have two machines, one with Playlist Broadcaster, the other wit

4Sight 63Administrator GuideVersion 3.1 Multiple servers: Unicast and announceThis is a more automated alternative to the previous setup. Using an an

64 Chapter 6Playlist Broadcaster Version 3.1Broadcast to a multicast addressBroadcasting to a multicast address is similar to broadcast to a unicast a

4Sight 65Administrator GuideVersion 3.1 Configuration file parametersThis section describes the different parameters that you can modify in your play

66 Chapter 6Playlist Broadcaster Version 3.1destination_base_port The base port number for the broadcast must be an even number. If you do not specify

4Sight 67Administrator GuideVersion 3.1 broadcaster_password Password to be provided to the destination address.multicast_ttl Time to live of the mul

68 Chapter 6Playlist Broadcaster Version 3.1Command line parametersThe Playlist Broadcaster takes a playlist configuration file as a mandatory paramet

4Sight 69Administrator GuideVersion 3.1 TroubleshootingThe Playlist Broadcaster and the WebAdmin If you are using the WebAdmin to configure, start, a

4sight Administrator Guide viiContents Versi o n 3 . 1 Relay verification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

70 Chapter 6Playlist Broadcaster Version 3.1Playlist filesAll the MPEG-4 files that you hint and include in your playlist must be ISMA-compliant and h

Version 3.1Chapter 7WebAdmin

72 Chapter 7WebAdmin Version 3.1OverviewThe WebAdmin allows you to remotely monitor and configure 4Sight. Starting the WebAdminYou can launch the WebA

4Sight 73Administrator GuideVersion 3.1 Configuration parametersTable 1. WebAdmin streamingadminserver.conf parametersKeyword ValueportThe port on w

74 Chapter 7WebAdmin Version 3.1

Version 3.1Chapter 8Stream Switcher

76 Chapter 8Stream Switcher Version 3.1OverviewThe Stream Switcher is a tool for relaying one stream out of a number of sources and then permits switc

4Sight 77Administrator GuideVersion 3.1 Basic setupTo set up the Stream Switcher using the WebAdmin, follow these steps:1. Using a web browser, conne

78 Chapter 8Stream Switcher Version 3.1Using a specific network interface card as outputYou can define the network interface card that you want to use

4Sight 79Administrator GuideVersion 3.1 Configuration exampleWe will use the following network structure to demonstrate the configuration of the Stre

viii 4sight Administrator GuideContents Versi o n 3 . 1Chapter 8 Stream Switcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

80 Chapter 8Stream Switcher Version 3.12. Provide the information about the input. Enter the hostname or IP address, then specify the ports you want t

4Sight 81Administrator GuideVersion 3.1 Accessing the stream generated by the switcherWe will use the following network structure to demonstrate how

82 Chapter 8Stream Switcher Version 3.1Viewing the active sourceTo view the output of the switcher:• If the broadcasters broadcast the SDP to port 987

4Sight 83Administrator GuideVersion 3.1 Your SDP file should look like this:v=0o=- 3557664794 484063668 IN IP4 192.168.105.42s=ELBc=IN IP4 235.55.58.

84 Chapter 8Stream Switcher Version 3.1Status of the configured switchersOnce everything is configured, you can check that the stream is effectively r

Version 3.1Chapter 9Load Balancer

86 Chapter 9Load Balancer Version 3.1OverviewThe Load Balancer distributes traffic efficiently among streaming servers so that no individual server is

4Sight 87Administrator GuideVersion 3.1 Basic setupAdding a slave serverTo set up the load balancing using the WebAdmin, follow these steps:1. Click

88 Chapter 9Load Balancer Version 3.15. The slave server will then be listed, followed by its status (either Enabled or Disabled).6. Click Save Change

Versi o n 3 . 1Chapter 10Authentication and Authorization

4sight Administrator Guide ixContents Versi o n 3 . 1 Access file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

90 Chapter 10Authentication and Authorization Versi o n 3 . 1Overview4Sight provides authentication and authorization services. This is configured us

4Sight 91Administrator GuideVersi o n 3 . 1 Basic SetupIf you want the end user to be prompted for a user name and password when he/she tries to str

92 Chapter 10Authentication and Authorization Versi o n 3 . 1The streamingserver.xml file also contains two parameters that are used for authenticati

4Sight 93Administrator GuideVersi o n 3 . 1 User, Group, and Access filesBy default, three files are provided as examples in the Config Directory: q

94 Chapter 10Authentication and Authorization Versi o n 3 . 1Access fileAn access file is a text file containing parameters to control access to a di

4Sight 95Administrator GuideVersi o n 3 . 1 require userrequire group A space separated list of user names or group names. This parameter specifies

96 Chapter 10Authentication and Authorization Versi o n 3 . 1The qtpasswd utilityThe qtpasswd utility lets you create a user file, and to add and del

4Sight 97Administrator GuideVersi o n 3 . 1 Common scenarioYou can have multiple access files, user files, and group files. One way to configure you

98 Chapter 10Authentication and Authorization Versi o n 3 . 1Restrict access to the WebAdminUsing the WebAdmin configuration fileTo restrict access t

4Sight 99Administrator GuideVersi o n 3 . 1 4. Reconnect to the WebAdmin using the default user name (admin) and password (admin).Changing the WebAd