Enables or disables file packing and controls the behavior of pack operations. This command sets global options that apply to the packing operation regardless of FilePool policy.
Usage
FilePool policies control files that are selected for packing. In addition, many of the options in the isi_packing command set system level control options (sysctl options) that are also applied to file selection. The system level control options are preset with default values. You may change the default settings with this command.
The packing operation skips the following types of files.
Non-regular files (not recorded).
Unlinked files (not recorded).
ADS files, if ads_enabled is false.
Stubbed (CloudPools) files.
Empty files (not recorded).
Zero-sized files, where all blocks have no physical content, such as shadow references, ditto, etc.
Oversized files, where the file size is greater than the max_size value.
Mirror protected files, if mirror_containers_enabled is false.
Reports
FSAnalyze job results. If you do not specify an FSAnalyze job ID, the request uses the results from the last
FSAnalyze job run.
--enabled {true |
false}
Enable or disable packing. Set to
true to enable packing. Set to
false to disable packing.
--enable-ads {true |
false}
Controls whether to process ADS files. The default is
false.
The
false setting does not process ADS files. Typically, these stream files are too large to be considered for packing. In addition, it is more efficient to process directories of streams files, but not efficient to process them singly from various locations.
The
true setting processes ADS files. Use this setting if you have small ADS files located together in a directory.
--enable-snaps {true |
false}
Controls whether to process snapshots. The default is
false.
The
false setting does not process snapshot files. Use this setting if processing time is an issue.
The
true setting processes snapshot files. This processing can significantly increase the time it takes to pack a data set if there are many snapshots with data. The advantage to using the
true setting is the storage savings that may be gained. Snapshot files are often sporadically allocated, which typically results in poor storage efficiency. Packing can improve the storage efficiency.
--enable-mirror-containers {true |
false}
Controls whether to process mirrored files. The default is
false.
The
false setting does not process mirrored files.
The
true setting allows creation of containers with mirrored protection policies. Mirrored files remain mirrored, so there is no space saving. However, this setting can reduce the total protection group count and potentially reduce rebuild times.
--enable-mirror-translation {true |
false}
Controls whether to pack mirrored files into FEC containers with equivalent protection. The default is
false.
The
false setting ensures that a mirrored file remains a true mirror. This is an important quality for some users.
The
true setting allows packing of files with mirror protection polices into containers with equivalent FEC protection policies. This setting can increase space savings.
--unpack-recent {true |
false}
Unpack recently modified files.
--unpack-snaps {true |
false}
Unpack packed snapshot version files.
--avoid-dedupe {true |
false}
Controls whether to avoid cloned and deduped files.
The default is
true, meaning that deduped files are not processed. We recommend not to pack deduped files. Packing them has the effect of undoing the benefits of dedupe. Also, packing deduped files may affect performance when reading the packed file.
NOTE: The dedupe functionality does not dedupe packed files.
--max-size <bytes>
Maximum size of files to select for processing. The default is 1040384 bytes, which is 8192 bytes less than 1MB, or 127 fs blocks. This value makes files less than 1MB available for packing.
--sin-cache-cutoff-size <bytes>
Maximum size of a container ShadowStore in cache.
--min-age
<seconds>
A global setting for the minimum amount of time that must pass since a file was modified before the file is selected for packing, in seconds. The installed default minimum age is one day.
A FilePool policy may set a higher minimum age using its
--changed-time parameter.
--dir-hint-entries <entries>
Number of entries in the directory container hint.
--container-min-size <bytes>
Minimum size of a container shadow file. The default is 1040384 bytes. Any containers whose size is less than this are considered to be underfull and not able to provide decent savings. A container shadow file is a ShadowStore used exclusively by packing.
--container-max-size <bytes>
Maximum size of a container shadow file.
Examples
To look at the
FSAnalyze results for job 2069:
# isi_packing --fsa --fsa-jobid 2069
# isi_packing --ls
# isi_packing -I --help
Data is not available for the Topic
Please provide ratings (1-5 stars).
Please provide ratings (1-5 stars).
Please provide ratings (1-5 stars).
Please select whether the article was helpful or not.
Comments cannot contain these special characters: <>()\