Changes the properties of an existing Clone LUN on the Oracle FS System.
clone_lun ‑modify ‑cloneLun clone‑lun‑id‑or‑fqn [‑name new‑name] [‑capacity capacity] [‑priority {premium | high | medium | low | archive}] [‑volumeGroup volume‑group‑id‑or‑fqn] [{‑fibreChannelAccess | ‑noFibreChannelAccess}] [‑maskedControllerPorts /controller[/slot[/port]] [, /controller[/slot[/port]]]... ] [‑unMaskedControllerPorts /controller[/slot[/port]] [, /controller[/slot[/port]]]... ] [{ ‑unmapped | ‑globalMapping lun‑number }] [{‑active | ‑inactive}] [‑clearPinnedData] [{‑disableRefTagChecking | ‑enableRefTagChecking}] [{‑bootLun | ‑noBootLun}] [{‑sessionKey | ‑u admin‑user ‑oracleFS oracle‑fs‑system}] [{‑outputformat | ‑o} { text | xml }] [{‑timeout timeout‑in‑seconds | ‑verify | ‑usage | ‑example | ‑help}]
To change the Quality of Service (QoS) attributes for a Clone LUN to address the needs of a specific task, such as increasing the capacity that is allocated to the Clone LUN, use the clone_lun ‑modify command. You can also modify the mapping of a Clone LUN as well as change the Controller to which the Clone LUN is assigned.
Enables the Clone LUN to be accessible and available for use immediately after the Clone LUN is modified. 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 volume. The amount of space cannot be less than the current maximum capacity of the Clone LUN. This space is sometimes referred to as addressable capacity.
Specifies the ID or the fully qualified name (FQN) of the Clone LUN to modify.
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.
Permits 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.
Renders the LUN volume invisible on the network. An inactive volume is not accessible and cannot be used by a SAN host.
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 new name for the Clone LUN. The name that you provide must be from 1 through 40 characters. To prevent parsing errors, use double quotation marks around names containing one or more spaces or dashes.
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 modified Clone LUN through FC ports. By default, access is enabled.
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.
Opens access to the volume through the Controller ports that were previously set to restricted access.
Indicates the unique ID or the name of a Controller. Include a forward slash ( / ) character before the name.
Specifies the PCIE slot number of the HBA on which the port is located. The slot number must be 0 or greater.
Identifies the port number on the HBA slot. The port number must be 0 or greater.
For example, /CONTROLLER-01/1/0 specifies port 1 on HBA slot 0 of the Controller named CONTROLLER-01.
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.
The following global options can be used for fully formed fscli commands:
The command completes successfully.
The command returns with an error.
The session times out.
Inspects the validity of the command syntax, not the semantics. Used to test the structure of a command without running the command. Does not determine whether errors would be produced if you issue a structurally correct command with the input provided.
Directs the CLI to prompt you to supply a session key when you issue the command. The CLI displays Sessionkey: as the prompt. To obtain a session key, log in with the ‑returnKey option specified. After the session is established, the session key is displayed in STDOUT. If you request a session key, the ‑sessionkey option is required syntax for all commands that are issued in a given session. In environments with more than one Oracle FS System, the session key is used to determine to which Oracle FS System to direct the command for validation. Session keys are also used to establish two or more CLI sessions when using a shared administrator account.
Change the name of a Clone LUN and increase the logical capacity. Change the priority to the highest processing queue setting for testing purposes, and make the Clone LUN accessible immediately.
The fully qualified name (FQN) of the Clone LUN: /user1_vg/CLONE_DISK1
The new name of the Clone LUN: /user1_vg/CLONE_DISK3
The size of the Clone LUN, in gigabytes: 128
The priority level: premium
$ fscli clone_lun ‑modify ‑cloneLun /user1_vg/CLONE_DISK1 ‑name CLONE_DISK3 ‑capacity 128 ‑priority premium