7.2.11 scrub

On-demand file scrubbing for logical consistency.

Syntax

scrub [{ -w | --wallet } wallet-location ] [ -a ] 
   [ -i interval] [ -n requests]
   [ -r count] [ -H ] [ -v[v[v]] ] filename

Command Options

The options for the scrub command are:

• filename: Specifies the files being scrubbed.

  You can use a wildcard (%) in the filename to specify multiple files.

• -w, --wallet: Optionally specifies the path to the Exascale wallet directory.

• -a: Specifies that the scrub operation performs HARD checks on all regions, regardless of the file type or mirror status.

• -i: Specifies the interval (in seconds) to wait before re-scrubbing a region.

• -n: Specifies the queue depth for the scrubbing operation. This option controls the number of concurrent read requests performed by the scrubbing operation. Larger values enable faster scrubbing but consume more resources, which may affect other workloads.

• -r: Specifies the number of re-scrubbing attempts permitted while awaiting concurrent writes on the region. After the specified number of re-scrubbing attempts is exhausted, the corresponding region is reported in the command output and the scrubbing operation continues.

• -H: Instructs the scrub operation to record HARD failure details in the debug trace file.

• -v[v[v]: Increases the verbosity of the command output:

  • -v: Generates detailed output.
  • -vv: Generates more detailed output.
  • -vvv: Generates the most detailed output.

Examples

Example 7-13 Scrub an Exascale file

The following example performs logical scrubbing on @MYDATA/myfile.

$ xsh scrub @MYDATA/myfile