Skip to content

HYCU Migration Path — Runbook ​

Step-by-step migration runbook using HYCU. Execute one batch of 8–10 VMs at a time.


Section 1 — HYCU Setup ​

1.1 Deploy HYCU Controller VM ​

  1. Download the HYCU appliance image (QCOW2 for AHV) from the HYCU customer portal
  2. In Prism, create a new VM: 4 vCPU, 8 GB RAM, 256 GB disk
  3. Assign a static IP on the management VLAN; verify DNS resolution in both directions
  4. Power on the VM — HYCU boots within a few minutes
  5. Open a browser: https://<hycu-ip>:8443
  6. Set admin password, accept EULA, apply your HYCU license key

1.2 Add Nutanix Cluster as Source ​

=== "Nutanix AHV"

1. In HYCU web console → **Administration → Sources → Add Source**
2. Select **Nutanix AHV**
3. Enter Prism Element cluster VIP or FQDN
4. Provide Nutanix Cluster Admin credentials
5. HYCU validates connectivity and auto-discovers all VMs, volume groups, and Nutanix Files shares
6. Verify VM inventory shows the expected count

=== "Nutanix ESXi"

1. In HYCU web console → **Administration → Sources → Add Source**
2. Select **VMware vSphere**
3. Enter vCenter or ESXi FQDN
4. Provide vSphere service account credentials
5. HYCU discovers all VMs managed by vCenter

1.3 Configure Backup Target ​

  1. HYCU console → Administration → Targets → Add Target
  2. Select target type (SMB, NFS, S3, or iSCSI) and provide connection details and credentials
  3. Test the connection and save
  4. Size the target for the total used disk of the concurrent batch + 20% overhead

1.4 Register Hyper-V Host as Restore Target ​

  1. HYCU console → Administration → Targets → Add Target
  2. Select Microsoft Hyper-V
  3. Enter Hyper-V host FQDN and provide domain or local admin credentials
  4. HYCU discovers available storage paths and virtual switches on the Hyper-V host
  5. Set the default restore path (e.g., D:\Restored) and default virtual switch
  6. Verify the connection shows healthy

Section 2 — Create Backup Policies (Per Batch) ​

  1. HYCU console → Policies → Create Policy
  2. Name: Use MIG-Batch01-VMs001-010, MIG-Batch02-VMs011-020, etc.
  3. Assign VMs: Select exactly 8–10 VMs for this batch
  4. Schedule: Daily incrementals; set a manual or scheduled full backup time
  5. Retention: Keep at least the latest restore point (short retention is fine for migration-only use)
  6. Run Initial Full Backup: Trigger the first full backup immediately. Monitor progress.

Initial full backup time varies with VM disk size and backup target bandwidth (typically 2–12 hours per batch on first run).


Section 3 — Hop 1 Cutover Procedure (Per Batch) ​

WARNING

Do not delete source VMs Source Nutanix VMs are your rollback point. Do NOT decommission them until the batch is fully validated on Azure Local.

!!! info "Hop 1 downtime starts at VM power-off and ends when the restored VM is running and validated on Hyper-V" Typical Hop 1 downtime: 30 minutes to 4+ hours per VM depending on disk size and storage throughput. Plan approximately 1 hour per 200 GB of VM used disk at 10 GbE speeds. Establish your baseline in the PoC.

3.1 Pre-Cutover ​

  1. Notify stakeholders — maintenance window begins for this batch
  2. Trigger a manual incremental backup to capture the latest changes
  3. Wait for the incremental to complete successfully

3.2 Cutover Steps ​

  1. Power off source VMs on Nutanix (in Prism or vCenter)
  2. Trigger one more manual incremental backup to capture final dirty blocks from shutdown
  3. Restore to Hyper-V:
    • In HYCU console, select each VM → Restore → Restore to Hyper-V
    • Select the Hyper-V staging host registered in step 1.4
    • Select the restore storage path and virtual switch
    • HYCU automatically converts disk format to VHDX during restore
  4. Monitor restore progress in the HYCU console
  5. Power on the restored VMs on Hyper-V

3.3 Re-IP After Restore (If Subnets Differ) ​

NOTE

HYCU does not have built-in re-IP rules Unlike Veeam, HYCU does not inject new IP addresses during restore. If your Hyper-V staging network uses different subnets, apply IP changes immediately after the VM boots on Hyper-V — before running the validation checks or proceeding to Hop 2.

powershell
# Example: Update IP post-restore (Windows)
Set-NetIPAddress -InterfaceAlias "Ethernet" -IPAddress "10.0.2.50" -PrefixLength 24
Set-DnsClientServerAddress -InterfaceAlias "Ethernet" -ServerAddresses "10.0.0.10"

