Overview
The migration service migrates VM operating systems and data from a source platform to ZStack ZSphere. This chapter describes migration from VMware vSphere environments. The source platform provides the VMs to migrate, data gateways transfer migration data, and the target platform hosts the migrated VMs.
Before using the migration service, upload its installation package, deploy the service, and upload the required VDDK packages. Then add the source platform. When creating migration tasks, check the source VMs and configure target resources. After data synchronization, you can create test VMs to verify the migration results before performing cutover. After migration, remove migration snapshots and tasks as needed.
Step 1: Upload the Migration Service Package
After uploading the installation package, the system automatically decompresses it and extracts the required files.
- Ensure that the migration service license is installed on the platform and that you have sufficient license capacity.
- Prepare the migration service installation package in .tar.gz format.
- Ensure that an image storage is added to the platform and that the image storage has sufficient storage space.
Step 2: Deploy the Migration Service
Select the appropriate resources for your business requirements and deploy the migration service. After deployment, upload the required VDDK packages before using the migration resource and task features.
After deployment, the migration service page displays Migration Overview and Service Management. Continue by uploading the VDDK packages from Migration Overview.
Step 3: Upload VDDK Packages
VMware licensing requires you to obtain and upload the VDDK packages yourself. The migration service must be enabled and VDDK uploads must be complete before you can access the migration resource and task pages.
- The migration service is deployed and enabled.
- You have the original VDDK 6.7.3 and 8.0.3 packages for Linux. Both files must be in .tar.gz format.
On Migration Overview, confirm that the VDDK status is Uploaded. Before you add a source platform, also verify that VDDK 6.7.3 and 8.0.3 are ready on the data gateway you will use. A completed package upload does not mean that distribution to every data gateway is complete.
Upgrade the Migration Service
- Ensure that no migration tasks are in progress. Otherwise, you cannot upgrade the migration service.
- Ensure that the image storage has sufficient storage space before you upload the migration service upgrade package.
- Prepare an upgrade package with a version higher than the current service version, in .tar.gz format.
Check the upgrade status on Migration Overview. If the upgrade fails, click Reupgrade:
- If the package was uploaded successfully but upgrade execution failed, select Use Existing Upgrade Package or Reupload Upgrade Package under Upgrade Method.
- If the upgrade package upload failed, upload the package again.
Review the configuration, click OK, and wait for the upgrade to finish.
Enable or Disable a Migration Gateway
Control the running state of a migration gateway VM from Service Management.
Delete a Migration Gateway
Delete a migration gateway VM that is no longer needed from Service Management.
- Only disabled migration gateways can be deleted.
Uninstall the Migration Service
When you no longer need the migration service, uninstall it from Migration Overview to remove its installation package and proxy configuration.
After uninstallation, the migration service page returns to the deployment entry point.
Add a Source Platform
The migration service is enabled and the required VDDK packages have been uploaded. The data gateway used to connect to the source platform must be available, with both VDDK 6.7.3 and 8.0.3 ready.
Check ESXi Hosts
After adding the source platform, use ESXi Host Precheck to investigate connection issues between the data gateway and individual ESXi hosts:
- On the Source Platform page, select the target platform and click .
- In the precheck dialog, expand a host to review the results and descriptions for DNS resolution, HTTPS port connectivity, and NFC port connectivity.
- If a check fails, resolve the corresponding network or DNS issue and click Recheck.
Delete a Source Platform
- In the navigation pane, select .
- On the Source Platform page, select the target source platform, and then click .
- Review the selected source platform and risk notice, then click OK to confirm deletion.
Add a Data Gateway
Deploy a data gateway as a new VM to connect to source platforms and transfer migration data.
After the gateway VM is created and connected, the system distributes VDDK to it. In the data gateway list, verify the connection status and readiness of VDDK 6.7.3 and 8.0.3.
If VDDK shows Distributing, wait for distribution to finish. If it shows Not ready or Installation failed, click Retry. If the version is shown as "-" with a query failure or timeout message, click Refresh to query it again.
Delete a Data Gateway
- In the navigation pane, select .
- On the Data Gateway page, select the target data gateway, and then click .
- After you read and confirm the risk information, click OK.
Create a Migration Task
Synchronize a Migration Task
After submitting the synchronization task, monitor its progress in the task list and wait for synchronization to complete.
Create a Test VM
Perform Cutover
- The migration task is in Ready for Cutover status.
- If the source VM's network configuration is cloned, power off the source VM before cutover or verify that automatic source VM shutdown is configured to avoid IP address conflicts.
After submitting the cutover request, monitor its progress and result in the task list.
View and Delete Migration Snapshots
After a migration task's cutover succeeds or fails, you can view its migration snapshots by disk and delete them when they are no longer needed.
The migration task is in Cutover Success or Cutover Failed status. You can view snapshots for only one migration task at a time.
After the snapshot deletion task finishes, check the list for any remaining snapshots. If a message indicates that the deletion result could not be confirmed, wait for the list to refresh and check again.
Delete a Migration Task
- Tasks in Pending Sync, Syncing, Sync Stopped, Sync Failed, or Ready for Cutover status proceed directly to deletion confirmation. The migration tasks and associated target instances are deleted.
- Tasks in Cutting Over, Cutover Success, or Cutover Failed status require a deletion policy first.
- These two categories cannot be deleted together in one batch. Select and delete them separately.

Note: