add handling for LVM configuration

The relevant user LVM configuration is now copied into the target userspace
container along with enabling LVM dracut module for upgrade initramfs creation.
The LVM configuration is copied into the target userspace container when
lvm2 package in installed. Based on the configuration, the devices file
is also copied in when present and enabled. The --nolvmconf option used when
executing dracut is changed into --lvmconf instead if the files are
copied into the target userspace container.

Jira: RHEL-14712

Author: PeterMocary

repos/system_upgrade/common/actors/checklvm/actor.py

@@ -0,0 +1,24 @@
+from leapp.actors import Actor
+from leapp.libraries.actor.checklvm import check_lvm
+from leapp.models import DistributionSignedRPM, LVMConfig, TargetUserSpaceUpgradeTasks, UpgradeInitramfsTasks
+from leapp.reporting import Report
+from leapp.tags import ChecksPhaseTag, IPUWorkflowTag
+
+
+class CheckLVM(Actor):
+    """
+    Check if the LVM is installed and ensure the target userspace container
+    and initramfs are prepared to support it.
+
+    The LVM configuration files are copied into the target userspace container
+    so that the dracut is able to use them while creating the initramfs.
+    The dracut LVM module is enabled by this actor as well.
+    """
+
+    name = 'check_lvm'
+    consumes = (DistributionSignedRPM, LVMConfig)
+    produces = (Report, TargetUserSpaceUpgradeTasks, UpgradeInitramfsTasks)
+    tags = (ChecksPhaseTag, IPUWorkflowTag)
+
+    def process(self):
+        check_lvm()

repos/system_upgrade/common/actors/checklvm/libraries/checklvm.py

@@ -0,0 +1,74 @@
+import os
+
+from leapp import reporting
+from leapp.libraries.common.rpms import has_package
+from leapp.libraries.stdlib import api
+from leapp.models import (
+    CopyFile,
+    DistributionSignedRPM,
+    DracutModule,
+    LVMConfig,
+    TargetUserSpaceUpgradeTasks,
+    UpgradeInitramfsTasks
+)
+
+LVM_CONFIG_PATH = '/etc/lvm/lvm.conf'
+LVM_DEVICES_FILE_PATH_PREFIX = '/etc/lvm/devices'
+
+
+def _report_filter_detection():
+    title = 'LVM filter definition detected.'
+    summary = (
+        'RHEL 9 and above uses the LVM devices file by default to select devices used by LVM. '
+        f'Since this system has LVM filter defined in the {LVM_CONFIG_PATH}, it will be '
+        'used after the upgrade as well.'
+    )
+
+    remediation_hint = (
+        'While not mandatory, switching to the LVM devices file from the LVM filter is possible '
+        'using the following command. It uses the existing LVM filter to create the system.devices '
+        'file which is then used instead of the LVM filter as long as it exists. Before running the command, '
+        'make sure that the use_devicesfile=1 (default for RHEL 9 and above).'
+    )
+    remediation_command = ['vgimportdevices', '-a']
+
+    reporting.create_report([
+        reporting.Title(title),
+        reporting.Summary(summary),
+        reporting.Remediation(hint=remediation_hint, commands=[remediation_command]),
+        reporting.ExternalLink(
+            title='Limiting LVM device visibility and usage',
+            url='https://red.ht/3MfgK7c',
+        ),
+        reporting.Severity(reporting.Severity.INFO),
+    ])
+
+
+def check_lvm():
+    if not has_package(DistributionSignedRPM, 'lvm2'):
+        return
+
+    lvm_config = next(api.consume(LVMConfig), None)
+    if not lvm_config:
+        return
+
+    lvm_devices_file_path = os.path.join(LVM_DEVICES_FILE_PATH_PREFIX, lvm_config.devices.devicesfile)
+    lvm_devices_file_exists = os.path.isfile(lvm_devices_file_path)
+
+    filters_used = not lvm_config.devices.use_devicesfile or not lvm_devices_file_exists
+    if filters_used:
+        _report_filter_detection()
+
+    api.current_logger().debug('Including lvm dracut module.')
+    api.produce(UpgradeInitramfsTasks(include_dracut_modules=[DracutModule(name='lvm')]))
+    # TODO: decide if we need to install lvm2 package in the container as well
+
+    copy_files = []
+    api.current_logger().debug('Copying "{}" to the target userspace.'.format(LVM_CONFIG_PATH))
+    copy_files.append(CopyFile(src=LVM_CONFIG_PATH))
+
+    if lvm_devices_file_exists and lvm_config.devices.use_devicesfile:
+        api.current_logger().debug('Copying "{}" to the target userspace.'.format(lvm_devices_file_path))
+        copy_files.append(CopyFile(src=lvm_devices_file_path))
+
+    api.produce(TargetUserSpaceUpgradeTasks(copy_files=copy_files))

