Skip to main content

storage iscsi-initiator add-target

Contributors
Suggest changes
PDFs

Add an iSCSI target

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

Description

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.

Parameters

-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|partner2|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 10.0.0.2 and 10.0.0.2:860 .

-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 .

Examples

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-portal 10.0.0.2:860
             -target-name iqn.2012-06.com.bsdctl:target0