Skip to main content
A newer release of this product is available.

storage iscsi-initiator add-target

Suggest changes

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 (privilege: advanced)

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

-label <text> - User Defined Identifier (privilege: advanced)

Specifies a label for the target to be added.

-target-type {external|mailbox|partner|dr_auxiliary|dr_partner} - Target Type (privilege: advanced)

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 (privilege: advanced)

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 (privilege: advanced)

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

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

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