ONTAP 9.14.1 commands

storage iscsi-initiator add-target

Add an iSCSI target

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


The storage iscsi-initiator add-target command adds an iSCSI target to a node’s list of targets. This command is only supported on high-availability shared-nothing virtualized platforms.


-node {<nodename>|local} - Node

Specifies the name of the Data ONTAP node to which the iSCSI target will be added.

-label <text> - User Defined Identifier

Specifies a label for the target to be added.

-target-type {external|mailbox|partner|partner2|dr_auxiliary|dr_partner} - Target Type

Specifies the type of the target. It is used by the node to determine how to use the LUNs. There are five target types:

  • partner - The partner target should belong to the node’s HA partner. This allows the node to access its partner’s disks.

  • mailbox - A mailbox target’s LUNs are used exclusively as HA mailboxes.

  • external - External targets' LUNs can be used by the node but do not play a role in HA.

  • dr_auxiliary - The DR auxiliary target for MetroCluster over IP. Not a valid target type for the add-target command.

  • dr_partner - The DR partner target for MetroCluster over IP. Not a valid target type for the add-target command.

-target-portal <text> - Target Portal

Specifies the target’s IP address and listening TCP port. The port is not required if it is the default iSCSI port (3260). Examples of correct target portals are and .

-target-name <text> - iSCSI Name

Specifies the iSCSI target name such as an IQN (iSCSI qualified name).

[-status-admin {down|up}] - Administrative Status (default: up)

Use to specify whether the initial administrative status of the connection is up or down. The default setting is up .


The following example adds and connects to an iSCSI target from the specified node.

cluster1::*> storage iscsi-initiator add-target -node node1
             -label target1 -target-type external
             -target-name iqn.2012-06.com.bsdctl:target0
Top of Page