Use the Novell ZENworks Image Explorer utility to view or modify device images, create add-on images, compress image files, and split images.
There are no command line parameters for the Image Explorer utility.
To start Image Explorer, run the following file:
Windows: C:\Novell\ZENworks\bin\preboot\zmgexp.bat
Linux: /opt/novell/zenworks/preboot/bin/zmgexp
You can run ZENworks Configuration Management Image Explorer as a standalone application on any device that has java installed.The standalone device need not have ZENworks Configuration Management installed.
To install and start the Image Explorer on a standalone device:
Install Java JRE 1.5 or later by using one of the following ways:
ZENworks 11 Installation DVD: Do the following:
On a 32-bit Windows device: Copy novell-zenworks-jdk-1.5.0_22.msi from the \common\msi\ directory on the ZENworks 11 installation DVD to the system drive, and subsequently run it.
Ensure that Java is configured in the system path variable.
On a 64-bit Windows device: Copy novell-zenworks-jdk-1.5.0_22.x86_64.msi from the \common\msi\ directory on the ZENworks 11 installation DVD to the system drive, and subsequently run it.
Ensure that Java is configured in the system path variable.
On a 32-bit Linux device: Install the following RPMs located in the \common\rpm directory on the ZENworks 11 installation DVD in the specified order:
On a 64-bit Linux device: Install the following RPMs located in the \common\rpm directory on the ZENworks 11 installation DVD in the specified order:
Java Web site: Download and install Java JRE 1.5 or later from the Developer Resources for Java Technology Web site.
Install the Image Explorer utility.
On Windows: Do one of the following:
Open a Web browser to the http://primary_server_IP_address_or_DNS_name/zenworks-setup address, click the tab, download novell-zenworks-zmgexplorer-11.0.0.xxxxx.msi to the system drive.
If you double-click the msi file, it gets installed in the C:\Novell\ZENworks location.
To install the Image explorer utility in a specific location (For example, %ZENworks Home%), run the following command:
msiexec /i novell-zenworks-zmgexplorer-11.0.0.67528.msi TARGETDIR="C:\Program Files\Novell\ZENworks", where the %ZENWORKS_HOME% path is C:\Program Files\Novell\ZENworks
Insert the appropriate ZENworks 11 installation DVD, browse to the \common\msi\ directory, copy novell-zenworks-zmgexplorer-11.0.0.xxxxx.msi to the system drive, then double-click the installer.
On Linux: Insert the appropriate ZENworks 11 installation DVD, browse to the \common\rpm\ directory, then double-click novell-zenworks-zmgexplorer-11.0.0-xxxxx.i586.rpm.
Start the Image Explorer utility.
Windows: Run the C:\Novell\ZENworks\bin\preboot\zmgexp.bat file.
Linux: Do the following:
If Java is installed from the ZENworks 11 installation DVD, run the following command:
/opt/novell/zenworks/preboot/bin/zmgexp
If Java is installed from the Java Web site, go to /opt/novell/zenworks/preboot/java/lib and run the following command:
java -Djava.library.path=/opt/novell/zenworks/preboot/lib -Xmx256m -jar ./zmgexp.jar
If the Java is not set in the System path, then you must enter the following command:
/usr/java/jdk-1_5_0_11/bin/java -Djava.library.path=/opt/novell/zenworks/preboot/lib -Xmx256m -jar ./zmgexp.jar
To determine which version of Image Explorer you are using:
Click
> .Although ZENworks Imaging Explorer looks and functions like Microsoft Windows Explorer in most situations, some functionality differences exist between the two programs. The following describes the key differences between ZENworks Image Explorer and Microsoft Windows Explorer:
Replacing Files in an Image: During the life cycle of an image, files might be deleted or updated through Image Explorer. When you replace an existing file in an image by using Image Explorer, the original file is not deleted from the image. Image Explorer purges only deleted files; it does not purge files that have been updated.
When files are added to an image where the file already exists, Image Explorer appends the entry to the end of the image. When images are restored, all files that have been previously updated are sequentially restored.
To avoid performance problems, you should manually delete and purge each instance of a duplicate file in order to have the duplicates purged from the image. In Windows Explorer, replaced files are automatically deleted.
Dragging Files from Image Explorer: You cannot drag files from Image Explorer in order to extract them, which you can do in Windows Explorer. However, you can drag and drop files and folders into an image by using Image Explorer.
Start Image Explorer.
Click on the toolbar, browse for and select the image (.zmg) file, then click .
For Windows, the default image location should open (...\content-repo\images).
For Linux, the file browser opens to the .../content-repo directory; you need to click the /images directory to access the image file.
Browse for and select the image file.
Large image files might take a few moments to open.
To save your changes when exiting the utility:
Click
> or .For Windows, the default image location should open (...\content-repo\images).
For Linux, the file browser opens to the .../content-repo directory; you need to click the /images directory for saving the file.
If you have a subdirectory structure under images, browse for the location to save the image file.
Click
> to close the utility.If you create a new image file in Image Explorer, then select a .lnk file for the image, instead of including the shortcut file, the file it points to is saved in the image.
For example, you open Image Explorer, click services.msc, then save the new image file. Instead of including the .lnk file that points to services.msc, services.msc itself is contained in the image.
> , select a partition, click > , select a shortcut file that points toYou can view the properties of an image file or any item in its content, including modifying some of the properties:
Click
> .For Windows, the default image location should open (...\content-repo\images).
For Linux, the file browser opens to the .../content-repo directory; you need to click the /images directory to access the image file.
Browse for and select the image file.
Large image files might take a few moments to open.
Select the top line of the opened image file.
This is the line that displays the path to the .zmg file.
Click
> .You can also right-click the top line, then select
.(Optional) Fill in the fields:
Description: Specify useful information, such as its purpose or its important content.
Author: Specify the author of this version of the image.
Comments: Specify any information that is helpful.
Save the image file to save your properties changes.
To close the properties dialog box, click
.Click
> .For Windows, the default image location should open (...\content-repo\images).
For Linux, the file browser opens to the .../content-repo directory; you need to click the /images directory to access the image file.
Browse for and select the image file.
Large image files might take a few moments to open.
Select a partition, directory, or file in the image.
For other information on a partition’s properties, see Changing a Partition’s Size.
Click
> .You can also right-click the item, then select
.To close the properties dialog box, click
.You can change a partition’s size for the next time the image is applied to a device. You can edit this value for base images only; you cannot edit this value for add-on images.
If the number that you specify in the
text box exceeds the size of the target hard drive, ZENworks automatically uses the entire disk. Therefore, you can specify a value larger than exists on the target device.However, if you specify a smaller disk space size than is on the target device, only that amount of disk space is used, so the remaining disk space is unused. For example, if you create a base image of a device with a 20 GB hard drive and you want to then place that image on a new device with a 60 GB hard drive, 40 GB of that drive is unused.
You cannot decrease the number in the
text box to a smaller value that what is shown in the text box.To modify the partition’s size:
Click
> .For Windows, the default image location should open (...\content-repo\images).
For Linux, the file browser opens to the .../content-repo directory; you need to click the /images directory to access the image file.
Browse for and select the image file.
Large image files might take a few moments to open.
Select a partition.
Click
> .You can also right-click the partition, then select
.In the
field, specify the new partition size.Click
to save the change.This only saves the partition size change. You must save the image file for it to be in effect the next time the image is applied.
You can do the following with an image file:
You can compress an uncompressed image (including images created by previous versions of ZENworks) by 40 to 60 percent of the original file size.
You can compress an image in two ways:
Use this dialog box to set compression options so that it takes less time to restore the image file or less space to store the file on your Imaging server.
IMPORTANT:If you have used
to hide files in the image, they are removed from the image during compression.To compress the image file:
Click
> .For Windows, the default image location should open (...\content-repo\images).
For Linux, the file browser opens to the .../content-repo directory; you need to click the /images directory to access the image file.
Browse for and select the image file.
Large image files might take a few moments to open.
Click
> .Fill in the fields:
Image File to Compress: Specifies the name of the existing imaging file to compress.
Save Compressed Image As: Click the browse button next to this field to specify the location and filename under which to save the image.
Compression Level: Specify an image-compression level:
Compress for Speed: Takes the least amount of time to compress but creates the largest compressed image file.
Balanced Compression: Represents a compromise between compression time and image file size. This option is used by default when an image is created.
Compress for Size: Creates the smallest image file but takes longer to compress.
Click
to compress the image file, using the settings you specified.Use this dialog box to set compression options to quickly compress an image file without waiting for the file to fully load into Image Explorer.
To quickly compress an image file:
Click
> .Fill in the fields:
Image File to Compress: Specify or browse to an existing imaging file to compress.
Save Compressed Image As: Specify the location and filename under which to save the image, or click the browse button next to this field to locate and select it.
Compression Level: Specify an image-compression level:
Compress for Speed: Takes the least amount of time to compress but creates the largest compressed image file.
Balanced Compression: Represents a compromise between compression time and image file size. This option is used by default when an image is created.
Compress for Size: Creates the smallest image file but takes longer to compress.
Click
to compress the image file using the settings you specified.You can split an image file into separate files so that you can span the entire image across several CDs or DVDs.
When you split a device image and span it across several CDs or DVDs, you are essentially creating a base image on the first CD or DVD. The remaining CDs or DVDs are add-on images.
Because images are split by placing individual files into different images, an image cannot be split if it contains any single file that is larger than the specified maximum file size.
To restore a device image that has been spanned across several CDs or DVDs you should restore the first CD or DVD before restoring the remaining CDs or DVDs containing the add-on images. For more information, see Manually Restoring an Image on a Device.
Restoring split Images is done using bundles, such as restoring a base plus add-ons. For more information, see Creating an Add-On Image from Files in a File System.
To split an image:
Click
> .Fill in the fields:
Image File to Split: Enter or browse to an existing base image file to split.
Directory to Store Split Images: Specify the location and filename under which to save the split-image files, or click the browse button next to this field to locate and select it.
The split-image files are named automatically. For example, if you enter image.zmg in the field, the first split-image file is named image_base.zmg, the second file is named image_a1.zmg, the third file is named image_a2.zmg, and so forth. The image_base.zmg file contains files that allow the device to boot to the operating system. The add-on images (image_a1.zmg, image_a2.zmg, etc.) contain additional files.
Maximum Split File Size _ MB: Specify the maximum size of each split-image file. Depending on the size of the original image and the number you enter in this field, ZENworks creates as many files as necessary to split the entire image into separate split-image files.
To split the image file into as many files as necessary, using the settings you specified, click
.You can hide a directory or file from being used when the image is applied to a device. You can also permanently remove hidden or excluded directories and files from an image file.
You can hide directories or files so that they are not used when the image is applied to a device. This enables you save their existence so that you can later unhide them to be applied to the imaged device.
Click
> .For Windows, the default image location should open (...\content-repo\images).
For Linux, the file browser opens to the .../content-repo directory; you need to click the /images directory to access the image file.
Browse for and select the image file.
Large image files might take a few moments to open.
Select the directories and files to be hidden.
IMPORTANT:When editing a base image, do not hide BPB files or the device won’t be able to boot the new operating system after receiving the image.
Click
> .You can also right-click the selected directories and files, then select
.Deleting a file in the Image Explorer merely marks it for deletion; it can still be retrieved. A file marked as deleted is not removed from the image until the image is purged; files and folders marked as deleted are not restored during imaging.
You can unhide directories or files so that they are available when the image is applied to a device.
Click
> .For Windows, the default image location should open (...\content-repo\images).
For Linux, the file browser opens to the .../content-repo directory; you need to click the /images directory to access the image file.
Browse for and select the image file.
Large image files might take a few moments to open.
Select the directories and files that were previously hidden that you want to unhide.
Click
> .You can also right-click the selected directories and files, then select
.This makes them available in the image when it is applied to a device.
To permanently remove hidden directories and files from the open image in order to create a different version of the image file:
Click
> .For Windows, the default image location should open (...\content-repo\images).
For Linux, the file browser opens to the .../content-repo directory; you need to click the /images directory to access the image file.
Browse for and select the image file.
Large image files might take a few moments to open.
Click
> .Browse to the image filename or specify a new image filename, then click
.You can save over the original image file to make this modification, or create another version of the image with the hidden directories and files removed.
For Windows, the default image location should open (...\content-repo\images).
For Linux, the file browser opens to the .../content-repo directory; you need to click the /images directory for saving the file.
If you have a subdirectory structure under images, browse for the location to save the new image file.
For information on file sets, see Section A.0, File Sets and Image Numbers.
To configure a file set:
Click
> .For Windows, the default image location should open (...\content-repo\images).
For Linux, the file browser opens to the .../content-repo directory; you need to click the /images directory to access the image file.
Browse for and select the image file.
Large image files might take a few moments to open.
Select the directories and files in the image that you want excluded from the image.
Ways that you can select content:
Click a single file in the right pane.
Use the Shift and Ctrl keys to select multiple files in the right pane.
Individually select partitions and directories in the left pane. Any partition or directory that you select includes everything under it.
Select a partition or directory in the left pane, then click
> to select all files listed in the right pane. Subdirectories are not included.Do one of the following to exclude the selected files and directories from the image:
Click
> , then select one of the options from through .You can also right-click your selection to access the
menu options.Click
> > to open the File Sets dialog box, do the following as applicable, then click to exit the dialog box:Exclude Specific Items: To exclude the selected directories and files from specific file set numbers, click the check box for each set number.
This causes all selected directories and files to be excluded from the image for any Image bundle assigned to the specified file set numbers.
Exclude All Items: To exclude the selected directories and files from all file sets of this image, click
.This causes all selected directories and files to be excluded from the image for any Image bundle assigned to any file set number.
Include All Items: To clear all of the check boxes, click
.This allows all selected directories and files to be included in the image.
You can also right-click your selection to access the
menu options.To extract a file or directory from the open image and copy it to a directory:
Click
> .For Windows, the default image location should open (...\content-repo\images).
For Linux, the file browser opens to the .../content-repo directory; you need to click the /images directory to access the image file.
Browse for and select the image file.
Large image files might take a few moments to open.
Click
> .If any changes have been made, this must be done before you can extract the information.
Click
> > .Browse to and select a directory for the files, then click
.To extract a file or directory from the open image as an add-on image:
Click
> .For Windows, the default image location should open (...\content-repo\images).
For Linux, the file browser opens to the .../content-repo directory; you need to click the /images directory to access the image file.
Browse for and select the image file.
Large image files might take a few moments to open.
Click
> .If any changes have been made, this must be done before you can extract the information.
Click
> > .Specify the name and location of the new add-on image, then click
.You can create an add-on image from existing directories and files on your system and add partitions to the new add-on image.
Click
> .To add a partition, click the root of the image, click
, then click .You cannot add a partition to an existing image.
Do any of the following to add content:
Browse to the directories and files you want the add-on image to contain, then drag or copy the directories and files into the right pane from your file browser.
Click
> and select the files to be added.Click
> and select the directories to be added.Click the
icon and select the directories to be added.Click the
icon and select the files to be added.Click .zmg filename extension.
> , then specify the filename of the add-on image, including theFor Windows, the default image location should open (...\content-repo\images).
For Linux, the file browser opens to the .../content-repo directory; you need to click the /images directory for saving the file.
If you have a subdirectory structure under images, browse for where to save the new image file.
You can modify the content of an image file in the following ways:
To add directories and files to the open image:
Click
> .For Windows, the default image location should open (...\content-repo\images).
For Linux, the file browser opens to the .../content-repo directory; you need to click the /images directory to access the image file.
Browse for and select the image file.
Large image files might take a few moments to open.
Do any of the following to add content:
Browse to the directories and files you want the add-on image to contain, then drag or copy the directories and files into the right pane from your file browser.
Click
> and select the files to be added.Click
> and select the directories to be added.Click the
icon and select the directories to be added.Click the
icon and select the files to be added.Browse to and select the files or directory, then click
or .You can select multiple files using the Shift and Ctrl keys.
Repeat these steps as necessary.
To create a directory in the open image:
Click
> .For Windows, the default image location should open (...\content-repo\images).
For Linux, the file browser opens to the .../content-repo directory; you need to click the /images directory to access the image file.
Browse for and select the image file.
Large image files might take a few moments to open.
Browse to the partition or directory in the left pane where you want to create the directory, then click
> .You can also click the
icon.Specify the name of the directory, then click
.New partitions cannot be created in an existing base or add-on image that you opened for editing. You can only create a new partition in a new image file. For more information, see Adding Partitions.
You can resize the partitions in a base image, but not an add-on image. For more information, see Changing a Partition’s Size.
(Windows only) To add specific Windows registry settings that are to be applied after the open image is laid down:
Click
> .The default image location (...\content-repo\images) should open.
Browse for and select the image file.
Large image files might take a few moments to open.
Select a partition.
Click
> .Select the registry (.reg) file that contains the settings, then click .
The registry file is added to a fixed, known area of the partition and is applied by the ZENworks Imaging Windows Agent (ziswin) when the device reboots after receiving the image.
Do the following to create a new image file:
Click
> .Configure the new image file using the instructions in Selecting New Image File Options, then return to Step 3.
To save the new image file, click
.For Windows, the default image location should open (...\content-repo\images).
For Linux, the file browser opens to the .../content-repo directory; you need to click the /images directory for saving the file.
If you have a subdirectory structure under images, browse for where to save the new image file.
Specify an image filename, including the .zmg filename extension, then click .
You can do the following in this new image file:
Select the top line of the new image file.
This is the line that will display the path to the new .zmg file when you save it.
Click
> .To add content to the partitions, continue with Adding Content.
NOTE:
While installing Windows 7 or Windows Server 2008 R2, a hidden system partition with 100 MB disk space is created by default as the first disk partition. If you want to restore an add-on image on a Windows 7 or Windows Server 2008 R2 device that has a hidden partition, ensure to create adequate partitions from the Image Explorer and copy the image files to the appropriate partition where you want to restore the files. Lets assume that you want to restore the add-on images on a Windows 7 device that has two partitions, a hidden system partition and a disk partition (C:). You must create two partitions in the Image Explorer, and copy the add-on files to the second partition.
For creating a partition, ensure that you enter a partition number between 2 and 1280.
See Section D.1.9, Modifying Image Content for instructions on adding new content.
Continue with Configuring File Sets, or return to Step 3 in Creating, Configuring, and Saving the New Image File.
See Configuring File Sets for instructions on configuring file sets.
Return to Step 3 in Creating, Configuring, and Saving the New Image File.