You are here: Learn about Citrix App Layering [UnideskVersion Layering 4.0.8] > Layer > OS Layer > In Nutanix AHV

Prepare the OS Image (Nutanix AHV)

This topic explains how to prepare an OS Image for the Unidesk environment, using the OS Machine Tools available for download on the Unidesk Download page.

Notes:

Which operating system are you using?

Choose the operating system you are using for the OS Image:

Prepare a Windows Server 2016 image (Session Host)

STEP 1: Set up a Windows Server 2016 OS Image on a virtual machine

In the Prism Console:

  1. Select Task > VM, and switch to Table View to see the existing VMs.
  2. Click +Create VM in the upper right corner, and enter the specifics about the new VM:

    1. Enter a Name and add a Description.

    2. Select the number of VCPUs.

    3. Set the Cores per CPU.

    4. Set Memory.

    5. Select Disks, and create a VM with three disks. The first CD-ROM is the ISO for the OS, the second CD-ROM is for the Nutanix VIRTIO drivers that allow the Nutanix VM to access the disk where you install the OS. To start, one CD-ROM is assigned.

      1. Edit the values for the assigned CD-ROM:
      2. For Operation, select Clone from ADSF file.

      1. For Bus Type, select IDE.

      2. Enter the path to your Windows ISO. The path is the combination of the Storage Container and the ISO Name. For example:

        /ISOStore/en_windows_16_enterprise_version_1511_x64_dvd_7224901.iso

      3. Click Update.
    6. Add another disk by clicking the +Add New Disk button:
      1. Set the Type to CDROM.
      2. Set the Operation to Clone from ADSF file.
      3. Set the Bus Type to IDE

      4. Enter the path to the Windows VIRTIO Drivers. For example:

        /ISOStore/virtio-win-0.1.102.iso

      5. Click Add.
    7. Click the +Add New Disk button.
      1. Set the Type to Disk.
      2. Set the Operation to Allocate on Container.
      3. Set the Bus Type to SCSI.
      4. Select the Container you want to use.
      5. Enter the Size
      6. Click Add.
    8. Click +Add new Nic.
      1. Enter the VLAN Name.

    9. Click Save.

  3. Power on the VM:

    1. Select Tasks > VM.
    2. Switch to the Table View to see existing VMs.
    3. Select the VM in the Table, and click Power On.

  4. Launch the Console by selecting the VM and clicking Launch Console. When the VM boots it begins to install the Windows OS from the ISO disk. When the VM boots it will begin to install the Windows OS from the ISO disk.

    1. When asked, "Where do you want to install Windows?" notice that even though you added a disk in the VM creation wizard, there is no disk.

    2. Select the Load Driver option, and select Browse.

    3. Select the CD with the virtio-win-0.1.1 drivers.

    4. Select the vioscsi folder, and choose the folder for your Windows OS.

    5. Once the driver is installed, select the hard drive that you added earlier and finish installing the OS.

  5. After the OS is installed, manually install the VirtIO drivers:

    1. Launch Device Manager.

    2. Select Other Devices, right-click Ethernet Controller and choose Update Driver Software.

    3. Browse My Computer, and choose the VirtIO CD. The ethernet drivers are stored in the NetKVM folder.

  6. Disable Windows System Restore and Windows Automatic Updates. The Unidesk system handles restore points for you, and Unidesk layer versions allow you to control when updates occur.

STEP 2: Copy the Unidesk OS Machine Tools onto the OS Image

  1. Download the Unidesk_OS_Machine_Tools ZIP file onto the OS Image.
  2. Extract the Unidesk_OS_Machine_Tools_x.x.x to c:\windows\setup\scripts.

STEP 3: (Optional) Create an answer file for unattended installation on Unidesk desktops

  1. In the c:\windows\setup\scripts folder, right-click the unattend.exe tool and choose Run as administrator. The unattend builder form opens.

  2. Complete the unattend form.

  3. Click Save File.

