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/.

Useful tips