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. Install the latest available software update:

    yum update -y
    BASH
  3. Reboot the server:

    reboot
    BASH
  4. Install the Elevate software:

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

    yum install -y leapp-upgrade leapp-data-almalinux
    BASH
  6. 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.

  7. Configure the Leapp framework:

    rmmod pata_acpi
    BASH
    leapp answer --section remove_pam_pkcs11_module_check.confirm=True
    BASH
  8. Start the OS change:

    leapp upgrade
    BASH
  9. Reboot the server:

    reboot
    BASH
  10. 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