Skip to main content

storage disk option modify

Contributors
Suggest changes

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.