On July 01, 2024, support for CentOS 7 will end. From this date the platform and cluster nodes on servers with CentOS 7 OS are no longer supported. To keep the product support, you can change the OS of servers from CentOS 7 to AlmaLinux 8. The OS change is performed using Elevate software.

  • This article contains actions not intended by the CentOS developers. The OS change procedure may not perform successfully.
  • The platform will be unavailable during the OS change process on the server with the platform.
  • Virtual machines on a cluster node will be unavailable during the OS change process on that node.

Preparation

  1. Check the compatibility of the hardware with AlmaLinux 8 OS. To do this, boot the AlmaLinux OS in Live Media mode.
  2. If you change the OS on a cluster node, migrate virtual machines to another node. For more information, see Migration of virtual machines.
  3. Create a backup of the platform on external storage. For more information, see Creating platform backups.

OS change

  1. Connect to the server via SSH.

  2. As the main CentOS repository is unavailable, specify valid mirrors in the repository settings:

    sed -i s/mirror.centos.org/vault.centos.org/g /etc/yum.repos.d/*.repo
    BASH 
    sed -i s/^#.*baseurl=http/baseurl=http/g /etc/yum.repos.d/*.repo
    BASH 
    sed -i s/^mirrorlist=http/#mirrorlist=http/g /etc/yum.repos.d/*.repo
    BASH

  3. Install the latest available software update:

    yum update -y
    BASH

  4. Reboot the server:

    reboot
    BASH

  5. Install the Elevate software:

    yum install -y http://repo.almalinux.org/elevate/elevate-release-latest-el$(rpm --eval %rhel).noarch.rpm
    BASH

  6. Install the Leapp framework: 

    yum install -y leapp-upgrade leapp-data-almalinux
    BASH

  7. Check that the system is ready for an OS change:

    leapp preupgrade
    BASH

    Examine the output of the command and the report file /var/log/leapp/leapp-report.txt. They contain information about possible problems when changing OS.

  8. Configure the Leapp framework:

    rmmod pata_acpi
    BASH 
    leapp answer --section remove_pam_pkcs11_module_check.confirm=True
    BASH

  9. Start the OS change:

    leapp upgrade
    BASH

  10. Reboot the server:

    reboot
    BASH

    The server may reboot longer than usual due to the OS change.

  11. Check the OS version:

    cat /etc/os-release
    BASH

Actions after OS change on a cluster node

  1. Connect to the cluster node via SSH.

  2. Delete old repositories:

    rm /etc/yum.repos.d/ispsystem-base6.repo  /etc/yum.repos.d/CentOS-QEMU-EV.repo
    BASH
  3. Connect to the server with the platform via SSH.

  4. Change the firewall settings:

    docker exec -it vm_box bash
    BASH 
    cd /opt/ispsystem/vm
    BASH 
    /usr/bin/ansible-playbook -i <NODE IP>:22, -e targets=all -e ansible_python_interpreter='auto_silent' -e datacenter_type='common' -e ssh_port='22' -e network_autosetup_enabled='1' -e is_lxd='0' -e dc_ips='' -e dc_ips6='' -e closed_contour='0' etc/playbooks/node/firewall.yml --timeout 60 -b
    BASH

    <NODE_IP> — IP address of the cluster node

Useful tips

Related topics: