Page 1 MediaCenter Server ™ ™ Administrator’s Guide Release 2.1 A Sun Microsystems, Inc. Business 901 San Antonio Road Palo Alto, CA 94303 USA 415 960-1300 fax 415 969-9131 Part No.: 805-3194-10 Revision A, December 1997...
Page 2 Sun, the Sun logo, Sun Microsystems, Solaris, Sun Media Center, SunATM, SunFastEthernet, Java, and HotJava are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and certain other countries. UNIX is a registered trademark in the United States and other countries, exclusively licensed through X/Open Company, Ltd. OPEN LOOK is a registered trademark of Novell, Inc.
Page 3: Table Of Contents
Contents Introduction 1-1 Introduction 1-1 Sun MediaCenter Hardware 1-2 Sun MediaCenter Software 1-4 1.3.1 Media File System (MFS) 1-5 1.3.2 Media Stream Manager 1-7 1.3.3 Content Manager 1-8 1.3.4 Web-based Tools 1-8 Video Output Interfaces 1-8 1.4.1 ATM 1-9 1.4.2 LAN 1-9 Content Preparation and Loading 1-10 Server Management 1-11...
Page 4 Splice Points 2-3 2.3.1 Packet Boundary 2-3 2.3.2 closed_gop 2-4 2.3.3 payload_unit_start_indicator 2-4 2.3.4 adaptation_ﬁeld_control 2-4 2.3.5 random_access_indicator 2-4 2.3.6 PCR_ﬂag 2-4 Content Loading 2-5 References 2-7 Monitoring the Server 3-1 Overview 3-1 Using the WebAdmin Tool 3-2 3.2.1 Invoking the Tool 3-2 3.2.2 Common Page Elements 3-5 Resource Utilization 3-5...
Page 5 Table of Contents Page 4-12 4.4.1 View Menu 4-13 4.4.2 Selected Menu 4-15 Sun MediaCenter Server Utilities 5-1 Setting a Title Access Control List 5-1 The smc_copy Utility 5-4 The smc_tar Utility 5-8 5.3.1 Syntax and Options 5-8 5.3.2 Content Loading 5-9 5.3.3 Copying Content 5-10 5.3.4...
Page 6 Server Output Data Format 7-1 Introduction 7-1 ATM Encapsulation 7-2 7.2.1 MPEG-2 Transport Stream Packet Encapsulation 7-2 7.2.2 MPEG-2 Program Stream Packet Encapsulation 7-3 7.2.3 MPEG-1 System Stream Packet Encapsulation 7-3 7.2.4 Thomson Electronics Packet Encapsulation 7-3 7.2.5 MPEG-2 Encapsulation over Classical IP over AAL5 7-3 ATM Addressing 7-4 7.3.1 MPEG over AAL5 7-4...
Page 7 Access Control Lists 9-1 ACL Files 9-1 Permissions 9-2 Server ACL 9-2 Player ACL 9-3 Title ACL 9-4 Session ACL 9-4 Troubleshooting 10-1 10.1 Symptoms and Possible Solutions/Workarounds 10-1 10.2 Error Messages 10-4 10.2.1 Server Console Messages 10-4 10.2.2 MFS Error Messages 10-5 A.
Page 8 Tape Storage Format B-12 B.6.1 Tar Format B-12 B.6.2 Tapes B-14 Example B-14 References B-18 Glossary Glossary-1 Index Index-1 viii Sun MediaCenter Server Administrator’s Guide • December 1997...
Page 9 Preface This document, the Sun MediaCenter Server Administrator’s Guide, tells you how to set up, load content onto, and perform other administrative duties relevant to a Sun™ MediaCenter™ server. Speciﬁcally, this document describes: at a high level, the hardware and software architecture of the Sun MediaCenter server;...
Page 10: Administering Mfs Disks
The Sun MediaCenter Documentation Suite This manual is a companion to the Sun MediaCenter Server Installation and Conﬁguration Manual, the Sun MediaCenter Server Programmer’s Guide and the Sun MediaCenter UltraSPARC Hardware Manual. Together these manuals are complementary of the hardware manuals shipped with the Sun products that make up a Sun MediaCenter server.
Page 11: Glossary
Appendix A “Setting up the SNMP Agent,” tells you how to make use of the SNMP agent that is shipped with the Sun MediaCenter server. Appendix B “Creating a Content Package,” describes how to prepare content if you are unable to use ftp for loading content. The Glossary lists terms from the realm of video technology, as well as terms speciﬁc to the Sun MediaCenter product.
Page 12 Shell Prompts in Command Examples The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell. Shell Prompts TABLE P-2 Shell Prompt C shell prompt machine_name% C shell superuser prompt machine_name# Bourne shell and Korn shell prompt Bourne shell and Korn shell...
Page 13: Introduction
C H A P T E R Introduction Introduction page 1-1 Sun MediaCenter Hardware page 1-2 Sun MediaCenter Software page 1-4 Video Output Interfaces page 1-8 Content Preparation and Loading page 1-10 Server Management page 1-11 Push Model page 1-11 Design Beneﬁts page 1-12 Introduction...
Page 14: Sun Mediacenter Hardware
a Content Manager (CM), which includes an RPC-based API that allows users to move content between servers or between a server and a client. Web-based tools that allow you to conﬁgure a Sun MediaCenter server, monitor server operations, and transfer video content to a server. The Sun MediaCenter server delivers MPEG bit streams at a constant bit rate.
Page 15 Control Content Sun MediaCenter Server Media Streams (Fast Ethernet or ATM) From tape, network-accessible ﬁle, Fast/Wide or Ultra or live source SCSI Media File System Files High-level Hardware Architecture FIGURE 1-1 Content is loaded onto the Sun MediaCenter server via the server ’s Content Manager, over a LAN or using 4- or 8-mm DAT tape.
Page 16: Sun Mediacenter Software
Sun MediaCenter Software The Sun MediaCenter software has three major components, the Media File System (MFS), the Media Stream Manager (MSM), and the Content Manager (CM). (In addition to these, there are special network interface drivers, which are tightly coupled with the MFS.) The relationship of these modules is illustrated in FIGURE 1-2.
Page 17: Introduction
With the exception of the APIs for the MSM and CM, the workings of the server ’s software components are largely invisible to the user. This is particularly true of the MFS, access to which is exclusively throughout the MSM and CM. The Sun MediaCenter software offers the following features: Guaranteed stream delivery rate Once a stream is accepted for delivery, the server delivers the stream contents at a...
Page 18 Hot swappability The MFS supports the replacement of a failed disk while the server continues to deliver streams. Following disk replacement, you use a single command to restore data from the parity disk to the new disk and return the server to normal playback mode.
Page 19: Media Stream Manager
scheduler The scheduler sorts and schedules disk I/O, manages bit pump buffers, performs admission control, and schedules output driver activity. bit pump The bit pump is responsible for allocating internal buffering and efﬁciently transferring data between the disk and the output drivers using the internal buffers.
Page 20: Content Manager
The MSM’s primary interface is the MSM Client API, described in the Sun MediaCenter Server Programmer’s Guide. The MSM supports playthrough, trick play, and other features of the Media File System. 1.3.3 Content Manager The CM provides for the loading of content onto a Sun MediaCenter server. Server requirements for content, such as Table of Contents ﬁles and index ﬁles (for trick play) are handled transparently by the CM.
Page 21 1.4.1 In an ATM environment, one or more Sun MediaCenter servers are directly connected to an ATM switch via ATM host adapters. Digital video streams are sent to clients using ATM virtual circuits. Sun MediaCenter Servers in ATM Environment FIGURE 1-4 1.4.2 In the LAN environment, each Sun MediaCenter server is connected to one high- speed 100BaseT subnetwork via one or more Fast Ethernet host adapters.
Page 22: Content Preparation And Loading
Sun MediaCenter Servers in LAN environment FIGURE 1-5 Content Preparation and Loading The Sun MediaCenter software speciﬁes a format for content, described in Chapter 2, “Preparing and Loading Content.” Sun MediaCenter software uses the Content Manager for storing video content on the server.
Page 23: Server Management
Server Management An SNMP agent is provided is provided with the Sun MediaCenter software. This agent includes the following MIB information: current number of playing streams; current aggregate bandwidth; number of missed deadlines; number and location of disk errors. The SNMP agent also supports the following traps: Missed_Deadline Admission_Failed Disk_Failure...
Page 24: Design Beneﬁts
delivery support output only. The MSM Client API has calls that allow you to specify an ultimate destination, but do not, for example, allow you to set any parameters on that destination, which would imply the ability of the receiver to conﬁrm a setting.
Page 25: Preparing And Loading Content
C H A P T E R Preparing and Loading Content General MPEG Encoding Requirements page 2-1 MPEG Encoding Requirements for Trick Play page 2-2 Splice Points page 2-3 Content Loading page 2-5 References page 2-7 This chapter speciﬁes what video content should consist of and how it should be formatted, as required by the Sun MediaCenter software.
Page 26: Mpeg Encoding Requirements For Trick Play
The timing information embedded in an MPEG ﬁle must exactly reﬂect the constant bit rate encoded in the ﬁle. Speciﬁcally, the time differences between any two consecutive PCR (SCR for Program Streams or MPEG-1 System Streams) time stamps must exactly reﬂect the time required to play out the number of bytes between the two PCRs (SCRs for Program Streams or MPEG-1 System Streams) at the bit stream’s speciﬁed bit rate.
Page 27: Splice Points
All trick ﬁles must be encoded at a bit rate that is less than or equal to the bit rate of the normal-speed bit stream. The Media Stream Manager supports the playing of trick play streams. See the chapter on the Media Stream Manager Client API in the Sun MediaCenter Server Programmer’s Guide for a discussion of how to play titles that have trick play streams.
Page 28: Closed_Gop
2.3.2 closed_gop The closed_gop is a one-bit ﬂag that indicates the nature of the predictions used in the B-pictures immediately following the ﬁrst coded I-frame following the group-of- pictures header. The closed_gop must be set to 1 to indicate that these B-pictures have been encoded using only backward prediction.
Page 29: Content Loading
Content Loading The preferred method of storing content on a Sun MediaCenter server is to use the Web-based CmTool. CmTool uses the Sun MediaCenter FTP daemon and the Content Manager (CM), part of the Sun MediaCenter software, to store content. The CM automatically extracts from MPEG content the information the server needs to successfully store and play that content.
Page 30 The machine on which your content is stored does not have ftp client software. For video ﬁle transfers from the server to a client machine, if your video ﬁle is smaller or equal to 2.1 GB, use smc_copy or ftp. If the ﬁle is larger than 2.1 GB, use smc_tar.
Page 31: References
References ISO/IEC 13818-1/2/3 Recommendation H.262: “Generic Coding of Moving Pictures and Associated Audio Information: Systems/Video/Audio” ISO/IEC 11172-1/2/3 “Coding of Moving Pictures and Associated Audio for digital storage media at up to 1.5 Mbit/s: Systems/Video/Audio” Chapter 2 Preparing and Loading Content...
Page 32 Sun MediaCenter Server Administrator’s Guide • December 1997...
Page 33: Overview
C H A P T E R Monitoring the Server Overview page 3-1 Using the WebAdmin Tool page 3-2 Resource Utilization page 3-5 Streaming Videos page 3-6 Copy Sessions page 3-9 Disk Capacity page 3-12 Troubleshooting page 3-15 This chapter describes the Sun MediaCenter WebAdmin tool, a Web-based graphical user interface (GUI) for monitoring the Sun MediaCenter server.
Page 34: Using The Webadmin Tool
Using the WebAdmin Tool You can run WebAdmin from the following: Any browser that is fully compatible with Java Developer ’s Kit (JDK) version 1.1.1 or later (for example, HotJava™ 1.0 or later). Java Applet Viewer available with JDK 1.1.3. The server that you want to monitor must have the Sun MediaCenter SUNWsmswa package installed;...
Page 35 Sun MediaCenter Page FIGURE 3-1 You may need to set security on your browser to allow the WebAdmin applet to connect to your local system. For the Sun HotJava browser, select “Allow all connects without warning” and “Allow access to all properties” in the Security Violation popup windows.
Page 36 Once the applet loads, the Resource Utilization page is displayed: Resource Utilization Page FIGURE 3-2 Sun MediaCenter Server Administrator’s Guide • December 1997...
Page 37: Common Page Elements
3.2.2 Common Page Elements This section describes the items that appear at the top of each page in the WebAdmin tool. Each page is described in detail in later sections in this chapter. The Server Name ﬁeld appears at the top left corner of each page and identiﬁes the Sun MediaCenter server being monitored.
Page 38: Streaming Videos
Videos being copied Displays the number of content movement sessions on the server. Click on the icon or the link to display the Copy Sessions page, where you can view more information about the content movement sessions. See Section 3.5, “Copy Sessions,”...
Page 39 Streaming Videos Page FIGURE 3-3 The top portion of the Streaming Videos page shows the number of streams that are being played on the server, the average rate of the streams (in bits per second), and the percentage of available bandwidth being used by the streams. The lower portion of the Streaming Videos page shows the following information about each stream that is being played on the server: the TCP/IP hostname or the ATM port number of the user who is viewing the...
Page 40 the title being viewed speed (Fast-Forward, Slow Motion, Stopped, Playing, Reverse) Click on the stream icon to view more information about this stream. The Streaming Videos page shows detailed information about the stream that you selected in the Streams page; this is shown in FIGURE 3-4 Streaming Videos Page with Stream Detail FIGURE 3-4...
Page 41: Copy Sessions
This page shows the following information about the stream being viewed: Stream Name and Direction Title and direction (fast-forward, playing, stopped, reverse, etc.) of the stream. Format Format of the content. Bit Rate Bit rate at which the stream is being played. Destination TCP/IP port or ATM virtual circuit.
Page 42 Copy Sessions Page FIGURE 3-5 The top of the Copy Sessions page shows the number of copy sessions that are active on the server. The lower portion of the Copy Sessions page shows the following information about each session on the server: title of the content being transferred speed of the content being transferred (1000 is normal play speed) status of the CM session (“being created”...
Page 43 Click on the session icon to view more information about this stream. The Session Information page shows detailed information about the content movement session that you selected in the Copy Sessions page. The Session Information page is shown below: Session Information Page FIGURE 3-6 Chapter 3 Monitoring the Server...
Page 44: Disk Capacity
This page displays the following information: State Creating or Opening Shared or Exclusive Reliable or Unreliable Status OK or error message from CM_API. Transfer Mode TCP or ATM Address TCP port or ATM address. Bytes Xfered The number of bytes already transferred. Bytes total The total number of bytes to be transferred.
Page 45 Disk Capacity Page FIGURE 3-7 A red, Failed Disk icon appears at the top of this page only if there is a failed disk in the MFS. The top portion of the Disk Capacity page shows the number of titles that are stored on the server, the amount of disk space used to store the titles, and the percentage of available disk space in the MFS being used by the titles.
Page 46 The bottom portion of the Disk Capacity page displays the disks in groups, as speciﬁed by the RAID layout. Individual disks can be either Data or Parity type. The size and name of each disk are shown. Click on the disk name to view more information about the disk. The Disk Info page shows detailed information about the disk that you selected in the Disk Information page.
Page 47: Troubleshooting
The top portion of the Disk Info page shows statistics about the usage of the disk. The bottom portion of the page shows any late events or disk errors. Troubleshooting The Troubleshooting page allows you to monitor the following server components: MFS disks, network, console, and bit pump.
Page 48 Troubleshooting Page FIGURE 3-9 The Troubleshooting page contains the following links: Media File System: disks displays the Disk Health page. See Section 3.7.1, “Disk Health,” on page 3-17. Console Output displays Sun MediaCenter server console messages. See Section 3.7.2, “Console Log,” on page 3-18. Bit Pump Statistics displays Sun MediaCenter server bit pump information.
Page 49: Disk Health
3.7.1 Disk Health This page shows the status of disks in the MFS. The Disk Health page is shown below: Disk Health Page FIGURE 3-10 Chapter 3 Monitoring the Server 3-17...
Page 50: Console Log
The Disk Health page displays the disks in groups, as speciﬁed by the RAID layout. Individual disks can be either Data or Parity type. The name of each disk is shown, along with an icon that shows the status of the disk. Icons can be one of the following colors: green is normal red is failed or reconstructing...
Page 51 Console Log Page FIGURE 3-11 You can use the search function at the bottom of the page to search for a speciﬁc string. Enter in the string you want to ﬁnd, then select the Search! button. Chapter 3 Monitoring the Server 3-19...
Page 52: Scheduler And Bitpump
3.7.3 Scheduler and Bitpump The Bitpump page displays information about the Sun MediaCenter server scheduler and bitpump. The Bitpump page is shown below: Scheduler and Bitpump Page FIGURE 3-12 3-20 Sun MediaCenter Server Administrator’s Guide • December 1997...
Page 53 describes the ﬁelds in this page. TABLE 3-1 Scheduler and Bitpump Statistics TABLE 3-1 Active Number of active streams Active Streams Collective network bandwidth of all active streams, in bytes/sec. Bandwidth System Bandwidth of each disk (without considering seek overhead). Disk Bw Total bandwidth of all data disks.
Page 54 Scheduler and Bitpump Statistics (Continued) TABLE 3-1 Admit Maximum number of streams allowed. This a ﬁxed value. Max Active Maximum bandwidth allowed for streams, in bytes/sec. Max Bw Number of successful admissions. Num Admitted Number of failed admissions. Num Failed Total delay for the admission of all streams since last reboot, in Total Delay milliseconds.
Page 55 Scheduler and Bitpump Statistics (Continued) TABLE 3-1 bitPump Current number of bit pump streams. bitPumpStreams Bandwidth of the bit pump, in bits/sec. This is a ﬁxed value. bitPumpBandwidth Number of missed deadlines. bitPumpMissedDeadlines Chapter 3 Monitoring the Server 3-23...
Page 56 3-24 Sun MediaCenter Server Administrator’s Guide • December 1997...
Page 57: Moving Content
C H A P T E R Moving Content Overview page 4-1 Using CmTool page 4-2 Loading Content page 4-5 Table of Contents Page page 4-12 This chapter describes the Sun MediaCenter CmTool, a Web-based graphical user interface (GUI) that allows you to transfer content to a Sun MediaCenter server. The tool is part of the software that is installed on the Sun MediaCenter server.
Page 58 Using CmTool You can run CmTool from the following: Any browser that is fully compatible with Java Developer ’s Kit (JDK) version 1.1.1 or later (for example, HotJava 1.0 or later). Java Applet Viewer available with JDK 1.1.3. The server that you want to move content to must have the Sun MediaCenter SUNWsmswa package installed;...
Page 59 Sun MediaCenter Page FIGURE 4-1 You may need to set security on your browser to allow the CmTool applet to connect to your local system. For the Sun HotJava browser, select “Allow all connects without warning” and “Allow access to all properties” in the Security Violation popup windows.
Page 60 Table of Contents Page FIGURE 4-2 Sun MediaCenter Server Administrator’s Guide • December 1997...
Page 61 4.2.2 Common Page Elements This section describes the items that appear at the top of each page in CmTool. Speciﬁc elements of each page are described later in this chapter. The Server Name ﬁeld appears at the top left corner of each page and identiﬁes the Sun MediaCenter server you are managing.
Page 62 Server Login Page FIGURE 4-3 You enter in a username and password for the Sun MediaCenter server in the Login Information page. Once you have successfully logged in to the server, you will not need to enter the login information again unless you quit CmTool or reload the page. Upon successful login, the Load Content page is displayed.
Page 63 Load Content Page FIGURE 4-4 The disk space available on the server is shown in the upper right corner of the page. To load content onto the server, ﬁrst specify the source where the content is located. If you select Local ﬁlesystem, you are prompted for the username and password to log in to the local system.
Page 64 Content on Remote System FIGURE 4-5 To copy a title from a remote system or local ﬁlesystem, select the title or ﬁle from the scrolling list, then click the Copy selected ﬁle button. (You can also display information about a selected title or ﬁle with the View button.) Sun MediaCenter Server Administrator’s Guide •...
Page 65 You are prompted to specify a title for the content on the server, as shown in . You can enter a name that is different from the source or use the same FIGURE 4-6 title. Remember that you cannot use spaces in titles. Click the Copy button (or select the Cancel button to cancel the copy operation).
Page 66 You are prompted to conﬁrm the copy operation, as shown in . Click the FIGURE 4-7 smc_copy button (or select the Cancel button to cancel the copy operation). Copy Conﬁrmation FIGURE 4-7 4-10 Sun MediaCenter Server Administrator’s Guide • December 1997...
Page 67 The Session Information page, shown in , shows the status of the content FIGURE 4-8 transfer. Session Information FIGURE 4-8 A message appears when the content has been successfully copied to the server. The content is now available for viewing on the Sun MediaCenter server. Chapter 4 Moving Content 4-11...
Page 68: Table Of Contents Page
Table of Contents Page This section describes the View and Selected menu options on the Table of Contents page. Table of Contents Page FIGURE 4-9 4-12 Sun MediaCenter Server Administrator’s Guide • December 1997...
Page 69: View Menu
4.4.1 View Menu The View menu provides options that affect the display of titles in the Table of Contents page. The following options are available: Display allows you to select the attributes that you want displayed for the titles. For example, in addition to title name, you can specify that format and playtime be displayed.
Page 70 Sort Dialog Box FIGURE 4-11 To sort by one or more attributes, click on the attribute in the Available Attributes list and then click on the Add >> button. To remove an attribute from the sort list, click on the attribute name in the Sort Order list and then click on the << Remove button.
Page 71: Selected Menu
4.4.2 Selected Menu The Selected menu allows you to view more information about a selected title, and to rename, delete, or play the title. Select a title in the Table of Contents page, then select the More Info option from the Selected menu. The Title Information page appears, as shown below: Title Information Page FIGURE 4-13...
Page 72 4-16 Sun MediaCenter Server Administrator’s Guide • December 1997...
Page 73: Sun Mediacenter Server Utilities
C H A P T E R Sun MediaCenter Server Utilities Setting a Title Access Control List page 5-1 The smc_copy Utility page 5-4 The smc_tar Utility page 5-8 The smc_ls Utility page 5-17 The smc_rm Utility page 5-21 This chapter describes the utilities shipped with the Sun MediaCenter software. Sun MediaCenter software offers a variety of means to transfer video ﬁles.
Page 74 When you create a new title on a Sun MediaCenter server by, for example, using smc_copy to copy a video ﬁle from one server to another, you (the copier) have read, write, and admin permissions for that title. Depending on the settings of the server ACL, other users can list your title (smc_ls) and get certain statistics on the title.
Page 75 For the -d (delete) option, <title_users> stands for a comma-separated list of items of the form: u[ser]:<username> ...where <username> is a Solaris login name. The -s, -m, and -d options accept an asterisk in the <username> ﬁeld, so that you can specify ACL changes for all users on a server.
Page 76: The Smc_Copy Utility
The smc_copy Utility The smc_copy utility copies content, speciﬁed by a title name or a local ﬁlesystem name, between a local ﬁlesystem and a Sun MediaCenter server or between two Sun MediaCenter servers. Examples of a local ﬁlesystem are the Unix ﬁlesystem (UFS) and NFS™.
Page 77 ﬁlename The name of a ﬁle in the form speciﬁed by a local ﬁlesystem, such as UFS or NFS. The ﬁlename might specify an MPEG ﬁle or, for a content package, a tar ﬁle. hostname:ﬁlename The IP hostname of a machine on which ﬁlename is stored, plus the ﬁlename. You must supply an argument for source.
Page 78 -t type Indicates the type of the ﬁle, either data or index. A data ﬁle is an MPEG ﬁle. An index ﬁle is a ﬁle containing splice points for switching back and forth among trick play streams. When copying a title to or from a Sun MediaCenter server, you must have appropriate permissions in the ACL portion of the copied title.
Page 79 The following command performs the same function as the preceding, except the -t and -s options are made explicit: host1% smc_copy -i -t data -s 1000 -r 1568700 heidi.mpg server1:Heidi The following command copies the title heidi from Sun MediaCenter server server1 to a Solaris machine host1: server1% smc_copy -o heidi /net/host1/export/mpeg_files/heidi.tar The preceding command copies all ﬁles associated with the title heidi.
Page 80: The Smc_Tar Utility
The smc_tar Utility If you cannot use ftp to load content, as explained in Section 2.4 “Content Loading” on page 2-5, you can use smc_tar. The smc_tar command extracts a content package from a tar archival device or tar ﬁle. smc_tar parses the TOC ﬁle in the content package and stores the data and index ﬁles associated with the title, as well as the TOC ﬁle itself, into the correct locations on the Sun MediaCenter server.
Page 81: Content Loading
the last argument in the command line if the b option is after the f option. <blknum> immediately follows the option list if the b option precedes the f option. Prompts you before overwriting already-existing content. The f argument, which precedes a source tar ﬁle or device, is required for all smc_tar commands.
Page 82: Copying Content
Content Package (tar format) Input to the Media Stream Manager ﬁle smc_tar --veriﬁes TOC format --extracts index ﬁles index --extracts MPEG ﬁles ﬁles ﬁles (MPEG) Loading Content with smc_tar FIGURE 5-1 After loading content with smc_tar, you can pass a TOC ﬁle (title name) as an argument to MSM Client API functions (described in the Sun MediaCenter Server Programmer’s Guide), to play the title described by that TOC ﬁle.
Page 83 Using smc_tar, you can copy ﬁles that were loaded onto the server by means other than smc_tar, such as with smc_copy or ftp. Sun MediaCenter Title Device smc_tar or File Optional Sun MediaCenter Title Copying a Title from a Sun MediaCenter Server FIGURE 5-2 As you can infer from the ﬁgure, smc_tar provides a convenient means to backup titles on a Sun MediaCenter server.
Page 84: Remote Copying And Extraction
5.3.4 Remote Copying and Extraction You can run smc_tar from a Sun MediaCenter server or from a remote host that has a network connection to a Sun MediaCenter server. The syntax for the c option is: smc_tar cf <tar device> <server>:<title> For the c option, you must have only one argument of the form <server>:<title>.
Page 85 The preceding command differs from the one before it in two respects, indicated by the w and b options. The w option means that you are prompted before ﬁles of the same name are overwritten. The b option, in combination with the value of 40, speciﬁes that smc_tar uses a block size of 40 rather than the default of 20.
Page 86 A useful technique for situations in which your MPEG ﬁle resides on CD-ROM is to create a symbolic link from the directory where your TOC ﬁle resides to the ﬁle on CD-ROM. You then use tar with the h option, which causes tar to follow symbolic links.
Page 87 Examples of scripts that use smc_tar are shown below. The following script archives content to the locally-mounted /dev/rmt/0 device and writes the content titles to the UFS ﬁle SMCBackup.current-date in the current directory. #!/bin/sh # smc_backup: Script to archive multiple SMC titles to tape # To use, type smc_backup [title]+ PATH="/sbin:/usr/sbin:/bin:/usr/bin:/usr/ccs/bin:/opt/SUNWsms/bin"...
Page 88 The following script locates a speciﬁed content title from a previously-created SMCBackup.date ﬁle. It then prompts you to load the appropriate tape to restore the archived title from the locally-mounted /dev/rmt/0 device. #!/bin/ksh # smc_restore: Script to restore an SMC backup usage() { echo "usage: smc_restore [-c ContentsFile] [title]+"...
Page 89: The Smc_Ls Utility
echo "Restore it? (yes or no) \c" read response < /dev/tty if [ $response = "yes" ]; then found=true echo "Load tape dated $date and hit return when done \c" read response < /dev/tty if mt -f ${inputDevice} rew && mt -f ${inputDevice}n fsf $((fileNumber - 1));...
Page 90 The other smc_ls options affect the display and sort of the title output. As a general rule, lowercase options specify the type of sort to be performed, while uppercase options specify the display of an attribute. By default, sort options turn on the corresponding display option.
Page 91 Reverse the order of the sort. This option applies across all other sort options. Display the play speeds for the title. For titles with multiple speeds, each available speed is listed, separated by a comma (,). Streams that have a corresponding index ﬁle are indicated by a trailing asterisk (*).
Page 92 The following example displays a “long listing” of the content on the local Sun MediaCenter server, sorted in order of most-recently-modiﬁed time: client% smc_ls -lt AustinPowers Jul 17 15:23 FREE 00:02:18 MPEG1SYS 1000 SMC_Trick Jul 17 02:26 FREE 00:03:17 MPEG1SYS 1000,4000,8000,-4000,-8000 roc13 May 25 22:09 FREE...
Page 93: The Smc_Rm Utility
The following example displays a long list of the current titles on the local server, with the output reverse-sorted by modiﬁcation time (most-recently modiﬁed time last) and bitrate information displayed (instead of play speed): smc_ls -lrtB pc_test1.5 Apr 01 10:06 FREE 00:02:56 MPEG1SYS 1500000 PC_TEST_1.4 Apr 01 10:30 FREE...
Page 94 5-22 Sun MediaCenter Server Administrator’s Guide • December 1997...
Page 95: Sun Mediacenter Server Ftp Daemon
C H A P T E R Sun MediaCenter Server FTP Daemon Keyword for Video-File Functions page 6-3 Video-File Attributes page 6-4 Video-File Commands page 6-5 Loading Content with ftp page 6-14 This chapter describes the Sun MediaCenter server FTP daemon. This daemon allows any ftp user—on any operating system/hardware platform—to access video ﬁles on a Sun MediaCenter server.
Page 96 PC or Workstation Sun MediaCenter Server FTP Protocol Standard FTP Functions Sun MediaCenter Standard FTP Client Daemon Software FTP Functions for Video Files Local Unix Media File File System System File System (Video Files) Sun MediaCenter FTP Functions FIGURE 6-1 Sun MediaCenter Server Administrator’s Guide •...
Page 97: Keyword For Video-File Functions
Keyword for Video-File Functions The keyword smc: in an ftp command invokes a video-ﬁle function. So, for example, to obtain a directory listing of the video ﬁles on a Sun MediaCenter server, you enter the following command: ftp> dir smc: Title Usage Format...
Page 98: Video-File Attributes
Video-File Attributes A piece of video content is stored as a title on a Sun MediaCenter server. The ftp video-ﬁle commands report or perform operations on titles. A title is identiﬁed by the following attributes: name of the title, which usually corresponds to the name of the movie or video clip;...
Page 99: Video-File Commands
The attribute values of the title named Bambi indicate a normal-play, forward- direction, MPEG ﬁle that was encoded 3 Mb/sec. in MPEG-2 Program Stream format. All video-ﬁle commands require a value for the title attribute. (The value can be, with some commands, a wildcard.) Certain commands have requirements beyond this.
Page 100 All ftp commands except rename, when used with the Sun MediaCenter FTP daemon, accept the asterisk (*) as a wildcard character. When using the Solaris FTP client, you must use a backslash to escape the asterisk. Otherwise, the shell interprets the asterisk to mean all ﬁles in the current working directory. Other FTP clients, such as one you might use on a Wintel PC, might not have this requirement.
Page 101: Listing Files
6.3.1 Listing Files The dir command lists the names of the data and index ﬁles associated with the titles on a Sun MediaCenter server. An example of its use: ftp> dir smc: Title Usage Format Available Speeds Bambi FREE 02:03:42 MPEGPS 1000, batman...
Page 102 Like the dir command, the ls command lists the names of the data and index ﬁles associated with the titles on a Sun MediaCenter server. An example of its use: ftp> ls smc:title=\* smc:title=Bambi,format=MPEGPS,speed=1000,type=data,rate=3000000, smc:title=batman,format=MPEGTS,speed=10000,type=index smc:title=batman,format=MPEGTS,speed=10000,type=date,rate=3000000 smc:title=java_class,format=MPEG1SYS,speed=1000,type=data,rate=1500000 smc:title=java_class,format=MPEG1SYS,speed=1000,type=index smc:title=java_class,format=MPEG1SYS,speed=3000,type=data,rate=1500000 smc:title=java_class,format=MPEG1SYS,speed=3000,type=index smc:title=java_class,format=MPEG1SYS,speed=-3000,type=data,rate=1500000 smc:title=java_class,format=MPEG1SYS,speed=-3000,type=index smc:title=haircut,format=MPEGTS,speed=1000,type=data,rate=2600000...
Page 103: Moving Files
Examples of mls use: ftp> mls smc:title=batman smc:title=seahunt - 200 PORT command successful. 150 ASCII data connection for smc:title=batman (129.144.90.32,56451). smc:title=batman,format=MPEGTS,speed=10000,type=index smc:title=batman,format=MPEGTS,speed=10000,type=date,rate=3000000 226 ASCII Transfer complete. remote: smc:title=batman 242 bytes received in 0.045 seconds (5.2 Kbytes/s) 200 PORT command successful. 150 ASCII data connection for smc:title=seahunt (129.144.90.32,56585).
Page 104 With regard to video-ﬁle attributes, when you get or mget ﬁles, (the Media File System [MFS]-to-local ﬁle system direction) those ﬁles are stored in a local ﬁle system with as many or few attributes as you specify. Conversely, when you put or mput ﬁles (the local ﬁle system-to-MFS direction), those ﬁles are stored in the MFS with the attributes that were recorded in the local ﬁle system from which the ﬁles were copied.
Page 105 The get command allows you to copy a video ﬁle from a Sun MediaCenter server to a local ﬁle system. An example of its use: ftp> bin ftp> get smc:title=batman,format=MPEGTS,speed=1000,type=data,\ rate=3000000 /home/backup/batman.data 200 PORT command successful. 150 Binary data connection for smc:title=batman,speed=1000,type=data, rate=3000000 (129.144.90.32,56133) (0 bytes).
Page 106 6.3.2.2 Moving Multiple Titles The mget and mput commands are intended for the backup and restore of titles between the MFS and a local ﬁlesystem. You can use mput only with ﬁles that you have previously backed up with mget. For example, if you periodically use the command: ftp>...
Page 107: Renaming Files
mput The mput command copies ﬁles from a local ﬁle system to a Sun MediaCenter server. mput allows you to copy a single video title or all of the titles that have been copied to a given directory in a local ﬁle system using the mget command. mput supports the use of the asterisk (*) wildcard character to specify all of the ﬁles in a directory.
Page 108: Deleting Files
6.3.4 Deleting Files delete The delete (or del) command allows you to delete a video ﬁle from a Sun MediaCenter server. You specify only a title name for this command. An example of its use: ftp> del smc:title=Batman 250 DELE command successful. 200 PORT command successful.
Page 109 As an example, consider that you encode the title “Batman” at 3 Mbits/sec., in MPEG Transport Stream format. You have three MPEG ﬁles, one for normal speed, one for 21 times normal speed, forward direction, and one for 21 times normal speed, reverse direction.
Page 110 6-16 Sun MediaCenter Server Administrator’s Guide • December 1997...
Page 111: Server Output Data Format
C H A P T E R Server Output Data Format Introduction page 7-1 ATM Encapsulation page 7-2 ATM Addressing page 7-4 Fast Ethernet Encapsulation page 7-5 Fast Ethernet Addressing page 7-7 Specifying Encapsulation page 7-8 Differences Among Different Types of Links page 7-9 References page 7-9...
Page 112: Atm Encapsulation
controlled by the Content Manager (CM). Utilities that use the CM are described in Chapter 5 and Chapter 6. The CM server and client APIs are described in the Sun MediaCenter Server Programmer’s Guide. illustrates the separation of data and control ﬂows with respect to the Sun FIGURE 7-1 MediaCenter server.
Page 113: Mpeg-2 Program Stream Packet Encapsulation
7.2.2 MPEG-2 Program Stream Packet Encapsulation The MPEG-2 Program Stream can have any packet size. The server delivers AAL-5 packets with an MPEG data size corresponding to twenty MPEG Transport packets or 3760 bytes for the Program Stream encapsulation. This encapsulation uses a larger ATM packet size than is used for MPEG-2 Transport Streams.
Page 114: Atm Addressing
ATM Addressing You specify the destination address with the MSMC API’s msmSetConnect() function. You ﬁll in an instance of the MsmConnect structure before calling msmSetConnect(). This structure contains an destTiAddr ﬁeld, which holds a string. This ﬁeld determines the destination address to which the server delivers data.
Page 115: Fast Ethernet Encapsulation
The address is a string of the following format: host=<IP hostname>,udpport=<UDPport num> The components of this address are as follows: The <IP hostname> is the destination client’s IP hostname. The <UDPport num> is the destination UDP port number on which the client host is awaiting data.
Page 116: Mpeg-2 Transport Stream Packet Encapsulation
Sun MediaCenter Server Control Port trafﬁc Fast Ethernet Ports video data Ethernet Switch . . . 10/100BaseT Clients LAN/Enterprise Scenario FIGURE 7-2 7.4.1 MPEG-2 Transport Stream Packet Encapsulation As of the date of this publication, there is no standard for transmitting MPEG over Ethernet.
Page 117: Mpeg-2 Program Stream Packet Encapsulation
7.4.2 MPEG-2 Program Stream Packet Encapsulation The MPEG-2 Program Stream is not deﬁned to have any ﬁxed packet size by the MPEG-2 standard. The server delivers UDP packets with payload containing MPEG data of size corresponding to seven MPEG-2 transport packets or 1316 bytes for the program stream encapsulation.
Page 118: Specifying Encapsulation
The components of this address are as follows: The <IP hostname> is the destination client’s IP hostname. The <UDPport num> is the destination UDP port number on which the client host is awaiting data. For example, the address of host=cordelia,udpport=40000 speciﬁes that data be delivered to host cordelia at UDP port 40000.
Page 119: Differences Among Different Types Of Links
Differences Among Different Types of Links The following are distinctions among the ways a Sun MediaCenter server handles video output over Fast Ethernet or ATM links: As described in this chapter, MPEG streams are encapsulated in UDP/IP packets and then in Ethernet packets, when sent over Fast Ethernet links. Over ATM, MPEG streams can be encapsulated in AAL5 ATM packets or in IP packets for subsequent encapsulation in AAL5 packets.
Page 120 7-10 Sun MediaCenter Server Administrator’s Guide • December 1997...
Page 121: Administering Mfs Disks
C H A P T E R Administering MFS Disks Monitoring MFS Disks page 8-1 MFS Utilities page 8-2 Replacing a Failed Disk page 8-10 This chapter tells how to monitor MFS disks and how to detect and respond to disk failures.
Page 122: Mfs Utilities
You can also use the Solstice Domain Manager (or other SNMP-conformant program) to monitor the Media File System (MFS) disks. The SNMP agent for the Sun MediaCenter server, sms-vod, has an SNMP trap, Disk_Failure, that allows for automatic notiﬁcation when a disk failure occurs. This trap is particularly signiﬁcant if a disk failure is followed by a reboot of the server.
Page 123 mfs df usage is as follows: mfs df [-kv] The mfs df command has the following options: Space is reported in kilobytes, rather than 64K blocks An option that produces “verbose” output. The two options can be used together, to obtain verbose output with space reported in kilobytes.
Page 124: Mfs Diskusg
Note in the verbose mfs df output, above, that the MFS block size (64k) is reported, as well as the disk type, which can be either data or parity. Output with the -k option is the same except that the Total, Used, and Avail data is displayed in kilobytes rather than 64K blocks.
Page 125: Mfs Repair
MPEGPS MPEG Program Stream packet format. MPEG1SYS MPEG-1 System Stream packet format. MPEGTCE MPEG Thomson Consumer Electronics format. The packetization of this encapsulation consists of an arbitrary number 130-byte packets. The mfs diskusg utility is useful in conjunction with mfs df. You can compare the output of mfs diskusg, the amount of space a ﬁle would consume, with the output of mfs df, which tells you the space available.
Page 126 mfs repair usage is as follows: mfs repair [-cs] [-Fpr] [-d /dev/rdsk/device] [-ovy] The arguments to mfs repair are described below: Perform consistency checking, including reclaiming unused blocks. Display the status of a failed drive (if any). Force a failure of a speciﬁed disk. Initiate phase-out of parity mode.
Page 127 To ﬁnd out which MFS disk has failed, you enter: server# mfs repair -s drive /dev/rdsk/c1t3d0s2 (dev 0x80009a) is FAILED mfs repair reports that the disk at c1t3d0s2 has failed. Chapter 3 of the Sun MediaCenter UltraSPARC Hardware Manual tells you that c1t3d0s2 corresponds to the third data disk in the ﬁrst Multipack enclosure connected to SCSI port 1 on the server.
Page 128: Mkmfs
Following this command, use the mfs repair commands described above to replace the failed disk. Use of mfs repair is appropriate only for single disk failures. Two, overlapping disk failures cause the server to panic. If you experience the failure of more than one disk, you must use smc_copy or ftp, in conjunction with the Sun MediaCenter FTP daemon, to restore your original data from backup storage.
Page 129 Following invocation without the -f option, mkmfs prompts you for the information required to build an MFS. For example: server% /opt/SUNWsms/mfs/bin/mkmfs FS path name: /var/opt/SUNWsms Total number of drives: 12 Number of parity drives: 2 Drive name: /dev/rdsk/c1t1d0s2 Drive name: /dev/rdsk/c1t2d0s2 Drive name: /dev/rdsk/c1t3d0s2 Drive name: /dev/rdsk/c1t4d0s2 Drive name: /dev/rdsk/c1t5d0s2...
Page 130: Replacing A Failed Disk
The meta-ﬁle for the MFS is stored in /var/opt/SUNWsms/MFS. Use the Solaris format command to obtain the SCSI target numbers used as input for mkmfs. The preceding example assumes you use slice 2 (s2) to stand for the entire disk. Slice 2 is one of the default slice assignments in effect when you install Solaris.
Page 131 In the output above, make note of the SCSI disk address (similar to the number c1t4d0s2). Chapter 3 of the Sun MediaCenter UltraSPARC Hardware Manual has instructions for mapping SCSI disk addresses to physical disks. 2. Open the appropriate Multipack enclosure, locate the failed disk, and remove and replace it.
Page 132 The procedure to replace and restore a parity disk is the same as for a data disk. A parity disk failure would be discovered while loading content. At the point of disk failure, the loading operation ceases. As with a data disk, you use the -r option to mfs repair to restore the parity disk.
Page 133: Access Control Lists
C H A P T E R Access Control Lists You restrict Sun MediaCenter server operations to speciﬁc users by creating access control lists (ACLs). You can create ACLs for the following: Server: Allows programs to list players, titles, or states and/or create or delete players.
Page 134: Permissions
Permissions All ﬁles used for ACLs support the following syntax: <user>:<permission> For all ACL ﬁles, standard Solaris lookup mechanisms are used for user name lookup. In support of unknown UIDs, all ﬁles support: nobody:<permission> Each type of ACL ﬁle allows different permissions; the permissions are described in the following sections in this chapter.
Page 135: Player Acl
...with the result that all users have read permission. For example, with only read permission for a Sun MediaCenter server, a user can look up titles on the server, but cannot play a stream. Each instance of the ServerAcl ﬁle must contain a line that indicates the version number of the ﬁle;...
Page 136: Title Acl
Title ACL Each content title has an ACL which is accessible either programmatically through the cmGetAcl() function or by the smc_gettacl utility. To create or modify permissions, use the cmSetAcl() function or the smc_settacl command. shows the permissions that you can specify: TABLE 9-3 Title ACL Permissions TABLE 9-3...
Page 137 A session ACL has a single type of permission. Session ACL Permissions TABLE 9-4 Access Permission Level User can run... Program can call... admin CmAdmin to abort a session cmSetSessionAcl() cmClientClose() cmRpcSetTimeout() cmOpen() cmCreate() cmSessionAbort() cmSessionClose() A programmer who invokes cmClientCreate() to create a session obtains admin access to that session.
Page 138 Sun MediaCenter Server Administrator’s Guide • December 1997...
Page 139: Symptoms And Possible Solutions/Workarounds
C H A P T E R Troubleshooting This chapter describes tools you can use to track down problems you might have with your Sun MediaCenter server. The most useful tool you can have for modeling your server ’s behavior and for detection of problems is SunNet Manager or another SNMP-conformant management platform that allows you to read values collected by the Sun MediaCenter server’s SNMP agent in its Management Information Base (MIB).
Page 140 Underperforming stream output Possible cause is network congestion. Use a network analyzer or your switch vendor’s diagnostics to analyze network performance. Note that your server is intended only for the storage and delivery of multimedia streams. Any processes not associated with this purpose have the potential to disrupt server output.
Page 141 Poor video quality Possible causes: Content is stored at a bit rate different from that at which it was encoded. Content might be poorly encoded. The destination client might not be able to keep up with the video stream. Check the bit rate of the content. The bit rate should be roughly ﬁlesize * 8/playtime, where playtime is the duration of a title, in seconds.
Page 142: Error Messages
Unable to create title on the MFS. Likely cause: A ﬁlled MFS or a disk failure. In this situation, the Sun MediaCenter software removes all ﬁles associated with the title. Use mfs df, documented in the Sun MediaCenter Server Service Manual, to determine free space in the MFS.
Page 143: Mfs Error Messages
WARNING: stream id 107 (ba@426,3,80@) xmit error: Q size 33 Cause: Low-level software has detected a transmission error. Action required: None. Most often, higher level software can recover from such an error. However, if you receive such messages continually or if such messages are accompanied by degraded video output, contact your Sun service representative.
Page 144 10-6 Sun MediaCenter Server Administrator’s Guide • December 1997...
Page 145 A P P E N D I X Setting up the SNMP Agent The Sun MediaCenter Server MIB page A-2 Enabling Management by Solstice Domain Manager page A-6 Enabling Trap Handling page A-9 The Sun MediaCenter software is shipped with its own SNMP agent, which is part of the SUNWsmsnm package.
Page 146: A.1 The Sun Mediacenter Server Mib
Note – A caveat on the use of the SNMP agent shipped with the Sun MediaCenter server: If you use SNMP to manage the Sun MediaCenter software, you cannot also run an SNMP agent to manage other components of your system (for example, the ATM interface).
Page 147 Sun MediaCenter Server MIB Deﬁnitions TABLE A-1 Group or Table Attribute Name Description Total delay for the admission of all streams since last reboot, in admTotalDelay milliseconds. Average admission delay, in milliseconds. admAverageDelay bitPump Current number of bit pump streams. bitPumpStreams Bandwidth of the bit pump, in bits/sec.
Page 148 Sun MediaCenter Server MIB Deﬁnitions TABLE A-1 Group or Table Attribute Name Description Time at which the late event was detected, in microseconds. diskLateTime Duration of lateness, in milliseconds. diskLateDuration diskTable Name of the disk. diskDeviceId Number of I/O operations for a disk. diskNumIOoperations Number of times a disk was late.
Page 149 Sun MediaCenter Server MIB Deﬁnitions TABLE A-1 Group or Table Attribute Name Description Number of zones per disk. A zone is a region of a disk used for the sysZonesPerDisk storage of streams A ﬁxed interval used by VOD scheduler for MFS operations. sysTimePeriodLength Number of conﬁgured buffers.
Page 150: A.2 Enabling Management By Solstice Domain Manager
The remaining attributes, those not in , are counters, sizes, identiﬁers, and TABLE A-2 times (both durations and instants) that change according to conditions on the server. These attributes can be categorized as follows: Streams and stream admission The active and admission groups. Bit pump The bitPump group and the bitPumpStreamTable.
Page 151 3. Edit $SNMHOME/struct/elements.schema, to add lines for the Sun MediaCenter server. Use the lines for the SPARCcenter 1000 (sc1000) as a basis for the new lines for the Sun MediaCenter server (sms1000). For example: record component.sc1000 ( # SC1000 string[64] Name string[40] IP_Address...
Page 152 6. Run: build_oid (with no arguments). This program maps names in Sun MediaCenter server MIB to new OIDs. 7. (Optional) Copy your $SNMHOME/discover.conf ﬁle to /etc/opt/SUNWconn/ snm. In the MAPPINGS section of this copy, add the line: media component.sms1000 In addition to modifying discover.conf, set the environment variable SNMDISCOVERMAP to the directory where discover.conf is located.
Page 153: A.3 Enabling Trap Handling
As an example of a the SNMP agent’s capability, the following is a Quick Dump report for the bitPump attribute on a machine redoubt: Wed May 24 15:12:15 1995 [ redoubt ] : Quick Dump: sms-vod.bitPump bitPumpStreams=2 bitPumpBandwidth=8003840 bitPumpTimePeriod=5405:07:40.72 bitPumpMissedDeadlines=0 Enabling Trap Handling In addition to the six standard SNMP traps, the Sun MediaCenter server ’s SNMP agent supports three enterprise-speciﬁc traps, Admission_Failed,...
Page 154 2 Missed_Deadline The Sun MediaCenter software ensures delivery of media streams at the same rate at which they were recorded. The bit pump’s missing of a deadline indicates that the machine was, at least momentarily, unable to keep up with the rate of a title. This indicates a resource conﬂict on the server.
Page 155 A P P E N D I X Creating a Content Package Content Package page B-2 The TOC File page B-3 Simplest Case TOC File page B-8 TOC File for Large Files page B-9 Index File Requirements page B-10 Tape Storage Format page B-12 Example page B-14...
Page 156: B.1 Content Package
Content Package A content package is a collection of separate MPEG streams that represent the content of a title (including audio and video) at various playback speeds. There are two types of ﬁles that together describe each of the (potentially) multiple bit streams that make up a content package: the data ﬁle containing the MPEG-encoded data;...
Page 157: B.2 The Toc File
Content Package TOC File <ASN.1 description of MPEG stream 1> <ASN.1 description of MPEG stream 2> <ASN.1 description of MPEG stream N> MPEG MPEG MPEG stream 1 stream 2 stream N Data Index Data Index Data Index File File File File File File...
Page 158 A TOC ﬁle is described with the following structures: content ContentObjects ContentObjects ::= SEQUENCE title GraphicString, version GraphicString, format GraphicsString, description GraphicStringOPTIONAL, bitstreams BitStreamObjects BitStreamObjects ::= SEQUENCE description GraphicStringOPTIONAL, speed INTEGER, bitrate INTEGER, indexfile GraphicString, indexsize INTEGER, datafile DataFileObjects DataFileObjects ::= SEQUENCE segment INTEGER, filepath...
Page 159: B.2.1 Contentobjects
B.2.1 ContentObjects The structure contains the overall information for the content package. B.2.1.1 title The title property is a string that speciﬁes the name of the content. Use the convention: title "<stock symbol> <titlename>" , For example, if you want to load the content for the title, “Bambi”, ﬁll in the title ﬁeld as follows: title "SUNW Bambi"...
Page 160: B.2.2 Bitstreamobjects
MPEGTCE DSS transport format wherein the server transports data in units of 130-byte packets. MPEGPS MPEG-2 program stream encapsulation wherein the server transports data in 4- byte aligned packet sizes of arbitrary length. MPEG1SYS MPEG-1 system stream encapsulation wherein the server transports data in 4-byte aligned packet sizes of arbitrary length.
Page 161: B.2.3 Datafileobjects
B.2.2.3 bitrate The bitrate property, expressed in bits/sec., speciﬁes the bit rate at which the MPEG data ﬁle was encoded. This number also speciﬁes the rate at which the ﬁle is to be played by the server to the network. B.2.2.4 indexﬁle The indexﬁle property is a string that speciﬁes the pathname to the index ﬁle.
Page 162: B.3 Simplest Case Toc File
B.2.3.2 ﬁlepath The ﬁlepath property is a string specifying the pathname of the data ﬁle for this segment of the bit stream’s data. B.2.3.3 ﬁlesize The ﬁlesize property is an integer specifying the size of the data ﬁle for this segment of the bit stream’s data, in bytes.
Page 163: B.4 Toc File For Large Files
The ﬁelds in the TOC ﬁle are described as follows: title A name of your choosing. After you have stored the title on the server, smc_ls returns the contents of this ﬁeld. version For versions 1.0 and 1.1 of the Sun MediaCenter server software, this is always SUNW.00.01.
Page 164: B.5 Index File Requirements
The following is an example of a TOC ﬁle for a multi-part title: content title “Perils of Technology”, version “SUNW.00.01”, format “MPEG1SYS”, description “History of technology, with Luddite slant“, bitstreams description “Normal play bit stream“, speed 1000, bitrate 1660400, datafile segment 1, filepath “Part1.mpg”, filesize 284512264...
Page 165: B.5.1 Normal Play Time
Note – For video formatted as MPEG-2 Transport Streams, the CM automatically generates index ﬁles for titles that contain trick play streams, at the point when content is loaded onto the server. For other formats, you must generate your own index ﬁles.
Page 166: B.5.2 File Offset
NPTs for a reverse-playing stream must monotonically decrease, from beginning to end of the index ﬁle. NPT is a time offset into the content as one would view the content at normal speed, not the time at which the pictures are presented (PTS). B.5.2 File Offset The value in the ﬁle offset ﬁeld speciﬁes the byte offset into the MPEG-2 data ﬁle...
Page 167 Start of Tape Bambi.TOC Index File 1X play speed Tape Index File 4X play speed Content Package Index File nX play speed Start of Data Files Data File 1X play speed Data File 4X play speed Data File nX play speed Tape Storage Format FIGURE B-2 The TOC ﬁle must be positioned as the ﬁrst ﬁle in the tar tape and must have a ﬁle...
Page 168: B.6.2 Tapes
The recommended block size of the tar format is 500 512-byte blocks, or 256,000 bytes. The default blocking factor for tar is 20 blocks, or 10,240 bytes. B.6.2 Tapes The Sun MediaCenter server supports both 4-mm and 8-mm cartridge tapes. Example This section provides an example of a content package—the TOC ﬁle and the index and data ﬁles for each bit stream—and its storage on a tape using the tar format.
Page 169 The content of the TOC ﬁle bambi.TOC is shown below. It contains attributes for every bit stream included in the content package for the movie “Bambi”. Example Content Package CODE EXAMPLE B-1 content title “bambi”, version “SUNW.00.01”, format “MPEGTCE”, description “Aftermath of concentration camp survival“, bitstreams description ““, speed -7000,...
Page 170 Example Content Package CODE EXAMPLE B-1 filesize 5710380 description ““, speed 21000, bitrate 2559999, indexfile “bambi.21x.index”, indexsize 16, datafile segment 1, filepath “bambi.21x.mpeg”, filesize 1905670 description ““, speed 1000, bitrate 5380000, indexfile “bambi.1x.index”, indexsize 250, datafile segment 1, filepath “bambi.1x.mpeg”, filesize 83554510 The textual content of index ﬁles for various speeds are shown below.
Page 171 For a ﬁle bambi.1x (index ﬁle for normal-speed play): required NPT and ﬁle offset starting values 496978 258310 993956 595010 1490935 935610 1987913 1268670 2484892 1605500 200+ entries omitted from example 121262750 82085770 121759728 82422600 122256707 82759430 122753685 83096130 123250664 83432960 Total NPT and bit steam size 124244621...
Page 172: References
For a ﬁle bambi.n21x (index ﬁle for twenty-one times normal speed, in reverse): 124244621 116479333 107510 108714044 239070 100948755 362960 93183466 498550 85418177 621400 77652889 750100 69887600 876980 62122311 1012570 54357022 1133860 46591733 1263210 38826445 1387490 31061156 1520610 23295867 1648140 15530578 1775930 1902680...
Page 173 CCITT Recommendation X.209 (1988): Speciﬁcation of Basic Encoding Rules for Abstract Syntax Notation One (ASN.1). Technically aligned with ISO 8825 and ISO 8825/AD 1. Appendix B Creating a Content Package B-19...
Page 174 B-20 Sun MediaCenter Server Administrator’s Guide • December 1997...
Page 175 Glossary This glossary contains general, multimedia-related terms, as well as terms speciﬁc to the Sun MediaCenter product. Words and phrases in the latter category are indicated as such. access control list A list of users and the associated operations they are allowed to perform. An access control list is a feature of the Media Stream Manager (MSM).
Page 176 A matrix, block, or single sample representing a monochrome representation of luminance the signal. Luminance is related to the primary colors in the manner deﬁned in the bit stream. The symbol for luminance is Y. Luminance is distinguished from chrominance. Media Stream Manager (MSM) An RPC-based API that provides users with a means of interacting with a...
Page 177 Table of Contents A fundamental component of a content package. A TOC ﬁle lists the set of (TOC) ﬁle index and data ﬁles that contain the bit streams that make up the movie contained by that content package. MSM clients play movies by specifying a TOC ﬁle for that movie.
Page 178 Glossary-4 Sun MediaCenter Server Administrator’s Guide • December 1997...
Page 179 Index bit pump, 1-7 bit pump characteristics, 3-23, A-3 access control list, deﬁnition of, Glossary-1 bit rate requirements for encoding, 2-2 access control list, title, 5-1 bit rate, encoding/play mismatch, 10-3 active streams, detecting number of, 3-21, A-2 bit rate, supported range for encoding, 2-2 admin permission, requirement for one user in title BitStreamObjects, portion of ContentObjects, B-6 ACL, 5-3...
Page 180 content requirements, 2-1 Fast Ethernet and ATM links, differences content requirements for trick play, 2-2 between, 7-9 content, utility for listing, 5-20 Fast Ethernet data packet format, 7-5 ContentObjects, ASN.1 description of content Fast Ethernet output data encapsulation, 7-5 package, B-5 FastEthernet interface copying content with smc_tar, 5-10 treatment of multiple, 10-3...
Page 181 loading content with smc_tar, 5-9 MPEG-1 System Stream encapsulation for Fast loading content, with smc_copy, 5-4 Ethernet, 7-7 ls command, in ftp, 6-8 MPEG-2 Program Stream encapsulation for Fast Ethernet, 7-7 luminance, deﬁnition of, Glossary-2 MPEG-2 Program Stream packet encapsulation for ATM, 7-3 MPEG-2 Transport Stream encapsulation for Fast Ethernet, 7-6...
Page 182 playthrough, support in the MFS, 1-5 snmp.traps ﬁle, A-9 Program Association Table, encoding snmpd daemon, A-2 requirement, 2-2 snoop, used for troubleshooting, 10-1 Solstice Domain Manager, using with SMC Program Clock Reference, encoding requirement, 2-2 MIB, A-6 push model, description of, 1-11 space consumption in /var, 2-6 put command, in ftp, 6-11 SPARCstorage MultiPack enclosure, monitoring...
Page 183 title access control list, 5-1 title ACL permissions, 5-2 title naming convention, B-5 title, setting access to, 5-2 titles, obtainiing list of on server, 5-17 titles, removing, 5-21 TOC ﬁle for large MPEG ﬁles, B-9 TOC ﬁle, example for simplest case, B-8 TOC ﬁle, parsing, 5-9 trick play streams, loading, 6-15 trick play, deﬁnition of, Glossary-3...
Page 184 Index-6 Sun MediaCenter Server Administrator’s Guide • December 1997...

Sun Microsystems Sun MediaCenter 2.1 Administrator's Manual

Glossary

Index

2 Preparing and Loading Content

3 Monitoring the Server

10 Troubleshooting

4 Moving Content

5 Sun Mediacenter Server Utilities

1 Introduction

7 Server Output Data Format

8 Administering MFS Disks

9 Access Control Lists

Quick Links

Troubleshooting

Need help?

Questions and answers

Related Manuals for Sun Microsystems Sun MediaCenter 2.1

Summary of Contents for Sun Microsystems Sun MediaCenter 2.1

Table of Contents