On July 01, 2024, support for CentOS 7 will end. From this date the platform and locations 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 a supported OS.

For a list of supported operating systems, see the Server requirements article.

  • This article contains actions not intended by the CentOS developers. The OS change procedure may not complete successfully.

  • The platform will be unavailable during the OS change process on the server with the platform.

Migration via DCImanager 6 backup


This section describes how to migrate from CentOS 7 to any supported OS. You can use this method to change the OS if the platform and location are on the same server. If the platform is on a separate server, you can only change the OS on the platform server. For instructions on how to change the OS on a location server, see the following article: If you need to reinstall the OS or replace the location server.

  1. Create a new token value for your license. You can do this in your client area at my.ispsystem.com or contact technical support.
  2. If both platform and location are on the server, move the etc/yum.repos.d/docer-ce.repo file to another directory or external media:

    mv etc/yum.repos.d/docer-ce.repo ~/exapmle_directory/.
    BASH
  3. Create a backup of the platform:

    dci backup
    BASH

    The backup will be saved in the /opt/ispsystem/dci/backup/ directory.

    If there is a location on the server in addition to the platform, back up the /opt/ispsystem/dci/os_templates/ directory.
  4. Save the backups to external media.
  5. Stop the platform:

    dci down
    BASH
  6. Install a supported OS.
  7. Connect to the server via SSH.
  8. If you do not have the tar archiver or curl utility installed on your system, install them:

    Ubuntu

    apt install tar
    apt install curl
    BASH

    AlmaLinux

    yum install tar
    yum install curl
    BASH
  9. Download the installer: 

    curl -O https://download.ispsystem.com/6/dci/dcibox/dci
    BASH
  10. Make the installer file executable:

    chmod +x dci
    BASH
  11. Create the /opt/ispsystem/license/ directory:

    mkdir -p /opt/ispsystem/license
    BASH
  12. Copy the previously created backup of the platform to the /opt/ispsystem/dci/backup/ directory.
  13. Start restoring the platform from the backup:

    ./dci restore -b=<backup_file>
    BASH
  14. Activate the license:
    1. In the DCImanager 6 interface, go to System overview.
    2. In the License token field, enter the value of the license token.
    3. Click the Activate button.
  15. If there is a location on the server in addition to the platform:
    1. Transfer a backup copy of the /opt/ispsystem/dci/os_templates/ directory.
    2. If the IP address of the server has changed, specify the new IP address in the location settings.
    3. If the server user's password has changed, specify the new password in the location settings.
  16. Reconfigure the locations if necessary.
  17. Update the database:

    docker exec -it mysql bash -c "mysql_upgrade -u root -p$MYSQL_ROOT_PASSWORD"
    BASH
  18. If both platform and location are on the server, move the docer-ce.repo file back to etc/yum.repos.d/.

Migration to AlmaLinux 8 without reinstalling DCImanager 6


This section describes how to migrate from CentOS 7 to AlmaLinux 8 using the Elevate software. You can use this method to change the OS if:

  • the platform and the location are on the same server;
  • the platform and locations are located on different servers. In this case, repeat the process on each server.

To perform the migration:

  1. Check the compatibility of the hardware with the AlmaLinux 8 OS. To do this, boot the AlmaLinux 8 OS in Live Media mode.
  2. Connect to the server via SSH.
  3. If both platform and location are on the server, move the etc/yum.repos.d/docer-ce.repo file to another directory or external media:

    mv etc/yum.repos.d/docer-ce.repo ~/exapmle_directory/.
    BASH
  4. Make a backup copy of the platform in case of malfunctions during the migration:

    dci backup
    BASH

    The backup will be saved in the /opt/ispsystem/dci/backup/ directory.

  5. Transfer the backup to external media.
  6. 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
    CODE
    sed -i s/^mirrorlist=http/#mirrorlist=http/g /etc/yum.repos.d/*.repo
    BASH
  7. Install the latest available software update:

    yum update -y
    BASH
  8. Reboot the server:

    reboot
    BASH
  9. Install Elevate:

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

    yum install -y leapp-upgrade leapp-data-almalinux
    BASH
  11. Check that the system is ready for the 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.

  12. Configure the Leapp framework:

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

    leapp upgrade
    BASH
  14. Reboot the server:

    reboot
    BASH

    Due to the OS change, the server may take longer than usual to reboot.

  15. If both platform and location are on the server, move the docer-ce.repo file back to etc/yum.repos.d/.
  16. Check the OS version:

    cat /etc/os-release
    BASH