E.3 Make Mode

Use the -make mode command to take an image of the device and store it in a specified location. Normally, all partitions on the local hard disks are included in the image, but there are some exceptions noted in Table E-2.

You can take an image of a device by using either the imaging maintenance mode prompt or by using the ZENworks Imaging Engine menu. For step-by-step instructions, see Manually Taking an Image of a Device. You can also use the Make Locally mode command to take an image of the device and store it in a partition on the local hard disk. For step-by-step instructions, see Section 3.1.3, Setting Up Disconnected Imaging Operations.

The image size corresponds to about half the size of the data in all of the device’s partitions, except that the ZENworks partition and Compaq or Dell configuration partitions are always excluded. Devices with logical volumes (LVMs) are not supported for imaging.

The syntax of this mode depends on whether you store the image locally or on an Imaging Server (proxy).

The following sections contain additional information:

E.3.1 Make Locally

To use the Make Locally mode:

IMPORTANT:When you make an image locally, using the Tuxera driver, use the following command to mount the partition on which the image is stored if the partition is NTFS:

# mount -t tntfs /dev/sdXn mount_dir

In this command, sdX is the device node and n stands for the partition number in the device.

Using the ZENworks Imaging Engine Menu to Make an Image Locally

  1. To display the ZENworks Imaging Engine menu, enter:

    img
    
  2. Click Imaging > Make Image.

    This displays the Make Image Wizard.

  3. In the wizard, select Local, then click Next.

    The Make Local Image Wizard is displayed.

  4. Fill in the fields:

    Path to Image Archive: Click Browse to select the location for the image file, or specify an existing path.

    Include Partitions: Click the check box for any partitions that you do not want to include in the image. By default, all partitions are selected.

    Compression: Specify any number from 0 to 9 where 0 means no compression, 1 means the least compression, and 9 means the most compression.

  5. Click Next to continue.

    The next Make Image Wizard dialog box is displayed.

  6. (Optional) Fill in the fields:

    Author: Specify who created the image file.

    Computer: Identify the computer where this image is being made.

    Image Description: Describe the image file’s content or purpose.

    Comments: Specify anything that might be helpful concerning this image.

  7. Click Next to make the image.

    The ZENworks Imaging Engine Menu displays a progress bar while making image.

  8. If the imaging process was successful, click OK in the Information dialog box, then click Close to return to a blank ZENworks Imaging Engine Menu display.

    If the imaging process was unsuccessful, determine and resolve the issue, then repeat these steps.

Using the Imaging Maintenance Mode Prompt to Make an Image Locally

Using the imaging maintenance mode prompt, the following example explains the syntax and available parameters that you can use with the “make locally” (-makel) mode command:

img -make -local local_filepath/filename.zmg [‑part=partition_number] [‑comp=comp_level] [‑exclude=partition_number] [‑include=partition_number]

where the [...] brackets indicate optional commands.

You can abbreviate -make -local as: -m -local, -makel, or -ml.

You can also abbreviate ‑exclude as ‑x and ‑include as ‑I.

For more information, see:

Command Details

Table E-2 Make Local Commands and Parameters

Parameter

Specifies

local_filepath/filename.zmg

The image filename, including the .zmg extension (which is case sensitive), and any local path. However, the directories in the path must exist.

If the file already exists, an error is given. You must use a different filename or delete the existing image file in order to use that filename.

-part=partition_number or -P=partition_number

The partition number of the local partition for where to store the image. It must be a primary partition. This partition is excluded from the image that is created.

Be sure to specify an existing partition that has enough space to store the image file.

Available partitions can be displayed using img -dump.

If you omit the partition number from this parameter, or do not use this parameter, the image is stored in volatile RAM.

-comp=comp_level

comp_level is the amount of compression used when creating the image. Specify any number from 0-9. 0 means no compression. 1 is the same as Optimize for Speed and is used by default if you do not specify this parameter. 6 is similar to Balanced. 9 is the same as Optimize for Space, which provides the slowest performance.

-exclude=partition_number or -x=partition_number and -include=partition_number or -I=partition_number

The partition number of a local partition to exclude from the image or include in the image. You can repeat this parameter as needed to exclude or include multiple partitions.

Available partitions can be displayed using img -dump.

If you omit the exclude parameter, all partitions are included in the image except the one where the image is stored.

Examples

Table E-3 Make Local Examples

Example

Explanation

img -makel /myimages/myimage.zmg

Takes an image of all partitions and saves it to myimages/myimage.zmg in RAM.

img -makel /myimages/myimage.zmg ‑x=2 ‑x=3

