Changing the OS of an existing DCImanager 6 installation

The article describes transferring existing platforms and locations to a different operating system with data preservation. The instructions are suitable, in particular, for migration from an unsupported OS.

For the transfer, you will need temporary storage for the platform and location files. For example, cloud storage or an external hard drive.

Backing up the platform and required directories

To transfer the platform:

1. Connect to the server with the platform via SSH. For more information about connecting via SSH, see Workstation setup.

2. If the tar archiver or curl utility is not installed on the system, install them:

   apt install tar curl

3. Perform the backup:

   dci backup

   The backup will be saved in the /opt/ispsystem/dci/backup directory. Before backing up, ensure sufficient free space is available on the disk partition containing the /tmp directory. For information on determining required free space, see the article Creating platform backups.

4. Stop the DCImanager 6 service:

   dci down

5. Move the backup file to any external storage:
   
   Example command for uploading to an external drive

   mv /opt/ispsystem/dci/backup/<backup_file_name> /media/<hard_drive>/.

   Comments

   <hard_drive> — path to the external drive;

   <backup_file_name> — archive file in .tar.gz format.

   Example command for uploading to an FTP server

   curl -T /opt/ispsystem/dci/backup/<backup_file_name> -u "user:password" sftp://<ftp.example.com>/<file_path>/

   Comments

   <ftp.example.com> — domain name or IP address of the FTP server;<user:password> — username and password for the FTP server;<file_path> — path to the directory where the backup file should be saved.<backup_file_name> — archive file in .tar.gz format.

6. If a location is also installed on the platform server, and you use any templates besides those from the ISPsystem repository, create a backup of the /opt/ispsystem/dci/os_templates/ directory according to the instructions in the Transferring a location section.
7. Create a backup of the /opt/ispsystem/dci/clickhouse_storage directory:
   

   tar -cvzf /opt/ispsystem/dci/clickhouse_storage.tar.gz /opt/ispsystem/dci/clickhouse_storage

8. Move the /opt/ispsystem/dci/clickhouse_storage.tar.gz archive to external storage.
9. Install a new OS on the server.

Restoring the platform after installing a new OS

1. Generate a new license token.

   You can do this in the my.ispsystem.com personal account or contact technical support.

2. Connect to the platform server via SSH. For details about SSH connection, see the article Setting up a workstation.
3. Update the operating system to the latest stable version:
   

   sudo apt update && sudo apt upgrade -y

4. If the tar archiver or curl utility is not installed on the system, install them:

   apt install tar curl

5. Download the installer:

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

6. Make the installer file executable:

   chmod +x dci

7. Start the restoration:

   ./dci restore -b=<backup_file>

8. If the backup archive is password-protected, enter it.

9. Restore the /opt/ispsystem/dci/clickhouse_storage directory:

   1. Comments

      <backup_file> — full path to the backup archive. For example, /opt/ispsystem/dci/backup/2022_03_30__00_00.tar.gz

      Transfer the clickhouse_storage.tar.gz archive from external storage to the platform server:

      Example command for downloading from an external drive

      mv /media/<hard_drive>/clickhouse_storage.tar.gz /opt/ispsystem/dci/backup/.

      Comments

      <hard_drive> — path to the external drive.

      Example command for downloading from an FTP server

      curl -o "/opt/ispsystem/dci/clickhouse_storage.tar.gz" -u "user:password" sftp://<ftp.example.com>/<file_path>/clickhouse_storage.tar.gz

      Comments

      <ftp.example.com> — domain name or IP address of the FTP server;
      <user:password> — username and password for the FTP server.
   2. Extract the downloaded file:
      

      tar -xvzf /opt/ispsystem/dci/clickhouse_storage.tar.gz

10. If the server's domain name has changed:
    
    1. Specify the new domain name in the DomainName parameter of the /opt/ispsystem/dci/config.json file
    2. Restart the platform:
       

       dci restart

11. Activate the license:
    
    1. In the DCImanager 6 interface, go to → System Overview.
    2. In the License key field, enter the license token.
    3. Click the Activate button.

Transferring a location

1. Connect to the location server via SSH. For more information about connecting via SSH, see Workstation setup.
2. If you use any templates besides those from the ISPsystem repository:
   1. Create a backup of the /opt/ispsystem/dci/os_templates/ directory:
      

      tar -cvzf /opt/ispsystem/dci/os_templates.tar.gz /opt/ispsystem/dci/os_templates/

   2. Transfer the /opt/ispsystem/dci/os_templates.tar.gz archive to external storage:
      
      Example command for uploading to an external drive

      mv /opt/ispsystem/dci/os_templates.tar.gz /media/<hard_drive>/.

      Comments

      <hard_drive> — path to the external drive.

      Example command for uploading to an FTP server

      curl -T /opt/ispsystem/dci/os_templates.tar.gz -u "<user:password>" sftp://<ftp.example.com>/<file_path>/

      Comments

      <ftp.example.com> — domain name or IP address of the FTP server;<user:password> — username and password for the FTP server;<file_path> — path to the directory where the backup file should be saved.

   If you use only templates from the ISPsystem repository, there is no need to back up the /opt/ispsystem/dci/os_templates/ directory.
3. Install a new OS on the server.
4. If you backed up the /opt/ispsystem/dci/os_templates directory, restore it:
   
   1. Transfer the os_templates.tar.gz archive to the location server from storage:
      
      Example command for downloading from an external drive

      mv /media/<hard_drive>/os_templates.tar.gz /opt/ispsystem/dci/backup/.

      Comments

      <hard_drive> — path to the external drive.

      Example command for downloading from an FTP server

      curl -o "/opt/ispsystem/dci/os_templates.tar.gz" -u "<user:password>" sftp://<ftp.example.com>/<file_path>/os_templates.tar.gz

      Comments

      <ftp.example.com> — domain name or IP address of the FTP server;
      <user:password> — username and password for the FTP server;
      <file_path> — directory where the file should be downloaded from the server.
   2. Extract the downloaded file:
      

      tar -xvzf /opt/ispsystem/dci/os_templates.tar.gz