Sun Microsystems 2.1 - Manual

vi Sun MediaCenter Server Administrator’s Guide • December 1997 7. Server Output Data Format 7-1 7.1 Introduction 7-1 7.2 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 ...

Contents vii 9. Access Control Lists 9-1 9.1 ACL Files 9-1 9.2 Permissions 9-2 9.3 Server ACL 9-2 9.4 Player ACL 9-3 9.5 Title ACL 9-4 9.6 Session ACL 9-4 10. 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....

viii Sun MediaCenter Server Administrator’s Guide • December 1997 B.6 Tape Storage Format B-12 B.6.1 Tar Format B-12 B.6.2 Tapes B-14 B.7 Example B-14 B.8 References B-18 Glossary Glossary-1 Index Index-1

Preface ix Preface This document, the Sun MediaCenter Server Administrator ’s Guide, tells you how to setup, load content onto, and perform other administrative duties relevant to a Sun™MediaCenter™ server. Specifically, this document describes: ■ at a high level, the hardware and software architect...

x Sun MediaCenter Server Administrator’s Guide • December 1997 The Sun MediaCenter DocumentationSuite This manual is a companion to the Sun MediaCenter Server Installation andConfiguration Manual, the Sun MediaCenter Server Programmer ’s Guide and the SunMediaCenter UltraSPARC Hardware Manual. Toget...

xi 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 ...

xii Sun MediaCenter Server Administrator’s Guide • December 1997 Shell Prompts in Command Examples The following table shows the default system prompt and superuser prompt for theC shell, Bourne shell, and Korn shell. TABLE P-2 Shell Prompts Shell Prompt C shell prompt machine_name% C shell superuse...

1-2 Sun MediaCenter Server Administrator ’s Guide • December 1997 ■ a Content Manager (CM), which includes an RPC-based API that allows users tomove content between servers or between a server and a client. ■ Web-based tools that allow you to configure a Sun MediaCenter server, monitorserver operati...

