Migrating from CentOS 7

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.

Create a new token value for your license. You can do this in your client area at my.ispsystem.com or contact technical support.
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/.
```
Create a backup of the platform:
```
dci backup
```
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.
Save the backups to external media.
Stop the platform:
```
dci down
```
Install a supported OS.
Connect to the server via SSH.
If you do not have the tar archiver or curl utility installed on your system, install them:
Ubuntu
```
apt install tar
apt install curl
```
AlmaLinux
```
yum install tar
yum install curl
```

Download the installer:

curl -O https://download.ispsystem.com/6/dci/dcibox/dci

Make the installer file executable:
```
chmod +x dci
```
Create the /opt/ispsystem/license/ directory:
```
mkdir -p /opt/ispsystem/license
```
Copy the previously created backup of the platform to the /opt/ispsystem/dci/backup/ directory.
Start restoring the platform from the backup:
```
./dci restore -b=<backup_file>
```
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.
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.
Reconfigure the locations if necessary.

Update the database:

docker exec -it mysql bash -c "mysql_upgrade -u root -p$MYSQL_ROOT_PASSWORD"

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:

Check the compatibility of the hardware with the AlmaLinux 8 OS. To do this, boot the AlmaLinux 8 OS in Live Media mode.
Connect to the server via SSH.
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/.
```
Make a backup copy of the platform in case of malfunctions during the migration:
```
dci backup
```
The backup will be saved in the /opt/ispsystem/dci/backup/ directory.
Transfer the backup to external media.

Specify valid mirrors in the repository settings:

sed -i s/mirror.centos.org/vault.centos.org/g /etc/yum.repos.d/*.repo

sed -i s/^#.*baseurl=http/baseurl=http/g /etc/yum.repos.d/*.repo

sed -i s/^mirrorlist=http/#mirrorlist=http/g /etc/yum.repos.d/*.repo

Install the latest available software update:
```
yum update -y
```
Reboot the server:
```
reboot
```

Install ELevate:

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

Install the Leapp framework:

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

Check that the system is ready for the OS change:
```
leapp preupgrade
```
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.

Configure the Leapp framework:

rmmod pata_acpi

leapp answer --section remove_pam_pkcs11_module_check.confirm=True

Start the OS change:
```
leapp upgrade
```
Reboot the server:
```
reboot
```
Due to the OS change, the server may take longer than usual to reboot.
If both platform and location are on the server, move the docer-ce.repo file back to etc/yum.repos.d/.
Check the OS version:
```
cat /etc/os-release
```

Useful tips