Migrating to Yandex Cloud using Hystax Acura
You can use Hystax Acura to migrate your cloud infrastructure to Yandex Cloud from another cloud platform. To do so, you will need to create a VM with Hystax Acura in your cloud. This VM will be used to manage the migration setup and run, while the migration process itself will be performed by a service VM with Hystax Acura Cloud Agent. This service VM will migrate your VMs to your cloud. Before VM migration starts, VM replicas are created. Those replicas will be used for infrastructure deployment during migration.
To migrate VMs:
- Prepare your cloud.
- Create a service account and authorized key.
- Configure network traffic permissions.
- Create a VM with Hystax Acura.
- Set up Hystax Acura.
- Set up Hystax Acura Cloud Agent.
- Create VM replicas.
- Create a migration plan.
- Start migration.
If you no longer need the resources you created, delete them.
Prepare your cloud
Sign up for Yandex Cloud and create a billing account:
- Go to the management console
and log in to Yandex Cloud or create an account if you do not have one yet. - On the Yandex Cloud Billing
page, make sure you have a billing account linked and it has theACTIVE
orTRIAL_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
Learn more about clouds and folders.
Required paid resources
Note
Note that the infrastructure for Hystax Acura and Hystax Acura Cloud Agent and all the migrated VMs will be charged and counted against the quotas
- A Hystax Acura VM uses 8 vCPUs, 16 GB of RAM, and a 200-GB disk.
- A Hystax Acura Cloud Agent VM uses 2 vCPUs, 4 GB of RAM, and an 8-GB disk.
The cost of the resources required to use Hystax Acura Live Migration includes:
- Fee for disks and continuously running VMs (see Yandex Compute Cloud pricing).
- Fee for storing images (see Compute Cloud pricing).
- Fee for using 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 key
Hystax Acura Live Migration will run under a service account:
- Create a service account named
hystax-acura-account
with theeditor
andmarketplace.meteringAgent
roles. - Create an authorized key for the service account.
Save the following details to use in the next steps:
- Service account ID.
- Service account authorized key ID.
- Service account private authorized key.
Configure network traffic permissions
Configure network traffic permissions in the default security group. If a security group is unavailable, any incoming or outgoing VM traffic will be allowed.
If a security group is available, add to it the following rules:
Traffic direction |
Description | Port range | Protocol | Source / Destination name |
CIDR blocks |
---|---|---|---|---|---|
Incoming | http |
80 |
TCP |
CIDR |
0.0.0.0/0 |
Incoming | https |
443 |
TCP |
CIDR |
0.0.0.0/0 |
Incoming | https |
4443 |
TCP |
CIDR |
0.0.0.0/0 |
Incoming | vmware |
902 |
TCP |
CIDR |
0.0.0.0/0 |
Incoming | vmware |
902 |
UDP |
CIDR |
0.0.0.0/0 |
Incoming | iSCSI |
3260 |
TCP |
CIDR |
0.0.0.0/0 |
Incoming | udp |
12201 |
UDP |
CIDR |
0.0.0.0/0 |
Incoming | tcp |
15000 |
TCP |
CIDR |
0.0.0.0/0 |
Outgoing | http |
80 |
TCP |
CIDR |
0.0.0.0/0 |
Outgoing | https |
443 |
TCP |
CIDR |
0.0.0.0/0 |
Outgoing | vmware |
902 |
TCP |
CIDR |
0.0.0.0/0 |
Outgoing | vmware |
902 |
UDP |
CIDR |
0.0.0.0/0 |
Outgoing | iSCSI |
3260 |
TCP |
CIDR |
0.0.0.0/0 |
Outgoing | udp |
12201 |
UDP |
CIDR |
0.0.0.0/0 |
Save the security group ID. You will need it when creating VMs with Hystax Acura.
Create a VM with Hystax Acura
Create a VM with a boot disk from the Hystax Acura Live Migration to Yandex Cloud image:
-
In the management console
, select the folder to create your VM in. -
In the list of services, select Compute Cloud.
-
In the left-hand panel, select
Virtual machines. -
Click Create virtual machine.
-
Under Boot disk image:
- Go to the Marketplace tab.
- Click Show all Marketplace products.
- In the public image list, select Hystax Acura Live Cloud Migration to Yandex Cloud and click Use.
-
Under Location, select an availability zone to place your VM in.
-
Under Disks and file storages, enter
200 GB
for boot disk size. -
Under Computing resources, select the configuration with
8 vCPU
and16 GB
. -
Under Network settings:
-
In the Subnet field, enter the ID of a subnet in the new VM’s availability zone. Alternatively, you can select a cloud network from the list.
-
Each network must have at least one subnet. If there is no subnet, create one by selecting Create subnet.
-
If you do not have a network, click Create network to create one:
- In the window that opens, enter the network name and select the folder to host the network.
- (Optional) Select the Create subnets option to automatically create subnets in all availability zones.
- Click Create network.
-
-
If a list of Security groups is available, select the security group you had previously configured network traffic permissions for. If this list does not exist, all incoming and outgoing traffic will be enabled for the VM.
-
-
Under Access, select SSH key and specify the information required to access the VM:
- In the Login field, enter a username, e.g.,
yc-user
. -
In the SSH key field, select the SSH key saved in your organization user profile.
If there are no saved SSH keys in your profile, or you want to add a new key:
- Click Add key.
- Enter a name for the SSH key.
- Upload or paste the contents of the public key file. You need to create a key pair for the SSH connection to a VM yourself.
- Click Add.
The SSH key will be added to your organization user profile.
If users cannot add SSH keys to their profiles in the organization, the added public SSH key will only be saved to the user profile of the VM being created.
- In the Login field, enter a username, e.g.,
-
Under General information, specify the VM name:
hystax-acura-vm
. -
Under Additional, select the
hystax-acura-account
service account. -
Click Create VM.
If you do not have the Yandex Cloud command line interface yet, install and initialize it.
The folder specified in the CLI profile is used by default. You can specify a different folder using the --folder-name
or --folder-id
parameter.
In the terminal, run the following command:
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
Where:
-
name
: VM name, e.g.,hystax-acura-vm
. -
zone
: Availability zone, e.g.,ru-central1-a
. -
cores
: Number of vCPUs the VM has. -
memory
: VM RAM size. -
network-interface
: VM network interface description:-
subnet-id
: Subnet to connect your VM to.You can get the list of subnets using the
yc vpc subnet list
CLI command. -
nat-ip-version=ipv4
: Connect a public IP address. -
security-group-ids
: Security groups.You can get the list of groups using the
yc vpc security-group list
command. If you skip this parameter, the default security group will be assigned.
-
-
create-boot-disk
: Create a new disk for the VM:-
name
: Disk name, e.g.,hystax-acura-disk
. -
size
: Disk size. -
image-id
: Disk image ID.For this example, use
image_id
from the product description in Cloud Marketplace.
-
-
service-account-id
: ID of the previously created service account.You can get the list of accounts using the
yc iam service-account list
command. -
ssh-key
: Path to the public SSH key file.
Set up Hystax Acura
-
Open the
hystax-acura-vm
VM page in the management console and find its public IP address. -
Enter the
hystax-acura-vm
VM public IP address in your browser. This will open the initial setup screen for Hystax Acura.Note
Booting the Hystax Acura Live Cloud Migration VM for the first time will start an installation process which can take over 20 minutes.
-
By default, a Hystax Acura VM has a self-signed certificate installed.
-
When you are prompted to fill out the fields, 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.
-
Click Next.
-
Specify the Yandex Cloud connection settings:
-
Service account ID: ID of the service account.
-
Key ID: ID of the service account authorized key.
-
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: ID of your folder.
-
Availability zone: Availability zone hosting the
hystax-acura-vm
VM. -
Hystax Service Subnet: ID of the subnet the
hystax-acura-vm
VM is connected to. -
S3 host:
storage.yandexcloud.net
. -
S3 port:
443
. -
Enable HTTPS: Select this option to enable HTTPS connections.
-
Public IP address of the Hystax Acura management console:
hystax-acura-vm
public IP address. Replace the value in this field with the IP address obtained in Step 1. -
Additional parameters: Additional parameters. Do not edit this field.
-
-
Click Next.
Hystax Acura will automatically check whether it can access your cloud. If everything is correct, you can now log on to the Hystax Control Panel using the specified email address and password.
Prepare and install agents for migration
The agents are normally installed onto VMs to be migrated to Yandex Cloud. To download and install an agent:
-
If you are migrating from VMware ESXi, Microsoft Hyper-V, or any other hypervisor different from KVM, make sure to install virtio drivers on the VM before performing migration.
-
In the Hystax Acura admin panel, click the Download agent tab.
-
Choose one of the agent types depending on the OS:
- VMware
- Windows
- Linux
Click Next.
-
Download and install the agent on the VMs you would like to migrate:
VMwareWindowsLinux-
Select New VMware vSphere and fill in these fields:
- Platform name: Platform name.
- Host IP address: IP address of the VMware ESXi host where to deploy the replication agent.
- Login: Login.
- Password: Password.
Click Next.
-
Click Download agent and wait for the download to complete.
-
Unpack the downloaded OVA agent file to the VMs in your cluster.
-
Start the VMs with the agent.
- Click Next.
- Click Download agent and wait for the download to complete.
- Unpack the archive and install the agent from
hwragent.msi
on the VMs you want to migrate.
- Select Linux distribution type:
- CentOS/RHEL (.rpm package): CentOS or Red Hat-based.
- Debian/Ubuntu (.deb package): Ubuntu or Debian.
- Select driver install method:
- Pre-built: Install a driver binary.
- DKMS: Compile as you install.
- Click Next.
- You will get commands for installing the agent to the VM. Run these commands following the instructions for your distribution and installation method.
-
The VM will show up in the target group a few minutes after the agent is installed.
Create VM replicas
Alert
When replication starts, Hystax Acura creates a new VM with Hystax Acura Cloud Agent in the cloud to run all operations in your cloud.
Start replication:
- Click the Hystax logo.
- Under Machines Groups, select the virtual machines to replicate.
- You can specify additional parameters for the
network-ssd
volume in the replication editing menu. - Click Bulk actions and in the menu that opens, select Start replication.
A VM replica will include all the data of the original VM; therefore, replication can take a long time (about 40 minutes). The replication status will be displayed in the Status column under Machines Groups. Wait for the status to change to Synced
and make sure you can see the new replicas of the selected VMs in the Compute Cloud VM list in your folder.
Create a migration plan
As soon as the VMs you are replicating switch to Synced
, you can create a migration plan. The migration plan defines which machines should be migrated to your cloud and their start order after migration.
- Click Add Migration plan.
- Enter the migration plan name:
YC Migration
. - Under Devices & Ranks, click
. In the menu that opens, click Add machine, pick the VM group you need, and select the VM you want to add to the migration plan. Repeat the steps for all VMs to migrate. - In the Subnet ID and the CIDR fields, specify the ID and CIDR of the subnet the VMs will be connected to following the migration.
- Expand the device description and edit the Flavor name field (the new VM's parameters) as follows:
<platform>-<cpu>-<ram>-<core_fraction>
, e.g.,2-8-16-100
. - In the Port ip field, enter a new VM IP from the current subnet.
- Click Save.
Start migration
Perform the migration as per the created plan:
- Open the Migrate tab.
- Select the
YC Migration
plan and click Next. - Enter
CloudSite
in the Cloud Site Name field. - Make sure all required resources are in the list and click Run migration.
The migration process might take about 10 minutes. The status of the VM being migrated will be displayed in the Status column under Machines. Wait for the status to change to Running
, then make sure all required resources have been transferred and your applications are ready to run. If the migrated infrastructure is running as expected, click Detach on the CloudSite page and confirm the detach action.
How to delete the resources you created
To stop paying for the migration infrastructure:
- Delete
hystax-acura-vm
. - Delete the secondary
cloud-agent
VMs. - Delete the
hystax-acura-account
service account.
If you reserved a public static IP address, delete it.