Tivoli Header

Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User's Guide

Imagegapsize

Use the imagegapsize option with the backup image command, in the dsm.opt file, or with the include.image option to specify the minimum size of empty regions on a volume that you want to skip during backup. For example, if you specify gap size of 10, this means that an empty on disk that is larger than 10k in size will not be backed up. Gaps that are exactly 10k will be backed up. However, an empty region that is smaller than 10k will be backed up, even though it does not contain data. A smaller image gap size means less data will need to be transferred, but potentially decreased throughput. A larger image gap size results in more data being transferred, but potentially better throughput. Use this option for LAN-based, LAN-free, and server-free image backup.

Place the include.image statement containing the imagegapsize value in your dsm.opt file.

Supported Clients

This option is valid for the Windows 2000 client only. The Tivoli Storage Manager Client API does not support this option.

Syntax

>>-IMAGEGapsize- size------------------------------------------><
 
 

Parameters

size
Specifies the minimum size of empty regions in a formatted logical volume that should be skipped during an image backup. You may specify k (kilobytes) m (megabytes) or g (gigabytes) qualifiers with the value. Without a qualifier, the value is interpreted in kilobytes. Valid values are zero through 4294967295. If you specify a value of 0, all blocks, including unused blocks at the end of the volume, will be backed up. If you specify any value other than 0, unused blocks at the end of the volume will not be backed up. For LAN-based and LAN-free image backup the value is 32k. For server-free image backup the default value is 5m.

Examples

Options file:
imagegapsize 1m

Include-exclude list example: include.image h: MYMC imagegapsize=1m

Command line:
-imagegapsize=64k


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]