storage aggregate scrub

Aggregate parity scrubbing

Availability: This command is available to cluster administrators at the admin privilege level.

Description

The storage aggregate scrub command scrubs an aggregate for media and parity errors. Parity scrubbing compares the data disks to the parity disks in their RAID group and corrects the parity disks contents, as required. If no name is given, parity scrubbing is started on all online aggregates.
Note: By default, scrubs are scheduled to run for a specified time on a weekly basis. However, you can use this command to run scrubs manually to check for errors and data inconsistencies.

Parameters

{ -aggregate <aggregate name> - Aggregate
This parameter specifies the aggregate to be scrubbed for errors.
[-plex <text>] - Plex
This parameter specifies the name of the plex to scrub. If this parameter is not specified, the command scrubs the entire aggregate.
[-raidgroup <text>] - RAID Group
This parameter specifies the RAID group to be scrubbed. If this parameter is not specified, the command scrubs the entire aggregate.
Note: This parameter is only applicable when the -plex parameter is used.
| -node {<nodename>|local}} - Node
This parameter specifies the name of the node associated with the aggregate to be scrubbed. The value local specifies the current node.
-action {start|stop|resume|suspend|status} - Action
This parameter specifies the action to be taken. The possible actions are:
  • start - Starts a scrub.
  • stop - Permanently stops a scrub. A stopped scrub cannot be resumed.
  • resume - Resumes a suspended parity scrub.
  • suspend - Suspends a parity scrub.
  • status - Displays the current status of a scrub.

Examples

The following example starts a scrub on a RAID group named rg0 of plex named plex0 on an aggregate named aggr0:

cluster1::> storage aggregate scrub -aggregate aggr0 -raidgroup rg0 -plex plex0 -action start

The following example queries the status of a scrub:

cluster1::> storage aggregate scrub -aggregate aggr0 -raidgroup rg0 -plex plex0 -action status

Raid Group:/aggr0/plex0/rg0, Is Suspended:false, Last Scrub:Sun Nov 13
01:30:55 2011
, Percentage Completed:7%

The following example starts a scrub on plex1 of an aggregate named aggr1:

cluster1::> storage aggregate scrub -aggregate aggr1 -plex plex1 -action start   

The following example queries the status of plex1 of an aggregate named aggr1:

cluster1::> storage aggregate scrub -aggregate aggr1 -plex plex1 -action status   
   
Raid Group:/aggr1/plex1/rg0, Is Suspended:false, Last Scrub:Sun Nov 13 02:07:29   
2011   
, Percentage Completed:1%   

The following example queries the status of all the plexes for an aggregate named aggr1:

cluster1::> storage aggregate scrub -aggregate aggr1 -action status   
   
Raid Group:/aggr1/plex0/rg0, Is Suspended:false, Last Scrub:Sun Nov 13 01:58:06   
2011   
   
Raid Group:/aggr1/plex1/rg0, Is Suspended:false, Last Scrub:Sun Nov 13 02:07:29   
2011   
, Percentage Completed:4%