Skip to main content

Creating a Hyper-V VM from VHDX Disks

To run Kraken in a Hyper-V environment, you must first verify that the Windows host has met the Hyper-V system hardware requirements, and then enable the Hyper-V feature:

image-20250424-225200.png

The Kraken VM for Hyper-V is available as two sets of VHDX disks:

  • BIOS version: This set, which supports BIOS boot, consists of two files (kraken-<version>_<build nmuber>_<tag>.vhdx and kraken-<version>_<build nmuber>_<tag>-1.vhdx) which can be used to create a Generation 1 VM.

  • EFI version: This set, which supports UEFI boot, consists of two files (kraken-<version>_<build nmuber>_<tag>_efi.vhdx and kraken-<version>_<build nmuber>_<tag>_efi-1.vhdx) which can be used to create a Generation 2 VM.

Note

The following setup examples are based on the Hyper-V version for Windows 10 Enterprise.

Setting up a Generation 1 VM

  1. In the Hyper-V Manager, click New->Virtual Machine to open the New Virtual Machine Wizard:

    image-20250424-202944.png
  2. Click Next:

    image-20250424-203135.png
  3. Specify a Name and physical disk Location, and then click Next:

    image-20250424-203301.png
  4. Choose Generation 1, and then click Next:

    image-20250424-203355.png
  5. Assign Memory, and then click Next:

    image-20250424-203454.png
  6. Under Configure Networking, select an external virtual switch, and then click Next:

    image-20250424-203640.png
  7. Under Connect Virtual Hard Disk, add the primary Kraken VHDX disk (BIOS version) by choosing Use an existing virtual hard disk and then clicking Browse to locate the primary .vhdx file (kraken-<version>_<build nmuber>_<tag>.vhdx). When done, click Next:

    image-20250424-203828.png
  8. Review the Summary, and then click Finish:

    image-20250424-203918.png
  9. Once the Kraken VM is created, click Settings:

    image-20250424-204056.png
  10. Select an IDE Controller (the default for Generation 1). Click Add to add an additional Hard Drive (this will be Kraken’s secondary BIOS VHDX disk):

    image-20250424-204224.png
  11. Click Browse to locate the secondary .vhdx file (kraken-<version>_<build nmuber>_<tag-1>.vhdx). When done, click Apply:

    image-20250424-204332.png
  12. In the Hyper-V Manager, under the list of actions for the VM click Start to boot up the Kraken VM instance:

    image-20250424-204527.png
  13. Double-click the VM’s console icon to bring up the console UI (Kraken CUI) in a new browser window:

    image-20250424-204736.png

Setting up a Generation 2 VM

  1. In the Hyper-V Manager, click New->Virtual Machine to open the New Virtual Machine Wizard:

    image-20250424-202944.png
  2. Click Next:

    image-20250424-203135.png
  3. Specify a Name and physical disk Location, and then click Next:

    image-20250424-203301.png
  4. Choose Generation 2, and then click Next:

    image-20250424-205257.png
  5. Assign Memory, and then click Next:

    image-20250424-205358.png
  6. Under Configure Networking, select an external virtual switch, and then click Next:

    image-20250424-205454.png
  7. Under Connect Virtual Hard Disk, add the primary Kraken VHDX disk (EFI version) by choosing Use an existing virtual hard disk and then clicking Browse to locate the primary .vhdx file (kraken-<version>_<build nmuber>_<tag>_efi.vhdx). When done, click Next:

    image-20250424-205622.png
  8. Review the Summary, and then click Finish:

    image-20250424-205707.png
  9. Once the Kraken VM is created, click Settings:

    image-20250424-205806.png
  10. Select an SCSI Controller (the default for Generation 2). Click Add to add an additional Hard Drive (this will be Kraken’s secondary EFI VHDX disk):

    image-20250424-210029.png
  11. Click Browse to locate the secondary .vhdx file (kraken-<version>_<build nmuber>_<tag>_efi-1.vhdx). When done, click Apply:

    image-20250424-210125.png
  12. Un-check Enable Secure boot to disable secure boot, and then click Apply:

    image-20250424-210244.png

Note

Generation 2 Linux virtual machines will not boot unless the secure boot option is disabled.

  1. In the Hyper-V Manager, under the list of actions for the VM click Start to boot up the Kraken VM instance:

    image-20250424-210424.png
  2. Double-click the VM’s console icon to bring up the console UI (Kraken CUI) in a new browser window:

    image-20250424-211040.png

Note

Haivision VM images use two disks: Disk 1 is thin-provisioned and set up to grow up to 185GB; Disk 2 is thin-provisioned up to 10GB and should be replaced by your organization's preferred asset storage, NFS mount, or VM storage disk.

Important

Reserve sufficient virtual resources (CPU, RAM, NIC, and HD) to avoid adverse effects to system performance. For improved performance, configure your VM with more CPU cores and a larger memory.

Minimum VM specifications

  • 4 CPU cores, 4 GB memory, 185GB storage on disk 1, 10GB storage on disk2.

  • Be aware that the default virtual assets disk size is only 10GB.

  • Contact Haivision Technical Support before attempting to resize or replace the virtual disk, as this requires access to the Kraken command line interface (to configure the virtual disk devices, LVM, file system, and OS).

Hyper-V Integration Services — Time Management

The following are some important considerations regarding the Hyper-V guest Kraken VM’s time management:

  1. Kraken uses chronyd / NTP to do primary time management. It takes precedence over Hyper-V host - guest time sync.

    1. If there is no NTP source provided (in NTP manual mode) or detected (in NTP auto mode), then the Hyper-V host-to-guest time sync will take effect.

      Time Synchronization on the VM’s settings must always be enabled:

      Hyper-V-time-sync.jpeg
    2. If chronyd reports no source and time tracking, then Hyper-V host-to-guest time sync would take effect.

Starting the VM

  1. In the left sidebar, select the new VM and click Console in the submenu.

  2. Click the Start Now button.

  3. After a few minutes the Console UI appears. Make note of the IP address assigned to your VM:

    KRAK_PROX_Console.png

Continue to Signing in to Your Hyper-V VM.

For more details on using the Console UI, refer to Using the Console UI with Haivision Hardware.

References

https://learn.microsoft.com/en-us/windows-server/virtualization/hyper-v/hyper-v-overview?pivots=windows-server

https://learn.microsoft.com/en-us/training/modules/configure-manage-hyper-v-virtual-machines/5-create-configure-vms

https://learn.microsoft.com/en-us/windows-server/virtualization/hyper-v/get-started/create-a-virtual-machine-in-hyper-v?tabs=hyper-v-manager

https://learn.microsoft.com/en-us/windows-server/virtualization/hyper-v/system-requirements-for-hyper-v-on-windows?pivots=windows-server

https://learn.microsoft.com/en-us/windows-server/virtualization/hyper-v/integration-services

https://learn.microsoft.com/en-us/windows-server/virtualization/hyper-v/manage/manage-hyper-v-integration-services

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.