Enables you to set up a Clone LUN without completing its creation.
clone_lun ‑prepare ‑name clone‑lun‑name ‑source source‑lun‑id‑or‑fqn [‑capacity capacity] [‑priority {premium | high | medium | low | archive}] [‑volumeGroup volume‑group‑id‑or‑fqn] [{ ‑unmapped | ‑globalMapping lun‑number | ‑hostmap host‑id‑or‑fqn [, host‑id‑or‑fqn]... ‑lunNumber lun‑number | ‑hostGroupMap host‑group‑id‑or‑fqn ‑lunNumber lun‑number }] [{‑fibreChannelAccess | ‑noFibreChannelAccess}] [{‑iscsiAccess | ‑noIscsiAccess}] [‑maskedControllerPorts /controller[/slot[/port]] [, /controller[/slot[/port]]]... ] [{‑active | ‑inactive }] [{‑disableRefTagChecking | ‑enableRefTagChecking}] [‑bootLun | ‑noBootLun] [{‑sessionKey | ‑u admin‑user ‑oracleFS oracle‑fs‑system}] [{‑outputformat | ‑o} { text | xml }] [{‑timeout timeout‑in‑seconds | ‑verify | ‑usage | ‑example | ‑help}]
The clone_lun -prepare command enables you to organize the details of a new Clone LUN without creating an active clone. You can define the characteristics for the new clone, such as Quality of Service (QoS) attributes, mapping, and storage capacity. When you are ready to complete the creation of the new Clone LUN, run the clone_lun -commit command.
Enables the Clone LUN to be accessible and available for use immediately after you run the clone_lun ‑commit command. To ensure accurate mapping relationships, use the ‑globalMapping option, the ‑hostmap option, or the ‑hostGroupMap option with the ‑active option. Enabling the Clone LUN to be accessible is the default.
Identifies that the Clone LUN can be used as a boot drive in the SAN.
Specifies the storage space in gigabytes for the clone. Specify this value if you want the capacity of the clone volume to be different from the capacity of the source volume. This value must be equal to or larger than the source volume. This space is sometimes referred to as addressable capacity.
Instructs the HBA to bypass the check of whether a host has written to a specific area of the LUN before the host reads from that same area. If this option is omitted, read-before-write error events can be generated.
If this option is omitted, reference tag checking is enabled by default.
By default, reference tag checking is enabled.
Allows users to access to the volume through the Fibre Channel (FC) ports. By default, FC access is enabled.
Maps the Clone LUN globally to all hosts using the specified lun-number.
Specifies a mapping relationship between a Clone LUN and a host group. You identify the host group mapping by providing a fully qualified name (FQN) or a unique ID (ID).
Specifies a mapping relationship between a Clone LUN and a SAN host. You identify the host by providing a unique ID (ID) or a fully qualified name (FQN).
Renders the LUN volume invisible on the network. An inactive volume is not accessible and cannot be used by a SAN host.
Allows access to the Clone LUN through the iSCSI ports.
For controller, provide a string that includes the FQN or ID of the Controller.
For slot, specify the HBA slot number.
For port, specify the port number.
Specifies a name for the Clone LUN. The name that you provide must be between 1 and 40 characters. Use double quotation marks around names containing one or more spaces or dashes to prevent parsing errors.
Tab
/ (slash) and \ (backslash)
. (dot) and .. (dot-dot)
Embedded tabs
Identifies that the Clone LUN cannot be used as a boot drive in the SAN. Not using the Clone LUN as a boot drive is the default.
Disables access to the Clone LUN through FC ports. By default, access is enabled.
Disables access to the Clone LUN through use of the iSCSI protocol. By default, the Clone LUN is not accessible through the iSCSI protocol.
premium. Indicates the highest priority for responding to requests in the processing queue. For Auto-Tier LUNs, busy LUN extents receive the highest priority when the system migrates the data to the higher-performing storage tiers.
high. Indicates the next highest priority for responding to requests in the processing queue. For Auto-Tier LUNs, busy LUN extents receive the next highest priority when the system migrates the data to the higher-performing storage tiers.
medium. Indicates an intermediate priority for responding to requests in the processing queue. For Auto-Tier LUNs, busy LUN extents receive an intermediate priority when the system migrates the data to the higher-performing storage tiers.
low. Indicates the next to lowest priority for responding to requests in the processing queue. For Auto-Tier LUNs, busy LUN extents receive the next to lowest priority when the system migrates the data to the higher-performing storage tiers.
archive. Indicates the lowest priority for responding to requests in the processing queue. For Auto-Tier LUNs, busy LUN extents receive the lowest priority when the system migrates the data to the higher-performing storage tiers.
Specifies the FQN or unique identifier (ID) of the source LUN.
Prevents the Clone LUN from being detected or accessed by any SAN host.
Specifies the FQN or the ID of the volume group to which the Clone LUN is assigned. If you do not include this option, the Clone LUN is assigned to the root level volume group.
Prepare a Clone LUN that will be created later using the clone_lun ‑commit command.
The name of the Clone LUN: CLONE_DISK1
The fully qualified name (FQN) of the source LUN: /user1_vg/DISK1
$ fscli clone_lun -prepare ‑name CLONE_DISK1 ‑source /user1_vg/DISK1