Takes an image of all partitions except those in slots 2 and 3 and saves the image to myimages/myimage.zmg in RAM.

E.3.2 Make to Proxy

To use the Make Proxy mode:

Using the ZENworks Imaging Engine Menu to Make an Image on a Proxy

  1. To display the ZENworks Imaging Engine menu, enter:

    img
    
  2. Click Imaging > Make Image.

    This displays the Make Image Wizard.

  3. In the wizard, select Server, then click Next.

    The Make Server Image Wizard is displayed.

  4. Fill in the fields:

    Server IP Address: Specify the IP address or DNS name of an Imaging Server. If you specified an Imaging Server for the settings.txt file when booting from the imaging CD, that Imaging Server’s IP address is the default; otherwise, the IP address for the Imaging Server specified in the settings.txt file for the PROXYADDR variable is displayed.

    Path to Image Archive: Edit the default image filename (archive.zmg) as needed, replacing /path with any additional subdirectories that you have previously created under the content-repo/images directory.

    Include Partitions: Click the check box for any partitions that you do not want to include in the image. By default, all partitions are selected.

    Compression: Specify any number from 0 to 9 where 0 means no compression, 1 means the least compression, and 9 means the most compression.

  5. Click Next to continue.

    The next Make Image Wizard dialog box is displayed.

  6. (Optional) Fill in the fields:

    Author: Specify who created the image file.

    Computer: Identify the computer where this image is being made.

    Image Description: Describe the image file’s content or purpose.

    Comments: Specify anything that might be helpful concerning this image.

  7. Click Next to make the image.

    The ZENworks Imaging Engine Menu displays a progress bar while making image.

  8. If the imaging process was successful, click OK in the Information dialog box, then click Close to return to a blank ZENworks Imaging Engine Menu display.

    If the imaging process was unsuccessful, determine and resolve the issue, then repeat these steps.

Using the Imaging Maintenance Mode Prompt to Make an Image on a Proxy

Using the imaging maintenance mode prompt, the following example explains the syntax and available parameters that you can use with the “make to proxy” (-makep) mode command:

img -make -proxy added_filepath/filename.zmg -ip=IP_address [‑comp=comp_level] [‑exclude=partition_number] [‑include=partition_number]

where the [...] brackets indicate optional commands.

You can abbreviate -make -proxy as: -m -proxy, -makep, or -mp.

If you specified an Imaging Server for the settings.txt file when booting from the imaging CD, that Imaging Server’s IP address defaults; otherwise, the IP address for the Imaging Server specified in the settings.txt file for the PROXYADDR variable is displayed.

For more information, see:

Command Details

Table E-4 Make Proxy Commands and Parameters

Parameter

Specifies

added_path/filename.zmg

The image filename, including a .zmg extension (which is case sensitive) and any added path. The Imaging engine automatically saves images to the default images directory on the Imaging Server:

Windows: %ZENWORKS_HOME%\work\content-repo\images\

Linux: /var/opt/novell/zenworks/content-repo/images/

If no folders are specified in the path (added_path), the image is created in this images directory.

A forward slash is not needed at the beginning of any added path.

You can create subdirectories under images for organizing your image files. However, any such subdirectories that you specify in the path must already exist when you use this command. ZENworks does not create the directories during imaging.

If the image file itself already exists, the Imaging Server won’t overwrite it unless you enable this behavior in ZENworks Control Center for the Imaging Server. To enable the behavior in ZENworks Control Center, click Configuration > Management Zone Settings > Device Management > Preboot Services > Device Imaging Work Assignment, select the Allow Preboot Services to overwrite existing files when uploading option.

-ip=IP_address

The IP address or DNS name of an imaging server. If you do not use this parameter, the value for PROXYADDR is used.

-comp=comp_level

comp_level is the amount of compression used when creating the image. Specify any number from 0-9. 0 means no compression. 1 is the same as Optimize for Speed and is used by default if you do not specify this parameter. 6 is similar to Balanced. 9 is the same as Optimize for Space, which provides the slowest performance.

-exclude=partition_number or -x=partition_number and -include=partition_number or -I=partition_number

The partition number of a local partition to exclude from the image or include in the image. You can repeat this parameter as needed to exclude or include multiple partitions.

Available partitions can be displayed using img -dump.

If you omit either parameter, all partitions are included in the image.

Examples

Table E-5 Make Proxy Examples

Example

Explanation

img -makep subdir1/myimage.zmg

Takes an image of all partitions and saves the image to the Imaging Server.

img -makep subdir1/myimage.zmg ‑x=2 ‑x=3

Takes an image of all partitions except those in slots 2 and 3 and saves the image to the Imaging Server.