3.3. Configuring the upgrade from RHEL 9.7 to RHEL 10.1 with LiveMode

Procedure

1. If you want to modify LiveMode’s default specifications, create a YAML file in the /etc/leapp/actor_conf.d/ file, for example livemode.yaml.

2. Enter the desired LiveMode configuration into the YAML file.

   Expand

   표 3.1. LiveMode configuration

   Configuration field	Value type	Default	Description
   additional_packages	List[str]	[]	Additional packages to be installed into the upgrade image.
   autostart_upgrade_after_reboot	bool	True	If set to True, the upgrade starts automatically after the reboot. Otherwise, a manual trigger is required.
   capture_strace_info_into	str	''	If set to a non-empty string, leapp is executed under strace and results are stored within the provided file path.
   dracut_network	str	''	Dracut network arguments. Required if the `url_to_load_squashfs_`from option is set to a non-empty string.
   setup_network_manager	bool	False	If set to False, the Leapp tool enables Network Manager in the upgrade image.
   setup_opensshd_using_auth_keys	str	''	If set to a non-empty string, openssh daemon is set up within the upgrade image using the provided authorized keys file.
   setup_passwordless_root	bool	False	If set to True, the root account of the upgrade image has an empty password. Use with caution.
   squashfs_image_path	str	/var/lib/leapp/live-upgrade.img	Desired location of the upgrade image of the minimal target system.
   url_to_load_squashfs_image_from	str	''	URL of the desired upgrade image.

   Show more

   The following is an example of a /etc/leapp/actor_conf.d/livemode.yaml file:

   livemode:
     additional_packages : [ vim ]
     autostart_upgrade_after_reboot : false
     setup_network_manager : true
     setup_opensshd_using_auth_keys : /root/.ssh/authorized_keys

   The example file results in the following actions:

   • The Leapp utility installs the vim package into the upgrade environment.
   • The upgrade does not start automatically after reboot. You must manually restart it. This allows you to manually inspect the system and verify that the upgrade finished as expected and the system is ready for use before starting.
   • The Leapp utility attempts to enable NetworkManager inside the upgrade environment by using the source system’s network profiles.
   • The Leapp utility enables the opensshd service. If the system establishes network access successfully, you can use SSH to log in to the upgrade environment by using the root account and interact with the system.