1. Creating and Using Oracle Solaris Zones
  2. Oracle Solaris Zones on Shared Storage
  3. About Shared Storage Resources Using Storage URIs
  4. iSCSI URI

iSCSI URI

The iSCSI URI type describes storage devices accessed by using the iSCSI network-based storage protocol. It always refers to an entire disk.

For more information about iSCSI Qualified Name (IQN), see the suri(7) man page.

The following is a list of URI syntax:

iscsi:///luname.naa.ID
iscsi:///luname.eui.ID
iscsi://host[:port]/luname.naa.ID
iscsi://host[:port]/luname.eui.ID
iscsi:///target.IQN,lun.LUN
iscsi://host[:port]/target.IQN,lun.LUN

The following examples show how to use the URI syntax:

iscsi:///luname.eui.0021280001cf80f6
iscsi:///luname.naa.600144f03d70c80000004ea57da10001
iscsi://[::1]/luname.naa.600144f03d70c80000004ea57da10001
iscsi://127.0.0.1/luname.naa.600144f03d70c80000004ea57da10001
iscsi://127.0.0.1:3260/luname.naa.600144f03d70c80000004ea57da10001
iscsi://hostname:3260/luname.eui.0021280001cf80f6
iscsi://hostname:3260/luname.naa.600144f03d70c80000004ea57da10001
iscsi://[::1]/target.iqn.com.sun:02:d0f2d311-f703,lun.2

See Logical Unit URI for an explanation of the luname-only URI form and the ID.

Optionally, the hostname[: port ] authority section provides information to automatically configure the iSCSI initiator using an unauthenticated SendTargets discovery address. IPv6 addresses must be enclosed in square brackets ([]).

Use the luname-only URI form only for static or iSNS based configurations, or when using authentication. These functions must be configured outside of the zones framework before they can be used.

Note that if you want to use iSCSI over iSER transports, the iSCSI storage URI transparently allows for this as well. To use iSER, the target and initiator must go through the address assigned to the InfiniBand (IB) partition link. In the global zone, you must set up the IB partitions with the dladm create-part command and assign the target and initiator addresses to the IB partitions using the ipadm create-ip and ipadm create-addr commands. This address is then used in the authority section of the iSCSI storage URI to specify the target's discovery address.

If InfiniBand (IB) hardware is present and an InfiniBand reliable-connected (RC) connection can be established, then an iSER-enabled initiator uses iSER connections to iSER-enabled targets. If the RC connection cannot be established, the connection is established using IP-based connectivity.