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 in Yandex Cloud and create a billing account:

1. Navigate to the management console and log in to Yandex Cloud or register a new account.
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 and link a cloud to it.

If you have an active billing account, you can navigate 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 an authorized key for the service account.

Save the following details to use at the next steps:

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

Configure the network traffic permissionsConfigure the network traffic permissions

Configure the network traffic permissions in the default security group. If it is unavailable, any inbound or outbound VM traffic will be allowed.

If a 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. Open the hystax-acura-vm VM page in the management console and find its public IP address.

2. Enter the hystax-acura-vm VM public IP address in your browser. 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 for logging in to the admin panel.
   • 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): Ubuntu or Debian.
   2. Select the driver installation method:
      • Pre-built: Install a driver binary.
      • DKMS: Compile as you install.
   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 the secondary cloud-agent VMs.
3. Delete the hystax-acura-account service account.

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