VMmanager 6: Administrator guide

How to move VMmanager to a new server?

ISPSystem

To move VMmanager from one server to another you need to perform two steps:

  1. Import VMmanager data.
  2. Import the domain name if it assigned to the source server.

Step 1. Import VMmanager data


Note

If you do not need to migrate statistics data, you can back up the platform on the source server and recovery backup data on the target server. For more information, see Creating platform backups.

  1. On the target server:
    1. Install VMmanager. Learn more in the article Installation.
    2. Suspend VMmanager and delete the containers:

      docker-compose -f /opt/ispsystem/vm/docker-compose.yaml down
    3. Delete the data created by the installer:

      rm -rf /opt/ispsystem/vm/mysql /opt/ispsystem/vm/clickhouse /opt/ispsystem/vm/config.json
      
    4. Check that the nodes and virtual machines of the source server are accessible from the target server. Edit the firewall configuration if needed.
  2. On the source server:

    1. Stop VMmanager and delete its docker containers:

      vm down
    2. Move the directories /opt/ispsystem/vm/mysql/, /opt/ispsystem/vm/telegram-srv/, /opt/ispsystem/vm/clickhouse/ and the file /opt/ispsystem/vm/config.json to the target server. For example:

      Move the data using rsync
      rsync -avzP /opt/ispsystem/vm/{mysql,clickhouse,config.json} user@1.2.3.4:/opt/ispsystem/vm/

      user  the username on the target server;

      1.2.3.4   the IP address of the target server.

      Be sure to transfer the config.json file to the destination server.

      Directories:

      • mysql  be sure to transfer to the destination server;
      • telegram-srv — to be transferred if integration with telegram is configured;
      • clickhouse  to be transferred if it is necessary to preserve the statistics;
      • socket and consul — do not need to be transferred.

      Note

       rsync must be installed both on the source and target servers.

    3. Stop and deactivate VMmanager service:

      systemctl stop vm
      systemctl disable vm
  3. Start VMmanager on the target server: 

    vm start
  4. If the migration was successful, remove the platform from the source server:
    1. Stop VMmanager service and disable it: 

      systemctl stop vm.service
      systemctl disable vm.service
    2. Delete the information about the platform operation:  

      rm /opt/ispsystem/vm -rf
    3. Remove the installed docker images and containers: 

      docker system prune -a -f

Step 2. Move the domain name


  1. Edit the A-record: change the IP address of the source server into the IP of the target one.
  2. If an SSL certificate is connected to the domain, copy its files from the source server to the target one.

Note

Create a temporary subdomain while you are moving the domain. If your SSL certificate doesn't support Wildcard, receive a free Let's Encrypt certificate for the subdomain. 

Thank you for your feedback!
Was the article useful?
Tell us why not:

it does not match the title

it was hard to understand

I didn't find the answer

recommendations from the article did not help

other

Tell us what you didn't like in the article: