Deploy with the Operator
The Holoscan for Media operator for VSR NIM manages the VSR NIM media function through a Kubernetes custom resource.
Use the operator when you want a CR-driven deployment model that reconciles the VSR NIM deployment, ConfigMaps, SDP data, Rivermax configuration, Multus networking, and NMOS settings.
What the Operator Creates
When you apply a NvidiaVsrNimMediaFunction custom resource, the operator creates and manages the following components:
The operator manages only the VSR NIM media function. Source and receiver endpoints must be provided by existing ST 2110 equipment, platform services, or the sample Helm chart with its VSR service disabled.
Provide Source and Receiver Endpoints
The operator does not create a test-pattern source or output-file receiver. Use existing ST 2110/NMOS equipment, platform services, or the packaged sample chart for the endpoints around the operator-managed VSR NIM pod.
For local validation with the sample chart, complete the operator installation workflow to create the operator-managed VSR NIM deployment. After the NvidiaVsrNimMediaFunction CR creates the VSR NIM pod, deploy the sample receiver from the sample chart archive in the same namespace as the custom resource. The following sample chart command intentionally disables its own VSR service and sample sender. Set NAMESPACE, SECRET_NAME, and NODE_HOSTNAME for your cluster before running the command:
Wait for the sample receiver and the CR-created VSR NIM pod to be ready, and then enable the sample sender:
If the cluster does not run topo-aware-scheduler, add --set h4m.schedulerName="" to both sample chart commands. For static ST 2110 validation, pass the sample chart values-st2110.yaml overlay and keep the sample chart transport values aligned with the operator CR.
In NMOS mode, enabling the sample sender does not start media flow by itself. Use the NMOS controller to connect the sample sender to the operator-managed VSR input, and then connect the VSR output to the sample receiver.
Pull the Operator Chart
Install the Operator
If the operator image requires a pull secret, set it in the operator chart values:
If generated media function pods should use a default pull secret when the CR omits spec.parameters.imagePullSecrets, set it in the operator chart values:
The pull secret for the operator image and the pull secret for generated VSR NIM media function pods are separate settings. A CR-level spec.parameters.imagePullSecrets value overrides the chart-level media function default for that CR.
Wait for the operator:
Create a Media Function
Create a NvidiaVsrNimMediaFunction custom resource. The CR defines:
- One ST 2110-20 video input.
- One ST 2110-20 video output.
- NMOS or inline SDP control.
- VSR processing parameters.
- GPU, network, Rivermax, logging, security, resources, and scheduler settings.
Example CR for NMOS mode:
VSR NIM ST 2110 SDP generation supports SDR transfer characteristics in this release. Use transfer_characteristic: SDR.
The operator chart uses global.h4m.pipeline: "720-to-4K" as the default nvidia.com/holoscan-for-media.pipeline label for generated VSR NIM pods. To override labels for a specific media function, set these labels on the NvidiaVsrNimMediaFunction metadata:
Apply the CR:
On Red Hat OpenShift, replace kubectl with oc.
High-Speed Network Resource Pools
The operator configures Multus network attachments for ST 2110 media transport through spec.parameters.highSpeedNetwork.
If highSpeedNetwork is omitted, the operator uses the following values:
The first attachment becomes the first secondary interface in the pod, typically net1, and the second attachment becomes net2. Keep spec.inputs.<name>.parameters.localInterfaceName and spec.outputs.<name>.parameters.localInterfaceName aligned with that order.
Set resourceName when the cluster exposes named SR-IOV device-plugin resources. If an attachment needs more than one virtual function, set resourceCount; it defaults to 1 when resourceName is present.
On clusters with single-numa-node topology requirements, configure highSpeedNetwork[].resourceName and resourceCount so the VSR pod can allocate the GPU, hugepages, and SR-IOV virtual functions from a compatible NUMA zone.
On clusters in which both VSR interfaces must use the same NUMA-local SR-IOV pool, list the same NetworkAttachmentDefinition twice and set the same device-plugin resource on each attachment:
The generated VSR pod still receives two in-pod interfaces. Use the repeated-entry form when you need two distinct interfaces. Use a single entry with resourceCount: 2 only when your media function and CNI setup intentionally use one in-pod interface:
Do not collapse separate RX and TX pools into one logical resource unless the cluster exposes one shared pool. On single-numa-node clusters, hiding the resource split can cause scheduler or kubelet topology placement failures.
Verify
Check the custom resource:
Check the generated deployment:
Check operator logs:
Useful status fields include the following:
status.conditionsstatus.inputs.video_input.controlstatus.outputs.video_output.controlstatus.managed_resources
If the generated VSR NIM pod stays Pending, inspect pod events:
Common causes include a missing NetworkAttachmentDefinition, an unavailable spec.schedulerName, insufficient GPU or hugepage capacity, unavailable SR-IOV device resources, or GPU and SR-IOV pool resources that cannot be placed on the same NUMA node.
Metrics and Health
The operator chart can expose controller-runtime metrics and health endpoints for the operator controller. Media function metrics are separate. The VSR NIM media function image in this release does not currently expose /metrics; the media function metricsEnabled setting only adds Prometheus scrape annotations.
Operator Chart Settings
The following are common operator chart settings:
Per-CR fields such as spec.parameters.imagePullSecrets, spec.schedulerName, and Holoscan for Media metadata labels override the corresponding chart-level media function defaults.
Uninstall
Delete the media function CR:
Uninstall the operator: