Envivio 4Sight Bedienungsanleitung

4SightAdministrator GuideVersion 5.0 rev.4May 17, 2006P/N 01000002

12 Chapter 1Introduction Version 5.0OverviewThe 4Sight Video Server from Envivio provides MPEG-4 and H.264 streaming capabilities for small, medium a

102

Appendix DThe Web Admin configuration file

104 Table 1. WebAdmin streamingadminserver.conf parametersKeyword Valueport The port on which WebAdmin listens for requests.root The root directory f

Appendix EVideo Server access log file

106 Field Name W3C orCustomExample valuec-ip IP address of client W3C 157.100.200.300date Date of the access W3C 11/16/1998time Time of the access

4Sight 107Administrator Guide c-osos Custom Windows [Windows, Windows NT, Unix-[flavor], Mac-[flavor]]c-osversionos version Custom 4.0.0.1212c-cpu c

108 c-pkts-recovered-resentCustom 5 [this refers to packets recovered via UDP retransmission]c-buffercount Custom 1c-totalbuffertime seconds buffered

4Sight 109Administrator Guide GlossaryADSLAsymmetric Digital Subscriber Line.bandwidthBandwidth has many meanings, depending on context. It started as

110 GlossarycodecThe software that encodes and decodes a file. The word is a shortened form of coder-decoder or compression-decompression.This product

4Sight 111Administrator Guide ISO International Standards Organization.kbps Kilobits per second.key frameA frame that fully refreshes its contents and

4Sight 13Administrator GuideVersion 5.0 the associated IETF recommendations dedicated to MPEG-4 transport over IP.Monitoring and administrationMonito

112 Glossarybroadcasters the tools to deliver multimedia presentations over the Web.Real-timeRapid transmission and processing of event-oriented data

4Sight 113Administrator Guide SmootherA process that modifies the send times of media packets to fit the transmission channel and makes the transmissi

114 GlossaryUnicastUnicast is communication between a single sender and a single receiver over a network.URLUniform Resource Locator. A method of nami

115IndexNumerics4Caster 26Aaccess file 60Access moduleaccess file 93group list 93user list 93adddestination 30, 41group file 59movie folder 24user 62a

116 Index GGET request 86group file 56, 59add 59modify 59remove 59GUID value 106Hhint track 83hinted file 49filehinted 83host program 106HTML page 82H

Administrator Guide 117qtgroups 56, 59qtpasswd 56, 57, 59, 62qtusers 56, 59QuickTime 83Rrealm 59, 60, 62, 63, 86, 104red stop sign 48reflecting 26, 92

118 Index stream 30unicast 30, 40address 32, 40user agent 106user file 56, 57, 59, 60, 62, 63create 62user name 33, 57, 59, 61WWebAdmin 19, 20, 21, 24

