kmp_cc_out_ctrl_retries
The `kmp_cc_out_ctrl_retries` directive sets the number of retries for control connection attempts in Kaltura Media Framework deployments.
Description
The kmp_cc_out_ctrl_retries directive, specific to the Kaltura Media Framework Common NGINX Module, defines the maximum number of attempts that the server will make to retry establishing a control connection after a failure. This is particularly useful in environments where control connections can be intermittent or subject to network issues. By configuring the number of retries, administrators can manage how resilient the system will be in handling temporary failures in control connection attempts, thus ensuring better reliability and availability of the streaming services.
The directive takes a single numeric argument, which specifies the number of retry attempts. For instance, if set to '5', the server will attempt to reconnect up to five times before giving up. The behavior of the retries is sequential, meaning that after an initial connection attempt fails, the server will wait a specified interval (often defined by other settings) before trying again, thus avoiding rapid-fire connection attempts which could exacerbate the issue.
This directive should be set within the appropriate context (stream or server) to ensure it applies effectively to the intended traffic flow, particularly for scenarios handling Kaltura-specific media streaming protocols. Optimal configuration involves balancing the retry attempts with the expected behavior of the media sources and network conditions.
Config Example
stream {
kmp_cc_out_ctrl_retries 5;
server {
listen 1935;
# additional server configurations
}
}The directive must be set in the correct context; it's applicable only in 'stream' or 'stream server' blocks.
Too high a number of retries may lead to prolonged connection attempts that can delay response times.
Ensure that any related timeout settings are adjusted accordingly to avoid conflicting behaviors.