ProMedia TM Xpress. (Xpress Preset and Package Preset) User Guide RELEASE Rev A

Transcription

1 ProMedia TM Xpress (Xpress Preset and Package Preset) User Guide RELEASE Rev A

2 Disclaimer Harmonic reserves the right to alter the equipment specifications and descriptions in this publication without prior notice. No part of this publication shall be deemed to be part of any contract or warranty unless specifically incorporated by reference into such contract or warranty. The information contained herein is merely descriptive in nature, and does not constitute a binding offer for sale of the product described herein. Harmonic assumes no responsibility or liability arising from the use of the products described herein, except as expressly agreed to in writing by Harmonic. The use and purchase of this product do not convey a license under any patent rights, copyrights, trademark rights, or any intellectual property rights of Harmonic. Nothing hereunder constitutes a representation or warranty that using any products in the manner described herein will not infringe any patents of third parties. Trademark Acknowledgments Harmonic and all Harmonic product names are trademarks of Harmonic Inc. All other trademarks are the property of their respective owners. The software described in this document is furnished under a license agreement or nondisclosure agreement. The software may be used or copied only in accordance with the terms of those agreements Harmonic Inc. All rights reserved.

3 Documentation Conventions This manual uses some special symbols and fonts to call your attention to important information. The following symbols appear throughout this manual: CAUTION: The Caution symbol calls your attention to information that, if ignored, can adversely affect the performance of your Harmonic product, or that can make a procedure needlessly difficult. NOTE: The Note symbol calls your attention to additional information that you will benefit from heeding. It may be used to call attention to an especially important piece of information you need, or it may provide additional information that applies in only some carefully delineated circumstances. TIP: The Tip symbol calls your attention to parenthetical information that is not necessary for performing a given procedure, but which, if followed, might make the procedure or its subsequent steps easier, smoother, or more efficient. In addition to these symbols, this manual uses the following text conventions: Convention Typed Command Buttons and Menus <Ctrl>, <Ctrl>+<Shift> Links Bold LCD Screen Output ScreenOutput Emphasis Explanation Indicates the text that you type in at the keyboard prompt. Indicates a button to click, or a menu item to select. A key or key sequence to press. The italics in blue text to indicate Cross-references, and hyperlinked cross-references in online documents. Indicates a new term. For example: SpanWindow - the transmission frequency along the 1GHz spectrum allocated for each RF Port. It spans across 384MHz. The text that is displayed on an LCD console output. The text that is displayed on a computer screen. The italics text used for emphasis and document references. NOTE: You require Adobe Reader or Adobe Acrobat version 6.0 or later to open the PDF files. You can download Adobe Reader free of charge from Harmonic Inc. All rights reserved.

4 Table of Contents Table of Contents Chapter 1 Preface 1.1 Organization of this guide... 5 Chapter 2 Introduction 2.1 ProMedia Xpress Overview... 6 Chapter 3 Configuring Xpress and Package Presets 3.1 Configuring Xpress Presets Input Baseband Processing Logo Insertion Encoding Profile Output Configuring Package Presets Configuring Package Presets for HDS Outputs Configuring Package Presets for HLS Outputs Configuring Package Presets for SS Outputs...21 Chapter 4 Creating Workflow Templates for Xpress & Package Presets 4.1 Adding a New Workflow Template Workflow Task Components Notification Command Line Process Web Notification Output File Transfer Source File Transfer Report Package Configuring Pre-Transform Tasks Configuring Transform Tasks Adding Xpress Targets Adding Package Targets Configuring Job End Tasks On Success On Failure Harmonic Inc. 4 ProMedia Xpress, Release , Rev A

5 Chapter 1 Preface This guide describes features of the Xpress and Package Presets. 1.1 Organization of this guide This user guide is organized as follows: Chapter 1, Preface (this chapter), outlines the guide s organization. Chapter 2, Introduction, describes the overview of ProMedia Xpress. Chapter 3, Configuring Xpress and Package Presets, describes the procedures on how to configure the Xpress and Package presets. Chapter 4, Creating Workflow Templates for Xpress & Package Presets, describes the procedures on how to create workflow templates for the Xpress and Package presets Harmonic Inc. 5 ProMedia Xpress, Release , Rev A

6 Chapter 2 Introduction This chapter describes the overview of Harmonic s ProMedia Xpress. It includes the following section: ProMedia Xpress Overview 2.1 ProMedia Xpress Overview ProMedia Xpress performs transcoding and packaging services, which are managed by the Harmonic s Workflow System (WFS). For trancoding purposes, ProMedia Xpress Transcoder enables faster-than-real-time transcoding of broadcast-quality video for multiscreen VOD applications. For packaging purposes, ProMedia Xpress Packager performs specific requirements for each adaptive streaming format, whether Apple HTTP Live Streaming, Microsoft Smooth Streaming, or Adobe HTTP Dynamic Streaming. You are required to configure the following presets to perform ProMedia Xpress features: Configuring Xpress Presets Configuring Package Presets 2013 Harmonic Inc. 6 ProMedia Xpress, Release , Rev A

7 Chapter 3 Configuring Xpress and Package Presets This chapter introduces the procedures on configuring the Xpress Presets and Package Presets. It includes the following sections: Configuring Xpress Presets Configuring Package Presets for HDS Outputs Configuring Package Presets for HLS Outputs Configuring Package Presets for SS Outputs 3.1 Configuring Xpress Presets The Xpress Preset Editor is used to create, import, export, and edit presets for Xpress Transcoder to perform transcoding. NOTE: Xpress Presets should be configured before creating a workflow template. To configure a Xpress preset, proceed with the following steps: 1. In the WFS Manager GUI, navigate to Tools > Xpress Preset Editor. Click to add Figure 3 1: Xpress Preset Editor 2. Click the button and a Xpress Preset Editor window appears. 3. Enter the name and description for the new Xpress preset. Click the Create button Harmonic Inc. 7 ProMedia Xpress, Release , Rev A

