4.1. Converting from CentOS 7¶

To convert a CentOS 7 installation to VzLinux 8, do the following:

1. Log in as the root user.

2. Update the system:

   # yum update
   

3. Add the VzLinux repository. For example:

   # cat << EOF > /etc/yum.repos.d/vzlinux.repo
   [vzlinux]
   name=vzlinux
   baseurl=http://repo.virtuozzo.com/vzlinux/7.9/x86_64/os/
   enabled=1
   gpgcheck=0
   EOF
   

4. Install the conversion tool from the VzLinux repository:

   # yum install vzupgrade
   

5. Disable the VzLinux repository. For example:

   # yum-config-manager --disable vzlinux
   

6. Optionally, add custom executable files. Files placed in /usr/share/vzupgrade/pre-check will be run before the check stage (including vzupgrade check). Files placed in /usr/share/vzupgrade/pre-install will be run before the upgrade stage. All executable files are run in the alphabetical order.

7. Check that the system is ready for converting:

   # vzupgrade check --skip-vz
   No upgrade blockers found!
   <...>
   A report has been generated at /var/log/leapp/leapp-report.json
   A report has been generated at /var/log/leapp/leapp-report.txt
   <...>
   Answerfile has been generated at /var/log/leapp/answerfile
   

   This command will imitate the conversion, downloading the required RPM packages in the process.

   If issues are found, investigate the logs in /var/log/leapp. In addition, note the packages that are marked as unknown. They may be removed during the upgrade.

8. Once no blockers have been found and the system is ready, launch the conversion:

   # vzupgrade install --skip-vz
   <...>
   A reboot is required to continue. Please reboot your system.
   A report has been generated at /var/log/leapp/leapp-report.json
   A report has been generated at /var/log/leapp/leapp-report.txt
   <...>
   Answerfile has been generated at /var/log/leapp/answerfile
   

   The upgrade tool will perform preparation steps and ask you to reboot to the kernel Vz-Upgrade-Initramfs to perform the upgrade.

9. Reboot to the VzLinux 8 kernel.