4.1. Converting from CentOS 7

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

  1. Log in as the root user.

  2. Update the system:

    # yum update
    
  3. Add the Virtuozzo Linux 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 Virtuozzo Linux repository:

    # yum install vzupgrade
    
  5. Disable the Virtuozzo Linux 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 Virtuozzo Linux 8 kernel.