Prerequisites
Before you can use AWS Elemental MediaPackage, you need an AWS account and the appropriate permissions to access, view, and edit MediaPackage components. Make sure that your system administrator has completed the steps in Setting up (p. 16), and then return to this tutorial.
For supported live inputs and codecs, see Live supported codecs and input types (p. 3).
Step 1: Access AWS Elemental MediaPackage
Using your IAM credentials, sign in to the AWS Elemental MediaPackage console:
https://console.aws.amazon.com/mediapackage/
Step 2: Create a channel
The channel is the first component in AWS Elemental MediaPackage. It represents the input to MediaPackage for incoming live content from an encoder such as AWS Elemental MediaLive.
Step 3: Create endpoints
MediaPackage does not require that you supply any customer data. There are no fields in channels where there is an expectation that you will provide customer data.
To create a channel
1. On the MediaPackage Channels page, choose Create channel.
2. For ID, enter a name that describes the channel, such as channelHLS1. The ID is the primary identifier for the channel, and must be unique for your account in the AWS Region. Supported characters are letters, numbers, underscore (_), and dash (-). You can't use spaces in the ID.
3. Keep the defaults for the remaining fields, and then choose Create channel.
MediaPackage displays the new channel's details page.
4. On the channel's details page, note the values for Input URL, Username, and Password. If you're using input redundancy, you need this information for both input URLs. If you're sending only one stream to the channel, you can note the information for either input URL.
MediaPackage securely generates the WebDAV user names and passwords when it creates the channel. If you need to change these credentials, see Rotating credentials on an input URL (p. 42).
Provide the information from these fields to the person in charge of the upstream encoder. In the stream configuration in the encoder, this person must enter the destination as the input URL, and the WebDAV credentials as the channel's user name and password. The upstream encoder must use digest authentication and push WebDAV over HTTPS to MediaPackage, and include these credentials. If you're using input redundancy, the input streams to this channel must have identical encoder settings. For more information about setting up source streams for input redundancy, see Live input redundancy AWS Elemental MediaPackage processing flow (p. 10).
Step 3: Create endpoints
The endpoint is attached to a channel, and represents the output of the live content. You can associate multiple endpoints to a single channel. Each endpoint gives players and downstream CDNs (such as Amazon CloudFront) access to the content for playback.
AWS Elemental MediaPackage does not require that you supply any customer data. There are no fields in endpoints where there is an expectation that you will provide customer data.
To create an endpoint
1. On the Channels page, choose the channel that the endpoint will be associated with.
2. On the details page for the channel, choose either Add and edit endpoint or Add endpoints if there are no existing endpoints.
3. For ID, enter a name that describes the endpoint, such as HLSendpoint1. The ID is the primary identifier for the endpoint, and must be unique for your account in the AWS Region. Supported characters are letters, numbers, underscore (_), and dash (-). You can't use spaces in the ID.
4. Keep the defaults for the remaining fields, and then choose Save endpoints.
MediaPackage displays the channel's details page, including the endpoint that you just created.
5. On the channel's details page, note the value in the URL field for the endpoint. Provide this information to the person in charge of the downstream device (CDN or player). In the downstream device, this person must enter the request destination as the endpoint's URL.
(Optional) step 4: Monitor AWS Elemental MediaPackage activity
(Optional) step 4: Monitor AWS Elemental MediaPackage activity
Use Amazon CloudWatch to track AWS Elemental MediaPackage activity, such as the counts of bytes that MediaPackage has received and sent, response times, and request counts. Metrics are grouped first by the service namespace, and then by the various dimension combinations within each namespace.
To view metrics using the CloudWatch console
1. Open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.
2. In the navigation pane, choose Metrics.
3. Under All metrics, choose the AWS/MediaPackage namespace.
4. Select the metric dimension to view the metrics (for example, choose channel to view metrics per channel).
For a list of AWS Elemental MediaPackage metrics, see AWS Elemental MediaPackage live content metrics (p. 143).
Step 5: Clean up
To avoid extraneous charges, be sure to delete all unnecessary channels and endpoints. You must delete all endpoints on a channel before the channel can be deleted.
To delete an endpoint
1. On the Channels page, choose the channel that the endpoint is associated with.
2. On the channel details page, choose the name of the endpoint that you want to delete.
3. On the endpoint details page, choose Delete endpoint.
4. On the Delete Endpoints page, choose Save all.
To delete a channel
1. On the Channels page, choose the channel using one the following methods:
• Choose the channel name
• Select the check box next to the channel name 2. Choose Delete selected or Delete channel.
3. In the confirmation dialog box, choose Delete.
AWS Elemental MediaPackage removes the channel and all associated endpoints.
Getting started with live-to-VOD content delivery in AWS Elemental MediaPackage
This Getting Started tutorial shows you how to use the AWS Elemental MediaPackage console to create a live-to-VOD (video on demand) asset and make it available for playback.
To deliver live-to-VOD content, you do these three main things:
Prerequisites
• Ingest a live HLS content stream into MediaPackage
• Extract a VOD asset from the stream
• Make the asset available for playback
NoteYou're not required to use MediaPackage to deliver your live-to-VOD asset to viewers. This tutorial is meant as an illustration of how you can use MediaPackage to complete the live-to-VOD workflow.
The following sections are a guided tutorial for becoming familiar with these three things and other supporting actions.
Topics
• Prerequisites (p. 30)
• Step 1: Access AWS Elemental MediaPackage (p. 30)