14 Chapter 1Introduction Version 5.0• UDP (User Datagram Protocol), IETF RFC 769• TCP (Transmission Control Protocol), IETF RFC 793• IP (Internet Pro

4Sight 15Administrator GuideVersion 5.0 Envivio Professional Services and SupportYou may contact us for specific projects requiring customized option

16 Chapter 1Introduction Version 5.0

Chapter 2WebAdmin

18 Chapter 2WebAdmin Version 5.0Overview4Sight WebAdmin is a web based administration tool that allows the administrator to monitor and configure the

4Sight 19Administrator GuideVersion 5.0 Restricting access to the WebAdminUsing the WebAdmin configuration fileTo restrict access to the WebAdmin, yo

20 Chapter 2WebAdmin Version 5.04. Reconnect to the WebAdmin using the default user name (admin) and password (admin).Changing the WebAdmin default us

4Sight 21Administrator GuideVersion 5.0 8. Fill the different fields, then click the Change password button. You will be disconnected from the WebAdm

© 2005-2006 Envivio Inc. All rights reserved.4Sight Administrator Guide 5.0This manual and the software described in it are furnished under license a

22 Chapter 2WebAdmin Version 5.0

Chapter 3Video Server

24 Chapter 3Video Server Version 5.0Setting up Movie foldersTo serve on-demand MPEG-4 files stored on your server, 4Sight needs to know where your fil

4Sight 25Administrator GuideVersion 5.0 5. Click the Saves Changes button to add this new folder, as shown in the figure below.:

26 Chapter 3Video Server Version 5.0Using 4Sight as a reflectorOverviewMost routers on the Internet cannot properly interpret multicast information as

4Sight 27Administrator GuideVersion 5.0 Figure 1. Example of reflectingFor example, if the SDP file referring to the multicast stream is called live

28 Chapter 3Video Server Version 5.0Using 4Sight as a relayOverviewA relay is a built-in mechanism of the server that accepts a stream from another vi

4Sight 29Administrator GuideVersion 5.0 5. Your relay will then be listed in the relay list, followed by its status that can be either Started or Sto

30 Chapter 3Video Server Version 5.0Configuration examplesRelay a UDP streamConsider the following graph where the user wants to relay a multicast str

4Sight 31Administrator GuideVersion 5.0 5. Click the Save Changes button.4Sight will then start relaying the source address to the configured destina

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

32 Chapter 3Video Server Version 5.0You can define the network interface card that you want to use for sending packets by specifying the Local Output

4Sight 33Administrator GuideVersion 5.0 The 4Sight Video Server Video Server will request a stream from the RTSP server specified in the source setti

34 Chapter 3Video Server Version 5.0Relay an SAP announced streamIn this last case, we suppose that we have a broadcaster that is able to announce the

4Sight 35Administrator GuideVersion 5.0 The following capture shows the source setup for an SAP relay:When the 4Caster sends a unicast stream to the

36 Chapter 3Video Server Version 5.0Connection to the output stream using an SDP fileTo connect to an output stream of the relay, you will need to pro

4Sight 37Administrator GuideVersion 5.0 Connection to the output stream using SAPIn the case of an SAP relay, there is a simpler way to connect to th

38 Chapter 3Video Server Version 5.0Stream SwitchingOverviewThe Stream Switcher is a tool for relaying one stream out of a number of sources towards o

4Sight 39Administrator GuideVersion 5.0 5. Your switcher will then be listed in the switcher list, followed by its status that can be either Enabled

40 Chapter 3Video Server Version 5.01. Specify the output address (this address can be either multicast or unicast), the description, the local output

4Sight 41Administrator GuideVersion 5.0 3. You can add more sources by clicking the Add source link.4. Then click the Save Changes button.WARNING If

42 Chapter 3Video Server Version 5.0Status of the configured switchersOnce everything is configured, you can check that the source stream is effective

Chapter 4Playlist Broadcaster

44 Chapter 4Playlist Broadcaster Version 5.0OverviewThe Playlist Broadcaster is a tool for broadcasting a set of movies. This section describes how to

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

46 Chapter 4Playlist Broadcaster Version 5.0Setting up a playlist using the WebAdminUsing a web browser, connect to the WebAdmin (see “WebAdmin” on pa

4Sight 47Administrator GuideVersion 5.0 Second part of the page lists the broadcast parametersFill in the different fields you need to set up your pl

48 Chapter 4Playlist Broadcaster Version 5.0Your playlist will then appear in the list of available playlists.You can then start and stop it directly

4Sight 49Administrator GuideVersion 5.0 RestrictionsAll the MPEG-4 files that you hint and include in your playlist must be ISMA-compliant and have e

50 Chapter 4Playlist Broadcaster Version 5.0

Chapter 5Load Balancer

v ContentsChapter 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11Overview . . . . . . . . . . . . . .

52 Chapter 5Load Balancer Version 5.0OverviewThe Load Balancer distributes traffic efficiently among video servers so that no individual server is ove

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

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

Chapter 6Authentication and Authorization

56 Chapter 6Authentication and Authorization Version 5.0Overview4Sight provides authentication and authorization services. This is configured using th

4Sight 57Administrator GuideVersion 5.0 Basic SetupIf you want the end user to be prompted for a user name and password when he/she tries to stream a

58 Chapter 6Authentication and Authorization Version 5.0The streamingserver.xml file also contains two parameters that are used for authentication and

4Sight 59Administrator GuideVersion 5.0 User, Group, and Access filesBy default, three files are provided as examples in/usr/Envivio/4Sight/Config: q

60 Chapter 6Authentication and Authorization Version 5.0Access fileAn access file is a text file containing parameters to control access to a director

4Sight 61Administrator GuideVersion 5.0 NOTE Parameter names and values are case sensitive. Respect the case for the following words:AuthName, AuthSc

vi 4sight Administrator GuideContents Relay a UDP stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

62 Chapter 6Authentication and Authorization Version 5.0The qtpasswd utilityThe qtpasswd utility lets you create a user file, and to add and delete us

4Sight 63Administrator GuideVersion 5.0 Configuration exampleYou can have multiple access files, user files, and group files. One way to configure yo

64 Chapter 6Authentication and Authorization Version 5.0

Chapter 7External authorization module

66 Chapter 7External authorization module Version 5.0OverviewThe Authorization module allows you to develop your own access control for the movies sto

4Sight 67Administrator GuideVersion 5.0 Installing the authorization moduleThis document explains how to install the external authorization module.1.

68 Chapter 7External authorization module Version 5.0Basic example of external authorization moduleAuthModuleTestLib.hextern "C"{ bool ESSR

Chapter 8SNMP monitoring

70 Chapter 8SNMP monitoring Version 5.0Using SNMP monitoringThe 4Sight Video Server supports monitoring using the SNMP protocol. This makes 4Sight Vid

4Sight 71Administrator GuideVersion 5.0 Monitoring 4Sight using MG-SOFT MIB BrowserNOTE This example is for windows only.Once you have downloaded and

4sight Administrator Guide viiContents Access file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

72 Chapter 8SNMP monitoring Version 5.0

4Sight 73Administrator GuideVersion 5.0 Your MIB Browser is now ready to be used with the 4Sight Video Server:7. In the MIB Browser, return to the Qu

74 Chapter 8SNMP monitoring Version 5.0You can now query all the fields available in the 4Sight Video Server MIB. The following graphic gives the outp

4Sight 75Administrator GuideVersion 5.0 Enabling SNMP trap receptionThe 4Sight Video Server uses traps to notify the SNMP monitor of events and alarm

76 Chapter 8SNMP monitoring Version 5.02. Right click on the destinationIpAddress node and select Set. 3. Double click on the first instance and speci

4Sight 77Administrator GuideVersion 5.0 4. Repeat the operation for the first instance of the destinationEnable node and set it to On.Your MIB Browse

78 Chapter 8SNMP monitoring Version 5.0

Appendix AHow-To

80 How to update an SDP fileIn order to successfully open a multicast stream, you simply need to open the associated SDP file in a player. In the case

4Sight 81Administrator Guide How to link to a streamable content in a web pageYou can link to an MPEG-4 streamed file directly into an HTML page. Open

viii 4sight Administrator GuideContents Access module parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

82 How to embed a streamable content in a web pageWhen you embed a content in a web page, no external player is used and the content is played directl

4Sight 83Administrator Guide What is a hint trackTo be streamed, an MPEG-4 file has to be hinted. The server uses hint tracks in an MPEG-4 file to pac

84 Can I use multicast over Internet?Multicast will work on a LAN if multicast forwarding is enabled on the routers between the network segments (unle

Appendix BThe Video Server configuration file parameters

86 General parametersThe following are general parameters, valid across all modules of the server: Keyword Valuertsp_portPort(s) for accepting client

4Sight 87Administrator Guide max_tcp_buffer_sizeMaximum size the send buffer can be set to.min_tcp_buffer_sizeMinimum size the send buffer can be set

88 Thinning parametersThe following preferences configure the server thinning algorithm. They are all in milliseconds.bind_ip_addrThis tells the serve

4Sight 89Administrator Guide More general parametersalways_thin_delay If a packet passes this delay, thin some more.thin_all_the_way_delay If a packet

90 Reliable UDP parametersKeyword Valuemax_retransmit_delay Maximum interval between when a retransmit is supposed to be sent and when it actually get

4Sight 91Administrator Guide RTSP debugging parametersreliable_udp_dirs If reliable UDP is enabled, specify the directories in which it is enabled. Di

Chapter 1Introduction

92 Specific parameters These parameters are module-specific.Reflector module parametersAccess Log module parametersKeyword Valueenforce_static_sdp_por

4Sight 93Administrator Guide Error Log modules parametersAccess module parametersrotation_interval Amount of time in days between rolls of the acces

94 WebAdmin parametersFile module parametersKeyword ValueRequestTimeIntervalMilli The minimum delay (in milliseconds) between processing each admin re

4Sight 95Administrator Guide Flow control module parametersmax_allowed_speedFile module accepts the RTSP Speed header, which controls the overall play

96 Multiple movie folders parametersRelay parametersSwitcher parametersloss_thick_tolerancenum_losses_to_thickIf a client reports loss percentages les

4Sight 97Administrator Guide Licensing module parametersLoad balancing module parametersExternal authentication parametersRecorder moduleKeyword Value

98

Appendix CThe Playlist Broadcaster configuration file

100 Figure 1. Playlist configuration file parametersKeyword Valueplaylist_filePlaylist filename and path.The path can be absolute or relative.play_mo

4Sight 101Administrator Guide broadcaster_nameUser name if one needs to be provided to the destination address.broadcaster_passwordPassword to be prov