Introduction to Oracle® Solaris Zones

Exit Print View

Updated: December 2014
 
 

solaris and solaris10 Only:rootzpool Resource

The optional rootzpool resource in the zonecfg utility is used to create a dedicated zpool for zone installation for solaris and solaris10 brand zones. The zone root zpool can be hosted on shared storage devices defined by one or more Universal Resource Identifiers (URIs). The required storage property identifies the storage object URI to contain the root zfs file system for a zone. Only one rootzpool can be defined for a given zone. The storage is automatically configured for the zone when the zone is booted.

The corresponding zpools are automatically created or imported during zone installation or zone attach operations. For both the rootzpool and zpool resources, you can automatically create zpool mirrors as soon as the zone is installed. For more information, see Chapter 14, Getting Started With Oracle Solaris Zones on Shared Storage, in Creating and Using Oracle Solaris Zones .

When the zone is uninstalled or detached, the following actions take place:

  • The corresponding zpools are automatically exported or destroyed.

  • The storage resources are automatically unconfigured.

To reuse a pre-created zpool for a zone installation, the zpool must be exported from the system.

The zones framework supports the following URI types:

  • dev

    Local device path URI

    Format:

    dev:local-path-under-/dev
    dev://absolute-path-with-dev
    dev:absolute-path-with-dev

    Examples:

    dev:dsk/c7t0d0s0
    dev:///dev/dsk/c7t0d0s0
    dev:/dev/dsk/c7t0d0s0
    dev:chassis/SYS/HD1/disk
  • lu (Logical Unit)

    Fibre Channel (FC) and Serial Attached SCSI (SAS)

    Format:

    lu:luname.naa.ID
    lu:luname.eui.ID
    lu:initiator.naa.ID,target.naa.ID,luname.naa.ID
    lu:initiator.naa.ID,target.naa.ID,luname.eui.ID

    Examples:

    lu:luname.naa.5000c5000288fa25
    lu:luname.eui.0021280001cf80f6
    lu:initiator.naa.2100001d38089fb0,target.naa.2100001d38089fb0,luname.naa.5000c5000288fa25
    lu:initiator.naa.2100001d38089fb0,target.naa.2100001d38089fb0,luname.eui.0021280001cf80f6 
  • iscsi

    iSCSI URI

    Format:

    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 

    Examples:

    iscsi:///luname.eui.0021280001cf80f6
    iscsi:///luname.naa.600144f03d70c80000004ea57da10001
    iscsi://[::1]/luname.naa.600144f03d70c80000004ea57da10001
    iscsi://127.0.0.1/luname.naa.600144f03d70c80000004ea57da10001
    iscsi://hostname:1234/luname.eui.0021280001cf80f6
    iscsi://hostname:3260/luname.naa.600144f03d70c80000004ea57da10001
    
    iscsi://127.0.0.1/target.iqn.com.sun:02:d0f2d311-f703,lun.0
    iscsi:///target.iqn.com.sun:02:d0f2d311-f703,lun.6
    iscsi://[::1]:1234/target.iqn.com.sun:02:d0f2d311-f703,lun.2
    iscsi://hostname:1234/target.iqn.com.sun:4db41b76-e3d7-cd2f-bf2d-9abef784d76c,lun.0 

The suriadm tool is used to administer shared objects based on storage URIs. For information about IDs, the Name Address Authority (NAA), and obtaining URIs for existing storage objects, see the suriadm(1M) and suri(5) man pages.

The system names the newly created or imported rootzpool for its associated zone. The assigned name has the form zonename_rpool.

The storage property is managed using the following commands from inside the rootzpool resource scope:

  • add storage URI string

  • remove storage URI string