8 Chapter 3 Configuring Xpress and Package Presets Configuring Xpress Presets Input 4. Specify the parameters on the Settings section as follows. Specify Program Number Selection If enabled, you can specify the Program Number selected for transcoding of MPTS source. Audio Selection Mode Determine which audio streams at the input will be selected. All. Select all audio streams. AAC. Select the AAC audio streams. AC3. Select the AC3 audio streams. MPEG1-Layer II. Select the MPEG1-Layer II audio streams. Audio Selection by descriptor If enabled, you can specify string descriptors for audio filtering (e.g. Eng, Spa, Fre). Multiple Audio Descriptor entries are supported Baseband Processing AFD Mode Select the aspect ratio based on the incoming AFD. Fixed Image Conversion Select to enable cropping of the original image before encoding. Crop Input Select this check box to apply cropping to the input image. Top. The number of video lines to crop (in pixels), starting from the top. Bottom. The number of video lines to crop (in pixels), starting from the bottom. Left. The number of video lines to crop (in pixels), starting from the left. Right. The number of video lines to crop (in pixels), starting from the right. SDT Regeneration If enabled, WFS reads the SDT information from the input and generates a corresponding stream on the output Logo Insertion You can perform logo insertion onto the video output according to the user-defined reference position and horizontal/vertical offset. Mode The choices for Mode are: All If selected, a single logo is inserted into ALL output streams with reference to the spatial domain of the logo on the output stream which has the LARGEST resolution. WFS achieves the logo picture according to the specified URL. Per-Bitrate If selected, different logos need to insert into output streams individually as Per Bitrate basis. Logo pictures with proper resolutions are needed for each Bitrate 2013 Harmonic Inc. 8 ProMedia Xpress, Release , Rev A

9 Chapter 3 Configuring Xpress and Package Presets Configuring Xpress Presets Profile. WFS achieves logo pictures according to the URLs specified in each Bitrate Profile. Enable. Click to enable/disable Logo Insertion. File Path. The FTP/HTTP download path of the logo picture. The supported graphics file format is PNG. NOTE: If you desire to have a new logo picture in place of the old picture, you must change and adopt a new FTP/HTTP download path. Position. It defines the reference position of the logo: Top Left Top Right Bottom Left Bottom Right Center Horizontal Offset Horizontal offset, in pixels, from the edge of the frame to the edge of the logo image, relative to the reference position selected. Vertical Offset Vertical offset, in pixels, from the edge of the frame to the edge of the logo image, relative to the reference position selected Encoding Profile Video Codec The codec for encoding/transcoding. De-Interlace Input Deinterlace the video before encoding. It should be off if the input is progressive video. If Dynamic Deinterlace is selected, WFS bases on the input frame s properties to determine whether or not to deinterface before encoding. Output Video Format The video format value set in the H.264 stream VUI (Video Usability Information) section of the output stream. This determines the playback format of the video stream. Output Aspect Ratio The output aspect ratio can be changed by adding black bands. Choose from: Pass-through Sample: Square Display: 4:3 Display: 16:9 Progressive Only If selected, WFS will produce progressive video for all bitrate profiles. Otherwise, it is up to WFS to decide which bitrate profile can have interlaced output in order to achieve better video quality. Closed Caption Pass-Through If selected, the input ATSC video closed captioning data will pass through. Copyright Specify whether or not the stream contains copyrighted contents. Choose from: Uncopyrighted Copy 2013 Harmonic Inc. 9 ProMedia Xpress, Release , Rev A

10 Chapter 3 Configuring Xpress and Package Presets Configuring Xpress Presets Uncopyrighted Original Copyrighted Copy Copyrighted Original Enable ABR ABR (Average Bit Rate) encoding uses the average bit rate per IDR interval (CBR over an integration period of the IDR interval), rather than the typical CBR over an integration period of 40 ms. This setting leads to significant video quality improvement for a given bit rate, with no additional overhead on the HTTP network. With ABR encoding enabled, users measuring the transport stream output rate with traditional MPEG analyzers will see more NULL packets than expected, and a VBR video PID peaking a bit rates higher than the configured rate. HTTP clients which use the IDR integration period in their analysis will continue to see the configured bit rate. VBV Delay If Default is selected, WFS will output the standard video quality. If Reduced is selected, the processing time needed to decode is reduced relative to the Default option. IDR Period (s) The time interval (expressed in seconds) between IDR (Intra Decoder Refresh) frames that are inserted into the stream. The range must be between 1 and 10. AC-3 Decoding Mode Specify whether to add 11 db for AC-3 decoding. Choose from: RF If RF mode is selected, it is used for portable devices which will produce a louder audio volume (i.e. fix gain of 11 db) at the transcoded output. Line If Line mode is selected, it is targeted for IPTV (i.e. set-top box) environment for better audio dynamic range. There will be no fix gain of 11 db added to the audio Harmonic Inc. 10 ProMedia Xpress, Release , Rev A

11 Chapter 3 Configuring Xpress and Package Presets Configuring Xpress Presets Video Profile Select a video encoding profile. The options are: Codec Profile H.264 Baseline, Main, High Video Level This is the data depth for the given codec and profile. The level specifies the data constraints for settings such as frame rate, or maximum Width and Height. The options are: Codec Level H.264 1, 1.1, 1.2, 1.3, 2, 2.1, 2.2, 3, 3.1, 3.2, 4, 4.1, 4.2, 5, 5.1 Bitrate (kbps) The video encoding bitrate, expressed in kbps. Width The width of the output frame size. Height The height of the output frame size. Frame Rate Select the desired output frame rate. GOP Structure Select the desired GOP structure to set the number of B picture between I picture and P picture. If Auto is enabled, WFS determines the appropriate number of B picture set between I picture and P picture. Audio Codec Select the desired codec that is used to encode/transcode the input audio stream. Output Codecs Adobe HTTP Dynamic Streaming Microsoft Smooth Streaming Apple HTTP Live Streaming AAC-LC HE-AAC v1 HE-AAC v2 AAC-LC AAC-LC HE-AAC v1 HE-AAC v2 Mode ProMedia Xpress supports Downmix 5.1 and stereo as input and, output to Stereo or 2013 Harmonic Inc. 11 ProMedia Xpress, Release , Rev A