STEP 4: (Optional) Optimize the OS Image for the Unidesk environment

  1. In the c:\windows\setup\scripts folder, run the Optimize executable to create a .cmd file (optimization.cmd) that will be run to optimize the image during Desktop creation.

  2. Follow the instructions to run the optimize.cmd file on the OS Image. This removes installation-specific drivers and settings.

    If you are using the Unidesk Optimizer script and you are enabling the View Persona feature, you must go to the section of the Optimizer script called Disable Unnecessary Services to Save Memory and CPU, deselect the option to Disable Offline File Service, and click Save File. This is because View Persona folder redirection requires Offline files to be enabled, and by default, the Unidesk Optimizer turns off Offline files, which are not a requirement for Unidesk.

STEP 5: Create a snapshot of the OS Image

Once the OS Image is ready, create a snapshot of it, so that you can return to this state at any time.

Important: It is critical to create a snapshot before installing the Unidesk software onto the OS Image. Without this snapshot, returning to this state requires rebuilding the image.

STEP 6: Install the Unidesk tools onto the OS Image

  1. In the Unidesk_OS_Machine_Tools folder, run the Unidesk setup_x86.exe (32-bit) or setup_x64.exe (64-bit).

  2. The installation prompts for the location of the unattend.xml file (the default location is c:\windows\panther).

Once this is done, you are ready to create a Unidesk Operating System Layer.

Prepare a Windows Server 2012 R2 image (Session Host)

STEP 1: Set up a Windows Server 2012 R2 OS Image on a virtual machine

In the Prism Console:

  1. Select Task > VM, and switch to Table View to see the existing VMs.
  2. Click +Create VM in the upper right corner, and enter the specifics about the new VM:

    1. Enter a Name and add a Description.

    2. Select the number of VCPUs.

    3. Set the Cores per CPU.

    4. Set Memory.

    5. Select Disks, and create a VM with three disks. The first CD-ROM is the ISO for the OS, the second CD-ROM is for the Nutanix VIRTIO drivers that allow the Nutanix VM to access the disk where you install the OS. To start, one CD-ROM is assigned.

      1. Edit the values for the assigned CD-ROM:
      2. For Operation, select Clone from ADSF file.

      1. For Bus Type, select IDE.

      2. Enter the path to your Windows ISO. The path is the combination of the Storage Container and the ISO Name. For example:

        /ISOStore/en_windows_12_enterprise_version_1511_x64_dvd_7224901.iso

      3. Click Update.
    6. Add another disk by clicking the +Add New Disk button:
      1. Set the Type to CDROM.
      2. Set the Operation to Clone from ADSF file.
      3. Set the Bus Type to IDE

      4. Enter the path to the Windows VIRTIO Drivers. For example:

        /ISOStore/virtio-win-0.1.102.iso

      5. Click Add.
    7. Click the +Add New Disk button.
      1. Set the Type to Disk.
      2. Set the Operation to Allocate on Container.
      3. Set the Bus Type to SCSI.
      4. Select the Container you want to use.
      5. Enter the Size
      6. Click Add.
    8. Click +Add new Nic.
      1. Enter the VLAN Name.

    9. Click Save.

  3. Power on the VM:

    1. Select Tasks > VM.
    2. Switch to the Table View to see existing VMs.
    3. Select the VM in the Table, and click Power On.

  4. Launch the Console by selecting the VM and clicking Launch Console. When the VM boots it begins to install the Windows OS from the ISO disk. When the VM boots it will begin to install the Windows OS from the ISO disk.

    1. When asked, "Where do you want to install Windows?" notice that even though you added a disk in the VM creation wizard, there is no disk.

    2. Select the Load Driver option, and select Browse.

    3. Select the CD with the virtio-win-0.1.1 drivers.

    4. Select the vioscsi folder, and choose the folder for your Windows OS.

    5. Once the driver is installed, select the hard drive that you added earlier and finish installing the OS.

  5. After the OS is installed, manually install the VirtIO drivers:

    1. Launch Device Manager.

    2. Select Other Devices, right-click Ethernet Controller and choose Update Driver Software.

    3. Browse My Computer, and choose the VirtIO CD. The ethernet drivers are stored in the NetKVM folder.

  6. Disable Windows System Restore and Windows Automatic Updates. The Unidesk system handles restore points for you, and Unidesk layer versions allow you to control when updates occur.

