Migrating to Yandex Cloud with Hystax Acura

You can use Hystax Acura to migrate your cloud infrastructure to Yandex Cloud from another platform. To do so, you will need to create a Hystax Acura VM in your cloud. This VM will manage the migration process, while another VM running Hystax Acura Cloud Agent will migrate your third-party platform VMs to your cloud. Before the migration starts, the system will create VM replicas for infrastructure deployment during the migration process.

To perform the migration:

1. Get your cloud ready.
2. Create a service account and authorized key.
3. Configure the network traffic permissions.
4. Create a VM with Hystax Acura.
5. Configure Hystax Acura.
6. Prepare the Hystax Acura Cloud Agent.
7. Create VM replicas.
8. Create a migration plan.
9. Start migration.

If you no longer need the resources you created, delete them.

Get your cloud readyGet your cloud ready

Sign up for Yandex Cloud and create a billing account:

1. Go to the management console and log in to Yandex Cloud or create an account if you do not have one yet.
2. On the Yandex Cloud Billing page, make sure you have a billing account linked and it has the ACTIVE or TRIAL_ACTIVE status. If you do not have a billing account, create one.

If you have an active billing account, you can go to the cloud page to create or select a folder for your infrastructure to operate in.

Learn more about clouds and folders.

Required paid resourcesRequired paid resources

The cost of resources for Hystax Acura Migration includes:

• Fee for disks and continuously running VMs (see Yandex Compute Cloud pricing).
• Fee for storing images (see Compute Cloud pricing).
• Fee for a dynamic or static public IP address (see Yandex Virtual Private Cloud pricing).
• Fee for each completed migration (see product description in Cloud Marketplace).

Create a service account and authorized keyCreate a service account and authorized key

Hystax Acura Migration will run under a service account:

1. Create a service account named hystax-acura-account with the editor and marketplace.meteringAgent roles.
2. Create a service account authorized key.

Save the following details since you will need them in the next steps:

1. Service account ID.
2. Service account authorized key ID.
3. Service account private authorized key.

Configure network traffic rulesConfigure network traffic rules

Configure network traffic rules for the default security group. If it is unavailable, it will allow any inbound or outbound VM traffic.

If the default security group is available, add the following rules to it:

Save the security group ID You will need it when creating the Hystax Acura VM.

Create a VM with Hystax AcuraCreate a VM with Hystax Acura

Create a VM with a boot disk from the Hystax Acura Migration in Yandex Cloud image.

yc compute instance create \
  --name hystax-acura-vm \
  --zone <availability_zone> \
  --cores 8 \
  --memory 16 \
  --network-interface subnet-id=<subnet_ID>,nat-ip-version=ipv4,security-group-ids=<security_group_ID_if_group_set_up_previously> \
  --create-boot-disk name=hystax-acura-disk,size=200,image-id=<Hystax_Acura_image_ID> \
  --service-account-id <service_account_ID> \
  --ssh-key ~/.ssh/id_ed25519.pub

Configure Hystax AcuraConfigure Hystax Acura

1. In the management console, open the hystax-acura-vm VM page and find its public IP address.

2. Enter the hystax-acura-vm VM public IP address in your browser address bar. This will open the Hystax Acura initial setup screen.

   Note

   Booting the Hystax Acura Migration VM for the first time will trigger an installation process which may take over 20 minutes.

3. By default, a Hystax Acura VM has a self-signed certificate.

4. When the setup prompts you to fill out the user profile data, use the values below:

   • Organization: Name of your organization.
   • Admin user login: Email address you will use as the admin username.
   • Password: Admin password.
   • Confirm password: Re-enter the admin password.

5. Click Next.

6. Specify the Yandex Cloud connection settings:

   • Service account ID: ID of the service account.

   • Key ID: Service account authorized key ID.

   • Private key: Service account private key.

     Note

     If you obtained the ID and private key in a JSON file, e.g., when creating an authorized key via the CLI, remove the line break characters (\n) from the ID and the private key.

   • Default folder ID: Your folder ID.

   • Availability zone: hystax-acura-vm VM availability zone.

   • Hystax Service Subnet: hystax-acura-vm VM subnet ID.

   • Public IP address of the Hystax Acura control panel: Public IP address of hystax-acura-vm you got in step 1.

   • Additional parameters: Do not edit this field.