12 Chapter 3 Configuring Xpress and Package Presets Configuring Xpress Presets Mono. Codec Mode AAC-LC HE-AAC v1 HE-AAC v2 MPEG1-Layer II Mono (L) Mono (R) Mono (L+R) Stereo 5.1 Mono (L) Mono (R) Mono (L+R) Stereo 5.1 Stereo 5.1 Mono (L) Mono (R) Mono (L+R) Dual Mono Stereo 5.1 Resampling Rate (khz) This is the input resampling for encoding audio. Select from the following options: Resampling Choices 16 khz, khz, 24 khz, 32 khz, 44.1 khz, 48 khz Output Bitrate (kbps) This is the bitrate for encoding audio. This impacts the output audio elementary stream but not the subsequent encapsulation process. Gain (db) This is the audio gain value, in decibels. The range of input is -20dB to +20dB. The default value is 0 db. Output File Base Name Output File Base Name. The following special patterns are supported: %SourceName%: the file name of the source. %Index%: the index of the output files. %BitRate%: the video bitrate of the output files. Directory for Entire Asset Create a sub-directory in the WFS task output directory for all output files. Asset Directory Base Name Define the directory name for all output files. The following special pattern is supported: 2013 Harmonic Inc. 12 ProMedia Xpress, Release , Rev A

13 Chapter 3 Configuring Xpress and Package Presets Configuring Package Presets %SourceName%: the file name of the source. Specify PMT PID Select this check box to specify the PMT PID. PMT PID Enter the Program Map Table PID that applies to the only program in the generated output SPTS. Specify PCR PID Select this check box to specify the PCR (Program Clock Reference) PID. PCR PID Enter the PCR PID that is used to synchronize audio and video elementary stream. Program Number This is the program number for the output TS. PCR Frequency (Hz) This is the insertion rate for the PCR in the transport stream. PSI Frequency (Hz) This is the insertion rate of the PAT and the PMT in the transport stream. 3.2 Configuring Package Presets The Package Preset Editor is used to add or modify the presets for Xpress Packager to package the Transport Stream files into Adaptive Streaming file format: Adobe HTTP Dynamic Streaming (HDS) Apple HTTP Live Streaming (HLS) Microsoft Smooth Streaming H.264 (SS) NOTE: Package Presets should be configured before creating a workflow template Configuring Package Presets for HDS Outputs To configure a Package Preset for HDS outputs, proceed with the following steps: 2013 Harmonic Inc. 13 ProMedia Xpress, Release , Rev A

14 Chapter 3 Configuring Xpress and Package Presets Configuring Package Presets 1. In the WFS Manager GUI, navigate to Tools > Package Preset Editor. Figure 3 2: Package Presets for HDS outputs 2. Click the button on the Adobe HDS entry. 3. Enter a name and description for the new Package preset. Click the Create button. 4. Specify the parameters on the Settings panel Stream Naming Pattern Manifest Base Name [F4M] The manifest file for the HDS player to look up the fragment for a stream. The file name has extension of.f4m. The following special pattern is supported: %CommonSourceName% Segment Base Name [F4F/F4X] The Segment Base Name allows you to define the base filename for F4F files. The following special patterns are supported: %CommonSourceName% %SourceFileName% %PID% %BitRate% Audio Segment Base Name [F4F/F4X] The Audio Segment Base Name allows you to define the base filename for F4F files. The following special patterns are supported: 2013 Harmonic Inc. 14 ProMedia Xpress, Release , Rev A

15 Chapter 3 Configuring Xpress and Package Presets Configuring Package Presets %CommonSourceName% %SourceFileName% %PID% %BitRate% %Language% Text Stream Base Name The Text Stream Base Name allows you to define the base filename for TTML files. The following special patterns are supported: %CommonSourceName% %SourceFileName% %Language% %TrackName% Text Stream Extension The Text Stream Extension allows you to define the file extension for TTML files Directory Creation and Naming Pattern Directory for Entire Asset If enabled, you can create a sub-directory in the package task output directory for all output files Substitution Name Filters General Name Formation Method Two options are available. The Longest Common Prefix option allows you to use the common prefix as the source name. The Name Region Delimiters option allows you to use delimiters to identify the name string. Name End Character Exclusion If Longest Common Prefix is selected, this option allows you to specify the end character to be excluded from the common prefix. Start Delimiter Character If Name Region Delimiters is selected, specify the Start Delimiter Character as the beginning, which is exclusive to the name string. End Delimiter Character If Name Region Delimiters is selected, specify the End Delimiter Character as the end, which is exclusive to the name string. Fragment Duration [second] The duration of each fragment (expressed in seconds) within the F4F files. Segment Duration [second] The duration of the media segment files (expressed in seconds) for each F4F file. Each segment can contain one or more fragments. Use 0 to create a single F4F file for each layer Harmonic Inc. 15 ProMedia Xpress, Release , Rev A

16 Chapter 3 Configuring Xpress and Package Presets Configuring Package Presets Audio A/ Data Audio Language Descriptors The drop-down menu allows you to insert or replace the language descriptor (according to ISO639, part 2) for each of the input streams for the output package. Audio Types The drop-down menu allows you to insert or replace the audio type (according to , section ) for each of the input streams for the output package. Source Select source from which A/72 CEA-708 data is generated. CEA-708 data handling Specify the approach to generate A/72 CEA-708 data from the input H.264 stream TTML File Configuration 1. Use CEA-708 Stream in H.264 Enable the check box to use the CEA-708 stream in H.264. Conversion Mode: the mode for processing EIA608 to TTML conversion. Use (CC1). Click the check box to use CC1. Language (for CC1). Specify the language in ISO code. If empty, the 'und' language code will be used. Track Name (for CC1). Specify a unique caption track name. 2. Use Teletext Stream in input TS Enable the check box to use the Teletext Stream in input TS. Number of Services to Extract: specify the number of services to be extracted for ETSI_EN_472 services. Track Name. Specify a unique caption track name. Stream ID. Specify the stream ID of the teletext stream to be extracted. TaskParamsPage Number. Specify the page number of the teletext stream to be extracted. 3. Use DVB Subtitle Stream in input TS Enable the check box to use the DVB Subtitle Stream in input TS. Multiple Track Names entries are supported. Track Name. Specify a unique caption track name. 4. Use external TTML Files Enable the check box to use external TTML Files. Click the Plus button and specify the parameters for using external TTML files: Input Map ID. Specify the input Map ID. Track Name. Specify a unique caption track name. Language Code. Specify the language in ISO code. If empty, the 'und' language code will be used. Reference TimeCode. Specify the approach to synchronize the caption and video Harmonic Inc. 16 ProMedia Xpress, Release , Rev A

