AWS Elemental MediaPackage
User Guide

Getting Started with AWS Elemental MediaPackage

This Getting Started tutorial shows you how to use the AWS Elemental MediaPackage console to create a channel and endpoints for streaming live videos.

Prerequisites

Before you can use AWS Elemental MediaPackage, you need an AWS account and the appropriate permissions to access, view, and edit MediaPackage components. Complete the steps in Setting Up AWS Elemental MediaPackage, and then return to this tutorial.

Step 1: Access AWS Elemental MediaPackage

Using your IAM credentials, sign in to the AWS Elemental MediaPackage console:

https://<region>.console.aws.amazon.com/mediapackage/home

Step 2: Create a Channel

The channel is the first component in AWS Elemental MediaPackage. It represents the input to MediaPackage for incoming content from an encoder such as AWS Elemental MediaLive.

AWS Elemental 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 AWS Elemental MediaPackage Channels page, choose Create channel.

  2. For ID, type 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 region. Supported characters are letters, numbers, underscore (_), and dash (-). You cannot use spaces in the ID.

  3. Keep the defaults for the remaining fields, and then choose Create channel.

    AWS Elemental 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.

    AWS Elemental MediaPackage securely generates the user names and passwords when it creates the channel. If you need to change these credentials, see Rotating Credentials on an Ingest URL.

    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 type the destination as the input URL, and the WebDAV credentials as the channel's user name and password. The upstream encoder must push WebDAV over HTTPS to AWS Elemental 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 How Input Redundancy Works.

Step 3: Create Endpoints

The endpoint is attached to a channel, and represents the output of the 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, type 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 region. Supported characters are letters, numbers, underscore (_), and dash (-). You cannot use spaces in the ID.

  4. Keep the defaults for the remaining fields, and then choose Save endpoints.

    AWS Elemental 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 type the request destination as the endpoint's URL.

(Optional) Step 4: Monitor AWS Elemental MediaPackage Activity

Use Amazon CloudWatch to track AWS Elemental MediaPackage activity, such as the counts of ingest and egress bytes, response times, and request counts.

To view metrics using the CloudWatch console

Metrics are grouped first by the service namespace, and then by the various dimension combinations within each namespace.

  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 CloudWatch Metrics.

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 to be deleted.

  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.