Use the Restore mode to retrieve an image from a specified location and put it down on a workstation.
You can restore an image of a workstation using either the bash prompt or using the ZENworks Imaging Engine menu. For step-by-step instructions, see Manually Putting an Image on a Workstation. You can also use the Restore mode to restore an image from a partition on a local (writable) device, such as a hard disk or Jaz drive. For step-by-step instructions, see Setting Up Disconnected Imaging Operations.
Normally, if the image to be put down is a base image (one created previously by the imaging engine), all existing partitions except ZENworks Linux and Compaq configuration partitions are removed from all local writable devices (such as hard disks and Jaz drives) before the new image is put down. When the image is put down, the sizes of the original partitions from which the image was taken are preserved if possible. If there's insufficient space, the last partition is shrunk to fit unless this would result in data loss, in which case the imaging engine denies the requested operation. If there's extra space left after all partitions in the image have been restored to their original sizes, that space is left unpartitioned.
If the image to be put down is an add-on image (one produced from an Application object or created by the Image Explorer (imgexp.exe) utility), or if it's a base image and you specify the apartition:ppartition parameter, none of the existing physical partitions are removed. Instead, the appropriate partitions are merely updated with the files from the image. The update process does not remove any existing files or overwrite any existing files of the same names if they are newer.
Restoring add-on images over 4 GB in size is not supported by Desktop Management Workstation Imaging.
The syntax of this mode depends on whether you will retrieve the image from a local device or from an Imaging (proxy) server, as explained in the subsections below:
Use the Restore from Local mode to retrieve an image from a local device and put it down on the workstation. For more information, see Setting Up Disconnected Imaging Operations.
Using the bash prompt, the following example explains the syntax and available parameters that you can use with the restorel "restore from local" parameter:
img restorel[pNumber] filepath [sfileset] [apartition:ppartition]
Parameter | Specifies |
---|---|
restorel[pNumber] |
The partition number (as displayed by img dump) of the local partition to retrieve the image from. It must be a primary FAT16 or FAT32 partition. This partition will not be changed by the imaging operation. If you omit the partition number from this parameter, the image is retrieved from the local Desktop Management imaging partition. |
filepath |
The filename of the image to retrieve, including the .zmg extension (case-sensitive) and the complete path from the root of the partition. |
sfileset |
The number of the image fileset (variant) to put down. Valid values are 1 through 10. For information on creating variants of an image, see Creating and Restoring Images. If you omit this parameter, fileset 1 is used. |
apartition:ppartition |
A mapping between a partition in the image archive (apartition) and a target physical partition on the local machine (ppartition). Use this parameter to selectively restore a specific part of the image to a specific local partition. IMPORTANT: If you use this parameter, none of the existing local partitions are removed, and only the target local partition is updated. The update process does not remove any existing files; however, any existing files of the same names are overwritten. If you want to remove all existing files from the target partition before updating it, first use img pd and img pc to delete and recreate the partition. For apartition, use the partition number displayed for the source partition in the Image Explorer (imgexp.exe) utility. For ppartition, use the partition number displayed by img dump for the target partition. The target partition must be a Windows partition. You can repeat this parameter as needed to request multiple selective restorations in a single operation. In doing so, you can apply multiple parts of the image to a single local partition, but you can't apply the same part of an image to multiple local partitions in a single operation. |
Use the Restore from Proxy mode to retrieve an image from an Imaging (proxy) server and put it down on the workstation. For more information, see Manually Putting an Image on a Workstation.
Using the bash prompt, the following example explains the syntax and available parameters that you can use with the restorep "restore from proxy" parameter:
img restorep address filepath [sfileset] [apartition:ppartition]
Parameter | Specifies |
---|---|
address |
The IP address or DNS name of the Imaging server to retrieve the image from. This can be any server running the Imaging Proxy service. |
filepath |
The UNC path to the image file to retrieve, including the image filename and the .zmg extension (case-sensitive). The format of the UNC path is as follows: //servername/volume_or_share/path_to_stored_images/imagename.zmg Upon execution of img restorep at the cmd line, the servername portion of this path is replaced with the value in the address portion of this syntax. IMPORTANT: Because Linux doesn't recognize backslashes, you must use forward slashes in the UNC path or enclose the entire path in quotes. |
sfileset |
The number of the image fileset (variant) to put down. Valid values are 1 through 10. For information on creating variants of an image, see Creating and Restoring Images. If you omit this parameter, fileset 1 is used. |
apartition:ppartition |
A mapping between a partition in the image archive (apartition) and a target physical partition on the local machine (ppartition). Use this parameter to selectively restore a specific part of the image to a specific local partition. IMPORTANT: If you use this parameter, none of the existing local partitions are removed, and only the target local partition is updated. The update process does not remove any existing files or overwrite any existing files of the same names if they are newer. If you want to remove all existing files from the target partition before updating it, first use the Partition Mode (img p) to delete and recreate the partition. For apartition, use the partition number displayed for the source partition in the Image Explorer (imgexp.exe) utility. For ppartition, use the partition number displayed by img dump for the target partition. The target partition must be a Windows partition. You can repeat this parameter as needed to request multiple selective restorations in a single operation. In doing so, you can apply multiple parts of the image to a single local partition, but you can't apply the same part of an image to multiple local partitions in a single operation. |