Creating and Using Oracle® Solaris Zones

Exit Print View

Updated: May 2015


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

The following is a list of URI syntax.

  • iscsi:///luname.naa.ID

  • iscsi://host[:port]/luname.naa.ID

Examples of the use of the URI syntax are as follows:

  • iscsi:///luname.naa.600144f03d70c80000004ea57da10001

  • iscsi://[::1]/luname.naa.600144f03d70c80000004ea57da10001

  • iscsi://hostname/luname.naa.600144f03d70c80000004ea57da10001

  • iscsi://hostname:3260/luname.naa.600144f03d70c80000004ea57da10001

  • iscsi://

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.