Start a Conversation


This post is more than 5 years old


June 6th, 2015 07:00

How to create a Golden Image using the Wyse UniPlat tool

Lightbulb How to create a Golden Image using the Wyse UniPlat tool

In an ideal world, there's only a single OS Image that supports multiple hardware platforms so you have to update and patch only one Image instead of keeping multiple Images up to date.

But to stream the OS, it must include the drivers for base system components like CPU, network card and video card. To create an image that supports multiple hardware platforms, Windows must have the drivers for all of them. Wyse delivers a tool that helps you to run through the various steps of creating a so called "Golden Image".

Wyse UniPlat Tool (UPT) is part of the WSM Client Utilities package. Using the UPT, you can create a single OS image which can be used on multiple hardware platforms. After you create the golden image, you can convert it into an OS image and stream the image to multiple platforms using Wyse WSM. This process allows you to easily create a universal image for use with various platforms.

This example outlines how to create a Golden Image for the Wyse V00L/LE, R00L/LE and C00L Zero Clients.

Before you start, ensure you have:

  • a VL, RL, and CLE Device, each with enough RAM to run the Windows OS.
  • if the flash on your reference devices do not have at least twice the size to install and restore the OS, you can also use a 2,5" Notebook hard disk.
  • an USB disk or network share, big enough to store the UniPlat backup files of the three OS-installations.
  • an external USB CD/DVD Drive to install the OS on the reference devices. Alternatively you can install the OS from the Network.
  • a bootable USB Key with a partition manager to create partitions and hide/unhide them. (I use Gparted in this example).
  • a PS/2 Mouse and Keyboard (highly recommended).
  • Windows installation CD with Volume/VDA license key.

Here are the steps to follow - more information can be found in the WSM Admin Guide.

  1. Open the housing on the device you want to start with, in this example it is the V00L
  2. Connect the 2,5 " hard disk
  3. Boot from the USB Key and create 4 primary partitions. If you labeled them VL, RL, CL and UNIPLAT you will recognize them more easily. Hide the RL and CL partition, so Windows does not use them to store files etc. The UNIPLAT partition must be always visible
  4. Unplug the USB Key, connect the USB CD-ROM and reboot the client
  5. Start the Windows installation and install the OS on the VL partition
  6. Install all the drivers for this Platform and tune the OS for streaming (fixed page file, disable hibernate etc.)
  7. Disconnect the USB CD-ROM and connect the USB hard disk
  8. Install the WSM Client utilities and run UNIPLAT
  9. Create a UniPlate disk file on the USB disk and backup the C: drive to it
  10. Shut down the VL, connect the hard disk to the RL device
  11. Boot from the USB Key, hide the VL partition and make the RL-Partition visible
  12. Repeat steps 4-8, but make sure you install Windows this time on the RL-Partition. You do not need to tune the OS at this time.
  13. Run UniPlat and restore the UniPlat disk file from step 9 to the UNIPLATpartition
  14. At the next boot the system will start from the UNIPLAT partition with the OS created on the VL and Windows will start to install the drivers for the RL platform. If it cannot find them automatically, point the New Hardware Wizard to the C:\windows\system32\drivers directory or the drivers installation source
  15. After you have installed all the drivers, repeat step 9 and then shutdown the client,
  16. Connect the hard disk on the CL device and boot from the USB Key to hide the VL & RL partition and make the CL-Partition visible. Format the UNIPLAT partition to get rid of the restored Windows OS.
  17. Repeat steps 4-8, but make sure you install Windows this time on the CL-Partition
  18. Run UniPlat and restore the UniPlat disk file from step 13 to the UNIPLAT partition
  19. After starting the restored OS from the restored VL-RL installation, install the drivers for the CL platform Remember: you can use UniPlat to backup this state, very useful if you want to add an other Platform later!
  20. Install the WSM Client and create an OS Image from the current OS Installation

If you want to create a Golden Image that runs on the old (pre 2008) and the new VL Hardware, you just need to

  1. Connect the hard disk to the VL you have not used in the steps before
  2. Use GParted to activate the previous VL OS Installation again
  3. Boot up Windows and let the OS find the different NIC
  4. Restore the UniPlat backup file for the VL-RL-CL platform and boot from it
  5. Install the WSM Client and create an OS Image

Note: The Windows version installed on all reference devices must bear the same major version number. Hence Reference devices cannot have a mix between XP and Windows 7,
Furthermore, the final golden VDisk must have the lowest common HAL among all supported platforms. To change the HAL, open Device Manager, right click the Entry under Computer and select Update Driver Software / Browse my computer for driver software / Let me pick from a list of device drivers on my computer.

200 Posts

June 6th, 2015 07:00

This is a known issue and has been fixed in WSM 3.6.1 and above.

32 Posts

June 6th, 2015 07:00

Same problem here hdlnd. However I am testing it on a laptop, shouldn't be a difference tho. I start the tool, create the .wup on a network drive or USB disk (tried both), change options to allow for bootable, streaming and delete all files before restoring. also tried with and without the keep drivers check box. When I select the .wup and click backup, and select C:\, it starts but it never calculates time remaning, doesnt show any files being copied, just seems like it never starts, there is no animation either. It uses 50% cpu and a few megabytes of memory when its like this. Im guessing it would have used 100% CPU if the tool could utilize two cores.

5 Posts

June 6th, 2015 07:00

I tried using the UniPlat tool to make a backup of the C: drive, but encountered a problem. I can make a backup of the C:\windows subdirectory, but when selecting C:\ (drive root), the UniPlat tool uses 100% CPU and never finishes the backup. Surely this job is not expected to take several hours?
I tried this on R00L and Xx0c clients.

32 Posts

June 6th, 2015 07:00

Try this HDLND, Ive not tried it my self, but as the error seems to come during formating new drives, Im quite positive this might be the solution (found in the archives)

The WSM client is using the command "Format" w/ option "/y" to force a no prompt formatting of the hard disk. This may cause the WSM Client to fail in Step 2 of 6 of the provisioning process when using Non-English OS Images. (just pick out the bits about the refistry as this was written for a problem regarding mobile mode failing)

In such scenario, the "/y" option must be translated to other letters for a Non-English OS, e.g. in German it must be "/J", in French "/O". You can specify a different letter to use when formatting the drive. Note that you don't need this if "Y" is the correct letter to use.

The steps:
1. Find out your current language identifier on
For example, in a typical English OS the langid is 0x0009 (Primary 09, sublanguage 00), German is 0x0007 (Primary 07, sublanguage 00), French is 0x000C, sublanguage 00), Norwegian is 0x0014.

2. Change the OS Image to private mode and stream it to a device

3. Create a key under HKLM\Software\Wyse\WSM\ClientConfig\L<4 digits langid> ("e.g. "L000C" for French or "L0014" for Norwegian)

4. Add registry value "Yes" = " "

There are a few samples in the registry we shipped.

No Events found!