Live & on-demand: Different Property Hostnames
Here, you set up two separate Property hostname to Edge hostname associations ("Property hostnames") and include them to target live or on demand content, based on specific rule match criteria.
1 - Get your live media set up
To start, you need to work with Media Services Live to set up your live media.
-
Create your Media Services Live (MSL) streams for the live media you want to distribute.
-
Configure an origin for your live streams. During this process, you'll need to make note of the Primary Hostname value.
2 - Set up the property hostnames
We need a new AMD property with two property hostnames: one for distribution of the Live content, and a second one for the VoD content. We also want to employ Standard TLS security for access. For this example, we set up the following:
- baseball-highlights-live-media.com. The Property hostname for the _live_content.
- baseball-highlights-ondemand-media.com. The Property hostname for the _VoD_content.
The steps that follow outline what you need to do to create the property hostnames for this use case.
-
You need Standard TLS certificates set up for each property hostname. These can take a while to provision, so you should create them before you create the AMD property. You need to include your Property hostnames as a CN or SAN in each respective certificate: "baseball-highlights-live-media.com" for the live content certificate, and "baseball-highlights-ondemand-media.com" for the VoD content certificate.
-
Create a new AMD property in Akamai Control Center.
-
Set up two separate, Standard TLS Property Hostname to Edge hostname associations, one for "baseball-highlights-live-media.com" and one for "baseball-highlights-ondemand-media.com." Select Media delivery type, and set as follows, per hostname:
- baseball-highlights-live-media.com. Live
- baseball-highlights-ondemand-media.com. On Demand
3 - Configure the Default Rule for Live Media
At this phase, you need to set up the Default Rule to accommodate live media using Media Services Live (MSL). To support MSL, configure the behaviors in the Default Rule as follows:
Behavior | Options |
---|---|
Origin Server | Set the following options:
|
Segmented Media Delivery Mode | Set the following options:
|
Origin Characteristics | Set the following options:
|
Content Characteristics | Set the following options:
|
Client Characteristics | Set Client Location to the geographic region that best represents the clients that will be accessing your Live content. |
4 - Add a new rule for VoD requests
This new rule uses the VoD property hostname in its match criteria.
-
In the Property Configuration Settings click Add Rule.
-
Ensure Blank Rule Template is selected (default) and click Insert Rule.
-
Click the gear icon in the New Rule and select Edit Name. Input the desired name (for example, "VoD Delivery Rule") and press Enter.
-
Click Add Match and set the fields as follows:
- Hostname
- is one of
- Select Items. Click this field and input the Property hostname for the VoD content (for example, " baseball-highlights-ondemand-media.com").
-
Click Add Behavior.
-
Type "origin" in the Search available behaviors field to filter results, select Origin Server, and click Insert Behavior. Set the options in this behavior as follows:
- Origin Type: NetStorage
- NetStorage Account: Click to select the NetStorage account associated with the Storage Group that houses the VoD content to be delivered.
-
Repeat steps 5-6, to add the Origin Characteristics, Segmented Media Delivery Mode, Content Characteristics (optional), and Client Characteristics (optional) behaviors.
Behavior | Options |
---|---|
Origin Characteristics | Set the following options:
|
Segmented Media Delivery Mode | Set Mode to On Demand. |
Content Characteristics | Set these options to best fit the VoD content you're delivering to your end users, to optimize its delivery.
|
Client Characteristics | Set Client Location to the geographic region that best represents the clients that will be accessing your VoD content.
|
What happens next?
First, you need to complete creation of the AMD property, optionally test it, and finally promote it to production for use.
Once live in production, request logic for your content works as follows:
-
Any request that includes the URL
baseball-highlights-live-media.com
will deliver _live_content. The match criteria you set in the VoD Delivery Rule is unique to requests to "baseball-highlights-ondemand-media.com," so all of the settings applied in the VoD Delivery Rule are ignored, and what you've set in the Default Rule is applied, to deliver the live content. -
Any request that includes the URL
baseball-highlights-ondemand-media.com
will deliver VoD content. The VoD Delivery Rule exists last in the property, so it's checked first. Since the match criteria in this rule has been triggered, all of its behaviors are applied. However, the Default Rule applies to _all_requests. So, the following also apply:-
With duplicate behaviors in both the VoD Delivery Rule and Default Rule, what's in the VoD Delivery Rule is used. For example, you set up "NetStorage" as your Origin Server for VoD, and "On Demand" for your Segmented Media Delivery Mode, so those are used for requests to "baseball-highlights-ondemand-media.com." Also, if you added the Content Characteristics behavior in this rule, _its_settings are used in place of what you've set for that behavior in the Default Rule.
-
If you've set behaviors in the Default Rule that aren't in the VoD Delivery Rule, they're applied. For example, if you left out the Client Characteristics behavior from the VoD Delivery Rule, what you set in the Default Rule is used.
-
The above points apply to all behaviors in either rule, not just the use case-based behaviors.
Updated 5 months ago