search

SUSE / suse-migration-services

GNU General Public License v3.0
7 stars 11 forks source link

Issue in "Installation" #266

Open m0rbo opened 1 year ago

m0rbo commented 1 year ago

Installation:

https://documentation.suse.com/suse-distribution-migration-system/15/single-html/distribution-migration-system/#id-installation

rewrite: The distribution migration system RPMs are available from the Public Cloud module. Therefore the Public Cloud module must be enabled on the system prior to upgrade. For running on-demand instances this module is already enabled.

Note: For data center customers it is recommended to continue to use the documented offline distribution upgrade using the next distribution version installation media.

The distribution migration process can be invoked using different 2 methods.

  1. Via the "run_migration" command. One method of activating the migration is the "run_migration" command included with the "SLES15-Migration" package.

OR

  1. Via the "reboot" method. The second method to invoking the migration process is via "reboot" after installing the "suse-migration-sle15-activation" and "SLES15-Migration" package (both packages are needed for this method).

To install the distribution migration system "run_migration" option only run:

tux > sudo zypper in SLES15-Migration The run_migration uses kexec to boot into the kernel delivered with the upgrade image delivered by the SLES15-Migration package. Once this system is live, after the kexec, the distribution migration process is automatically started. However, kexec is not supported and does not function in certain conditions. The run_migration utility does not work in Xen based environments.

To install the distribution migration system "reboot" option run:

tux > sudo zypper in SLES15-Migration suse-migration-sle15-activation Starting the migration via "reboot" after installing the suse-migration-sle15-activation package covers the Xen use case but does not work in cases where there is no direct access to the root file system from the bootloader or on architectures other than x86_64. During installation of the suse-migration-sle15-activation package the bootloader configuration is modified such that on the next boot the system will boot into the upgrade image. This in turns starts the automated distribution migration process.

m0rbo commented 1 year ago

I forgot to add a link for this TID to the "run_migration" section. replace the above with this paragraph: tux > sudo zypper in SLES15-Migration The run_migration uses kexec to boot into the kernel delivered with the upgrade image delivered by the SLES15-Migration package. Once this system is live, after the kexec, the distribution migration process is automatically started. However, kexec is not supported and does not function in certain conditions. The run_migration utility does not work in Xen based environments. If kexec causes a kernel panic this can cause the system to hang and the distribution migration to fail. In that case refer to this TID: https://www.suse.com/support/kb/doc/?id=000019733 And set the "soft_reboot" customization option: echo "soft_reboot: false" >> /etc/sle-migration-service.yml