7. Click Next.

Hystax Acura will automatically check whether it can access your cloud. If everything is correct, you will be able to log in to the Hystax control panel with the email address and password you set previously.

Prepare and install migration agentsPrepare and install migration agents

You need to install migration agents on the VMs you will be migrating to Yandex Cloud. To download and install the agent, do the following:

1. If you are migrating from VMware ESXi, Microsoft Hyper-V, or any other hypervisor different from KVM, install virtio drivers on the VM before the migration.

2. In the Hystax Acura control panel, select the Download agent tab.

3. Select one of the agent types depending on your OS:

   • VMware
   • Windows
   • Linux

   Click Next.

4. Download and install the agent on the VMs you are migrating:

   VMware

   Windows

   Linux

   1. Select New VMware vSphere and fill out these fields:

      • Platform name: Name of your platform.
      • Host IP address: IP address of the VMware ESXi host where you will deploy the replication agent.
      • Login: Your login.
      • Password: Your password.

      Click Next.

   2. Click Download agent and wait for the download to complete.

   3. Unpack the downloaded OVA file to the VMs in your cluster.

   4. Start the VMs with the agent.

   1. Click Next.
   2. Click Download agent and wait for the download to complete.
   3. Unpack the archive and run hwragent.msi on the VMs you want to migrate.

   1. Select Linux distribution:
      • CentOS/RHEL (.rpm package): CentOS or Red Hat-based.
      • Debian/Ubuntu (.deb package).
   2. Select the driver installation method:
      • Pre-built: Install a driver binary.
      • DKMS: Compile the modules during installation.
   3. Click Next.
   4. You will get agent installation commands you can run following the instructions for your distribution and installation method.

The VM will appear in the target group a few minutes after the agent is installed.

Create VM replicasCreate VM replicas

Start replication:

1. Click the Hystax logo.
2. Under Machines Groups, select the virtual machines to replicate.
3. You can specify additional parameters for the network-ssd volume in the replication editing menu.
4. Click Bulk actions and in the menu that opens, select Start replication.

A VM replica will include all original VM data; therefore, replication can take around 40 minutes. You will be able to see the replication status in the Status column under Instance groups. Wait for the status to change to Synced and check whether there are VM replicas in the Compute Cloud list in your folder.

Create a migration planCreate a migration plan

When the VMs you are replicating switch to Synced, you can create a migration plan. The migration plan defines the list of VMs to migrate and the order in which they will start in your cloud.

1. Click Add Migration plan.
2. Specify the migration plan name: YC Migration.
3. Under Devices & Ranks, click . In the menu that opens, click Add machine, select the instance group and then the VM you want to add to the migration plan. Repeat the steps for all VMs you are going to migrate.
4. In the Subnet ID and the CIDR fields, specify the ID and CIDR of the subnet where the VMs will get connected after migration.
5. Expand the device description and specify the new VM parameters in the Flavor name field in this format: <platform>-<cpu>-<ram>-<core_fraction>, e.g., 2-8-16-100.
6. In the Port ip field, specify a new IP from the current subnet for the VM.
7. Click Save.

Start migrationStart migration

Perform the migration according to the plan:

1. Open the Migrate tab.
2. Select the YC Migration plan and click Next.
3. Specify CloudSite in the Cloud Site Name field.
4. Make sure all required resources are in the list and click Run migration.

The migration process may take about 10 minutes. You can see the status of the VMs being migrated in the Status column under Machines. Wait for the status to change to Running, then make sure all the resources have been transferred and your applications are ready to run. If the migrated infrastructure is working correctly, click Detach on the CloudSite page and confirm the detach action.

How to delete the resources you createdHow to delete the resources you created

To stop paying for the migration infrastructure:

1. Delete hystax-acura-vm.
2. Delete cloud-agent VMs.
3. Delete the hystax-acura-account service account.

If you reserved a public static IP address, delete it.