Role - edpm_accel_drivers

osp.edpm.edpm_accel_drivers role – The main entry point for the edpm_accel_drivers role.

Entry point main – The main entry point for the edpm_accel_drivers role.

Synopsis

  • Installs and configures accelerator drivers on RHEL systems. Supports installation of NVIDIA drivers from an RPM repo or custom URL.

Parameters

Parameter

Comments

edpm_accel_drivers_blacklist_nouveau

boolean

Whether to blacklist nouveau driver

Choices:

  • false

  • true ← (default)

edpm_accel_drivers_download_delay

integer

The seconds between retries for failed download tasks

Default: 5

edpm_accel_drivers_download_retries

integer

Default: 5

edpm_accel_drivers_install_nvidia

boolean

Whether to install nvidia drivers.

Choices:

  • false ← (default)

  • true

edpm_accel_drivers_nvidia_cache_dir

string

The directory to cache the NVIDIA driver package when downloading from a custom URL.

Default: "/var/cache/nvidia-drivers"

edpm_accel_drivers_nvidia_cleanup_temp_files

boolean

Whether to cleanup temporary files after installation

Choices:

  • false

  • true ← (default)

edpm_accel_drivers_nvidia_custom_url

string

Custom NVIDIA driver URL (if set, driver will be installed from this URL instead of from a repository). Must end with .rpm (SUPPORTED) or .run extension (UNSUPPORTED). NOTE: file:/// URLs are supported, for example a local NFS mount.

Default: ""

edpm_accel_drivers_nvidia_custom_url_ssl_no_verify

boolean

Whether to disable SSL certificate verification when downloading NVIDIA driver from custom URL. Set to true to disable SSL certificate verification (not recommended for production).

Choices:

  • false ← (default)

  • true

edpm_accel_drivers_nvidia_dnf_module_stream

string

NVIDIA Driver dnf module stream to install from NVIDIA repo. If set to “”, no DNF module will be selected.

Default: "latest"

edpm_accel_drivers_nvidia_manage_mig

boolean

Whether to configure NVIDIA MIG (Multi-Instance GPU) partitioning.

Choices:

  • false ← (default)

  • true

edpm_accel_drivers_nvidia_mig_geometries

list / elements=string

List of MIG geometry strings, one per GPU. Index 0 applies to GPU 0, index 1 to GPU 1, etc. Each string is passed to nvidia-smi mig -cgi (e.g. “14,14,14,14” or “2g.12gb,2g.12gb”). Required when edpm_accel_drivers_nvidia_manage_mig is true. An empty (or shortened) list removes previously configured systemd units and disables MIG on affected GPUs.

Default: []

edpm_accel_drivers_nvidia_package_name

string

NVIDIA Driver package name to install from NVIDIA repo.

Default: "nvidia-driver"

edpm_accel_drivers_nvidia_repo_gpgkey

string

GPG key URL for NVIDIA repository verification.

Default: ""

edpm_accel_drivers_nvidia_repo_url

string

NVIDIA repository URL for driver installation.

Default: ""

edpm_accel_drivers_nvidia_rpm_disable_gpg_check

boolean

Whether to disable GPG check when installing NVIDIA driver from RPM. Set to true to disable GPG check (not recommended for production).

Choices:

  • false ← (default)

  • true