17 Chapter 3 Configuring Xpress and Package Presets Configuring Package Presets HDS Encryption Content ID Generate Mode This is the content identifier used to identify the service. The license server can use this identifier to decide which license should be granted to clients. The Content ID can be generated automatically or based on the Output File Name Configuring Package Presets for HLS Outputs To configure a Package Preset for HLS outputs, proceed with the following steps: 1. In the WFS Manager GUI, navigate to Tools > Package Preset Editor. Figure 3 3: Package Presets for HLS Outputs 2. Click the button on the Apple HLS entry. 3. Enter a name and description for the new Package preset. Click the Create button. 4. Specify the parameters on the Settings panel: Output Structure Variant Playlist Base Name Specify the filename of the variant playlist. The following special patterns are supported: %CommonSourceName% %Index% %PID% 2013 Harmonic Inc. 17 ProMedia Xpress, Release , Rev A

18 Chapter 3 Configuring Xpress and Package Presets Configuring Package Presets %Language% Index File Base Name Specify the file name of the index file for each variant stream. The following special patterns are supported: %CommonSourceName% %SourceFileName% %Index% %PID% %Bitrate% %Language% Segment File Base Name The file name prefix of the media segment files. The following special patterns are supported: %CommonSourceName% %SourceFileName% %Index% %PID% %Bitrate% %Language% Create Directory For Each Segment Create a sub-directory for each segment output files under the entire asset directory by using Index File Base Name or Segment Directory Base Name Directory Creation and Naming Pattern Directory for Entire Asset The drop-down menu allows you to create a sub-directory in the package task output directory for all output files. Asset Directory Base Name If Create using Asset Directory Base Name is selected, this field allows you to define the directory name for all the package output files. The following string pattern is supported: %CommonSourceName% Substitution Name Filters Name Formation Method Two options are available. The Longest Common Prefix option allows you to use the common prefix as the source name. The Name Region Delimiters option allows you to use delimiters to identify the name string. Name End Character Exclusion If Longest Common Prefix is selected, this option allows you to specify the end character to be excluded from the common prefix. Start Delimiter Character If Name Region Delimiters is selected, specify the Start Delimiter Character as the beginning, which is exclusive to the name string. End Delimiter Character If Name Region Delimiters is selected, specify the End Delimiter Character as the end, which is exclusive to the name string Harmonic Inc. 18 ProMedia Xpress, Release , Rev A

