VK Cloud logo
Updated atMay 18, 2023   11:25 AM

Migration using Hystax Acura

Before migrating your infrastructure to VK Cloud, you must:

  • download and install the migration agent;
  • configure the Migration plan, which specifies which hosts will be migrated.

Install the migration agent

The first step is to install the migration agent on the machine that will be migrated later. There are migration agents for both Windows and Linux.

On the main screen of the Hystax Acura user account and proceed to install the agent. You will be asked questions about the operating system of the replicated host, and in the last step you will receive a link to download the agent and installation instructions. Once the Migration Agent is successfully installed and launched, it will connect to the Hystax Acura installation.

On the Customer page, this host will appear in the Machine Groups section. The "Discovered" status indicates that this host has been discovered, but replication has not yet taken place.

Now you can start host replication. To do this, click on "..." and select "Start Replication" in the drop-down menu. The migration process can take a long time, depending on the amount of data on disk and network bandwidth. Upon successful completion of the replication process, the status of the replicated host is marked as "Synced".

Once the host data has been replicated, the hosts themselves can be migrated to the target cloud. To do this, you need to create a migration plan (Migration plan), which will indicate which hosts will be migrated.

Set up a migration plan

Now you can configure the migration options. To do this, click "..." and select "Edit Replication settings" in the drop-down menu. A window will appear in which you can specify the migration schedule and parameters such as Volume Type and Volume availability zone. Specify Volume type "dp1-ssd" and click "Save".

To create a migration plan, click "Add Migration plan". Go to the "Expert" tab and click on "Generate Migration plan from all machines". A migration plan will be generated in the form of a JSON document containing a description of all hosts added to the personal account with the default parameter value.

The migration plan should be adjusted to suit your deployment requirements for hosts migrating to the target project. An example of a migration plan for two hosts:

2  subnets: {
3    "subnet_0": {
4      "name": "subnet_0",
5      "cidr": "",
6      "subnet_id": "2aebd081-44a8-480f-xxxx-yyyyyyyyyyyy"
7    }
8  },
9  "devices": {
10    "ubuntu01": {
11      "id": "ec09a435-3389-d19f-4cf4-zzzzzzzzzz",
12      "security_groups": [
13        "default_all"
14      ],
15      "availability_zone": "MS1",
16      "rank": 0
17      "flavor": "Standard-4-8-80",
18      "ports": [
19        {
20          "name": "port_0",
21          "ip": "",
22          "floating_ip": true,
23          "subnet": "subnet_0"
24        }
25      ]
26    },
27    centos01: {
28      "id": "a40d5ef3-e244-dab5-9df0-aaaaaaaaaaaa",
29      "security_groups": [
30        "default_all"
31      ],
32      "availability_zone": "DP1",
33      "rank": 0
34      "flavor": "Standard-4-8-80",
35      "ports": [
36        {
37          "name": "port_0",
38          "ip": "",
39          "floating_ip": true,
40          "subnet": "subnet_0"
41        }
42      ]
43    }
44  }

This plan describes two hosts, and the subnet where these hosts will be deployed.

There are two objects at the top level of the document:

  • subnets – contains description of target project subnets to which migrating hosts will be connected.
  • devices - contains a description of the hosts that will be deployed in the target project. You can specify the desired flavor type, host security groups, host data center, start order, and also redefine the subnet and ip address of the migrating host.

A detailed description of these and other migration plan options can be found in official documentation of Hystax Acura.

Next, specify the name of the migration plan and click the "Save" button.

After completing the creation and configuration of the migration plan, proceed to start migration of the protected infrastructure.

Run migration

After adding a migration plan indicating the hosts to be migrated, as well as setting the parameters with which these hosts will be deployed in the target project (network settings, security_groups, flavor), you can start the migration process:

  1. In your Hystax Acura account, select a migration plan and click the "Run migration" button.
  2. In the run migration wizard, specify the name of the Cloud Site and click on the "Run migration" button. Cloud Site is the entity of host deployment according to the migration plan.

The deployment process takes time, depending on the size of the target migration plan. As a result of the successful completion of the migration process, Cloud Site will go into the "Synced" state, and the infrastructure will be migrated to the VK Cloud cloud. A certain amount of consumed resources will be displayed in the personal account of the cloud.

If errors are detected as a result of the deployment (wrong parameters for hosts were specified in the migration plan or not all hosts were specified), then you can delete all the created resources, and then make the necessary changes to the migration plan and restart the migration process. To do this, select Cloud Site and click the "Delete" button.

If no defects were found, "disconnect" the Cloud Site from Hystax Acura by clicking the "Detach" button.