STEP 2: Copy the Unidesk OS Machine Tools onto the OS Image

  1. Download the Unidesk_OS_Machine_Tools ZIP file onto the OS Image.
  2. Extract the Unidesk_OS_Machine_Tools_x.x.x to c:\windows\setup\scripts.

STEP 3: (Optional) Create an answer file for unattended installation on Unidesk desktops

  1. In the c:\windows\setup\scripts folder, right-click the unattend.exe tool and choose Run as administrator. The unattend builder form opens.

  2. Complete the unattend form.

  3. Click Save File.

STEP 4: (Optional) Optimize the OS Image for the Unidesk environment

  1. In the c:\windows\setup\scripts folder, run the Optimize executable to create a .cmd file (optimization.cmd) that will be run to optimize the image during Desktop creation.

  2. Follow the instructions to run the optimize.cmd file on the OS Image. This removes installation-specific drivers and settings.

    If you are using the Unidesk Optimizer script and you are enabling the View Persona feature, you must go to the section of the Optimizer script called Disable Unnecessary Services to Save Memory and CPU, deselect the option to Disable Offline File Service, and click Save File. This is because View Persona folder redirection requires Offline files to be enabled, and by default, the Unidesk Optimizer turns off Offline files, which are not a requirement for Unidesk.

STEP 5: Create a snapshot of the OS Image

Once the OS Image is ready, create a snapshot of it, so that you can return to this state at any time.

Important: It is critical to create a snapshot before installing the Unidesk software onto the OS Image. Without this snapshot, returning to this state requires rebuilding the image.

STEP 6: Install the Unidesk tools onto the OS Image

  1. In the Unidesk_OS_Machine_Tools folder, run the Unidesk setup_x86.exe (32-bit) or setup_x64.exe (64-bit).

  2. The installation prompts for the location of the unattend.xml file (the default location is c:\windows\panther).

Once this is done, you are ready to create a Unidesk Operating System Layer.

Prepare a Windows 2008 R2 image

STEP 1: Set up a Windows Server 2008 R2 OS Image on a virtual machine

In the Prism Console:

  1. Select Task > VM, and switch to Table View to see the existing VMs.
  2. Click +Create VM in the upper right corner, and enter the specifics about the new VM:

    1. Enter a Name and add a Description.

    2. Select the number of VCPUs.

    3. Set the Cores per CPU.

    4. Set Memory.

    5. Select Disks, and create a VM with three disks. The first CD-ROM is the ISO for the OS, the second CD-ROM is for the Nutanix VIRTIO drivers that allow the Nutanix VM to access the disk where you install the OS. To start, one CD-ROM is assigned.

      1. Edit the values for the assigned CD-ROM:
      2. For Operation, select Clone from ADSF file.

      1. For Bus Type, select IDE.

      2. Enter the path to your Windows ISO. The path is the combination of the Storage Container and the ISO Name. For example:

        /ISOStore/en_windows_08_enterprise_version_1511_x64_dvd_7224901.iso

      3. Click Update.
    6. Add another disk by clicking the +Add New Disk button:
      1. Set the Type to CDROM.
      2. Set the Operation to Clone from ADSF file.
      3. Set the Bus Type to IDE

      4. Enter the path to the Windows VIRTIO Drivers. For example:

        /ISOStore/virtio-win-0.1.102.iso

      5. Click Add.
    7. Click the +Add New Disk button.
      1. Set the Type to Disk.
      2. Set the Operation to Allocate on Container.
      3. Set the Bus Type to SCSI.
      4. Select the Container you want to use.
      5. Enter the Size
      6. Click Add.
    8. Click +Add new Nic.
      1. Enter the VLAN Name.

    9. Click Save.

  3. Power on the VM:

    1. Select Tasks > VM.
    2. Switch to the Table View to see existing VMs.
    3. Select the VM in the Table, and click Power On.

  4. Launch the Console by selecting the VM and clicking Launch Console. When the VM boots it begins to install the Windows OS from the ISO disk. When the VM boots it will begin to install the Windows OS from the ISO disk.

    1. When asked, "Where do you want to install Windows?" notice that even though you added a disk in the VM creation wizard, there is no disk.

    2. Select the Load Driver option, and select Browse.

    3. Select the CD with the virtio-win-0.1.1 drivers.

    4. Select the vioscsi folder, and choose the folder for your Windows OS.

    5. Once the driver is installed, select the hard drive that you added earlier and finish installing the OS.

  5. After the OS is installed, manually install the VirtIO drivers:

    1. Launch Device Manager.

    2. Select Other Devices, right-click Ethernet Controller and choose Update Driver Software.

    3. Browse My Computer, and choose the VirtIO CD. The ethernet drivers are stored in the NetKVM folder.

  6. Disable Windows System Restore and Windows Automatic Updates. The Unidesk system handles restore points for you, and Unidesk layer versions allow you to control when updates occur.

