Configure source properties for Wowza Streaming Engine Media Cache

Learn how to configure advanced source properties for Media Cache, a built-in caching mechanism included with Wowza Streaming Engine™ media server software that increases the scalability of video-on-demand (VOD) streaming.

Add custom source properties


You can tune Media Cache source performance by adding custom HTTP or Amazon S3 properties.

  1. In Wowza Streaming Engine Manager, click the Server tab, and then click Media Cache in the contents panel.
  2. On the Sources tab, click the name of the source to which you want to add custom properties.
  3. Click the Properties tab.
     
    Note: Access to the Properties tab is limited to administrators with advanced permissions. For more information, see Manage credentials.
  4. In the Custom area, click Edit.
  5. Click Add Custom Property, specify the following settings in the Add Custom Property dialog box, and then click Add:

HTTP source properties

Path Name Type Description
/Root/MediaCacheSources
/MediaCacheSource
closeConnectOnBadStatus Boolean Enables Wowza Streaming Engine to close the connection if it does not receive the HTTP status code 206 (Partial Content) in the response when making a range request to the HTTP source. The default value is false.
/Root/MediaCacheSources
/MediaCacheSource
sendHTTPKeepAlive Boolean Enables Wowza Streaming Engine to make a keep-alive connection to an HTTP source. The default value is true.
/Root/MediaCacheSources
/MediaCacheSource
sendHTTPProxyKeepAlive Boolean Enables Wowza Streaming Engine to make a keep-alive connection to an HTTP proxy. The default value is true.
/Root/MediaCacheSources
/MediaCacheSource
userHTTPHeaders String A pipe-separated list of key: value pairs that define HTTP headers to add to requests made to the source. For example: User-Agent: Mozilla/5.0|AccessControl-Request-Method: <method>.
/Root/MediaCacheSources
/MediaCacheSource
debugHTTPRequests Boolean Enables debug logging for all HTTP requests. The default value is false.
/Root/MediaCacheSources
/MediaCacheSource
urlDecodeStreamName Boolean Enables content names with non-safe transportable characters such as spaces and dots to be URL-encoded. The default value is false.
/Root/MediaCacheSources
/MediaCacheSource
base64DecodeStreamName Boolean Enables all content names to be base64 encoded. This can aid in the transport of both unsafe and HTTP GET variables to be passed through to the HTTP source. Note that passing HTTP GET variables means the same piece of content could be cached more than once if the variable changes for new requests. The default value is false.

Amazon S3 custom properties

Path Name Type Description
/Root/MediaCacheSources
/MediaCacheSource
awsSigningVersion Integer Enables you to specify the signature version for Amazon S3 bucket authentication. Valid values are 2 or 4. The default value is 2.
/Root/MediaCacheSources
/MediaCacheSource
awsDefaultRegion String The default region to use for bucket authentication signing. For a list of supported regions, see AWS service endpoints.
 
Note: If you created your Amazon S3 bucket within the last 24 hours, you’ll need to set awsSigningVersion to Version 4 and the awsDefaultRegion to the region where your Amazon S3 bucket is located. For more information, see Why am I getting an HTTP 307 Temporary Redirect response from Amazon S3? in the AWS documentation.
  1. Click Save, and then restart the server when prompted to apply the changes.

More resources