Skip to main content

storage path quiesce

Contributors
Suggest changes

Quiesce I/O on a path to array

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

Description

The storage path quiesce command quiesces I/O on one path to a LUN. It also quiesces the given entire path immediately or can monitor the given path for error threshold before quiesce. After the I/O has been quiesced, no new I/O is sent on the path unless the storage path resume command is issued to continue I/O.

Parameters

-node {<nodename>|local} - Node name

The name of the clustered node for which information is being displayed.

-initiator <initiator name> - Initiator Port

Initiator port that the clustered node uses.

-target-wwpn <wwpn name> - Target Port

Target World Wide Port Name. Port on the storage array that is being used.

{ [-lun-number <integer>] - LUN Number

Logical Unit number. The range is: [0…​65535]. If this parameter is not specified, Data ONTAP resumes the entire path to an array.

| [-path-failure-threshold <integer>] - Max Number of Path Failures Acceptable During wait-duration

The path failure count, exceeding this value within wait duration will quiesce the path.

[-wait-duration <integer>] - Wait Duration in minutes }

The time duration(minutes) in which path is monitored for path failures.

Examples

The following example suspends I/O between node vbv3170f1b, port 0a and the array port 50001fe1500a8669, LUN 1.

node::> storage path quiesce -node vbv3170f1b -initiator 0a -target-wwpn 50001fe1500a8669 -lun-number 1

The following example suspends I/O immediately between node vbv3170f1b, port 0a and the array port 50001fe1500a8669.

node::> storage path quiesce -node vbv3170f1b -initiator 0a -target-wwpn 50001fe1500a8669

The following example suspends I/O between node vbv3170f1b, port 0a and the array port 50001fe1500a8669 after reaching 10 or more errors in duration of 5 mins.

node::> storage path quiesce -node vbv3170f1b -initiator 0a -target-wwpn 50001fe1500a8669 -path-failure-threshold 10 -wait-duration 5