repos/system_upgrade/common/actors/checklvm/tests/test_checklvm.py

@@ -6,6 +6,7 @@
     BootContent,
     FIPSInfo,
     LiveModeConfig,
+    LVMConfig,
     TargetOSInstallationImage,
     TargetUserSpaceInfo,
     TargetUserSpaceUpgradeTasks,
@@ -31,6 +32,7 @@ class UpgradeInitramfsGenerator(Actor):
     consumes = (
         FIPSInfo,
         LiveModeConfig,
+        LVMConfig,
         RequiredUpgradeInitramPackages,  # deprecated
         TargetOSInstallationImage,
         TargetUserSpaceInfo,

repos/system_upgrade/common/actors/initramfs/upgradeinitramfsgenerator/actor.py

@@ -12,6 +12,7 @@
 from leapp.models import (
     BootContent,
     LiveModeConfig,
+    LVMConfig,
     TargetOSInstallationImage,
     TargetUserSpaceInfo,
     TargetUserSpaceUpgradeTasks,
@@ -363,20 +364,29 @@ def generate_initram_disk(context):
     def fmt_module_list(module_list):
         return ','.join(mod.name for mod in module_list)
 
+    env_variables = [
+        'LEAPP_KERNEL_VERSION={kernel_version}',
+        'LEAPP_ADD_DRACUT_MODULES="{dracut_modules}"',
+        'LEAPP_KERNEL_ARCH={arch}',
+        'LEAPP_ADD_KERNEL_MODULES="{kernel_modules}"',
+        'LEAPP_DRACUT_INSTALL_FILES="{files}"'
+    ]
+
+    if next(api.consume(LVMConfig), None):
+        env_variables.append('LEAPP_DRACUT_LVMCONF="1"')
+
+    env_variables = ' '.join(env_variables)
+    env_variables = env_variables.format(
+        kernel_version=_get_target_kernel_version(context),
+        dracut_modules=fmt_module_list(initramfs_includes.dracut_modules),
+        kernel_modules=fmt_module_list(initramfs_includes.kernel_modules),
+        arch=api.current_actor().configuration.architecture,
+        files=' '.join(initramfs_includes.files)
+    )
+    cmd = os.path.join('/', INITRAM_GEN_SCRIPT_NAME)
+
     # FIXME: issue #376
-    context.call([
-        '/bin/sh', '-c',
-        'LEAPP_KERNEL_VERSION={kernel_version} '
-        'LEAPP_ADD_DRACUT_MODULES="{dracut_modules}" LEAPP_KERNEL_ARCH={arch} '
-        'LEAPP_ADD_KERNEL_MODULES="{kernel_modules}" '
-        'LEAPP_DRACUT_INSTALL_FILES="{files}" {cmd}'.format(
-            kernel_version=_get_target_kernel_version(context),
-            dracut_modules=fmt_module_list(initramfs_includes.dracut_modules),
-            kernel_modules=fmt_module_list(initramfs_includes.kernel_modules),
-            arch=api.current_actor().configuration.architecture,
-            files=' '.join(initramfs_includes.files),
-            cmd=os.path.join('/', INITRAM_GEN_SCRIPT_NAME))
-    ], env=env)
+    context.call(['/bin/sh', '-c', f'{env_variables} {cmd}'], env=env)
 
     boot_files_info = copy_boot_files(context)
     return boot_files_info

repos/system_upgrade/common/actors/initramfs/upgradeinitramfsgenerator/libraries/upgradeinitramfsgenerator.py

@@ -0,0 +1,18 @@
+from leapp.actors import Actor
+from leapp.libraries.actor import scanner
+from leapp.models import DistributionSignedRPM, LVMConfig
+from leapp.tags import FactsPhaseTag, IPUWorkflowTag
+
+
+class ScanLVMConfig(Actor):
+    """
+    Scan LVM configuration.
+    """
+
+    name = 'scan_lvm_config'
+    consumes = (DistributionSignedRPM,)
+    produces = (LVMConfig,)
+    tags = (FactsPhaseTag, IPUWorkflowTag)
+
+    def process(self):
+        scanner.scan()

repos/system_upgrade/common/actors/scanlvmconfig/actor.py

@@ -0,0 +1,53 @@
+import os
+import re
+
+from leapp.libraries.common.config.version import get_source_major_version
+from leapp.libraries.common.rpms import has_package
+from leapp.libraries.stdlib import api
+from leapp.models import DistributionSignedRPM, LVMConfig, LVMConfigDevicesSection
+
+LVM_CONFIG_PATH = '/etc/lvm/lvm.conf'
+
+
+def _lvm_config_devices_parser(lvm_config_lines):
+    in_section = False
+    config = {}
+    for line in lvm_config_lines:
+        line = line.split("#", 1)[0].strip()
+        if not line:
+            continue
+        if "devices {" in line:
+            in_section = True
+            continue
+        if in_section and "}" in line:
+            in_section = False
+        if in_section:
+            value = line.split("=", 1)
+            config[value[0].strip()] = value[1].strip().strip('"')
+    return config
+
+
+def _read_config_lines(path):
+    with open(path) as lvm_conf_file:
+        return lvm_conf_file.readlines()
+
+
+def scan():
+    if not has_package(DistributionSignedRPM, 'lvm2'):
+        return
+
+    if not os.path.isfile(LVM_CONFIG_PATH):
+        api.current_logger().debug('The "{}" is not present on the system.'.format(LVM_CONFIG_PATH))
+        return
+
+    lvm_config_lines = _read_config_lines(LVM_CONFIG_PATH)
+    devices_section = _lvm_config_devices_parser(lvm_config_lines)
+
+    lvm_config_devices = LVMConfigDevicesSection(use_devicesfile=int(get_source_major_version()) > 8)
+    if 'devicesfile' in devices_section:
+        lvm_config_devices.devicesfile = devices_section['devicesfile']
+
+    if 'use_devicesfile' in devices_section and devices_section['use_devicesfile'] in ['0', '1']:
+        lvm_config_devices.use_devicesfile = devices_section['use_devicesfile'] == '1'
+
+    api.produce(LVMConfig(devices=lvm_config_devices))

repos/system_upgrade/common/actors/scanlvmconfig/libraries/scanner.py

@@ -0,0 +1,26 @@
+from leapp.models import fields, Model
+from leapp.topics import SystemInfoTopic
+
+
+class LVMConfigDevicesSection(Model):
+    """The devices section from the LVM configuration."""
+    topic = SystemInfoTopic
+
+    use_devicesfile = fields.Boolean()
+    """
+    Determines whether only the devices in the devices file are used by LVM. Note
+    that the default value changed on the RHEL 9 to True.
+    """
+
+    devicesfile = fields.String(default="system.devices")
+    """
+    Defines the name of the devices file that should be used. The default devices
+    file is located in '/etc/lvm/devices/system.devices'.
+    """
+
+
+class LVMConfig(Model):
+    """LVM configuration split into sections."""
+    topic = SystemInfoTopic
+
+    devices = fields.Model(LVMConfigDevicesSection)