19 Chapter 3 Configuring Xpress and Package Presets Configuring Package Presets General Segment Length The max. length for TS Segments (expressed in seconds). Order of URL In Variant Playlist Select from the drop-down menu to specify how the playlist URLs are arranged in the variant playlist. Enable CODECS Attribute In Variant Playlist Select this check box to specify the CODECS attribute in EXT-X-STREAM-INF in the variant playlist. Enable Data Streams Pass-through Select this check box to allow pre-encrypted private streams (e.g. DVB Subtitle, Teletext, SCTE-35, AC3) pass-through to HLS package output. Multiple Packages Per Audio If selected, WFS allows multiple packages for each audio found in the source file (HLS v2). Create an Audio Only Variant Stream If this check box is enabled, audio-only streams will be created and added to the playlist to provide a low-bandwidth alternate stream which are used to conform with the Apple requirements. These requirements apply to ios apps submitted for distribution in the App Store for use on Apple products. Uncheck the check box only if the downstream vendor doesn t support audio-only streams. Use separate streams for video and audio If this check box is enabled, audio and video streams are delivered separately. (This option is available only when HLS Version 4 and HLS Version 5 are selected.) Use Byte Range Media Segments If this check box is enabled, the Byte Range tags (i.e. #EXT-X-BYTERANGE) are used in the playlist to consolidate media segments into larger files, which can reduce the number of files to be managed. (This option is available only when HLS Version 5 is selected.) First Entry Variant Stream HLS Version First Variant Stream The drop-down menu allows users to select using bitrate in the variant stream to be the first entry stream. First Stream Bit Rate in bps Bitrate of the first entry stream. HLS Version Number Specify the HLS protocol version to be used for packaging the output stream. The HLS Version Number option includes HLS Version 3, HLS Version 4, and HLS Version Harmonic Inc. 19 ProMedia Xpress, Release , Rev A

20 Chapter 3 Configuring Xpress and Package Presets Configuring Package Presets Audio A/ Data Audio Language Descriptors The drop-down menu allows users to insert or replace the language descriptor (according to ISO639, part 2) for each of the input streams for the output package. Audio Types The drop-down menu allows users to insert or replace the audio type (according to , section ) for each of the input streams for the output package. Source Select source from which A/72 CEA-708 data is generated. CEA-708 data handling Specify the approach to generate A/72 CEA-708 data from the input H.264 stream TTML File Configuration 1. Use CEA-708 Stream in H.264 Enable the check box to use the CEA-708 stream in H.264. Conversion Mode: the mode for processing EIA608 to TTML conversion. Use (CC1). Click the check box to use CC1. Language (for CC1). Specify the language in ISO code. If empty, the 'und' language code will be used. Track Name (for CC1). Specify a unique caption track name. 2. Use Teletext Stream in input TS Enable the check box to use the Teletext Stream in input TS. Number of Services to Extract: specify the number of services to be extracted for ETSI_EN_472 services. Track Name. Specify a unique caption track name. Stream ID. Specify the stream ID of the teletext stream to be extracted. Page Number. Specify the page number of the teletext stream to be extracted. 3. Use DVB Subtitle Stream in input TS Enable the check box to use the DVB Subtitle Stream in input TS. Multiple Track Names entries are supported. Track Name. Specify a unique caption track name. 4. Use external TTML Files Enable the check box to use external TTML Files. Click the Plus button and specify the parameters for using external TTML files: Input Map ID. Specify the input Map ID. Track Name. Specify a unique caption track name. Language Code. Specify the language in ISO code. If empty, the 'und' language code will be used. Reference TimeCode. Specify the approach to synchronize the caption and video Harmonic Inc. 20 ProMedia Xpress, Release , Rev A

21 Chapter 3 Configuring Xpress and Package Presets Configuring Package Presets Encryption Encryption Type Select either Harmonic Key Management Server/Internal Key Generation/Adobe Flash Access from the drop-down menu. If Internal Key Generation is enabled, the Packager generates keys internally for encryption. If Adobe Flash Access is enabled, the generated HLS output is encrypted and protected using Adobe Flash Access. Resource ID Generate Mode This is the identifier used to identify the resource. Select the mode to generate the resource ID for KMS operation. The Resource ID can be generated automatically or based on the Output File Name. Encryption Method for HLS Select the following encryption methods for HLS publishing: Native If Native is selected, WFS encrypts the content using native way defined by Apple as the original encryption method. Native (Sample Based Encryption) If Native is selected, WFS encrypts the content using Sample Based Encryption method which is compliance with HTTP Live Streaming spec defined by Apple. AuthenTec PlayReady If AuthenTec PlayReady is selected, WFS encrypts the content according to AuthenTec's proposal for HLS encryption. Discretix PlayReady If Discretix PlayReady is selected, WFS encrypts the content according to Discretix's proposal for HLS encryption. Irdeto PlayReady If Irdeto PlayReady is selected, WFS encrypts the content according to Irdeto's proposal for HLS encryption. Enable Key Rotation Select this check box to enable key rotation for retrieving a new encryption key. Key Rotation Period (sec) This is the period of time the system will wait until it retrieves a new encryption key. A value of 0 means that only one key is used. Content ID Generate Mode This is the content identifier used to identify the service. The license server can use this identifier to decide which license should be granted to clients. The Content ID can be generated automatically or based on the Output File Name Configuring Package Presets for SS Outputs To configure a Package Preset for Smooth Streaming outputs, proceed with the following steps: 2013 Harmonic Inc. 21 ProMedia Xpress, Release , Rev A

22 Chapter 3 Configuring Xpress and Package Presets Configuring Package Presets 1. In the WFS Manager GUI, navigate to Tools > Package Preset Editor. Figure 3 4: Package Presets for Smooth Streaming Outputs 2. Click the button for on the Microsoft Smooth entry. 3. Enter a name and description for the new Package preset. Click the Create button. 4. Specify the parameters on the Settings panel: Stream Naming Pattern Manifest Base Name The base name for ISM and ISMC files. The following special pattern is supported: %CommonSourceName% Video Stream Base Name The Video Stream Base Name allows users to define the base filename for ISMV files. The following special patterns are supported: %CommonSourceName% %SourceFileName% %PID% %BitRate% Audio Stream Base Name The Audio Stream Base Name allows users to define the base filename for ISMA files. The following special patterns are supported: %CommonSourceName% %SourceFileName% 2013 Harmonic Inc. 22 ProMedia Xpress, Release , Rev A

23 Chapter 3 Configuring Xpress and Package Presets Configuring Package Presets %PID% %BitRate% %Language% Text Stream Base Name The Text Stream Base Name allows users to define the base filename for ISMA files. The following special patterns are supported: %CommonSourceName% %SourceFileName% %PID% %Language% Directory Creation and Naming Pattern Directory for Entire Asset The drop-down menu allows users to create a sub-directory in the package task output directory for all output files. Asset Directory Base Name If Create using Asset Directory Base Name is selected, this field allows users to define the directory name for all the package output files. The following string pattern is supprted: %CommonSourceName% Substitution Name Filters General DPI Messaging Name Formation Method Two options are available. The Longest Common Prefix option allows you to use the common prefix as the source name. The Name Region Delimiters option allows you to use delimiters to identify the name string. Name End Character Exclusion If Longest Common Prefix is selected, this option allows you to specify the end character to be excluded from the common prefix. Start Delimiter Character If Name Region Delimiters is selected, specify the Start Delimiter Character as the beginning, which is exclusive to the name string. End Delimiter Character If Name Region Delimiters is selected, specify the End Delimiter Character as the end, which is exclusive to the name string. Video Chunk Length [second] The duration of the video chunk files (expressed in seconds). Audio Chunk Length [second] The duration of the audio chunk files (expressed in seconds). SCTE-35 Handling Mode If Comcast is selected, WFS supports SCTE-35 conversion to Comcast s Acquired Signal XML format in Smooth Streaming output. Acquisition Point Identity 2013 Harmonic Inc. 23 ProMedia Xpress, Release , Rev A

24 Chapter 3 Configuring Xpress and Package Presets Configuring Package Presets Audio A unique ID or name to identify the machine that found the SCTE-35 signal A/ Data Audio Language Descriptors The drop-down menu allows users to insert or replace the language descriptor (according to ISO639, part 2) for each of the input streams for the output package. Audio Types The drop-down menu allows users to insert or replace the audio type (according to , section ) for each of the input streams for the output package. Source Select source from which A/72 CEA-708 data is generated. CEA-708 data handling Specify the approach to generate A/72 CEA-708 data from the input H.264 stream TTML File Configuration 1. Use CEA-708 Stream in H.264 Enable the check box to use the CEA-708 stream in H.264. Conversion Mode: the mode for processing EIA608 to TTML conversion. Remove empty caption streams: If enabled, the empty caption streams will be removed in the manifest. Use (CC1). Click the check box to use CC1. Language (for CC1). Specify the language in ISO code. If empty, the 'und' language code will be used. Track Name (for CC1). Specify a unique caption track name. 2. Use Teletext Stream in input TS Enable the check box to use the Teletext Stream in input TS. Number of Services to Extract: specify the number of services to be extracted for ETSI_EN_472 services. Track Name. Specify a unique caption track name. Stream ID. Specify the stream ID of the teletext stream to be extracted. Page Number. Specify the page number of the teletext stream to be extracted. 3. Use DVB Subtitle Stream in input TS Enable the check box to use the DVB Subtitle Stream in input TS. Multiple Track Names entries are supported. Track Name. Specify a unique caption track name. 4. Use external TTML Files Enable the check box to use external TTML Files. Click the Plus button and specify the parameters for using external TTML files: Input Map ID. Specify the input Map ID. Track Name. Specify a unique caption track name. Language Code. Specify the language in ISO code. If empty, the 'und' language code will be used. Reference TimeCode. Specify the approach to synchronize the caption and video Harmonic Inc. 24 ProMedia Xpress, Release , Rev A

25 Chapter 3 Configuring Xpress and Package Presets Configuring Package Presets Encryption Resource ID Generate Mode This is the identifier used to identify the resource. Select the mode to generate the resource ID for KMS operation. The Resource ID can be generated automatically or based on the Output File Name Harmonic Inc. 25 ProMedia Xpress, Release , Rev A

26 Chapter 4 Creating Workflow Templates for Xpress & Package Presets This chapter introduces the procedures on how to create workflow templates for Xpress and Package Presets. It includes the following sections: Adding a New Workflow Template Workflow Task Components Configuring Pre-Transform Tasks Configuring Transform Tasks Configuring Job End Tasks CAUTION: Workflow templates must be created and pre-configured for Watch Folders and File Queuer in order to process the input and output media files. 4.1 Adding a New Workflow Template To add a new Workflow Template, proceed with the following steps: 1. In the WFS Manager GUI, navigate to Tools > Workflow Editor. Figure 4 1: Workflow Editor 2. Click the button and a New Workflow window appears. 3. Enter the name and description for the new Workflow Template. Click the Create button Harmonic Inc. 26 ProMedia Xpress, Release , Rev A

27 Chapter 4 Creating Workflow Templates for Xpress & Package Presets Workflow Task Components 4. Specify the parameters on the Tasks panel that includes three main stages: Pre-Transform Tasks Transform Tasks Job End Tasks 4.2 Workflow Task Components Users can assign tasks to be performed in the Workflow Template. The following task components throughout Pre-Transform Tasks, Transform Tasks, and Job End Tasks stage can be assigned by users: Notification An Notification task can be used to send an on job start, completion, or error, as well as on various successful or failure stages of a task. You can use string replacement tokens in your subject and body. (Please refer to the tool tips on the WFS Manager GUI for details.) Parameter Description Notification Settings To From Subject SMTP Server Body address of the recipient. address of the sender. Subject line of the . String replacement tokens can be used in the subject of the . Select the SMTP Server parameters which can be configured through navigating to Tools > Server Registry. Body text of the . String replacement tokens can be used in the body of the . Node Assignment Enable Machine Groups Select this check box to enable the Monitor Node Assignment. Select the Machine Groups to which you want to assign the tasks if Monitor Node Assignment is enabled Harmonic Inc. 27 ProMedia Xpress, Release , Rev A

28 Chapter 4 Creating Workflow Templates for Xpress & Package Presets Workflow Task Components Command Line Process A Command Line Process task can be used to trigger external applications on job start, completion, or error as well as on various successful or failure stages of a task. You can use string replacement tokens in your command line execution. (Please refer to the tool tips on the WFS Manager GUI for details.) Parameter Description Process Notification Settings Command Line File Parameters Wait for Completion The location of the batch file or external application to be executed. This path should be accessible by all Nodes. Parameters, if any, that need to be passed to the batch file or external application. Check this option if you want to wait for the application to complete before moving on to the next task in the workflow. Node Assignment Enable Machine Groups Select this check box to enable Node Assignment. Select the Machine Groups to which you want to assign tasks if Node Assignment is enabled Web Notification A Web Notification task can be used to trigger external web services on job start, completion, or error as well as on various successful or failure stages of a task. Select from the list of supported arguments using the check boxes above and also choose the style of web notification (either GET or POST). Parameter Description Web URL Web Service URL The URL of the web service to be called. HTTP Request Type Select the type of HTTP request to be sent to the web service, either GET or POST. URL/Message Arguments Job Guid Job Name Error Message Source Path and Name Unique GUID for the complete job. Unique name for the complete job. Error message (only valid in error notifications). Full source path and name. Node Assignment 2013 Harmonic Inc. 28 ProMedia Xpress, Release , Rev A

29 Chapter 4 Creating Workflow Templates for Xpress & Package Presets Workflow Task Components Parameter Enable Machine Groups Description Select this check box to enable the Node Assignment. Select the Machine Groups to which you want to assign tasks if Node Assignment is enabled Output File Transfer Select the Output File Transfer task to transfer the output target files to another location over the network through CIFS or FTP. CIFS Parameter Description Remote Connection Remote Path (UNC) User (optional) Password (optional) The remote location where the target files will be transferred to UNC path must be used. Username for the remote folder access. Password for the above username. Options Delete Output File after Transfer Select this option to delete the local source files after successful transfer. Node Assignments Enable Machine Groups Select this check box to enable the Node Assignment. Select the Machine Groups to which you want to assign tasks if Node Assignment is enabled. FTP Parameter Description Server Connection FTP Server Address Username Password FTP Port Specified Transfer Rate (Mbps) IP Address of the FTP Server. Username to connect to the FTP Server. Password for the above username. Select this check box to specify any port other than the default for the FTP server. The default port is 21. Specify the port number in the text box. Select this check box if you would like to designate a Transfer Rate for FTP upload. Specify the Transfer Rate in the text box Harmonic Inc. 29 ProMedia Xpress, Release , Rev A

30 Chapter 4 Creating Workflow Templates for Xpress & Package Presets Workflow Task Components Parameter FTP Mode Description Choose from the following connection modes to connect to your FTP server. Automatic: WFS will attempt both Active and Passive connections to the FTP server. If Active connection fails, Passive connection is tried. An Active connection will be made to the FTP server. WFS will first attempt to make an Active connection to the server. If it fails, a Passive connection is tried. A Passive connection will be made to the FTP server. WFS will first attempt to make a Passive connection to the server. If it fails, an Active connection is tried. Max Transfer Threads Server Status Current Folder Selected Folder Set the maximum number of FTP connection threads to be used while retrieving the files. Display whether WFS is currently connected to the FTP server or not. The folder on the FTP server that is currently being browsed. Click Select to browse into this folder and click Up to browse out of the folder. The folder on the FTP server where the target files will be transferred. Options Delete Output File after Transfer Select this option to delete the local source files after successful transfer. Node Assignment Enable Machine Groups Select this check box to enable the Monitor Node Assignment. Select the Machine Groups to which you want to assign the tasks if Monitor Node Assignment is enabled Source File Transfer Select Source File Transfer Task to transfer the source media files to another location over the network through CIFS or FTP. CIFS Parameter Description Remote Connection Remote Path (UNC) User (optional) The remote location where the target files will be transferred to UNC path must be used. Username for the remote folder access Harmonic Inc. 30 ProMedia Xpress, Release , Rev A

31 Chapter 4 Creating Workflow Templates for Xpress & Package Presets Workflow Task Components Parameter Password (optional) Description Password for the above username. Options Delete Source File after Transfer Select this option to delete the source files after successful transfer. Node Assignments Enable Machine Groups Select this check box to enable the Node Assignment. Select the Machine Groups to which you want to assign tasks if Node Assignment is enabled. FTP Parameter Description Server Connection FTP Server Address Username Password FTP Port Specified Transfer Rate (Mbps) FTP Mode IP Address of the FTP Server. Username to connect to the FTP Server. Password for the above username. Select this check box to specify any port other than the default for the FTP server. The default port is 21. Specify the port number in the text box. Select this check box if you would like to designate a Transfer Rate for FTP upload. Specify the Transfer Rate in the text box. Choose from the following connection modes to connect to your FTP server. Automatic: WFS will attempt both Active and Passive connections to the FTP server. If Active connection fails, Passive connection is tried. An Active connection will be made to the FTP server. WFS will first attempt to make an Active connection to the server. If it fails, a Passive connection is tried. A Passive connection will be made to the FTP server. WFS will first attempt to make a Passive connection to the server. If it fails, an Active connection is tried. Max Transfer Threads Server Status Current Folder Set the maximum number of FTP connection threads to be used while retrieving the files. Display whether WFS is currently connected to the FTP server or not. The folder on the FTP server that is currently being browsed. Click Select to browse into this folder and click Up to browse out of the folder Harmonic Inc. 31 ProMedia Xpress, Release , Rev A

32 Chapter 4 Creating Workflow Templates for Xpress & Package Presets Workflow Task Components Parameter Selected Folder Description The folder on the FTP server where the target files will be transferred. Options Delete Source File after Transfer Select this option to delete the source files after successful transfer. Node Assignment Enable Machine Groups Select this check box to enable the Monitor Node Assignment. Select the Machine Groups to which you want to assign the tasks if Monitor Node Assignment is enabled Report A Report task can be used to generate the detailed XML report of job and its tasks information. Parameter Description Output Report XML Report Name Output Path If File Exists Name of the report XML file. The default value is %jobname%.xml. You can specify the report file name. The output location for the report XML file. Click Browse to select a path. If a file with the same name already exists at the Output Path, the following options are available: Overwrite Existing Create New File Generate TemplateEx XML using Targets Check this option to generate the TemplateEx XML file using all the output files of the targets added in this workflow. TemplateEx XML is a way to provide multiple files as source assets and override task parameters specified in the workflow. For packaging, create a workflow with multiple bitrate transport streams, check this option and directly set the output path to the TemplateEX XML watch folder linked with workflow with Package Targets. Checking this option will generate TemplateEx XML only and not the Report XML. If you want to generate Report XML as well, please add another Report task. TemplateEx XML Mapping 2013 Harmonic Inc. 32 ProMedia Xpress, Release , Rev A

33 Chapter 4 Creating Workflow Templates for Xpress & Package Presets Configuring Pre-Transform Tasks Parameter TaskParams Mapping ID Description Mapping ID is an optional field that ties report parameters from the TemplateEx XML file to a specific report task in the workflow. It is a string value that can be set by the user in the workflow and TemplateEx XML file for mapping purpose. If no Mapping ID is present, all report parameters from TemplateEx XML file are passed to all report tasks in the workflow. Node Assignment Enable Machine Groups Select this check box to enable the Monitor Node Assignment. Select the Machine Groups to which you want to assign the tasks if Monitor Node Assignment is enabled Package The Package task can be used to package the "Transport Stream Input Files" on the successful stage of a task. 4.3 Configuring Pre-Transform Tasks The Pre-Transform Tasks stage can be comprised of notification, command line process, and Web Notification. If any task fails in this stage, all tasks after the failed task are skipped and the job goes directly to the Job End Tasks. To configure a Pre-Transform Task, proceed with the following steps: 1. In the WFS Manager GUI, navigate to Tools > Workflow Editor. 2. Right-click on the Pre-Transform Tasks as follows. Figure 4 2: Pre-Transform Tasks 3. The tasks available to be performed are: Notification (Refer to Notification for details) Command Line Process (Refer to Command Line Process for details) Web Notification. (Refer to Web Notification for details) 2013 Harmonic Inc. 33 ProMedia Xpress, Release , Rev A

34 Chapter 4 Creating Workflow Templates for Xpress & Package Presets Configuring Transform Tasks 4. Click Apply after configuration, if desired. 4.4 Configuring Transform Tasks The Transform Tasks stage supports transcoding and packaging of source media assets. The tasks in this stage can be performed simultaneously by different Nodes, and can take their own individual path within this stage Adding Xpress Targets Xpress Targets can be configured to perform transcoding tasks later on. To add a new Xpress Target, proceed with the following steps: 1. Navigate to Tools > Workflow Editor. 2. Right-click on the Xpress Targets as follows. 3. Click Add Target. Figure 4 3: Transform Tasks: Xpress Targets 2013 Harmonic Inc. 34 ProMedia Xpress, Release , Rev A

35 Chapter 4 Creating Workflow Templates for Xpress & Package Presets Configuring Transform Tasks 4. Specify the parameters as follows: Figure 4 4: Xpress Preset parameters Preset This specifies the Xpress Preset used for transcoding. Click Browse to select the preset. Output Path This specifies the output path location path for delivering the transcoded outputs. Click Browse to select the location. TaskParams Mapping ID Mapping ID is an optional field that ties Xpress parameters from the TemplateEx XML file to a specific Xpress task in the workflow. It is a string value that can be set by the user in the workflow and TemplateEx XML file for mapping purpose. If no Mapping ID is present, all Xpress parameters from TemplateEx XML file are passed to all Xpress tasks in the workflow. Mapping ID is useful in scenarios where there are more than one Xpress tasks in the workflow and custom Xpress parameters like output path, preset parameters need to be passed to each task through TemplateEx XML file. Enable Select this check box to enable the Node Assignment. Machine Group Select the Machine Groups to which you want to assign the tasks, if Node Assignment is enabled. 5. Click Apply after configuration, if desired Harmonic Inc. 35 ProMedia Xpress, Release , Rev A

36 Chapter 4 Creating Workflow Templates for Xpress & Package Presets Configuring Transform Tasks On Success for Xpress Targets The On Success stage includes: Package (Refer to Package for details) Notification (Please refer to Notification for details) Command Line Process (Refer to Command Line Process for details) Web Notification (Refer to Web Notification for details) Output File Transfer (Refer to Output File Transfer for details) On Failure for Xpress Targets The On Failure stage includes: Notification (Refer to Notification for details) Command Line Process (Refer to Command Line Process for details) Web Notification (Refer to Web Notification for details) Adding Package Targets Package Targets can be configured to package the provided Transport Stream Input Files" into one of the HLS, Smooth Streaming, or HDS format. To add a new Package Target, proceed with the following steps: 1. In the WFS Manager GUI, navigate to Tools > Workflow Editor. 2. Right-click on the Package Targets as follows. 3. Click Add Target. Figure 4 5: Transform Tasks: Package Targets 2013 Harmonic Inc. 36 ProMedia Xpress, Release , Rev A

37 Chapter 4 Creating Workflow Templates for Xpress & Package Presets Configuring Transform Tasks 4. Specify the parameters as follows. Figure 4 6: Package Preset parameters Preset This specifies the Package Preset used for packaging Transport Stream Input Files" into one of HLS, Smooth Streaming, or HDS format. Click Browse to select the preset. Output Path This specifies the output path location path for delivering the packaged outputs. Click Browse to select the location. Enable Encryption If Enable Encryption is selected, the Encryption Settings area appears for encryption configuration. Select Server Definition This is the KMS and AdobeAccess server selection drop down list which lists the appropriate KMS and AdobeAccess from the configured registry depending on the Source Type. Output Resource/Content ID XML This is an optional setting to enable the output of Resource/Content ID XML. This file contains metadata about the encryption task including the Resource/Content ID used and the main pre and post encryption file references. Use Same Output Path as Encryption Target Specifies whether to use the same output path for Resource/Content ID XML file as the encryption target path. Output Path This specifies the output path location for the Resource/Content ID XML file if different 2013 Harmonic Inc. 37 ProMedia Xpress, Release , Rev A

38 Chapter 4 Creating Workflow Templates for Xpress & Package Presets Configuring Job End Tasks from encryption target path. TaskParams Mapping ID Mapping ID is an optional field that ties Package parameters from the TemplateEx XML file to a specific Package task in the workflow. It is a string value that can be set by the user in the workflow and TemplateEx XML file for mapping purpose. If no Mapping ID is present, all Package parameters from TemplateEx XML file are passed to all Package tasks in the workflow. Mapping ID is useful in scenarios where there are more than one Package tasks in the workflow and custom Package parameters like output path, preset parameters need to be passed to each task through TemplateEx XML file. Enable Select this check box to enable the Node Assignment. Machine Group Select the Machine Groups to which you want to assign the tasks, if Node Assignment is enabled. 5. Click Apply after configuration, if desired On Success for Package Targets The On Success stage includes: Notification (Refer to Notification for details) Command Line Process (Refer to Command Line Process for details) Web Notification (Refer to Web Notification for details) Output File Transfer (Refer to Output File Transfer for details) On Failure for Package Targets The On Failure stage includes: Notification (Refer to Notification for details) Command Line Process (Refer to Command Line Process for details) Web Notification (Refer to Web Notification for details) 4.5 Configuring Job End Tasks On Success Select the On Success stage to add tasks that need to be performed if all the tasks in previous stages complete successfully. To configure a Job End Task, proceed with the following steps: 1. In the WFS Manager GUI, navigate to Tools > Workflow Editor. 2. Navigate to Job End Tasks as follows Harmonic Inc. 38 ProMedia Xpress, Release , Rev A

39 Chapter 4 Creating Workflow Templates for Xpress & Package Presets Configuring Job End Tasks Figure 4 7: Pre-Transform Tasks 3. Right-click on the On Success entry. 4. The tasks available to be performed are: Notification (Refer to Notification for details) Command Line Process (Refer to Command Line Process for details) Web Notification (Refer to Web Notification for details) Source File Transfer (Refer to Source File Transfer for details) Report (Please refer to Report for details) 5. Click Apply after configuration, if desired On Failure Select the On Failure stage to add tasks that need to be performed if at least there is one failed task from the previous stages. To configure a Job End Task, proceed with the following steps: 1. In the WFS Manager GUI, navigate to Tools > Workflow Editor. 2. Navigate to Job End Tasks as follows. 3. Right-click on the On Failure entry. 4. The tasks available to be performed are: Notification (Refer to Notification for details) Command Line Process (Refer to Command Line Process for details) Web Notification (Refer to Web Notification for details) Source File Transfer (Refer to Source File Transfer for details) Report (Refer to Report for details) 5. Click Apply after configuration, if desired Harmonic Inc. 39 ProMedia Xpress, Release , Rev A

40 Harmonic Inc North First St. San Jose, CA 95134, U.S.A. T F Copyright 2013 Harmonic Inc. All rights reserved.