Skip to content

Environment variables

Michal Bocek edited this page Aug 14, 2024 · 18 revisions

CONVERT2RHEL_DISABLE_TELEMETRY

Important

No longer in the codebase. Instead we print the below information about what data is being collected.

Removed under https://github.com/oamg/convert2rhel/pull/1102.

The convert2rhel utility uploads the following data about the system conversion to Red Hat servers for the purpose of the utility usage analysis:

  • The Convert2RHEL command as executed
  • The Convert2RHEL RPM version and GPG signature
  • Success or failure status of the conversion
  • Conversion start and end timestamps
  • Source OS vendor and version
  • Target RHEL version
  • Convert2RHEL related environment variables\n To disable the data collection, use the CONVERT2RHEL_DISABLE_TELEMETRY=1 environment variable.

CONVERT2RHEL_PACKAGE_UP_TO_DATE_CHECK_SKIP

Important

No longer in the codebase - removed under https://github.com/oamg/convert2rhel/pull/1026.

Override a failure in checking if the installed packages are up to date.

CONVERT2RHEL_OUTDATED_PACKAGE_CHECK_SKIP

Override an inhibitor triggered by outdated packages being found on the system.

CONVERT2RHEL_SKIP_KERNEL_CURRENCY_CHECK

Note

Renamed from CONVERT2RHEL_UNSUPPORTED_SKIP_KERNEL_CURRENCY_CHECK

Skip the check that makes sure that the latest available kernel is installed and the system is booted to it.

CONVERT2RHEL_INCOMPLETE_ROLLBACK

Note

Renamed from CONVERT2RHEL_UNSUPPORTED_INCOMPLETE_ROLLBACK

When performing the pre-conversion analysis, convert2rhel needs to remove certain packages. Before removing them though it downloads them from the repositories enabled on the system for their subsequent reinstallation at the end of the analysis or when the conversion unexpectedly stops. When unable to download the package backups the conversion execution stops because a complete rollback without the package backups. If you accept the risk, set CONVERT2RHEL_INCOMPLETE_ROLLBACK=1. This variable is ignored when running the analysis (convert2rhel analyze).

CONVERT2RHEL_ALLOW_UNAVAILABLE_KMODS

Convert2rhel checks if all the loaded kernel modules are available in RHEL repositories. If not, the conversion is blocked because we can't tell if the system would run correctly without the unavailable kernel module after the conversion. If you accept the risk, set CONVERT2RHEL_ALLOW_UNAVAILABLE_KMODS=1 to proceed with the conversion.

CONVERT2RHEL_ALLOW_OLDER_VERSION

Skip the check that makes sure that the convert2rhel version is of the latest version available.

CONVERT2RHEL_CONFIGURE_HOST_METERING

Decide whether to install, enable and start host-metering on the system based on the environment variable value. Host-metering will be configured on systems running in AWS, GCP, and Azure.

Current values can be set and what they do:

  • "auto": host-metering will be configured based on the conditions in the codebase
  • "force": forces configuration of host-metering (e.g., even if not running on a hyperscaler)
  • env var not present: host-metering will not be configured
  • any other value: Will be ignored and host metering will not be configured.

NO_COLOR

Disables ANSI coloring of the output in the terminal. The colors used are green (\033[92m or \u001b[92m) for separating sections of the conversion process, blue for informational messages, yellow for warnings, and red for errors.

CONVERT2RHEL_TAINTED_KERNEL_MODULE_CHECK_SKIP

Allows the conversion even when there's a tainted kernel module loaded tainted.