PDF

OS Migration

Why AlmaLinux?

Since CentOS 8 is no longer supported since 01.01.2022, you will no longer be able to perform system updates on your DCM host.
The new base OS used by the DCM server is AlmaLinux 8 (https://almalinux.org) which is 100% binary compatible with CentOS 8 and will be supported until at least 2029.

The Migration Script

We provide a migration script that automates the process of converting your host from CentOS 8 to AlmaLinux 8.
The script performs the following steps:

  1. Verify OS name and version
  2. Delete CentOS related GPG keys and repositories
  3. Delete CentOS specific packages
  4. Download compatible AlmaLinux release package
  5. Adjust Redis 6 package source
  6. Perform a distro-sync (this can take a while, since old packages are being removed, upgraded and installed)
  7. Cleanup operations (remove old boot-entries, fix Redis config file location)

Performing the migration

Important

We highly recommend that you backup or snapshot your host before running the migration to avoid any unforseen loss of data!

  1. Login to your ecm host via ssh
  2. The configurator will appear, navigate to the Quit menuitem and press Enter
  3. Run the migration script using
    bash <(curl https://repo.tgfw.de/ECM/scripts/migrate_centos.sh)
  4. A confirmation prompt should appear:
    MigrationConfirm
    Press y to confirm
  5. Wait until the migration script terminates and a prompt appears asking your for a reboot
    MigrationRebootConfirm
  6. Press y to confirm and wait for the system to reboot