reverttoimage

Reverts the current 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 you want to read the name of the FlashCopy image to which you want to revert from stdin (for example, – << /work/image_list.txt).

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 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.

Until the reverttoimage command completes, you cannot perform any activity on the fileset except the rmimage and reverttoimage commands. If you issue a second reverttoimage command before the first one completes, you can only revert to a FlashCopy image that existed before the FlashCopy image being reverted by the first command.

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.

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
Image "cntA_image" successfully restored.

Parent topic: Administrative commands

Related reference
lsimage
mkimage
rmimage

Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.