For Linux VMs, update /etc/netplan/*.yaml or the appropriate network config file for the distro.

3.4 Hop 1 Completion Gate ​

CAUTION

Stop here — do not proceed to Hop 2 until all Hop 1 validation checks pass See Hop 1 Go / No-Go Sign-off for the full checklist. Each VM must be independently validated.

3.5 Rollback (If Needed) ​

If Hyper-V validation fails:

  1. Power off the restored Hyper-V VMs
  2. Delete the restored VMs from the Hyper-V host
  3. Power the source Nutanix VMs back on in Prism/vCenter
  4. Investigate the issue, adjust, and retry the restore

Section 4 — Azure Migrate Setup (Hop 2) ​

NOTE

Azure Migrate for Azure Local is in Preview The native Hyper-V → Azure Local migration path via Azure Migrate uses a dual appliance architecture and is currently in Preview (requires Azure Local 2503+). Both a source appliance (on the Hyper-V host) and a target appliance (on the Azure Local cluster) are required. Data does not leave your datacenter.

4.1 Prepare Azure Local Prerequisites ​

Before deploying appliances, confirm on the Azure Local cluster:

  1. Azure Local instance deployed, Arc-registered, and healthy
  2. A custom storage path created for the Arc resource bridge (VM configuration and OS disks)
  3. A logical network created for the Arc resource bridge for migrated VMs
  4. Contributor + User Access Administrator roles granted on the subscription for the Azure Migrate project

4.2 Create Azure Migrate Project ​

  1. Azure portal → Azure Migrate → Create Project
  2. Project name: use IIC naming (e.g., nutanix-to-azl-migration)
  3. Subscription: tied to Azure Local cluster registration
  4. Resource Group: rg-iic-migration-01

4.3 Deploy the Source Appliance (Hyper-V Host) ​

  1. Azure Migrate → Discover → select Hyper-V and Azure Local as the target
  2. Download the Azure Migrate source appliance VHD (16 GB RAM, 8 vCPU, 80 GB disk)
  3. Create a VM on the Hyper-V staging host using this VHD
  4. Boot and configure via browser wizard on port 44368
  5. Register with the Azure Migrate project key
  6. Add Hyper-V host credentials; start discovery

4.4 Deploy the Target Appliance (Azure Local Cluster) ​

  1. In Azure Migrate project → Deploy target appliance
  2. Download and deploy the Azure Migrate target appliance on the Azure Local cluster
  3. Register the target appliance with the same project key
  4. Associate with the Azure Local custom location, storage path, and logical network
  5. Verify both appliances show as Connected in the Azure Migrate portal

Section 5 — Azure Migrate Replication and Cutover (Hop 2) ​

NOTE

Hop 2 downtime starts when VMs are shut down for final delta sync and ends when Azure Local VMs pass validation Typical cutover downtime: 30–60 minutes per batch of 10 VMs.

5.1 Start Replication ​

  1. Azure Migrate → Replicate → Source: Hyper-V | Target: Azure Local
  2. Select Azure Local cluster, custom storage path, and logical network
  3. Select the 10 restored Hyper-V VMs; set target VM names (original names); set virtual switch
  4. Click Replicate — wait for Protected state (initial replication runs in background; VMs stay running on Hyper-V)

5.2 Test Migration ​

  1. Select all 10 VMs → Test Migration → select isolated test network
  2. Validate all VMs (see Hop 2 Validation)
  3. Clean up test migration after validation

5.3 Production Cutover ​

NOTE

Downtime begins here for Hop 2 Azure Migrate shuts down the Hyper-V VMs, performs a final delta sync, then creates Azure Local VMs. Expected time: 30–60 minutes per batch of 10 VMs.

  1. Select all 10 VMs → Migrate
  2. Toggle Shutdown VMs before migration = Yes
  3. Azure Migrate performs final delta sync and creates Azure Local VMs
  4. Confirm VMs are visible in Azure portal as Azure Local VMs
  5. Validate (see Hop 2 Validation)
  6. Click Complete Migration

Section 6 — Cleanup ​

After the batch is fully validated on Azure Local:

  1. Delete the restored Hyper-V VMs to free staging storage
  2. Delete HYCU backup policies for this batch (or disable them) to free backup target storage
  3. Begin the next batch (return to Section 2)
  4. Source Nutanix VMs: keep powered off during the holding period; decommission after it expires

Batch Execution Tracker ​

BatchVMsFull BackupRestore to HVHV ValidationAzure MigrateAzure LocalStatus
Batch 01VM001–VM010—————Not Started
Batch 02VM011–VM020—————Not Started
Batch 03VM021–VM030—————Not Started
Batch 04–30...—————Not Started

Released under the MIT License.