STEP 2: Copy the Unidesk Tools onto the OS Image

  1. Download the Unidesk_OS_Machine_Tools ZIP file onto the OS Image.
  2. Extract the Unidesk_OS_Machine_Tools_x.x.x to c:\windows\setup\scripts.

STEP 3: (Optional) Create an answer file for unattended installation on Unidesk desktops

  1. In the c:\windows\setup\scripts folder, right-click the unattend.exe tool and choose Run as administrator. The unattend builder form opens.

  2. Complete the unattend form.

  3. Click Save File.

STEP 4: (Optional) Optimize the OS Image for the Unidesk environment

  1. In the c:\windows\setup\scripts folder, run the Optimize executable to create a .cmd file (optimize.cmd) that will be run to optimize the image during desktop creation.

  2. Follow the instructions to run the optimize.cmd file on the OS Image. This removes installation-specific drivers and settings.

    If you are using the Unidesk Optimizer script and you are enabling the View Persona feature, you must go to the section of the Optimizer script called Disable Unnecessary Services to Save Memory and CPU, deselect the option to Disable Offline File Service, and click Save File. This is because View Persona folder redirection requires Offline files to be enabled, and by default, the Unidesk Optimizer turns off Offline files, which are not a requirement for Unidesk.

STEP 5: Create a snapshot of the OS Image

Once the OS Image is ready, create a VMware snapshot of it so you can return to this state at any time.

Important: It is critical to create a snapshot before installing the Unidesk software onto the OS Image. Without this snapshot, returning to this state requires rebuilding the image.

STEP 6: Install the Unidesk tools onto the OS Image

  1. In the Unidesk_OS_Machine_Tools folder, run the Unidesk setup_x86.exe (32-bit) or setup_x64.exe (64-bit).

  2. The installation prompts for the location of the unattend.xml file (the default location is c:\windows\panther).

Once this is done, you are ready to create a Unidesk Operating System Layer.

Prepare a Windows 10 image

When preparing the OS Image for import into a Unidesk Operating System Layer, you can speed up start times by removing Windows 10 built-in applications. If you do, we recommend removing these applications either on the OS Image itself, or on the Operating System Layer.

STEP 1: Set up a Windows 10 image on a virtual machine

In the Prism console:

  1. Create a VM for your OS image.

    Important: When creating the image, be sure to choose the default cluster allocation size of 4K.

  2. Configure the virtual machine hardware settings, for example, the NIC and video memory.

  3. Disable Windows System Restore and Windows Automatic Updates:

    1. Log into the VM.

    2. Select Computer Config > Administrative Templates > Windows Components > Windows Updates > Config Auto Updates.
    3. Set this to Disabled.

    The Unidesk system handles restore points for you, and Unidesk layer versions allow you to control when updates occur.

  4. If using KMS licensing, run a command window as Administrator, and enter these commands:

    slmgr /skms <kmsserverhost>
