URL Prefixes

URL prefixes are short strings that help the streamer select which backend to fetch content from. The prefixes are prepended to the URL path. They are typically used together with the AgileTV streamers.

The URL prefixes are configured at services.routing.settings.urlPrefixes. A typical configuration looks like this:

confcli services.routing.settings.urlPrefixes
{
    "urlPrefixes": [
        {
            "prefix": "abc123",
            "sessionGroups": [
                "host1-sessions"
            ]
        }
    ]
}

The above configuration will prepend the prefix abc123 to sessions in the host1-sessions session group. Prefixes usually differ per host, so the session group will typically be of type hostName. See Session Groups and Classification for more information.

Prefix insertion needs to be enabled per host group. It is only possible to enable prefix insertion for groups of type host. It is enabled via the services.routing.hostGroups.<group>.addUrlPrefix configuration:

confcli services.routing.hostGroups.<group>.addUrlPrefix true
services.routing.hostGroups.<group>.addUrlPrefix = True

Prefixes will be inserted in redirect response URLs for initial sessions. They will not be inserted for instream sessions.

For example, after the prefix abc123 is inserted, the URL

https://streamer1.example.com/film1/index.m3u8

will be:

https://streamer1.example.com/abc123/film1/index.m3u8