Use
the imagegapsize option with the backup
image command, in the options file, or with the include.image option
to specify the minimum size of empty regions on a volume that you
want to skip during image backup.
Use this option
for LAN-based and LAN-free image backup.
For
example, if you specify a gap size of 10, this means that an empty
region on the disk that is larger than 10 KB in size is not backed
up. Gaps
that are exactly 10 KB are backed up. Empty regions that are exactly
10 KB and that are smaller than 10 KB is backed up, even though they
do not contain data. However, an empty region that is smaller than
10 KB is backed up, even though it does not contain data. A smaller
image gap size means less data needs to be transferred, but with potentially
decreased throughput. A larger image gap size results in more data
being
transferred, but with potentially better throughput.
Place the include.image statement
containing
the imagegapsize value in your dsm.opt file.
Supported Clients
This option
is valid for AIX®, Linux, and JFS2 clients only. The Tivoli® Storage Manager client
API does not support this option.
This option
is valid for all Windows clients.
The Tivoli Storage Manager client
API does not support this option.
Options
File
Place this
option in the server stanza of the client systems options file (dsm.sys),
or in the include.image statement in the dsm.sys file.
Place this option in the client options file (dsm.opt).
Syntax
>>-IMAGEGapsize-- --size---------------------------------------><
Parameters
- size
- Specifies
the minimum size of empty regions in an AIX JFS2
file system that should be skipped during
an image backup. You can specify k (kilobytes) m (megabytes)
or g (gigabytes) qualifiers with the value. Without
a qualifier, the value is interpreted in kilobytes. Valid values are
0 through 4294967295 KB. If you specify a value of 0, all blocks,
including unused blocks at the end of the volume, is backed up. If
you specify any value other than 0, unused blocks at the end of the
volume are not backed up. For LAN-based and LAN-free image backup
the default value is 32 KB. This option is applicable to both static
and snapshot-based image backup.
Note: This option is valid for AIX JFS2 file systems. If you specify
an imagegapsize that is greater than 0 for a
file system other than AIX JFS2,
you get a warning message.
- size
- Specifies the minimum size of empty regions in a formatted logical
volume that should be skipped during an image backup. You can specify k (kilobytes) m (megabytes)
or g (gigabytes) qualifiers with the value. Without
a qualifier, the value is interpreted in KB. Valid values are 0 through
4294967295 KB. If you specify
a value of 0, all blocks, including unused blocks at the end of the
volume, is backed up. If you specify any value other than 0, unused
blocks at the end of the volume are not backed up. For LAN-based and
LAN-free image backup the default value is 32 KB.
Note: Because of
operating system limitations, use this option for NTFS file systems
only. If you specify an imagegapsize that is
greater than 0 for a file system other than NTFS, you get a warning
message.