slmgr /rearm
reboot
slmgr /ipk XXXX-YOUR-KMS-KEY-XXXX
slmgr /ato
  5. Install the VMware Tools on the OS image.

STEP 2: Copy the Unidesk Tools onto the OS Image

  1. Download the Unidesk_OS_Machine_Tools ZIP file onto the OS Image.
  2. Extract the Unidesk_OS_Machine_Tools_x.x.x to c:\windows\setup\scripts.

STEP 3: (Optional) Create an answer file for unattended installation on Unidesk Desktops

  1. In the c:\windows\setup\scripts folder, right-click the unattend.exe tool and choose Run as administrator. The unattend builder form opens.

  2. Complete the unattend form.

    Product key activation

    For KMS activation, select KMS Server.

    For KMS with a Multiple Activation Key (MAK), select KMS with MAK and enter the MAK.

    For Retail Licensing with a MAK, select Retail with MAK, and the MAK.

    Domain Join

    Select Enable if you want to configure the unattend.xml file to join Desktops to a specific domain. If you plan to use AD join scripts, ensure Enable is not selected.

    You can add Desktops to the Computer's container in Active Directory by deleting the OU entry. However, we recommend that you use an alternate OU for Unidesk Desktops, both to segregate the Desktop from other machines and to avoid applying virtual Desktop-specific GPOs to other types of machines.

    If you are supporting multiple OUs within one or more domains, you can join machines in different Domains or OUs by creating different unattend.xml files in different application layers.

    Local Administrator account

    You can enable the Administrator account on each Unidesk Desktop by selecting Enable. Remember to also enable this account in your OS Image or Operating System Layer version. You can also enable the Administrator account for your OS Image and then have it disabled in the deployed Desktops by clearing the check box.

    If you want to add an alternate Administrator account, select Enable and enter the account information. This account cannot be preconfigured in the OS Image.

    You can create a Desktop where the Administrator is disabled and the alternate administrator is created and enabled. However for this to work, the Administrator account must be enabled in the OS Image and it cannot be renamed.

    Time Zone

    If your time zone is not listed, you can add it to the Other box. Be sure to use the time zone, not the display setting.

    Disabling automatic activation

    Select this option if you plan to use the Microsoft Volume Activation Management Tool.

  3. Click Save File.

STEP 4: (Optional) Optimize the OS Image for the Unidesk environment

  1. In the c:\windows\setup\scripts folder, right-click the optimizations.exe tool and choose Run as administrator. This creates a .cmd file (optimizations.cmd) that will be run during Desktop creation to optimize the image.

  2. Follow the instructions to run the optimizations.cmd file on the OS Image. This removes installation-specific drivers and settings.

    If you are using the Unidesk Optimizer script and you are enabling the View Persona feature, you must go to the section of the Optimizer script called Disable Unnecessary Services to Save Memory and CPU, deselect the option to Disable Offline File Service, and click Save File. This is because View Persona folder redirection requires Offline files to be enabled, and by default, the Unidesk Optimizer turns off Offline files, which are not a requirement for Unidesk.

STEP 5: Install .Net Framework 3.5.1

The .Net Framework is a software framework provided by Microsoft that is required for many 3rd party applications to run. To install this feature, follow the steps below.

  1. On the Start menu, select Control Panel > Programs and Features.

  2. In the left panel select Turn Windows features on or off. A window opens.

  3. Select .NET Framework 3.5, click OK, and wait for the installation to complete.

    Important: Even if .NET is already installed, continue with the rest of these steps.

  4. Exit the Control Panel.

  5. In Notifications in the right-side of your taskbar, click All Settings, and open the Windows 10 Settings app.

  6. Select Settings > Update & Security.

  7. Check for updates, and install all updates available.

  8. Exit Settings.

  9. Open an administrator-level command prompt, and enter the following commands:

    cd \windows\Microsoft.Net\Framework\v4.nnnnn
