clone_lun ‑resnap

Resets an existing Clone LUN to the current state of the source LUN.

SYNOPSIS

clone_lun ‑resnap 
        ‑cloneLun clone‑lun‑id‑or‑fqn
        [‑name clone‑lun‑name]
        [‑source source‑lun‑id‑or‑fqn]
        [‑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]]]... ]
        [{‑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}]

DESCRIPTION

The clone_lun ‑resnap command can be used to update a Clone LUN so that the clone represents the current state of the source LUN, while retaining its existing serial number and other properties. You can also change some of the properties of the Clone while refreshing its data.

Note: Only administrators with primary administrator, admin1, or admin2 roles are authorized to run the clone_lun -resnap command.

OPTIONS

‑active

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.

‑bootLun

Identifies that the Clone LUN can be used as a boot drive in the SAN.

‑capacity

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.

‑cloneLun

Specifies the ID or the fully qualified name (FQN) of the Clone LUN.

‑disableRefTagChecking

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.

‑enableRefTagChecking

Instructs the HBA to check whether a SAN host has written to a specific area of the LUN before the host reads from that area. When a host reads from a specific area before writing to that area, the Oracle FS System generates a read-before-write error event.

Note: This check is sometimes called a reference tag check and is a part of the process for ensuring data protection integrity.

‑fibreChannelAccess

Permits access to the volume through the Fibre Channel (FC) ports. By default, FC access is enabled.

‑inactive

Renders the LUN volume invisible on the network. An inactive volume is not accessible and cannot be used by a SAN host.

‑maskedControllerPorts

Restricts access to the Clone LUN through one or more Controller ports. To mask all the ports in a Controller, to mask all the ports for a given Controller slot, or to mask only a specific Controller port, use the following format: /⁠controller[/⁠slot[/⁠port]]

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.

If you do not include this option, the Clone LUN becomes accessible on all Controller ports on the assigned node by default.

‑name

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.

The following characters are invalid in a LUN name:

Tab
/ (slash) and \ (backslash)
. (dot) and .. (dot-dot)
Embedded tabs

Note: If the Oracle FS System already contains a LUN with the specified name within the same volume group, the clone_lun ‑resnap command does not map the modified LUN. You can run the clone_lun ‑modify command to map the Clone LUN after determining the name to assign.

‑noBootLun

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.

‑noFibreChannelAccess

Disables access to the Clone LUN through FC ports. By default, access is enabled.

‑priority

Assigns a priority level that determines the system response to incoming I/O requests against the Clone LUN. In general, the higher the priority level, the faster the system can respond to an access request. Valid priority levels:

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.

‑source

Specifies the FQN or unique identifier (ID) of the source LUN.

‑unMaskedControllerPorts

Opens access to the volume through the Controller ports that were previously set to restricted access.

Specify the port using the form /Controller ID or name/HBA slot number/port number. Specify the arguments in the following manner:

Controller ID or name: Indicates the unique ID or the name of a Controller. Include a forward slash ( / ) character before the name.
HBA slot number: Specifies the PCIE slot number of the HBA on which the port is located. The slot number must be 0 or greater.
port number: 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.

‑volumeGroup

Specifies the fully qualified name (FQN) or the unique ID of a volume group.

GLOBAL OPTIONS FOR SUBCOMMANDS

The following global options can be used for fscli command-subcommand pairs that do not include other command-line options:

‑help: Returns the context-sensitive help for the specified subcommand.
‑usage: Returns the subcommand syntax for the given command, including all of the options that are available for the command-subcommand pair.

GLOBAL OPTIONS FOR COMMANDS

The following global options can be used for fully formed fscli commands:

‑example

Returns sample output from the specified command.

Note: To see the output in XML format, include the ‑o xml option.

‑timeout timeout-in-seconds

Specifies the length of time (timeout-in-seconds) that the command line interface waits before another command is allowed to run. If the command takes longer to run than the specified time limit, the system continues processing the command, but the command prompt is made available so that you can issue another command. If the -timeout option is omitted, the command line interface blocks until the one of the following conditions is met:

The command completes successfully.
The command returns with an error.
The session times out.

Note: Be sure to check the state of the system after initiating a long running command with the ‑timeout option. Many fscli commands run a series of underlying commands in sequence. When the timeout value is reached before all of the underlying commands have completed, the fscli command does not complete with the outstanding tasks reporting a failure status.

‑outputformat | ‑o { text | xml }: Controls the type of the output the system returns from a command. If the ‑outputformat option is not included, the format of the output defaults to simple text. If xml is provided, the output is a collection of XML elements.
Note: For XML output, if internal errors occur during command execution, each error is included in a separate <ErrorList> tag.

‑verify: 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.
‑sessionkey: 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.
‑u admin-user ‑oracleFS oracle‑fs-system: Routes the command to a particular Oracle FS System for execution. This option passes the name of the administrator account to use when opening the session on the specified system. Identify a specific Oracle FS System by its IP address or by the name that is recorded in the domain name system (DNS). When logging in to the Oracle FS System using the ‑u option and the ‑oracleFS option, the fscli application prompts you for a password on the command line interface for access. The Oracle FS System and the account login information are used to authenticate the current session. Establishing a login session by specifying an Oracle FS System and an account does not change the credentials that are associated with the active sessions that are running on other clients.
Caution
Oracle recommends that you not use the Cygwin command line interface to run the fscli application on Windows platforms. If you are running the Cygwin interface and include the ‑u option as a part of the ‑list subcommand, the password for the specified account is included in the results. Exposing the password can cause a breach in security.

EXAMPLE

Task

Reset a Clone LUN to match its source LUN.

Parameters

The fully qualified name (FQN) of the Clone LUN before being reset: /⁠user1_vg/⁠CLONE_DISK1

$ fscli clone_lun ‑resnap ‑cloneLun /⁠user1_vg/⁠CLONE_DISK1