kmp_ctrl_republish_url

The `kmp_ctrl_republish_url` directive specifies the URL to republish Kaltura Media Framework events to a designated endpoint.

Syntaxkmp_ctrl_republish_url URL;
Defaultnone
Context
Arguments1

Description

The kmp_ctrl_republish_url directive is a crucial configuration option within the Kaltura Media Framework. When enabled, it allows the NGINX server to forward specific JSON events generated by media components to a specified URL. This is particularly useful for orchestration purposes, as event handling can be centralized or managed through an external controller.

The directive requires a single argument, which is the target URL where the events should be republished. This URL must be accessible from the NGINX server and should be designed to handle incoming JSON POST requests, as the Kaltura media components will send their status and events in this format. When configured correctly, NGINX will listen for these events and automatically relay them, ensuring that the controller has the latest information about the media processing components in the system.

It’s important to ensure that the target URL is properly set up to handle the incoming requests, including any necessary authentication, response formatting, and error handling. The republishing mechanism is designed to enhance the versatility and scalability of the media framework by allowing it to interact seamlessly with different components and services within a media pipeline.

Config Example

kmp_ctrl_republish_url http://example.com/api/kaltura/events;

Ensure the target URL is correct and can receive requests; otherwise, events may be lost.

Monitor for potential network issues that could prevent successful event reposting.

Check that the target endpoint correctly handles incoming JSON structure, as any mismatches might cause failures.

← Back to all directives