AWS Elemental MediaLive .com

[Pages:584]AWS Elemental MediaLive

User Guide

AWS Elemental MediaLive User Guide

AWS Elemental MediaLive: User Guide

Copyright ? Amazon Web Services, Inc. and/or its affiliates. All rights reserved. Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's, in any manner that is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks not owned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored by Amazon.

AWS Elemental MediaLive User Guide

Table of Contents

What Is AWS Elemental MediaLive? ...................................................................................................... 1 How MediaLive Works ................................................................................................................. 1 Pipelines ........................................................................................................................... 2 MediaLive Inputs ................................................................................................................ 2 MediaLive Channels ............................................................................................................ 2 MediaLive Schedule ............................................................................................................ 3 Terminology .............................................................................................................................. 4 Related Services ......................................................................................................................... 5 Accessing AWS Elemental MediaLive ............................................................................................. 6

Pricing .............................................................................................................................................. 7 Quotas .............................................................................................................................................. 8 Feature rules and limits ...................................................................................................................... 9

Limits for inputs ........................................................................................................................ 9 Limits for outputs .................................................................................................................... 10 Limits for other features ........................................................................................................... 11

Limits for other features ................................................................................................... 13 Setting up: IAM permissions .............................................................................................................. 14

Signing up ............................................................................................................................... 14 Creating an administrator IAM user ............................................................................................ 14 Creating a non-administrator IAM user ........................................................................................ 16

Step 1: Create customer managed policies .......................................................................... 17 Step 2: Create an IAM group ............................................................................................. 18 Step 3: Create or add an IAM user to your group .................................................................. 19 Setting up as a trusted service ................................................................................................... 20 Setting up: IAM permissions for production ......................................................................................... 21 Setting up administrators and users ........................................................................................... 22 Creating an administrator user with limited access ....................................................................... 22 Creating a non-administrator user .............................................................................................. 25 Step 1: Requirements for permissions ................................................................................. 26 Step 2: Identify categories of users .................................................................................... 40 Step 3: Create the Custom Policies ..................................................................................... 40 Step 4: Create the groups ................................................................................................. 41 Step 5: Create users ......................................................................................................... 42 Step 6: Setting up required data ........................................................................................ 44 Setting up AWS Elemental MediaLive as a trusted service .............................................................. 44 How the trusted entity is created and attached .................................................................... 44 Creating trusted entity roles .............................................................................................. 45 Setting up permissions for non-administrator users .............................................................. 48 Reference: summary of user access ............................................................................................. 50 Reference: summary of trusted entity access ................................................................................ 56 Setting up: IAM permissions for distributors ........................................................................................ 60 Creating an administrator IAM user ............................................................................................ 60 Creating a non-administrator user .............................................................................................. 61 Getting started with AWS Elemental MediaLive .................................................................................... 63 Getting started tutorial ............................................................................................................. 63 Prerequisites .................................................................................................................... 64 Step 1: Set up the upstream system ................................................................................... 64 Step 2: Set up the downstream system ............................................................................... 64 Step 3: Create an input ..................................................................................................... 65 Step 4: Set up key information .......................................................................................... 66 Step 5: Attach the input ................................................................................................... 66 Step 6: Set up input video, audio, captions .......................................................................... 66 Step 7: Create an HLS output group ................................................................................... 67 Step 8: Set up the output and encodes ............................................................................... 67

iii

AWS Elemental MediaLive User Guide

