reverttoimage

Reverts the specified fileset to a specified FlashCopy® image of the file layout and contents.

Read syntax diagramSkip visual syntax diagram
>>-reverttoimage--+--------+--+---------+----------------------->
                  +- -?----+  '- -quiet-'
                  +- -h----+
                  '- -help-'

>-- -fileset--fileset_name--+-----+--+-image_name-+------------><
                            '- -f-'  '- - --------'

Parameters

–? | –h | –help
Displays a detailed description of this command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored.
–quiet
Turns off confirmation messages for this command.
–fileset fileset_name
Specifies the name of the fileset that you want to revert to a previous FlashCopy image.
–f
Forces the metadata server to revert to the specified FlashCopy image if a client is reading files in the current image. Changes made to files in the fileset since the specified FlashCopy image was created will be lost.
image_name
Specifies the name of the FlashCopy images to which you want to revert.
Specifies that in single-shot command mode you want this command to receive from the input stream (stdin) the name of the FlashCopy image to which you want to revert.

Prerequisites

You must have Administrator privileges to use the command.

You must be logged in to the operating system on the engine hosting the master metadata server to run this command.

Description

Attention: When you revert a fileset to a specified target FlashCopy image, the target FlashCopy image and all FlashCopy images taken between the current fileset and target FlashCopy image are deleted. The target FlashCopy image becomes the primary image for the current fileset and no longer appears as an image listed in the .flashcopy directory.

Unless you specify the –f parameter, there must not be any client activity in the FlashCopy images being deleted or in the current fileset image.

You cannot revert to a FlashCopy image when nested filesets exist within the fileset. You must manually detach the nested filesets before running the reverttoimage command.

The .flashcopy directory is a hidden directory. Windows-based clients must use special operating-system commands to view this directory.

Depending on the age of the specified FlashCopy image and the amount of unique file data in the image tree, the revert operation could result in significant background activity to clean up the file-system objects that are no longer referenced.

The reverttoimage command runs in two phases, a foreground phase and a background phase. The reverttoimage command returns to the user when the foreground phase completes. In the foreground phase, the following occurs:
  • The target FlashCopy image and all images created after the target image are removed.
  • The target FlashCopy image becomes the new primary image of the fileset.
  • Clients are notified of the change.
  • The background phase is initiated.
In the background phase, metadata that is used by any removed FlashCopy images and the old primary image is garbage collected. When the reverttoimage command returns from the foreground phase, the FlashCopy images it removed are no longer available and cannot be specified as parameters to FlashCopy commands such as lsimage, rmimage, or reverttoimage. During the background phase, the mkimage command cannot be issued, however the rmimage and reverttoimage can be issued.

Because the specified FlashCopy image is deleted after you issue the reverttoimage command, it is recommended that you preserve a secondary backup of the fileset before using the command for future use or disaster recovery.

To preserve the fileset hierarchy, you must reattach any nested filesets that you detached before issuing the command when this command completes. It is recommended that you note the hierarchy using the lsfileset command before reverting to a FlashCopy image.

You cannot use the reverttoimage command while the mvfile command is in progress on a file on the same fileset.

Example

Revert to a previous FlashCopy image The following example reverts the fileset cnt_A to the FlashCopy image cntA_image:
sfscli> reverttoimage -fileset cnt_A cntA_image
Are you sure you want to revert to FlashCopy image cntA_image? y/n Y
FlashCopy cntA_image successfully restored.

Parent topic: Administrative commands

Related tasks
Reverting to a previous FlashCopy image

Related reference
lsimage
mkimage
rmimage

Library | Support | Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.
IBM TotalStorage SAN File System v2.2