Image Management

• Image objects in FOG are the representation of the physical files that contain the disk or partition images that are saved on the FOG server.

Creating Image objects

• Image objects in FOG are created in the Images section of the FOG management portal. To create a new image click on the “New Image” button on the left hand menu. An image object requires a name and a image file path.

Image Name and Path

• Image Name is the friendly name used to identify the image throughout the FOG UI — when assigning it to hosts, scheduling tasks, and in reports. Use something descriptive (for example win11-lab or ubuntu-2404-base).

• Image Path is the folder name, under the storage node’s image directory (/images by default), where the image’s files are stored. It must be unique. By convention it matches the image name, contains no spaces, and is lower-case.

Operating System

• The Operating System tells FOG which OS the image contains. Select the OS that matches the source machine.

• FOG uses this setting to apply the right handling during capture and deploy (such as filesystem and bootloader fix-ups appropriate to that OS). Setting it incorrectly can leave a deployed image unable to boot, so make sure it matches the image’s actual OS.

Image Type

• When creating images you have a few choices in how you want that image to ‘act’. The possible partition types include:

Info

• Single Disk - Resizable
• Multiple Partition Image - Single Disk (Not Resizable)
• Multiple Partition Image - All Disks (Not Resizable)
• Raw Image (Sector By Sector, DD, Slow)

Single Disk - Resizable

• This is the detault choice used by FOG as it works in most cases and allows for deployment to smaller size disks as well.

• It takes a copy of every partition on the disk, and resizes partitions that has excessive free space to a smaller size where possible.

Each resizable partition will go through a "Resizing filesystem" process for each partition that is to be resized.

:   -   This process can take some time depending on how severe disk
        fragmentation is.
    -   The partitions that are shrank will be shrunk down to only
        2GB of free space on their partition.
    -   This allows an image taken from a 6TB drive with only 20GB
        of used space to be deployable to a drive with a total
        capacity of 25GB roughly.
    -   When the partitions are laid onto the destination drive, all
        resized partitions are intelligently expanded to utilize the
        entire drive.
    -   On FOS builds with [[lvm-imaging|LVM resize support]], Linux
        LVM setups resize too — the logical volumes inside the
        volume group are shrunk and expanded to fit the target disk,
        so an all-LVM disk (EFI + LVM physical volume) works with
        this image type.

Multiple Partition Image - Single Disk (Not Resizable)

• If you don’t need to deploy to a smaller size disk you might consider using this image type, as it’s less likely to cause an issue and image size on the server is still as small as with resizable image type.

• Single Disk will back up all the supported partitions on the first disk drive detected by FOG, but the partitions are NOT resized by FOG.

• This means that the image must be restored to a disk of the same or larger capacity.

• It is possible to backup NTFS drives with vendor specific ‘restore’ partitions with this type of image.

It is possible to capture Linux systems with this type of image given the following criteria

:   -   There is a Grub boot loader present.
    -   LVM setups are supported on FOS builds that include
        [[lvm-imaging|per-LV LVM imaging]]; on older FOS builds LVM
        must not be used.
    -   The partitions include **ext2**, **ext3**, **ext4**,
        **reiserfs**, and/or **swap**.
    -   The swap partition should be moved out of the extended
        partition

Multiple Partition Image - All Disks (Not Resizable)

• This is what you should pick when you want all partitions from multiple disks to be captured.

• The partitions are NOT resizable by FOG.

If you only wanted a particular partition captured or drive captured in a multi-drive system, you can define the disk or partition you want within a "Single Disk - Resizable" or "Multiple Partition Image - Single Disk (Not Resizable)" type image.

:   -   This is done through the host's "General" area, in the
        "Host Primary Disk" field.

Raw Image (Sector By Sector, DD, Slow)

!!! warning WARNING

This should always be the last resort.

-

This takes an absolute exact copy of an entire disk and does not compress the data.

:   -   i.e. If you take an image from a 6TB disk, the resultant
        image will be 6TB in size.

• This image type also takes a significant amount of time to capture and deploy.

!!! note

All of these image types can be deployed using multi-cast or unicast to
clients

Partition

• The Partition setting controls how much of the disk this image captures and deploys:

  • Everything (the default) — all partitions on the disk.
  • Partition Table and MBR only — just the partition table and master boot record, none of the partition contents.
  • Partition N only — a single specific partition (1 through 10).

• Most images use Everything; the other options are for special cases where you only need part of a disk.

Image Manager

FOG comes with two different tools (a.k.a “managers”) to create an image of your disks/partitions: partclone and partimage. In early versions partimage was the only tool. For historical reasons partimage is still available but hardly anyone uses it anymore as partclone is the more active project, supporting newer filesystems like APFS.

FOG 1.3.6 added the feature to compress (Gzip and Zstd) and split image files as well. This might be useful if images are stored on storage not able to handle huge files. Using compression will make the image files smaller but imaging takes longer. Compression is done on the client machine so depending on the CPU it is wise to use compression or not. Recent generations of CPUs handle compression more efficienly making it a great option to save image space and network transfer volume.

Adding Existing Image objects

To restore an image to the FOG database:

:   -   Create a new Image definition through the management browser
    -   Specify image name (SampleXPImage)
    -   Specify storage group (default)
    -   Specify image file path (SampleXPImage)
    -   Specify image type
    -   Log into the box hosting FOG, and move/rename your image to
        match browser input
    -   Create hierarchy if necessary. FOG, by default, puts images
        in /images/, so for the above example, you would need to
        create a folder structure like so: /images/SampleXPImage
    -   Drop your image file into the folder (be sure it's named
        the same as image name above)