Step 9: Create your channel .............................................................................................. 68 Step 10: Start the upstream system and the channel ............................................................ 68 Step 11: Clean up ............................................................................................................ 68 Components of AWS Elemental MediaLive ........................................................................................... 70 Inputs ..................................................................................................................................... 70 Channels ................................................................................................................................. 70 Encodes .......................................................................................................................... 70 Outputs ........................................................................................................................... 71 Output groups ................................................................................................................. 71 Input security groups ................................................................................................................ 71 How components are associated ................................................................................................ 71 Setup: Preparing upstream and downstream ........................................................................................ 72 Step 1: Identify output group types ............................................................................................ 73 Choosing among the AWS media services ............................................................................ 74 HLS versus MediaPackage .................................................................................................. 74 Options for Microsoft Smooth ........................................................................................... 75 Step 2: Identify encode requirements ......................................................................................... 75 Step 3: Identify resiliency requirements ....................................................................................... 76 Pipeline redundancy ......................................................................................................... 76 Automatic input failover ................................................................................................... 77 Comparison of the two features ......................................................................................... 77 Step 4: Assess the upstream system ........................................................................................... 78 Assess source formats and packaging ................................................................................. 78 Encrypted HLS content ..................................................................................................... 79 Assess video content ........................................................................................................ 80 Assess audio content ........................................................................................................ 81 Assess captions ................................................................................................................ 82 Result of this step ............................................................................................................ 83 Step 5: Collect information about the source content ................................................................... 83 CDI source ....................................................................................................................... 84 AWS Elemental Link source ............................................................................................... 84 HLS source ...................................................................................................................... 85 MediaConnect source ........................................................................................................ 85 MP4 source ...................................................................................................................... 86 RTMP source .................................................................................................................... 86 RTP source ...................................................................................................................... 86 Step 6: Coordinate with upstream system and create inputs .......................................................... 87 CDI source ....................................................................................................................... 88 AWS Elemental Link source ............................................................................................... 90 HLS pull source ................................................................................................................ 91 MediaConnect push source ................................................................................................ 94 MP4 pull source ............................................................................................................... 96 RTMP pull source ............................................................................................................. 98 RTMP push Input ............................................................................................................. 99 RTMP VPC source ........................................................................................................... 102 RTP push source ............................................................................................................. 104 RTP VPC source .............................................................................................................. 107 Step 7: Coordinate with downstream systems ............................................................................ 111 Archive or frame capture ................................................................................................. 112 HLS to Amazon S3 ......................................................................................................... 113 HLS to MediaStore ......................................................................................................... 114 HLS to MediaPackage ..................................................................................................... 115 HLS to HTTP .................................................................................................................. 116 MediaPackage ................................................................................................................ 117 Microsoft Smooth ........................................................................................................... 118 RTMP ............................................................................................................................ 119 UDP .............................................................................................................................. 119

iv

AWS Elemental MediaLive User Guide

Next steps ............................................................................................................................. 120 Setup: Planning the channel ............................................................................................................ 121

Step 1: Identify the output encodes .......................................................................................... 121 Identify video ................................................................................................................. 121 Identify audio ................................................................................................................ 122 Identify captions ............................................................................................................ 123 Summary of encode rules for output groups ...................................................................... 124 Example of a plan .......................................................................................................... 124

Step 2: Map outputs to sources ................................................................................................ 125 Example of mapping ....................................................................................................... 129

Step 3: Design the output groups ............................................................................................. 131 Archive output group ...................................................................................................... 131 Frame Capture output group ........................................................................................... 132 HLS or MediaPackage output group .................................................................................. 132 Microsoft Smooth output group ....................................................................................... 133 RTMP output group ........................................................................................................ 134 UDP output group .......................................................................................................... 134 Examples ....................................................................................................................... 135

Step 4: Design the encodes ..................................................................................................... 136 Plan the encodes ............................................................................................................ 136 Identify encode sharing opportunities ............................................................................... 139

Next steps ............................................................................................................................. 142 Resources: MediaLive channels ......................................................................................................... 144

Creating a channel from scratch ............................................................................................... 144 Getting ready ................................................................................................................. 145 Step 1: Complete channel details ..................................................................................... 146 Step 2: Attach inputs ...................................................................................................... 148 Step 3: Complete input settings ....................................................................................... 152 Step 4: Complete general settings .................................................................................... 157 Step 5: Create output groups ........................................................................................... 158 Step 6: Set up video ....................................................................................................... 204 Step 7: Set up audio ....................................................................................................... 206 Step 8: Set up captions ................................................................................................... 208 Step 9: Save channel ...................................................................................................... 210

Creating a channel from a template or by cloning ...................................................................... 211 About templates ............................................................................................................. 211 About cloning ................................................................................................................ 212 Creating a channel from a template .................................................................................. 212 Creating a channel by cloning .......................................................................................... 212 Creating a custom template ............................................................................................. 213

Editing and deleting a channel ................................................................................................. 213 Editing a channel ........................................................................................................... 213 Editing the tags associated with a channel ......................................................................... 214 Deleting a channel .......................................................................................................... 214

Updating channel class ........................................................................................................... 214 Viewing a channel configuration ............................................................................................... 214 Resources: MediaLive devices ........................................................................................................... 216 Creating a device .................................................................................................................... 216 Editing or viewing a device ...................................................................................................... 216 Transferring a device ............................................................................................................... 217

Initiating a device transfer ............................................................................................... 218 Cancelling an outgoing device transfer .............................................................................. 218 Accepting a device transfer .............................................................................................. 218 Viewing device status .............................................................................................................. 219 Deleting a device .................................................................................................................... 219 Resources: MediaLive input .............................................................................................................. 220 Categories for inputs .............................................................................................................. 220

