ts_kmp_ctrl_connect_url
The 'ts_kmp_ctrl_connect_url' directive configures the URL for connecting to the Kaltura Media Framework controller.
Description
The 'ts_kmp_ctrl_connect_url' directive specifies the URL that the Kaltura Media Framework uses to connect to its orchestrating controller. This connection is pivotal for managing media pipelines, as it allows communication between various media processing components and the controller, facilitating tasks such as receiving JSON events about component status and sending commands in response to those events.
The directive accepts a single argument, which should be a valid URL. This URL typically points to the controller's REST API that listens for HTTP requests, specifically POST requests containing JSON data. The controller utilizes these requests to monitor the media components, handle failures, and dynamically adjust the media pipeline as needed. As part of its functionality, the Kaltura Media Framework might utilize specific paths in this URL to carry out different actions, including retrieving status updates or modifying the media flow.
Proper configuration of the 'ts_kmp_ctrl_connect_url' directive ensures that all media processing components within the Kaltura ecosystem are effectively coordinated. An incorrect URL or a misconfigured directive can lead to communication issues, resulting in disrupted media service and unresponsive components.
Config Example
stream {
ts_kmp_ctrl_connect_url http://controller.example.com/api;
}Ensure the URL points to a valid and accessible controller endpoint.
The directive must be used within the appropriate contexts (stream, stream server).
Make sure to specify the correct HTTP method (usually POST) when interacting with the controller.