kmp_cc_out_max_republishes
The `kmp_cc_out_max_republishes` directive specifies the maximum number of times a Kaltura Media Framework component will attempt to republish a given media stream.
Description
The kmp_cc_out_max_republishes directive is an important setting within the Kaltura Media Framework Common NGINX Module that helps manage the reliability and resilience of media stream handling. When a media stream fails or encounters an error, the system can attempt to republish it to ensure continuous delivery. The value set for this directive determines the ceiling on the number of republish attempts allowed before the system stops trying. This provides a balance between resilience and resource management, as excessive republishing can lead to increased load and potential cascading failures in resource-constrained environments.
In practical terms, this directive should be configured according to the expected reliability of the network and servers involved in the media delivery process. For instance, in a stable environment with solid network infrastructure, a higher limit might be acceptable, while in a more volatile environment, a lower threshold may prevent overtaxing the system during errors. The directive accepts a single integer argument that dictates the maximum republishing attempts, offering administrators an opportunity to tailor the behavior of the media stream processing based on operational considerations.
By setting kmp_cc_out_max_republishes, administrators can fine-tune error handling strategies within Kaltura deployments, thereby optimizing the overall performance and ensuring uninterrupted streaming experiences.
Config Example
stream {
server {
kmp_cc_out_max_republishes 5;
}
}Setting the value too high can overload the system during persistent errors, leading to performance degradation.
Conversely, setting it too low may result in frequent stream failures without adequate recovery attempts, affecting user experience.