v

AWS Elemental MediaLive User Guide

Inputs, input security groups, and channels ............................................................................... 221 Creating an input ................................................................................................................... 221

Getting ready ................................................................................................................. 221 CDI input ....................................................................................................................... 222 CDI input ? Partner CDI input .......................................................................................... 224 Elemental Link input ....................................................................................................... 225 HLS input ...................................................................................................................... 226 MediaConnect input ........................................................................................................ 227 MP4 input ..................................................................................................................... 230 TS file input ................................................................................................................... 231 RTMP pull input ............................................................................................................. 233 RTMP push input ............................................................................................................ 234 RTMP VPC input ............................................................................................................. 236 RTP input ...................................................................................................................... 239 RTP VPC input ............................................................................................................... 241 Editing an input ..................................................................................................................... 243 Deleting an input ................................................................................................................... 245 Resources: MediaLive input security groups ........................................................................................ 246 Purpose of an input security group ........................................................................................... 246 Creating an input security group .............................................................................................. 246 Editing an input security group ................................................................................................ 247 Deleting an input security group .............................................................................................. 248 Resources: MediaLive multiplex ........................................................................................................ 249 Summary of actions ................................................................................................................ 249 Creating a multiplex and program ............................................................................................ 250 Creating a channel ................................................................................................................ 251 Editing multiplexes, programs, and channels ............................................................................. 251 Editing a multiplex ........................................................................................................ 251 Editing a program ......................................................................................................... 252 Editing a channel in a program ........................................................................................ 252 Deleting multiplexes, programs, and channels ........................................................................... 252 Deleting a multiplex ...................................................................................................... 252 Deleting a program ....................................................................................................... 253 Deleting a channel .......................................................................................................... 253 Resources: MediaLive reservations ..................................................................................................... 254 Input and output reservations .................................................................................................. 254 Input reservation attributes and matching ......................................................................... 254 Output reservation attributes and matching ...................................................................... 254 How an input or output reservation is applied ................................................................... 255 Add-on reservations ................................................................................................................ 256 Reservation attributes ..................................................................................................... 257 How an add-on reservation is applied ............................................................................... 257 Purchasing a reservation ......................................................................................................... 258 Filtering on the offerings page ......................................................................................... 258 Viewing purchased reservations ................................................................................................ 259 Deleting a reservation ............................................................................................................. 259 Resources: MediaLive schedule ......................................................................................................... 260 Types of actions ..................................................................................................................... 260 Types of timing ...................................................................................................................... 260 How actions work ................................................................................................................... 261 How input switch actions work ......................................................................................... 261 How input prepare actions work ....................................................................................... 262 How image overlay actions work ...................................................................................... 263 How motion graphics overlay works .................................................................................. 263 How SCTE-35 actions work .............................................................................................. 264 How ID3 metadata and tags actions work .......................................................................... 265 How pause and unpause actions work ............................................................................... 265

vi

AWS Elemental MediaLive User Guide

Working with the schedule (console) ......................................................................................... 266 Creating actions ............................................................................................................. 267 Deleting actions ............................................................................................................. 283 Modifying actions ........................................................................................................... 284 Viewing the schedule ...................................................................................................... 287

Working with the schedule (AWS CLI) ........................................................................................ 287 Update batch command .................................................................................................. 288 Submitting a command ................................................................................................... 290 JSON for create actions ................................................................................................... 291 JSON for delete actions .................................................................................................. 307 JSON for combinations ................................................................................................... 308 Viewing the schedule ...................................................................................................... 309

Resources: MediaLive workflow wizard .............................................................................................. 312 About the workflow wizard ...................................................................................................... 312 Supported inputs ............................................................................................................ 312 Supported outputs ......................................................................................................... 312 Low-touch setup ............................................................................................................ 312 Using the workflow wizard ...................................................................................................... 313 Creating a workflow ........................................................................................................ 313 Modifying a workflow ..................................................................................................... 313 Deleting a workflow ....................................................................................................... 313 Next steps--novice users ......................................................................................................... 314 Next steps--experienced video users ......................................................................................... 314

Starting, stopping, and pausing a channel ......................................................................................... 315 Monitoring a channel or multiplex .................................................................................................... 316

Monitoring a channel .............................................................................................................. 316 Status tab ? Viewing status information ............................................................................ 316 Alerts tab ? Viewing alerts .............................................................................................. 317 Handling alerts .............................................................................................................. 317 Destinations pane ........................................................................................................... 317

