Migrating DCImanager 6 to a new server

The article contains instructions on how to migrate the platform to another server. If the platform and the location are on the same server, the location will be migrated along with the platform.

If you need to migrate the location to a new server, follow the steps in the knowledge base article If you need to reinstall the OS or replace the location server.

Migration steps

To migrate DCImanager 6 to a new server:

Generate a new token in your client area eu.ispsystem.com.
On the source server:
1. Perform a backup:
```
dci backup
```
  The backup will be saved in the directory/opt/ispsystem/dci/backup.
2. Stop the DCImanager 6 service:
```
dci down
```
3. Transfer the archive file to the destination server:
```
 rsync -avzP /opt/ispsystem/dci/backup/<archive_file_name> user@1.2.3.4:/root/ 
```
  Comments
  
  1.2.3.4 — IP address of the destination server;
  user — user name at the destination server;
  <archive_file_name> — archive file in the .tar.gz. format.
  
  Note
  The rsync utility must be installed on both the source and destination server.
On the destination server:
1. Connect to the server via SSH with superuser permissions (root by default).
2. Download the installer:
```
curl -O https://download.ispsystem.com/6/dci/dcibox/dci
```
3. Make it executable:
```
chmod +x dci
```
4. Start the recovery:
```
./dci restore -b /root/<имя_файла_архива>
```
  Comments
  <archive_file_name> — archive file in the .tar.gz. format.
  Note
  Be sure to specify the full path to the archive file.
5. When the installation is complete, move the /opt/ispsystem/dci/clickhouse_storage directory from the source server:
```
rsync -avzP user@1.2.3.4:/opt/ispsystem/dci/clickhouse_storage /opt/ispsystem/dci
```
  Comments
  
  user — user name on the source server;
  1.2.3.4 — IP address of the source server.
6. Make the installer a service:
```
./dci make-service
```
7. In the DCImanager 6 interface:
  1. In the right menu click → System information.
  2. In the License key field enter the value of the license token.
  3. Click the Activate button.
If patches were applied to the platform:
1. Move the patch files to the destination server.
2. For each patch, run the command on the destination server:
```
dci add-patch -f <path_to_patch> -p <patch_name>
```
  Comments to the command
  
  <path_to_patch> — full path to the patch file
  <patch_name> — arbitrary patch name
If the migration was successful, remove the platform from the source server:
1. Stop DCImanager 6 service and disable it:
```
systemctl stop dci.service
```
```
systemctl disable dci.service
```
2. Delete the information about the platform operation:
```
rm /opt/ispsystem/dci -rf
```
3. Remove the installed docker images and containers:
```
docker system prune -a -f
```