Media Flow Controller Web-Based Interface : Service Config Tab : Service Config > Virtual Player

Service Config > Virtual Player
Create a virtual player and set virtual player options; these are set in the CLI with the virtual-player commands.
Add Virtual Player
Add a virtual player and then click Configure in the List of Virtual Players to open a new window and make configurations. See Figure 76.
Virtual Player Name—Name the virtual player; you use this name when adding a virtual player to a namespace.
Virtual Player Type—Choose Type0 (default) for a generic virtual player; this type has the most configuration options.
Figure 76 Service Config > Virtual Player Page Detail (Add Virtual Player)
List of Virtual Players Added
Displays existing virtual-players and provides a Configure link to jump to the configuration pages (in a new window) for that type of virtual-player, and a Show link to view the configurations of the selected virtual-player. See Figure 77.
Figure 77 Service Config > Virtual Player Page Detail (List of Virtual Players Added)
Virtual Player generic Configuration
After adding a generic virtual player, click Configure in the list of virtual players to open configuration pages (in a new window) for that type of virtual-player. Click Add/Update on each configuration page and simply close the window when you are done. Verify your configurations by clicking Show in the virtual player list.
Full Download Configuration: Allow the delivery to download content at the fastest possible speed, limited by the set connection max-bandwidth and possibly exceeding the set assured-flow rate.
Active—Select to activate the feature; de-select to de-activate it.
Always—Download all requests at the maximum possible speed.
Match String—Only download requests with this value in the URL at the maximum possible speed.
Query String Param—Enter a query param to signal full download.
Header—Only download requests with this header at the maximum possible speed.
Max Session Rate (kbps)—Set the maximum bandwidth for a session. The actual session bandwidth is between the AFR (Assured Flow Rate) and this value. Even if there is available bandwidth in the link, Media Flow Controller does not allocate more than this value for a session. When it is a full download, Media Flow Controller tries to allocate the max-bandwidth to the session. Default it is 0 Kbps (unbounded) with the Media Flow Controller license. Important! You must have the Media Flow Controller license installed to change the default (200 kbps without the license).
Active—Select to activate the feature; de-select to de-activate it.
Rate (kbps)—Set a rate no higher than the configured connection max-bandwidth.
Auto—Not supported in Release 2.0.2.
Query String Param—Enter a query param to signal the desired assured-flow rate.
Active—Select to activate the feature; de-select to de-activate it.
Size (KB)—Define how many kilobytes should be expedited.
Time—Define how many seconds should be expedited.
Query String Param—Specify a query param (associated value must be in kilobytes).
Active—Select to activate the feature; de-select to de-activate it.
Data String—Not supported in Release 2.0.2.
UOL Length—Not supported in Release 2.0.2.
UOL Offset—Not supported in Release 2.0.2.
URI Query String Param—This is the indicator of the provided hash value in the URL that, when processed by the hash digest, must match the Shared Secret Value .
Digest—Only md-5 is supported in Release 2.0.2.
Shared Secret Type—Either append or prefix to the URL the shared secret value (entered next).
Shared Secret Value—A secret key which must match the hash value provided in the URL and indicated by the URI Query String Parm.
Active—Select to activate the feature; de-select to de-activate it.
Query String Param—Enter a name to tell Media Flow Controller whether or not to implement seek.
Virtual Player break Type Configuration (Assured Flow, Fast Start, Hash, and Seek)
After adding a break virtual player, click Configure in the list of virtual players to open configuration pages (in a new window) for that type of virtual-player. Click Add/Update on each configuration page and simply close the window when you are done. Verify your configurations by clicking Show in the virtual player list.
Active—Select to activate the feature; de-select to de-activate it.
Rate (kbps)—Set a rate no higher than the configured connection max-bandwidth.
Auto—Not supported in Release 2.0.2.
Query String Param—Enter a query param to signal the desired assured-flow rate.
Active—Select to activate the feature; de-select to de-activate it.
Size (KB)—Define how many kilobytes should be expedited.
Time—Define how many seconds should be expedited.
Query String Param—Specify a query param (associated value must be in kilobytes).
Active—Select to activate the feature; de-select to de-activate it.
Data String—Not supported in Release 2.0.2.
UOL Length—Not supported in Release 2.0.2.
UOL Offset—Not supported in Release 2.0.2.
URI Query String Param—This is the indicator of the provided hash value in the URL that, when processed by the hash digest, must match the Shared Secret Value .
Digest—Only md-5 is supported in Release 2.0.2.
Shared Secret Type—Either append or prefix to the URL the shared secret value (entered next).
Shared Secret Value—A secret key which must match the hash value provided in the URL and indicated by the URI Query String Parm.
Max Session Rate (kbps)—Set the maximum bandwidth for a session. The actual session bandwidth is between the AFR (Assured Flow Rate) and this value. Even if there is available bandwidth in the link, Media Flow Controller does not allocate more than this value for a session. When it is a full download, Media Flow Controller tries to allocate the max-bandwidth to the session. Default it is 0 Kbps (unbounded) with the Media Flow Controller license. Important! You must have the Media Flow Controller license installed to change the default (200 kbps without the license).
Active—Select to activate the feature; de-select to de-activate it.
Query String Param—Enter a name to tell Media Flow Controller whether or not to implement seek.
Virtual Player qss-streamlet Type Configuration (Assured Flow Rate Map)
After adding a qss-streamlet virtual player, click Configure in the list of virtual players to open configuration pages (in a new window) for that type of virtual-player. Click Add/Update on each configuration page and simply close the window when you are done. Verify your configurations by clicking Show in the virtual player list.
Rate Map Configuration: Change the assured flow rate associated with each string or specify a parameter for Media Flow Controller to use to find the desired rate in the URL.
Active—Select to activate the feature; de-select to de-activate it.
Match String—Set the assured-flow rate with a string value.
Query String Param—Enter a name to tell Media Flow Controller the rate to use. Not supported in Release 2.0.2.
Rate—Extracts the value from the URL to calculate the assured flow rate needed for each HTTP request.
UOL Length—Not supported in Release 2.0.2.
UOL Offset—Not supported in Release 2.0.2.
By default, the match string (length 2 bytes) is extracted by going to the end of the URL and skipping 12 Bytes from the end. The value in that location is mapped to the configured rate in kbps. Example:
http://video.example.com/public/BBB87026/xy_750_1938344/AC60E15B2A7C4A45AC4C1472E2AC0816_030000003F.flv
In the URL above, the value 03 (12 Bytes from the end of the URL) is extracted, and the corresponding assured flow rate (1000Kbps) is applied. The configured CLI looks like this:
virtual-player my_virtual_player type 2
rate-map match 01 rate 300
rate-map match 02 rate 500
rate-map match 03 rate 1000
In this way, URLs containing 01 in the correct place (12 bytes from the end) maps to an assured flow rate of 300; with 02 the assured flow rate is 500; and so on. Instead of using the default match (12 bytes from the end of the URL) you can specify a query-string-parm or a uol offset and length. For details on these options see “Terminology” on page 28.
Virtual Player yahoo Type Configuration (Authorization and Health Probes)
After adding a yahoo virtual player, click Configure in the list of virtual players to open configuration pages (in a new window) for that type of virtual-player. Click Add/Update on each configuration page and simply close the window when you are done. Verify your configurations by clicking Show in the virtual player list.
Compute MD-5 hash of query string parameters representing stream-id, auth-id, a configured shared-secret, and time-interval; and match the computed value with the specified match query-string-parm <string>. The HTTP GET proceeds if the computed MD-5 hash matches; if there is no match, the session is rejected. Use virtual player <name> type 3 no req-auth to disable.
Important! Virtual-player yahoo requires a license to be configured.
Active—Select to activate the feature; de-select to de-activate it.
Auth ID URI Query String—String value to be hashed.
Digest—Only md-5 is supported in Release 2.0.2.
Match URI Query String—String value must match computed hash of Auth ID URI Query String, Shared Secret String, Stream ID Query String Param, and Time Interval values.
Shared Secret String—String value to be hashed.
Stream ID Query String Param—String value to be hashed.
Time Interval—Integer value.
Health-Probe Configuration (See “Terminology” on page 28 for explanation and example of uol offset and uol length. See “Using hash-verify” on page 73 for explanation).
Active—Select to activate the feature; de-select to de-activate it.
Query String Param—This is the value that, when processed by the hash digest, must match the Match String value.
Match String—Set the secret string that the hash attempts to verify.
Active—Select to activate the feature; de-select to de-activate it.
Query String Param—Enter a name to tell Media Flow Controller whether or not to implement seek.
Active—Select to activate the feature; de-select to de-activate it.
Rate (kbps)—Set a rate no higher than the configured connection max-bandwidth.
Auto—Not supported in Release 2.0.2.
Query String Param—Enter a query param to signal the desired assured-flow rate.
Max Session Rate (kbps)—Set the maximum bandwidth for a session. The actual session bandwidth is between the AFR (Assured Flow Rate) and this value. Even if there is available bandwidth in the link, Media Flow Controller does not allocate more than this value for a session. When it is a full download, Media Flow Controller tries to allocate the max-bandwidth to the session. Default it is 0 Kbps (unbounded) with the Media Flow Controller license. Important! You must have the Media Flow Controller license installed to change the default (200 kbps without the license).
Virtual Player smoothflow Type Configuration
After adding a smoothflow virtual player, click Configure in the list of virtual players to open configuration pages (in a new window) for that type of virtual-player. Click Add/Update on each configuration page and simply close the window when you are done. Verify your configurations by clicking Show in the virtual player list.
Active—Select to activate the feature; de-select to de-activate it.
Chunk Query String—Signals the desired video chunking rate.
Profile Query String—Signals the profile name.
Session Id Query String—Signals the session ID.
State Query String—Signals the SmoothFlow state.
Max Session Rate (kbps)—Set the maximum bandwidth for a session. The actual session bandwidth is between the AFR (Assured Flow Rate) and this value. Even if there is available bandwidth in the link, Media Flow Controller does not allocate more than this value for a session. When it is a full download, Media Flow Controller tries to allocate the max-bandwidth to the session. Default it is 0 Kbps (unbounded) with the Media Flow Controller license. Important! You must have the Media Flow Controller license installed to change the default (200 kbps without the license).
Active—Select to activate the feature; de-select to de-activate it.
Seek query string param—Enter a name, tells Media Flow Controller to implement seek or not .
Control Point string—Choose either player (default) or server as the source of bandwidth monitoring and reporting for bit-rate profile adjustments.
Active—Select to activate the feature; de-select to de-activate it.
Data String—Not supported in Release 2.0.2.
UOL Length—Not supported in Release 2.0.2.
UOL Offset—Not supported in Release 2.0.2.
URI Query String Param—This is the indicator of the provided hash value in the URL that, when processed by the hash digest, must match the Shared Secret Value .
Digest—Only md-5 is supported in Release 2.0.2.
Shared Secret Type—Either append or prefix to the URL the shared secret value (entered next).
Shared Secret Value—A secret key which must match the hash value provided in the URL and indicated by the URI Query String Parm.
Virtual Player youtube Type Configuration
After adding a youtube virtual player, click Configure in the list of virtual players to open configuration pages (in a new window) for that type of virtual-player. Click Add/Update on each configuration page and simply close the window when you are done. Verify your configurations by clicking Show in the virtual player list.
Active—Select to activate the feature; de-select to de-activate it.
Seek query string param—Enter a name to tell Media Flow Controller whether or not to implement seek.
Seek-length query string param—Enter a name to signal the number of bytes of data to send from the seek start position; referenced value must be in bytes.
Max Session Rate (kbps)—Set the maximum bandwidth for a session. The actual session bandwidth is between the AFR (Assured Flow Rate) and this value. Even if there is available bandwidth in the link, Media Flow Controller does not allocate more than this value for a session. When it is a full download, Media Flow Controller tries to allocate the max-bandwidth to the session. Default it is 0 Kbps (unbounded) with the Media Flow Controller license. Important! You must have the Media Flow Controller license installed to change the default (200 kbps without the license).
Active—Select to activate the feature; de-select to de-activate it.
Rate (kbps)—Set a rate no higher than the configured connection max-bandwidth.
Auto—Not supported in Release 2.0.2.
Query String Param—Enter a query param to signal the desired assured-flow rate.
Active—Select to activate the feature; de-select to de-activate it.
Size (KB)—Define how many kilobytes should be expedited.
Time—Define how many seconds should be expedited.
Query String Param—Specify a query param (associated value must be in kilobytes).
Active—Select to activate the feature; de-select to de-activate it.
Video-id (Query string)—Specify a query param string whose value provides the requested video ID (i.e. id). You Tube video URI requests do not specifically associate a name to a video asset in the URI, instead a unique query param is used.
Format Tag—Specify a query param string whose value provides the requested format (i.e. fmt or itag). You Tube video URI requests do not specifically associate a format to a video asset in the URI, instead a unique query param is used. Acceptable format values are shown in “About Virtual Player Type youtube” on page 77.
Virtual Player smoothstream-pub Type Configuration
This type virtual player is Not Supported in Release 2.0.2.

Report an Error
Media Flow Controller Administrator's Guide and CLI Command Reference
Copyright © 2010 Juniper Networks, Inc.