Listing node-dependent volumes using the CLI

You can use the command-line interface (CLI) to list the volumes that are dependent on the status of a node.

If a node goes offline or is removed from a system, all volumes that are dependent on the node go offline. Before taking a node offline or removing a node from a system, run the lsdependentvdisks command to identify any node-dependent volumes.

By default, the lsdependentvdisks command also checks all available quorum disks. If the quorum disks are accessible only through the specified node, the command returns an error.

Various scenarios can produce node-dependent volumes. The following examples are common scenarios in which the lsnodedependentvdisks command will return node-dependent volumes:
  1. The node contains flash drives and also contains the only synchronized copy of a mirrored volume.
  2. The node is the only node that can access an MDisk on the SAN fabric.
  3. The other node in the I/O group is offline (all volumes in the I/O group are returned).
  4. Pinned data in the cache is stopping the partner node from joining the I/O group.
To resolve (1), allow volume mirror synchronizations between Flash drive MDisks to complete. To resolve (2-4), bring any offline MDisks online and repair any degraded paths.
Note: The command lists the node-dependent volumes at the time the command is run; subsequent changes to a system require running the command again.
  1. Issue the lsdependentvdisks CLI command.

    The following example shows the CLI format for listing the volumes that are dependent on node01:

    lsdependentvdisks -enclosure -delim : 0:1

    The following example shows the output that is displayed:

    vdisk_id:vdisk_name
    4:vdisk4
    5:vdisk5
  2. If the lsdependentvdisks command returns an error, you must move your quorum disks to MDisks that are accessible through all nodes.
    Rerun the command until no errors are returned.
  3. Reissue the lsdependentvdisks command.
    When the command returns no volumes, the system is free from any node-dependent volumes.

    The following example shows the command syntax for listing the volumes that are dependent on node01:

    lsdependentvdisks -node01 :
    

    The following example shows the command output if there are no node-dependent volumes in the system:

    vdisk_id       vdisk_name