ts_kmp_ctrl_retries
The `ts_kmp_ctrl_retries` directive sets the number of retry attempts for controller requests in the Kaltura Media Framework.
Description
The ts_kmp_ctrl_retries directive in the Kaltura Media Framework's NGINX module configures how many times the NGINX server should attempt to resend a request when it encounters an error with the controller. This directive is particularly useful in scenarios where network issues or transient faults may prevent successful communication between NGINX and the media controller. By setting this directive, administrators can ensure that temporary issues do not impede media streaming functionalities, promoting higher reliability in live environments.
The directive takes an integer argument that specifies the maximum number of retry attempts for a controller request. Each attempt will occur after a specified period, which may be defined in other configurations or defaults. This built-in retry mechanism contributes to the robustness of the deployment, allowing for better handling in cases of failure due to network glitches rather than outright service failure.
This directive is applicable within stream and stream server contexts, allowing for its use in both global and server-specific settings. When deploying media streaming applications using the Kaltura framework, setting an appropriate value for this directive is crucial for maintaining a seamless user experience and ensuring that any hiccups in communication are addressed promptly.
Config Example
stream {
server {
ts_kmp_ctrl_retries 5;
}
}The value must be an integer; non-integer values will cause NGINX to throw a configuration error.
Setting this to a very high number may result in unnecessary delays in case of persistent failures, impacting overall performance.