ngen update /force

  10. Wait for the command to complete, and enter the following commands:

    cd \windows\Microsoft.Net\Framework64\v4.nnnnn
ngen update /force
  11. Exit the command prompt.

STEP 6: If using PVS, follow these steps to avoid ghost NICs.

  1. Enter the commands:

    set devmgr_show_nonpresent_devices=
devmgmt.msc

  2. Remove any ghost NICs.

  3. Reboot the system.

STEP 7: Create a backup copy of the OS Image

Once the OS Image is ready, create a copy of it so you can return to this state at any time.

Important: It is critical to create a backup copy before installing the Unidesk software onto the OS Image. Without this backup copy, returning to this state requires rebuilding the image.

STEP 8: Install the Unidesk software onto the OS Image

  1. Run setup_x64.exe from c:\Windows\setup\scripts.

Once this is done, you are ready to create a Unidesk Operating System Layer.

Prepare a Windows 7 image

STEP 1: Set up a Windows 7 OS Image on a virtual machine

In the Prism console:

  1. Create a VM for your OS Image.

    Important: When creating the image, be sure to choose the default cluster allocation size of 4K.

  2. Configure the virtual machine hardware settings, for example, the NIC and video memory.

  3. Disable Windows System Restore and Windows Automatic Updates. The Unidesk system handles restore points for you, and Unidesk layer versions allow you to control when updates occur.

  4. Make sure you have installed VMware Tools on the OS image.

STEP 2: Mount or copy the Unidesk Tools onto the OS Image

  1. Download the Unidesk_OS_Machine_Tools ZIP file onto the OS Image.
  2. Extract the Unidesk_OS_Machine_Tools_x.x.x to c:\windows\setup\scripts.

STEP 3: (Optional) Create an answer file for unattended installation on Unidesk desktops

  1. In the c:\windows\setup\scripts folder, right-click the unattend.exe tool and choose Run as administrator. The unattend builder form opens.

  2. Complete the unattend form.

  3. Click Save File.

STEP 4: (Optional) Optimize the OS Image for the Unidesk environment

  1. In the c:\windows\setup\scripts folder, run the Optimize executable to create a .cmd file (optimize.cmd) that will be run to optimize the image during desktop creation.

  2. Follow the instructions to run the optimize.cmd file on the OS Image. This removes installation-specific drivers and settings.

    If you are using the Unidesk Optimizer script and you are enabling the View Persona feature, you must go to the section of the Optimizer script called Disable Unnecessary Services to Save Memory and CPU, deselect the option to Disable Offline File Service, and click Save File. This is because View Persona folder redirection requires Offline files to be enabled, and by default, the Unidesk Optimizer turns off Offline files, which are not a requirement for Unidesk.

STEP 5: If using PVS, follow these steps to avoid ghost NICs

  1. Install KB2550978 hotfix.
  2. Reboot the VM,

  3. Enter the commands: 

    set devmgr_show_nonpresent_devices=1
devmgmt.msc
  4. Remove any ghost NICs.
  5. Reboot the system.

STEP 6: Create a snapshot of the OS Image

  1. Create a snapshot of the OS image so you can return to this state at any time.

    Important: It is critical to create a snapshot before installing the Unidesk software onto the OS Image. Without this snapshot, returning to this state requires rebuilding the image.

STEP 7: Install the Unidesk software onto the OS Image

  1. In the Unidesk_OS_Machine_Tools folder, run the Unidesk setup_x86.exe (32-bit) or setup_x64.exe (64-bit).

  2. The installation prompts for the location of the unattend.xml file (the default location is c:\windows\panther).

Once this is done, you are ready to create a Unidesk Operating System Layer.