Modify disk options
Availability: This command is available to cluster administrators at the admin privilege level.
Description
The storage disk option modify command modifies the background firmware update setting, automatic copy setting, controls automatic disk assignment of all disks assigned to a specified node, or modifies the policy of automatic disk assignment of unowned disks.
Parameters
- -node {<nodename>|local} - Node
- This parameter specifies the node that owns the disks whose options are to be modified.
- [-bkg-firmware-update {on|off}] - Background Firmware Update
- This parameter specifies whether firmware updates run as a background
process. The default setting is on, which specifies that
firmware updates to spare disks and file system disks is performed nondisruptively
via a background process. If the option is turned off, automatic firmware updates
occur at system startup or during disk insertion.
- [-autocopy {on|off}] - Auto Copy
- This parameter specifies whether data is to be automatically copied
from a failing disk to a spare disk in the event of a predictive failure. The
default setting is on. It is sometimes possible to predict
a disk failure based on a pattern of recovered errors that have occurred. In such
cases, the disk reports a predictive failure. If this option is set to on, the
system initiates Rapid RAID Recovery to copy data from the failing disk to an
available spare disk. When data is copied, the disk is marked as failed and placed
in the pool of broken disks. If a spare is not available, the node continues to use
the disk until it fails. If the option is set to off, the disk is immediately marked
as failed and placed in the pool of broken disks. A spare is selected and data from
the missing disk is reconstructed from other disks in the RAID group. The disk does
not fail if the RAID group is already degraded or is being reconstructed. This
ensures that a disk failure does not lead to the failure of the entire RAID group.
- [-autoassign {on|off}] - Auto Assign
- This parameter specifies whether automatic assignment of unowned disks
is enabled or disabled. The default setting is on.
This parameter is used to set both a node-specific and a cluster-wide disk option.
- [-autoassign-policy {default|bay|shelf|stack}] - Auto Assignment Policy
-
This parameter defines the granularity at which auto assign should
work. This option is ignored if the -autoassign option is off. Auto
assignment can be done at the stack/loop, shelf, or bay level.
The possible values for the option are default, stack, shelf, and bay.
The default value is platform dependent. It is stack for all non-entry platforms
and single-node systems, whereas it is bay for entry-level platforms.
Examples
The following example sets the background firmware update setting to on for all disks belonging to a node named node0:
cluster1::> storage disk option modify -node node0 -bkg-firmware-update on
The following example shows how to enable auto assignment for the disks on node1:
cluster1::> storage disk option modify -node node1 -autoassign on
cluster1::> storage disk option show
Node BKg. FW. Upd. Auto Copy Auto Assign Auto Assign Policy
------------- ------------- ------------ ------------- -----------------
node1 on on on default
node2 on on off default
2 entries were displayed.
The following example shows how to modify the auto assignment policy on node1:
cluster1::> storage disk option modify -node node1 -autoassign-policy bay
cluster1::> storage disk option show
Node BKg. FW. Upd. Auto Copy Auto Assign Auto Assign Policy
------------- ------------- ------------ ------------- -----------------
node1 on on on bay
node2 on on off default
2 entries were displayed.