1-4 Sun MediaCenter Server Administrator ’s Guide • December 1997 1.3 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). (Inaddition to these, there are special network interface ...

Chapter 1 Introduction 1-7 ■ scheduler The scheduler sorts and schedules disk I/O, manages bit pump buffers, performsadmission control, and schedules output driver activity. ■ bit pump The bit pump is responsible for allocating internal buffering and efficientlytransferring data between the disk and...

1-8 Sun MediaCenter Server Administrator ’s Guide • December 1997 The MSM’s primary interface is the MSM Client API, described in the SunMediaCenter Server Programmer ’s Guide. The MSM supports playthrough, trick play, and other features of the Media FileSystem. 1.3.3 Content Manager The CM provides...

Chapter 1 Introduction 1-9 1.4.1 ATM In an ATM environment, one or more Sun MediaCenter servers are directlyconnected to an ATM switch via ATM host adapters. Digital video streams are sentto clients using ATM virtual circuits. FIGURE 1-4 Sun MediaCenter Servers in ATM Environment 1.4.2 LAN In the LA...

1-10 Sun MediaCenter Server Administrator ’s Guide • December 1997 FIGURE 1-5 Sun MediaCenter Servers in LAN environment 1.5 Content Preparation and Loading The Sun MediaCenter software specifies a format for content, described in Chapter 2,“Preparing and Loading Content.” Sun MediaCenter software u...

Chapter 1 Introduction 1-11 1.6 Server Management An SNMP agent is provided is provided with the Sun MediaCenter software. Thisagent includes the following MIB information: ■ current number of playing streams; ■ current aggregate bandwidth; ■ number of missed deadlines; ■ number and location of disk...

1-12 Sun MediaCenter Server Administrator ’s Guide • December 1997 delivery support output only. The MSM Client API has calls that allow you tospecify an ultimate destination, but do not, for example, allow you to set anyparameters on that destination, which would imply the ability of the receiver t...

2-1 C H A P T E R 2 Preparing and Loading Content This chapter specifies what video content should consist of and how it should beformatted, as required by the Sun MediaCenter software. It also provides guidelinesfor content loading. This chapter does not tell you how to encode content. The Sun Medi...

Chapter 2 Preparing and Loading Content 2-3 ■ All trick files must be encoded at a bit rate that is less than or equal to the bit rateof the normal-speed bit stream. The Media Stream Manager supports the playing of trick play streams. See thechapter on the Media Stream Manager Client API in the Sun ...

Chapter 2 Preparing and Loading Content 2-5 2.4 Content Loading The preferred method of storing content on a Sun MediaCenter server is to use theWeb-based CmTool. CmTool uses the Sun MediaCenter FTP daemon and theContent Manager (CM), part of the Sun MediaCenter software, to store content. TheCM aut...

Chapter 2 Preparing and Loading Content 2-7 2.5 References ISO/IEC 13818-1/2/3 Recommendation H.262: “Generic Coding of Moving Picturesand Associated Audio Information: Systems/Video/Audio” ISO/IEC 11172-1/2/3 “Coding of Moving Pictures and Associated Audio for digitalstorage media at up to 1.5 Mbit...

3-1 C H A P T E R 3 Monitoring the Server This chapter describes the Sun MediaCenter WebAdmin tool, a Web-based graphicaluser interface (GUI) for monitoring the Sun MediaCenter server. The tool is part ofthe software that is installed on the Sun MediaCenter server. 3.1 Overview The Sun MediaCenter W...

3-2 Sun MediaCenter Server Administrator ’s Guide • December 1997 3.2 Using the WebAdmin Tool You can run WebAdmin from the following: ■ Any browser that is fully compatible with Java Developer ’s Kit (JDK) version1.1.1 or later (for example, HotJava™ 1.0 or later). ■ Java Applet Viewer available wi...

Chapter 3 Monitoring the Server 3-5 3.2.2 Common Page Elements This section describes the items that appear at the top of each page in theWebAdmin tool. Each page is described in detail in later sections in this chapter. The Server Name field appears at the top left corner of each page and identifie...

3-6 Sun MediaCenter Server Administrator ’s Guide • December 1997 Videos being copied Displays the number of content movement sessions on the server. Click on theicon or the link to display the Copy Sessions page, where you can view moreinformation about the content movement sessions. See Section 3....

Chapter 3 Monitoring the Server 3-9 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 playe...

3-12 Sun MediaCenter Server Administrator ’s Guide • December 1997 This page displays the following information: State Creating or OpeningShared or ExclusiveReliable or Unreliable Status OK or error message from CM_API. Transfer Mode TCP or ATM Address TCP port or ATM address. Bytes Xfered The numbe...

Chapter 3 Monitoring the Server 3-15 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. 3.7 Troubleshooting The Troubleshooting page allows you to monitor the following server components:MFS disks, ...

Chapter 3 Monitoring the Server 3-17 3.7.1 Disk Health This page shows the status of disks in the MFS. The Disk Health page is shown below: FIGURE 3-10 Disk Health Page

3-18 Sun MediaCenter Server Administrator ’s Guide • December 1997 The Disk Health page displays the disks in groups, as specified 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 ...

3-20 Sun MediaCenter Server Administrator ’s Guide • December 1997 3.7.3 Scheduler and Bitpump The Bitpump page displays information about the Sun MediaCenter serverscheduler and bitpump. The Bitpump page is shown below: FIGURE 3-12 Scheduler and Bitpump Page

4-1 C H A P T E R 4 Moving Content This chapter describes the Sun MediaCenter CmTool, a Web-based graphical userinterface (GUI) that allows you to transfer content to a Sun MediaCenter server. Thetool is part of the software that is installed on the Sun MediaCenter server. 4.1 Overview CmTool is a s...

4-2 Sun MediaCenter Server Administrator ’s Guide • December 1997 4.2 Using CmTool You can run CmTool from the following: ■ Any browser that is fully compatible with Java Developer ’s Kit (JDK) version1.1.1 or later (for example, HotJava 1.0 or later). ■ Java Applet Viewer available with JDK 1.1.3. ...

Chapter 4 Moving Content 4-5 4.2.2 Common Page Elements This section describes the items that appear at the top of each page in CmTool.Specific elements of each page are described later in this chapter. The Server Name field appears at the top left corner of each page and identifies theSun MediaCent...

Chapter 4 Moving Content 4-13 4.4.1 View Menu The View menu provides options that affect the display of titles in the Table ofContents 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 nam...

Chapter 4 Moving Content 4-15 4.4.2 Selected Menu The Selected menu allows you to view more information about a selected title, andto rename, delete, or play the title. Select a title in the Table of Contents page, thenselect the More Info option from the Selected menu. The Title Information pageapp...

5-4 Sun MediaCenter Server Administrator ’s Guide • December 1997 5.2 The smc_copy Utility The smc_copy utility copies content, specified by a title name or a local filesystem name, between a local filesystem and a Sun MediaCenter server or between two SunMediaCenter servers. Examples of a local fil...

5-8 Sun MediaCenter Server Administrator ’s Guide • December 1997 5.3 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 file. smc...

5-10 Sun MediaCenter Server Administrator ’s Guide • December 1997 FIGURE 5-1 Loading Content with smc_tar After loading content with smc_tar , you can pass a TOC file (title name) as an argument to MSM Client API functions (described in the Sun MediaCenter ServerProgrammer’s Guide), to play the tit...

5-12 Sun MediaCenter Server Administrator ’s Guide • December 1997 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: For the c option, you must have on...

6-4 Sun MediaCenter Server Administrator ’s Guide • December 1997 6.2 Video-File Attributes A piece of video content is stored as a title on a Sun MediaCenter server. The ftp video-file commands report or perform operations on titles. A title is identified bythe following attributes: ■ name of the t...

Chapter 6 Sun MediaCenter Server FTP Daemon 6-7 6.3.1 Listing Files dir The dir command lists the names of the data and index files associated with the titles on a Sun MediaCenter server. An example of its use: ftp> dir smc: Title Usage NPT Format Available Speeds Bambi FREE 02:03:42 MPEGPS 1000,...

Chapter 6 Sun MediaCenter Server FTP Daemon 6-9 Examples of mls use: 6.3.2 Moving Files When copying a data file (that is, an MPEG file), as distinguished from an index file,within ftp , use the bin command to put ftp in binary mode. Index files are ASCII files, so you can use ASCII mode, ftp ’s def...

6-10 Sun MediaCenter Server Administrator ’s Guide • December 1997 With regard to video-file attributes, when you get or mget files, (the Media File System [MFS]-to-local file system direction) those files are stored in a local filesystem with as many or few attributes as you specify. Conversely, wh...

6-12 Sun MediaCenter Server Administrator ’s Guide • December 1997 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 filesystem. You can use mput only with files that you have previously backed up with mget . For e...

Chapter 6 Sun MediaCenter Server FTP Daemon 6-13 mput The mput command copies files from a local file 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 file system using the mget command. mput s...

6-14 Sun MediaCenter Server Administrator ’s Guide • December 1997 6.3.4 Deleting Files delete The delete (or del ) command allows you to delete a video file from a Sun MediaCenter server. You specify only a title name for this command. An example of its use: 6.4 Loading Content with ftp Use of ftp ...

7-2 Sun MediaCenter Server Administrator ’s Guide • December 1997 controlled by the Content Manager (CM). Utilities that use the CM are described inChapter 5 and Chapter 6. The CM server and client APIs are described in the SunMediaCenter Server Programmer ’s Guide. FIGURE 7-1 illustrates the separa...

Chapter 7 Server Output Data Format 7-3 7.2.2 MPEG-2 Program Stream Packet Encapsulation The MPEG-2 Program Stream can have any packet size. The server delivers AAL-5packets with an MPEG data size corresponding to twenty MPEG Transport packetsor 3760 bytes for the Program Stream encapsulation. This ...

7-4 Sun MediaCenter Server Administrator ’s Guide • December 1997 7.3 ATM Addressing You specify the destination address with the MSMC API’s msmSetConnect() function. You fill in an instance of the MsmConnect structure before calling msmSetConnect() . This structure contains an destTiAddr field, whi...

Chapter 7 Server Output Data Format 7-5 The address is a string of the following format: 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 hostis awaiting ...

Chapter 7 Server Output Data Format 7-7 7.4.2 MPEG-2 Program Stream Packet Encapsulation The MPEG-2 Program Stream is not defined to have any fixed packet size by theMPEG-2 standard. The server delivers UDP packets with payload containing MPEGdata of size corresponding to seven MPEG-2 transport pack...

7-8 Sun MediaCenter Server Administrator ’s Guide • December 1997 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 hostis awaiting data. For example, the ...

8-1 C H A P T E R 8 Administering MFS Disks This chapter tells how to monitor MFS disks and how to detect and respond to diskfailures. 8.1 Monitoring MFS Disks The easiest way to monitor the Media File System (MFS) disks is to use the SunMediaCenter WebAdmin tool. The WebAdmin tool is a Web-based gr...

8-4 Sun MediaCenter Server Administrator ’s Guide • December 1997 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 ...

Chapter 8 Administering MFS Disks 8-5 MPEGPS MPEG Program Stream packet format. MPEG1SYS MPEG-1 System Stream packet format. MPEGTCE MPEG Thomson Consumer Electronics format. The packetization of thisencapsulation consists of an arbitrary number 130-byte packets. The mfs diskusg utility is useful in...

8-8 Sun MediaCenter Server Administrator ’s Guide • December 1997 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 experienc...

8-10 Sun MediaCenter Server Administrator ’s Guide • December 1997 The meta-file 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 dis...

9-1 C H A P T E R 9 Access Control Lists You restrict Sun MediaCenter server operations to specific users by creating accesscontrol lists (ACLs). You can create ACLs for the following: ■ Server: Allows programs to list players, titles, or states and/or create or deleteplayers. ■ Players: Allows prog...

9-2 Sun MediaCenter Server Administrator ’s Guide • December 1997 9.2 Permissions All files used for ACLs support the following syntax: <user>:<permission> For all ACL files, standard Solaris lookup mechanisms are used for user namelookup. In support of unknown UIDs, all files support: n...

Chapter 9 Access Control Lists 9-3 ...with the result that all users have read permission. For example, with only readpermission for a Sun MediaCenter server, a user can look up titles on the server, butcannot play a stream. Each instance of the ServerAcl file must contain a line that indicates the ...

9-4 Sun MediaCenter Server Administrator ’s Guide • December 1997 9.5 Title ACL Each content title has an ACL which is accessible either programmatically throughthe cmGetAcl () function or by the smc_gettacl utility. To create or modify permissions, use the cmSetAcl () function or the smc_settacl co...

10-4 Sun MediaCenter Server Administrator ’s Guide • December 1997 Unable to create title on the MFS. Likely cause: A filled MFS or a disk failure. In this situation, the Sun MediaCentersoftware removes all files associated with the title. Use mfs df , documented in the Sun MediaCenter Server Servic...

Chapter 10 Troubleshooting 10-5 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 suchan error. However, if you receive such messages continually or if suc...

A-1 A P P E N D I X A Setting up the SNMP Agent The Sun MediaCenter software is shipped with its own SNMP agent, which is partof the SUNWsmsnm package. This agent is based on the SNMP agent shipped with the Solstice Domain Manager (SDM); the agent has been extended to support theSun MediaCenter serv...

Appendix A Setting up the SNMP Agent A-9 As an example of a the SNMP agent’s capability, the following is a Quick Dumpreport for the bitPump attribute on a machine redoubt : A.3 Enabling Trap Handling In addition to the six standard SNMP traps, the Sun MediaCenter server ’s SNMPagent supports three ...

B-1 A P P E N D I X B Creating a Content Package This appendix describes a content package, which is one way that content can beprepared for storage on a Sun MediaCenter server. Specifically, this documentdescribes: ■ the types of files that make up a content package; ■ the storage format of those f...

B-2 Sun MediaCenter Server Administrator ’s Guide • December 1997 B.1 Content Package A content package is a collection of separate MPEG streams that represent the contentof a title (including audio and video) at various playback speeds. There are two types of files that together describe each of th...

Appendix B Creating a Content Package B-3 FIGURE B-1 Structure of a Content Package Note – If your content consists of a single bit stream, you do not need an index file. You content package will consist of only a Table of Contents file and the single bitstream. B.2 The TOC File The Table of Content...

Appendix B Creating a Content Package B-5 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 specifies the name of the content. Use theconvention: For example, if you want to load the content for the title, “...

B-6 Sun MediaCenter Server Administrator ’s Guide • December 1997 MPEGTCE DSS transport format wherein the server transports data in units of 130-bytepackets. MPEGPS MPEG-2 program stream encapsulation wherein the server transports data in 4-byte aligned packet sizes of arbitrary length. MPEG1SYS MP...

Appendix B Creating a Content Package B-7 B.2.2.3 bitrate The bitrate property, expressed in bits/sec., specifies the bit rate at which the MPEGdata file was encoded. This number also specifies the rate at which the file is to beplayed by the server to the network. B.2.2.4 indexfile The indexfile pr...

B-8 Sun MediaCenter Server Administrator ’s Guide • December 1997 B.2.3.2 filepath The filepath property is a string specifying the pathname of the data file for thissegment of the bit stream’s data. B.2.3.3 filesize The filesize property is an integer specifying the size of the data file for this s...

Appendix B Creating a Content Package B-9 The fields in the TOC file 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 field. version For versions 1.0 and 1.1 of the Sun MediaCenter server software, this is alw...

B-10 Sun MediaCenter Server Administrator ’s Guide • December 1997 The following is an example of a TOC file for a multi-part title: B.5 Index File Requirements An index file is an ASCII file that specifies the splice points for one bit stream in acontent package. (See Section 2.3 “Splice Points” on...

Appendix B Creating a Content Package B-11 Note – For video formatted as MPEG-2 Transport Streams, the CM automatically generates index files for titles that contain trick play streams, at the point whencontent is loaded onto the server. For other formats, you must generate your ownindex files. The ...

B-12 Sun MediaCenter Server Administrator ’s Guide • December 1997 ■ NPTs for a reverse-playing stream must monotonically decrease, from beginningto end of the index file. ■ NPT is a time offset into the content as one would view the content at normalspeed, not the time at which the pictures are pre...

B-14 Sun MediaCenter Server Administrator ’s Guide • December 1997 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 ta...

Index-1 Index A access control list, definition of, Glossary-1access control list, title, 5-1active streams, detecting number of, 3-21, A-2admin permission, requirement for one user in title ACL, 5-3 Admission_Failed trap, A-9alternatives for video file transfer, 2-5analog video, definition of, Glos...