test veritas logo


fsckpt_restore(1M)

NAME

fsckpt_restore - VxFS Storage Checkpoint file system restoration utility

SYNOPSIS

fsckpt_restore [ -n | -y ] [ -l ] device_name [ ckpt_name ]

AVAILABILITY

VRTSvxfs

DESCRIPTION

fsckpt_restore restores a VxFS file system on the block device device_name from one of its Storage Checkpoints ckpt_name. fsckpt_restore can operate interactively in a non-interactive mode depending on whether the -y or -n option is specified.

device_name specifies the block device on which the file system resides.

ckpt_name specifies the name of the Storage Checkpoint from which to restore the file system. If no Storage Checkpoint name is specified, fsckpt_restore lists the Storage Checkpoints found, and in interactive mode, prompts for selection and confirmation of a Storage Checkpoint from which to restore the file system.

NOTES

After restoring a Storage Checkpoint, a file system will be busy after it is next mounted until cleanup operations complete. If you try to unmount the file system during this time, a file system busy message may be displayed. Wait until the cleanup operations complete and try the unmount again.

The name of the Storage Checkpoint is preserved when a file system is restored from that Storage Checkpoint. That is, the name of the Storage Checkpoint is used by the fileset. For example, if a file system is restored from a Storage Checkpoint named backup1, you must rename the fileset if you wish to create another Storage Checkpoint using the name backup1. See the fsckptadm(1M) manual page for information on renaming a Storage Checkpoint.

You can restore from a Storage Checkpoint only to a file system that has disk layout Version 6 or later.

WARNINGS

When a file system is restored from a Storage Checkpoint using fsckpt_restore, all changes made to that file system after the creation of the Storage Checkpoint are permanently unrecoverable. The only Storage Checkpoints and data preserved are those that were created at the same time as, or before, the selected Storage Checkpoint’s creation time. Run fsckpt_restore only if later changes to the file system can be discarded.

Neither the file system nor any of its Storage Checkpoints can be mounted when fsckpt_restore is invoked.

Cluster File System Issues

No cluster issues; command operates the same on cluster file systems.

OPTIONS

-l Lists information on the file system root and all of its Storage Checkpoints. Typically, fsckpt_restore lists only those Storage Checkpoints which can be selected as sources for file system restoration.
-n Reports the dates and options for the Storage Checkpoint, but does not restore the file system.
-y Does not prompt for confirmation before restoring the file system.

EXAMPLE

The following example lists information about all of the Storage Checkpoints for the volume /dev/vx/dsk/MyDG/vol2, then prompts the user to specify from which Storage Checkpoint to restore the file system on the volume:

# fsckpt_restore -l /dev/vx/dsk/MyDG/vol2

/dev/vx/dsk/MyDG/vol2:

UNNAMED:         ctime =  Thu 05 Dec 2002 06:28:24 PM PST         mtime =  Thu 05 Dec 2002 06:28:26 PM PST         flags =  file system root ckpt6:         ctime =  Thu 05 Dec 2002 06:28:35 PM PST         mtime =  Thu 05 Dec 2002 06:28:35 PM PST         flags =  none ckpt5:         ctime =  Thu 05 Dec 2002 06:28:34 PM PST         mtime =  Thu 05 Dec 2002 06:28:34 PM PST         flags =  nomount ckpt4:         ctime =  Thu 05 Dec 2002 06:28:33 PM PST         mtime =  Thu 05 Dec 2002 06:28:33 PM PST         flags =  none ckpt3:         ctime =  Thu 05 Dec 2002 06:28:31 PM PST         mtime =  Thu 05 Dec 2002 06:28:36 PM PST         flags =  none ckpt2:         ctime =  Thu 05 Dec 2002 06:28:30 PM PST         mtime =  Thu 05 Dec 2002 06:28:30 PM PST         flags =  none ckpt1:         ctime =  Thu 05 Dec 2002 06:28:29 PM PST         mtime =  Thu 05 Dec 2002 06:28:29 PM PST         flags =  nodata

Select the Storage Checkpoint for restore operation, or enter RETURN to list Storage Checkpoints: ckpt3

ckpt3:         ctime =  Thu 05 Dec 2002 06:28:31 PM PST         mtime =  Thu 05 Dec 2002 06:28:36 PM PST         flags =  none

WARNING!! Checkpoint ckpt3 has been modified. WARNING!! Any file system changes or Storage Checkpoints made after Thu 05 Dec 2002 06:28:31 PM PST will be lost. Restore the file system from Storage Checkpoint ckpt3 ? (ynq) y (Yes)

File system restored from ckpt3

The following example lists information about the Storage Checkpoint ckpt1 for the volume /dev/vx/dsk/MyDG/vol1, then prompts if the user wants to restore the file system on the volume from ckpt1:


# fsckpt_restore -l /dev/vx/dsk/MyDG/vol1 ckpt1

/dev/vx/dsk/MyDG/vol1:

ckpt1: ctime = Mon Aug 17 11:54:06 2009 mtime = Mon Aug 17 11:54:06 2009 flags = largefiles

UX:vxfs fsckpt_restore: WARNING: V-3-24640: Any file system changes or storage checkpoints made after Mon Aug 17 11:54:06 2009 will be lost.

Restore the filesystem from storage checkpoint ckpt1 ? (ynq) y (Yes) UX:vxfs fsckpt_restore: INFO: V-3-23760: File system restored from ckpt1

SEE ALSO

fsckptadm(1M), mount_vxfs(1M)


VxFS 7.4 fsckpt_restore(1M)