The script expenv-check verifies settings for the system's GPUs and CPUs
specified on the command line. These can be:
The CPU scaling governor
GPU autoboost
GPU core frequency
GPU memory frequency
By default, settings are only checked and the script fails if the actual
settings and the expected settings do not match. If the --force flag is
specified, the script tries to enfore the specified settings by invoking
appropriate tools (cpufreq-set and nvidia-smi) and only fails if the actual
settings do not match the specified settings in a second check after
modification.
Forcing settings might require certain system settings if expenv-check is
invoked as a user other than root. The installation script expenv-install
provides a setup procedure:
Install appropriate systemd services:
nvidia-disable-autoboost: Disables GPU autoboost by default
nvidia-enable-persistence: Enables persistence mode for GPU settings
nvidia-permissions-autoboost: Allows any user to enable/disable autoboost
nvidia-permissions-freqs: Allows any user to set GPU core/memory frequencies
Install a sudo configuration file (cpufreq-set-non-root), allowing users of
the group "cpufreq" to invoke cpufreq-set with root privileges and without
entering a password
Add the group "cpufreq" if necessary
Install a modprobe configuration file (nvidia-cupti-allow-nonadmin.conf) that
allows any user to use nvidia CUPTI
The installation is done by simply invoking the installation script as root,
e.g.:
$ cd tools/expenv
$ sudo ./expenv-install
A reboot might be necessary after the installation. Users that should be able to
set CPU scaling governors must be added to the group "cpufreq".
The script expenv-check verifies settings for the system's GPUs and CPUs specified on the command line. These can be:
By default, settings are only checked and the script fails if the actual settings and the expected settings do not match. If the --force flag is specified, the script tries to enfore the specified settings by invoking appropriate tools (cpufreq-set and nvidia-smi) and only fails if the actual settings do not match the specified settings in a second check after modification.
Forcing settings might require certain system settings if expenv-check is invoked as a user other than root. The installation script expenv-install provides a setup procedure:
Install appropriate systemd services:
Install a sudo configuration file (cpufreq-set-non-root), allowing users of the group "cpufreq" to invoke cpufreq-set with root privileges and without entering a password
Add the group "cpufreq" if necessary
Install a modprobe configuration file (nvidia-cupti-allow-nonadmin.conf) that allows any user to use nvidia CUPTI
The installation is done by simply invoking the installation script as root, e.g.:
$ cd tools/expenv $ sudo ./expenv-install
A reboot might be necessary after the installation. Users that should be able to set CPU scaling governors must be added to the group "cpufreq".