Monitoring a multiplex ............................................................................................................ 318 Viewing status information .............................................................................................. 316

Monitoring using CloudWatch metrics ....................................................................................... 319 General information ........................................................................................................ 320 Global metrics ................................................................................................................ 321 Input metrics ................................................................................................................. 321 Output metrics ............................................................................................................... 328 Input device metrics ....................................................................................................... 331 Pipeline locking metrics ................................................................................................... 335

Monitoring using CloudWatch events ........................................................................................ 336 Option 1: Send all MediaLive events to an email address ..................................................... 336 Option 2: Send events for specific channels to an email address ........................................... 338

Monitoring using CloudWatch Logs ........................................................................................... 338 About channel logs ......................................................................................................... 339 Enabling channel encoder logs ......................................................................................... 340 Working with logs .......................................................................................................... 340

Logging using CloudTrail ......................................................................................................... 342 MediaLive information in CloudTrail .................................................................................. 342 Understanding MediaLive log file entries ........................................................................... 343

Maintenance windows ..................................................................................................................... 345 Viewing channels that require maintenance ............................................................................... 345 Setting maintenance windows .................................................................................................. 345

Features of MediaLive ..................................................................................................................... 347 Audio ? Audio-only outputs ..................................................................................................... 348 Inputs ........................................................................................................................... 348 Output groups and outputs ............................................................................................. 349 Streams ......................................................................................................................... 349

vii

AWS Elemental MediaLive User Guide

Audio ? audio rendition groups for HLS ..................................................................................... 350 About rendition groups ................................................................................................... 351 Creating a rendition group ............................................................................................... 352 Sample manifest ............................................................................................................ 357

AWS Elemental Link devices .................................................................................................... 358 Setting up AWS Elemental Link in MediaLive ...................................................................... 358 Using the AWS Elemental Link device as an input ............................................................... 359 Rules for devices, inputs, and channels .............................................................................. 359

Automatic input failover .......................................................................................................... 360 Automatic input failover in a single-pipeline channel .......................................................... 360 Automatic input failover in a standard channel .................................................................. 362 Setting up: CDI inputs ..................................................................................................... 364 Setting up: MediaConnect inputs ...................................................................................... 366 Setting up: other inputs .................................................................................................. 367 Changing the roles of the failover pair .............................................................................. 368 Starting the channel ....................................................................................................... 369 Manually forcing a failover .............................................................................................. 369 Automatic input failover and input switching ..................................................................... 370

Captions ................................................................................................................................ 370 Supported features ......................................................................................................... 371 Typical scenarios ............................................................................................................ 374 Setting up for captions ................................................................................................... 376 Examples ....................................................................................................................... 386

CDI inputs as partner inputs .................................................................................................... 393 Regular inputs versus partner inputs ................................................................................. 393 Rules for using partner CDI inputs .................................................................................... 394 Creating the set of partner inputs .................................................................................... 394 Editing the set of partner inputs ...................................................................................... 394 Deleting partner inputs ................................................................................................... 394

Channel classes and input classes ............................................................................................. 395 About channel classes ..................................................................................................... 395 About input classes ......................................................................................................... 395 Combinations of channel and input class ........................................................................... 395

Dynamic inputs ...................................................................................................................... 396 Setting up dynamic inputs ............................................................................................... 396

ID3 metadata ......................................................................................................................... 396 Enabling ID3 metadata .................................................................................................... 397 Passing through ID3 metadata ......................................................................................... 399 Inserting ID3 metadata when creating the channel ............................................................. 399 Inserting ID3 metadata using the schedule ....................................................................... 399

ID3 segment tags ................................................................................................................... 400 Inserting ID3 segment tags .............................................................................................. 401

Image overlays ....................................................................................................................... 401 Examples ....................................................................................................................... 401 Features of the static image overlay ................................................................................. 402 Step 1: Prepare the static image overlay file ...................................................................... 402 Step 2: Insert the overlay ................................................................................................ 403

Input clipping ........................................................................................................................ 403 Link devices and inputs ........................................................................................................... 404 Input prepare ......................................................................................................................... 404

Rules and limits ............................................................................................................. 405 Setting up input prepares ................................................................................................ 405 Runtime behavior ........................................................................................................... 410 Modifying ...................................................................................................................... 410 Deleting and stopping ..................................................................................................... 410 Input switching ...................................................................................................................... 411 About input switching ..................................................................................................... 411

viii

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download