PowerScale OneFS 9.3.0.0 CLI Administration Guide

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.

Syntax

isi_packing
[--ls] [--fsa] [--enabled true|false]
[--enable-ads true|false] 
[--enable-snaps true|false]
[--enable-mirror-containers true|false]
[--enable-mirror-translation true|false]
[--unpack-recent true|false] 
[--unpack-snaps true|false]
[--avoid-dedupe true|false] 
[--max-size bytes]
[--sin-cache-cutoff-size bytes] 
[--min-age seconds]
[--dir-hint-entries entries] 
[--container-min-size bytes]
[--container-max-size bytes] 
[-v]

Options

--ls

List current settings.

--fsa [ --fsa-jobid <job id> ]

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

# isi_packing --fsa --fsa-jobid 2069

# isi_packing --ls

# isi_packing -I --help