Machine recomposition simultaneously updates all the linked-clone virtual machines anchored to a parent virtual machine.

If possible, schedule recompositions during off-peak hours.

Prerequisites

  • Verify that you have a snapshot of the parent virtual machine. See Prepare a Parent Virtual Machine to Recompose Linked Clones.
  • Familiarize yourself with the recomposition guidelines. See Updating Linked Clones with Recomposition.
  • Decide when to schedule the recomposition. By default, View Composer starts the recomposition immediately.

    You can schedule only one recomposition at a time for a given set of linked clones. You can schedule multiple recompositions if they affect different linked clones.

  • Decide whether to force all users to log off as soon as the recomposition begins or wait for each user to log off before recomposing that user's linked-clone desktop.

    If you force users to log off, Horizon 7 notifies users before they are disconnected and allows them to close their applications and log off.

  • Decide whether to stop provisioning at first error. If you select this option and an error occurs when View Composer provisions a linked clone, provisioning stops for all clones in the desktop pool. You can select this option to ensure that resources such as storage are not consumed unnecessarily.

    Selecting the Stop at first error option does not affect customization. If a customization error occurs on a linked clone, other clones continue to be provisioned and customized.

  • Verify that provisioning for the desktop pool is enabled. When desktop pool provisioning is disabled, Horizon 7 stops the desktops from being customized after they are recomposed.
  • If your deployment includes replicated Horizon Connection Server instances, verify that all instances are the same version.

Procedure

  1. Choose whether to recompose the whole desktop pool or a single machine.
    Option Action
    To recompose all virtual machines in the desktop pool
    1. In Horizon Administrator, select Catalog > Desktop Pools.
    2. Select the desktop pool to recompose by double-clicking the pool ID in the left column.
    3. On the Inventory tab, click Machines.
    4. Use the Ctrl or Shift keys to select all the machine IDs in the left column.
    5. Select Recompose from the View Composer drop-down menu.
    To recompose selected virtual machines
    1. In Horizon Administrator, select Resources > Machines.
    2. Select the machine to recompose by double-clicking the machine ID in the left column.
    3. On the Summary tab, select Recompose from the View Composer drop-down menu.
  2. Follow the wizard instructions.
    You can select a new virtual machine to be used as the parent virtual machine for the desktop pool.

    On the Ready to Complete page, you can click Show Details to display the linked-clone desktops that will be recomposed.

Results

The linked-clone virtual machines are refreshed and updated. The OS disks are reduced to their original size.

In a dedicated-assignment pool, unassigned linked clones are deleted and recreated. The specified number of spare virtual machines is maintained.

In a floating-assignment pool, all selected linked clones are recomposed.

In vCenter Server, you can monitor the progress of the recomposition on the linked-clone virtual machines.

In Horizon Administrator, you can monitor the operation by clicking Catalog > Desktop Pools, double-clicking the pool ID, and clicking the Tasks tab. You can click Cancel task, Pause task, or Resume task to terminate a task, suspend a task, or resume a suspended task.

Note: If you used a Sysprep customization specification to customize the linked clones when you created the desktop pool, new SIDs might be generated for the recomposed virtual machines.