Citrix Provisioning

Converting BIOS vDisks to UEFI

March 29, 2024

Contributed by:

This article explains how to convert the BIOS vDisks to UEFI. This conversion is important because BIOS support is removed in Citrix Provisioning version 2311 and onwards.

There are two approaches to convert an existing vDisk from BIOS format to UEFI:

Convert the vDisk directly: Copy the VHD(X) file, mount it, convert, and then import the new file.
Convert the vDisk using reverse imaging: Reverse image the vDisk to a master VM, reboot from the local disk, convert, and then create a new image.

Important:

In both the approaches, ensure that:

There is sufficient free space

The disk is defragmented before starting. You can do this step either after reverse imaging or before merging the vDisk to a single version.

Image Portability Service can be used to automate the conversion to UEFI. For more information, see Convert to UEFI.

Convert the vDisk directly

Do the following steps to convert the vDisk directly:

Ensure that the disk is defragmented and merged down to a single base version.
Copy the .VHD(X) file to a new file in the store.
Run disk management in windows and attach the VHD.
Run diskpart to determine the disk number of the mounted disk.
Run the following command to convert the mounted vdisk file to UEFI (GPT).
```
mbr2gpt /convert /disk:3 /allowFullOS

```
Unmount the VHD file and import into the Citrix Provisioning store.

Convert the vDisk using reverse imaging

Do the following steps to Convert the vDisk using reverse imaging:

Reverse image to a master VM setup as BIOS with a local disk that is large enough.
Reboot the VM from the local disk (change the boot order) and log on as an administrator.
Run diskpart to confirm the disk number. The number must be zero.
Run the following command to convert the disk to UEFI (GPT).
```
mbr2gpt /convert /disk:0 /allowFullOS

```
Shut down the VM.
Update the hypervisor configuration for the VM to use UEFI. For example:
- With VMware as a hypervisor, go to the VM Edit Settings and from the VM Options tab> Boot Options section, select the firmware type as EFI.
- With XenServer as the hypervisor:
  1. Determine the UUID of the original VM. You can get the UUID from XenCenter or use the xe vm-list name-label="VM NAME" as shown:
    [root@xenserver01 ~]# xe vm-list name-label="Windows 10 BIOS" uuid ( RO) : e98a0a89-2fb9-886b-a843-b8a08642afa4 name-label ( RW): Windows 10 BIOS power-state ( RO): halted 
  2. Set the VM to use UEFI boot with xe vm-param-set uuid=UUID HVM-boot-params:firmware=uefi as shown:
    [root@xenserver01 ~]# xe vm-param-set uuid=e98a0a89-2fb9-886b-a843-b8a08642afa4 HVM-boot-params:firmware=uefi 
Boot the VM and run the Imaging Wizard to create a new vDisk for the converted disk.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

Converting BIOS vDisks to UEFI

March 29, 2024

Contributed by:

March 29, 2024

Contributed by:

Converting BIOS vDisks to UEFI

Convert the vDisk directly

Convert the vDisk using reverse imaging

In this article